← 返回目录
📁 Marketing API › Campaign Management › Guides › Ad group

归因窗口期和事件统计方式

在广告组层级,您可以自主为您的推广系列或广告组设置不同的归因窗口期,从而自定义对转化 进行衡量的时间区间。

广告组层级支持的归因设置有: - 点击归因窗口期( click_attribution_window ):该字段定义用于衡量点击广告后发生转化的时间范围。您可以将窗口期最长设置为 28 天,查看用户点击广告后 28 天内的转化量。
- 深度互动观看归因窗口期(engaged_view_attribution_window ):该字段定义用于衡量观看您的视频广告 6 秒后发生转化的时间范围。您可以将窗口期最长设置为 7 天,查看用户观看视频广告 6 秒后 7 天内的转化量。 - 展示归因窗口期( view_attribution_window ):该字段定义用于衡量浏览广告后发生转化的时间范围。您可以将窗口期最长设置为 7 天,查看用户浏览广告后 7 天内的转化量。 - 事件统计方式( attribution_event_count ):此选项指的是在仅查看或点击广告后如何计数人们的操作。该字段定义如何统计用户在仅点击或浏览广告后采取操作的次数。

不同推广目标下支持的归因设置

若要了解对于推广系列和广告组层级的特定设置,字段 click_attribution_window ,engaged_view_attribution_window, view_attribution_window和 attribution_event_count 支持的值,请查看下列表格。

需注意,对于下表中未列出的推广目标,您无法手动从一系列归因设置中进行选择。在此情况下,可能会应用默认设置。若要确认在您未手动配置归因设置时,您的广告组是否使用了默认设置,可使用/adgroup/get/或/campaign/spc/get/接口。

应用推广

推广目标
(objective_type)
应用推广类型
(app_promotion_type)
优化位置
(推广对象)
优化目标 计费事件
(计费点)
(billing_event)
归因窗口期 事件统计方式
(attribution_event_count)
点击归因窗口期
(click_attribution_window)
展示归因窗口期
(view_attribution_window)
深度互动观看归因窗口期
(engaged_view_attribution_window)
应用推广
(APP_PROMOTION)
应用安装
(APP_INSTALL)
安卓应用
(promotion_type设置为APP_ANDROID)
自归因应用
(/app/info/中应用( app_id )对应的self_attribution_enabled 字段的返回值为true)
安装
(optimization_goal设置为INSTALL)
oCPM
(OCPM)
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
支持的值:
  • OFF
  • ONE_DAY
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
支持的值:
  • ONCE
安装与应用内事件数据
(optimization_goal设置为INSTALL,且设置了 secondary_optimization_event)
应用内事件,且将优化事件设置为购买
(optimization_goal设置为IN_APP_EVENT,且 optimization_event设置为ACTIVE_PAY)
支持的值:
  • ONCE
  • EVERY
应用内事件,且将优化事件设置为非购买事件
(optimization_goal设置为IN_APP_EVENT,且 optimization_event设置为非ACTIVE_PAY事件)
支持的值:
  • ONCE
价值
(optimization_goal设置为VALUE)
支持的值:
  • EVERY
非自归因应用
(/app/info/中应用( app_id )对应的self_attribution_enabled 字段的返回值为false)
应用内事件,且将优化事件设置为购买
(optimization_goal设置为IN_APP_EVENT,且 optimization_event设置为ACTIVE_PAY)
oCPM
(OCPM)
支持的值:
  • SEVEN_DAYS
支持的值:
  • ONE_DAY
支持的值:
  • SEVEN_DAYS
支持的值:
  • ONCE
  • EVERY
非专属推广系列中的 iOS 应用
( promotion_type设置为 APP_IOS 且推广系列的 campaign_type为 REGULAR_CAMPAIGN)
自归因应用
(/app/info/中应用( app_id )对应的self_attribution_enabled 字段的返回值为true)
安装
(optimization_goal设置为INSTALL)
oCPM
(OCPM)
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
支持的值:
  • OFF
  • ONE_DAY
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
支持的值:
  • ONCE
安装与应用内事件数据
(optimization_goal设置为INSTALL,且设置了 secondary_optimization_event)
支持的值:
  • ONCE
应用内事件
(optimization_goal设置为IN_APP_EVENT)
支持的值:
  • ONCE
价值
(optimization_goal设置为VALUE)
支持的值:
  • EVERY
应用再营销 安卓应用
(promotion_type设置为APP_ANDROID)
自归因应用
(/app/info/中应用( app_id )对应的self_attribution_enabled 字段的返回值为true)
应用内事件,且将优化事件设置为购买
(optimization_goal设置为IN_APP_EVENT,且 optimization_event设置为ACTIVE_PAY)
oCPM
(OCPM)
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
支持的值:
  • OFF
  • ONE_DAY
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
支持的值:
  • ONCE
  • EVERY
