← 返回目录
📁 API Reference › Tools

获取应用可用的归因来源和数据源

使用此接口获取在创建升级版 Smart+ 广告组时,你的移动应用可用的归因来源和数据源。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/tool/available/attribution_source/

方法 GET

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](1738373164380162.html)接口获取。 |

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|advertiser_id {必填}|string|广告主 ID。|
|app_id {必填}|string|应用 ID。<br><br>要获取移动应用的应用 ID,可使用 [/app/list/](https://business-api.tiktok.com/portal/docs/get-the-app-list/v1.3)。|
|optimization_event|string|优化事件(转化事件)。<br><br>若想了解枚举值,可查看<a href="#item-link-optimization_event 的值列表">`optimization_event`的值列表</a>。|
|campaign_type|string|推广系列类型。<br><br>枚举值:<ul><li>`REGULAR_CAMPAIGN`:未开启 iOS 14 专属推广系列设置的推广系列。</li><li>`IOS14_CAMPAIGN`:已开启 iOS 14 专属推广系列设置的推广系列。</li></ul><br>默认值: `REGULAR_CAMPAIGN`。|

optimization_event 的值列表

|优化事件{40%}|optimization_event 值{60%}|
|---|---|
|安装|`ACTIVE`|
|注册|`ACTIVE_REGISTER`|
|购买<br>/购买价值(用于价值优化)|`ACTIVE_PAY`|
|结账|`IN_APP_ORDER`|
|加入购物车|`IN_APP_CART`|
|收集线索|`SALES_LEAD`|
|查看内容|`IN_APP_DETAIL_UV`|
|达到级别|`UPDATE_LEVEL`|
|创建角色|`CREATE_GAMEROLE`|
|启动应用|`LOAN_COMPLETION`|
|贷款批准|`LOAN_CREDIT`|
|登录|`LOGIN`|
|申请贷款|`LOAN_APPLY`|
|添加付款信息|`ADD_PAYMENT_INFO`|
|加入心愿单|`ADD_TO_WISHLIST`|
|启动应用|`LAUNCH_APP`|
|完成教程|`COMPLETE_TUTORIAL`|
|应用内广告点击|`IN_APP_AD_CLICK`|
|应用内广告展示|`IN_APP_AD_IMPR`|
|加入组|`JOIN_GROUP`|
|评分|`RATE`|
|搜索|`SEARCH`|
|开始试用|`START_TRIAL`|
|订阅|`SUBSCRIBE`|
|解锁关卡|`UNLOCK_ACHIEVEMENT`|
|广告收入价值(用于价值优化)|`AD_REVENUE_VALUE`/`IMPRESSION_LEVEL_AD_REVENUE`|

示例

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/tool/available/attribution_source/?advertiser_id={{advertiser_id}}&app_id={{app_id}}&campaign_type=REGULAR_CAMPAIGN' \
--header 'Access-Token: {{Access-Token}}'
(/code)

返回

|字段{30%}|类型{15%}|描述{55%}|
|-|-|-|
|code |number|返回码。完整返回码列表及描述参见[附录 - 返回码](https://business-api.tiktok.com/portal/docs/return-codes-appendix/v1.3)。|
|message |string|返回信息。更多信息参见[附录 - 返回码](https://business-api.tiktok.com/portal/docs/return-codes-appendix/v1.3)。|
|request_id|string| 请求的日志 ID,唯一标识一个请求。|
|data|object|返回数据。|
#|connected_data_source|string[]|该应用已连接的数据源列表。<br><br>枚举值:<ul><li>`MMP`: MMP(移动衡量合作伙伴)。</li><li>`EVENT_SDK`: TikTok 应用事件 SDK。</li><li>`EVENT_API`: TikTok 事件 API。</li></ul>|
#|available_attribution_source_list|object[]|创建升级版 Smart+ 广告组时可以为该应用配置的归因来源和数据源详情。<br><br>你可以在调用 [/smart_plus/adgroup/create/](https://business-api.tiktok.com/portal/docs/create-an-upgraded-smart-ad-group/v1.3) 时将此处`available_attribution_source` 和 `available_data_source` 的值传给 `app_attribution_source` 和 `app_data_source` 参数。|
##|available_attribution_source|string|创建升级版 Smart+ 广告组时可以为该应用配置的归因来源。<br><br>你选择的归因来源将用于优化、出价和报告。<br><br>枚举值:<ul><li>`MMP`: MMP 归因。来自所选 MMP 的信号将用于归因。</li><li>`SAN`: SAN 归因。来自 TikTok 自归因网络的信号将用于归因。</li></ul>|
##|available_data_source|string[]|创建升级版 Smart+ 广告组时可以为该应用配置的数据源列表。<br><br>你选择的归因信号将用于报告。<br><br>枚举值:<ul><li>`MMP`: MMP 信号。来自你的 MMP 的信号将用于报告。</li><li>`EVENT_SDK`: 应用事件 SDK 信号。来自 TikTok 应用事件 SDK 的信号将用于报告。</li><li>`EVENT_API`: 事件 API 信号。来自 TikTok 事件 API 的信号将用于报告。</li></ul>|

示例

(code curl http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "available_attribution_source_list": [
            {
                "available_attribution_source": "SAN",
                "available_data_source": [
                    "EVENT_SDK"
                ]
            }
        ],
        "connected_data_source": [
            "EVENT_SDK"
        ]
    }
}
(/code)

内容来源: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 每日平台更新简报 →