应用内事件,且将优化事件设置为非购买事件
(optimization_goal设置为IN_APP_EVENT,且 optimization_event设置为非ACTIVE_PAY事件)
支持的值:
  • ONCE
价值
(optimization_goal设置为VALUE)
支持的值:
  • EVERY
非自归因应用
(/app/info/中应用( app_id )对应的self_attribution_enabled 字段的返回值为false)
应用内事件,且将优化事件设置为购买
(optimization_goal设置为IN_APP_EVENT,且 optimization_event设置为ACTIVE_PAY)
oCPM
(OCPM)
支持的值:
  • SEVEN_DAYS
支持的值:
  • ONE_DAY
支持的值:
  • SEVEN_DAYS
支持的值:
  • ONCE
  • EVERY
iOS 应用
( promotion_type 设置为 APP_IOS )
自归因应用
(/app/info/中应用( app_id )对应的self_attribution_enabled 字段的返回值为true)
应用内事件
(optimization_goal设置为IN_APP_EVENT)
oCPM
(OCPM)
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
支持的值:
  • OFF
  • ONE_DAY
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
支持的值:
  • ONCE
价值
(optimization_goal设置为VALUE)
支持的值:
  • EVERY
应用预注册
(APP_PREREGISTRATION)
网站
(promotion_type设置为WEBSITE)
转化
(optimization_goal设置为CONVERT)
oCPM
(OCPM)
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
  • FOURTEEN_DAYS
  • TWENTY_EIGHT_DAYS
支持的值:
  • OFF
  • ONE_DAY
  • SEVEN_DAYS
/ 支持的值:
  • ONCE
  • EVERY

线索收集

推广目标
(objective_type)
优化位置
(推广对象)
优化目标
(optimization_goal)
计费事件
( 计费点 )
(billing_event)
归因窗口期 事件统计方式
(attribution_event_count)
点击归因窗口期
(click_attribution_window)
展示归因窗口期
(view_attribution_window)
线索收集 (LEAD_GENERATION) 网站
(promotion_type设置为LEAD_GENERATION ,且 promotion_target_type设置为EXTERNAL_WEBSITE)
转化
(CONVERT)
oCPM
(OCPM)
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
  • FOURTEEN_DAYS
  • TWENTY_EIGHT_DAYS
支持的值:
  • OFF
  • ONE_DAY
  • SEVEN_DAYS
支持的值:
  • ONCE
  • EVERY

商品销量

推广目标
(objective_type)
推广系列商品来源
(campaign_product_source)
优化位置
(推广对象)
优化目标 计费事件
( 计费点 )
(billing_event)
归因窗口期 事件统计方式
(attribution_event_count)
点击归因窗口期
(click_attribution_window)
展示归因窗口期
(view_attribution_window)
深度互动观看归因窗口期
(engaged_view_attribution_window)
商品销量
(PRODUCT_SALES)
商品库
(目录)
(CATALOG)
网站
(promotion_type设置为WEBSITE)
转化
(optimization_goal设置为CONVERT)
oCPM
(OCPM)
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
  • FOURTEEN_DAYS
  • TWENTY_EIGHT_DAYS
支持的值:
  • OFF
  • ONE_DAY
  • SEVEN_DAYS
/ 支持的值:
  • ONCE
  • EVERY
价值
(optimization_goal设置为VALUE)
支持的值:
  • EVERY
安卓应用,且未启用重定向
(promotion_type设置为APP_ANDROID,且shopping_ads_retargeting_type设置为OFF 或未传入)
自归因应用
(/app/info/中应用( app_id )对应的self_attribution_enabled 字段的返回值为true)
安装
(optimization_goal设置为INSTALL)
oCPM
(OCPM)
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
支持的值:
  • OFF
  • ONE_DAY
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
支持的值:
  • ONCE
应用内事件,且将优化事件设置为购买
(optimization_goal设置为IN_APP_EVENT,且 optimization_event设置为ACTIVE_PAY)
支持的值:
  • ONCE
  • EVERY
应用内事件,且将优化事件设置为非购买事件
(optimization_goal设置为IN_APP_EVENT,且 optimization_event设置为非ACTIVE_PAY事件)
支持的值:
  • ONCE
价值
(optimization_goal设置为VALUE)
支持的值:
  • EVERY
非自归因应用
(/app/info/中应用( app_id )对应的self_attribution_enabled 字段的返回值为false)
应用内事件,且将优化事件设置为购买
(optimization_goal设置为IN_APP_EVENT,且 optimization_event设置为ACTIVE_PAY)
oCPM
(OCPM)
支持的值:
  • SEVEN_DAYS
支持的值:
  • ONE_DAY
支持的值:
  • SEVEN_DAYS
支持的值:
  • ONCE
  • EVERY
安卓应用,且启用了重定向
(promotion_type 设置为 APP_ANDROID,且 shopping_ads_retargeting_type 设置为 LAB1, LAB2, 或 LAB3)
自归因应用
(/app/info/中应用(app_id)对应的 self_attribution_enabled 字段的返回值为 true)
应用内事件,且将优化事件设置为购买
(optimization_goal 设置为 IN_APP_EVENT,且 optimization_event 设置为 ACTIVE_PAY)
oCPM
(OCPM)
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
支持的值:
  • OFF
  • ONE_DAY
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
支持的值:
  • ONCE
  • EVERY
应用内事件,且将优化事件设置为非购买事件
(optimization_goal 设置为 IN_APP_EVENT,且 optimization_eventT 设置为非ACTIVE_PAY事件)
支持的值:
  • ONCE
价值
(optimization_goal 设置为 VALUE)
支持的值:
  • EVERY
非自归因应用

(/app/info/中应用(app_id)对应的 self_attribution_enabled 字段的返回值为 false)
应用内事件,且将优化事件设置为购买
(optimization_goal 设置为 IN_APP_EVENT,且 optimization_event 设置为 ACTIVE_PAY)
oCPM
(OCPM)
支持的值:
  • SEVEN_DAYS
支持的值:
  • ONE_DAY
支持的值:
  • SEVEN_DAYS
支持的值:
  • ONCE
  • EVERY
非专属推广系列中的 iOS 应用,且未启用重定向
(promotion_type 设置为 APP_IOS,推广系列的campaign_type 为 REGULAR_CAMPAIGN,且 shopping_ads_retargeting_type 设置为 OFF 或未传入)
自归因应用
(/app/info/中应用(app_id)对应的 self_attribution_enabled 字段的返回值为 true)
安装
(optimization_goal 设置为 INSTALL)
oCPM
(OCPM)
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
支持的值:
  • OFF
  • ONE_DAY
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
支持的值:
  • ONCE
安装与应用内事件数据
(optimization_goal 设置为 INSTALL,且设置了 secondary_optimization_event)
支持的值:
  • ONCE
应用内事件
(optimization_goal 设置为 IN_APP_EVENT)
支持的值:
  • ONCE
价值
(optimization_goal 设置为 VALUE)
支持的值:
  • EVERY
iOS 应用,且启用了重定向
(promotion_type 设置为 APP_IOS,且 shopping_ads_retargeting_type 设置为 LAB1, LAB2, 或 LAB3)
自归因应用
(/app/info/中应用(app_id)对应的 self_attribution_enabled 字段的返回值为 true)
应用内事件
(optimization_goal 设置为 IN_APP_EVENT)
oCPM
(OCPM)
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
支持的值:
  • OFF
  • ONE_DAY
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
支持的值:
  • ONCE
价值
(optimization_goal 设置为 VALUE)
支持的值:
  • EVERY
TikTok Shop (STORE)
视频购物广告
(promotion_type设置为VIDEO_SHOPPING,且 shopping_ads_type设置为VIDEO)
TikTok Shop
(store_id设置为 TikTok Shop ID)
转化
(optimization_goal设置为CONVERT)
oCPM
(OCPM)
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
  • FOURTEEN_DAYS
  • TWENTY_EIGHT_DAYS
支持的值:
  • OFF
  • ONE_DAY
  • SEVEN_DAYS
/ 支持的值:
  • ONCE
价值
(optimization_goal设置为VALUE)
直播购物广告
(promotion_type设置为LIVE_SHOPPING,且 shopping_ads_type设置为LIVE)
TikTok Shop
(store_id设置为 TikTok Shop ID)
转化
(optimization_goal设置为CONVERT)
oCPM
(OCPM)
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
  • FOURTEEN_DAYS
  • TWENTY_EIGHT_DAYS
支持的值:
  • OFF
  • ONE_DAY
  • SEVEN_DAYS
/ 支持的值:
  • ONCE
价值
(optimization_goal设置为VALUE)

网站转化量

推广目标
(objective_type)
优化位置
(推广对象)
优化目标
(optimization_goal)
计费事件
( 计费点 )
(billing_event)
归因窗口期 事件统计方式
(attribution_event_count)
点击归因窗口期
(click_attribution_window)
展示归因窗口期
(view_attribution_window)
网站转化量
(WEB_CONVERSIONS)
网站
(promotion_type设置为WEBSITE,且promotion_website_type设置为UNSET 或未传入)
转化
(CONVERT)
oCPM
(OCPM)
支持的值:
  • ONE_DAY
  • SEVEN_DAYS
  • FOURTEEN_DAYS
  • TWENTY_EIGHT_DAYS
支持的值:
  • OFF
  • ONE_DAY
  • SEVEN_DAYS
支持的值:
  • ONCE
  • EVERY
价值
(VALUE)
支持的值:
  • EVERY

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →