创建线下事件组
您可以使用本接口创建一个线下事件组。
重要提示
使用事件 API 接口代表您同意遵守TikTok 商业产品(数据)条款,并且不会与 TikTok 分享敏感数据。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/offline/create/
方法 POST
Header
|字段|类型|描述|
|---|---|---|
|Content-Type {必填}|string|请求信息类型。<br>允许格式:`application/json`。|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。
参数
|字段|类型|描述|
|---|---|---|---|
|advertiser_id {必填}|string|广告主ID。|
|name{必填}|string|线下事件组名称。<br>长度限制:40个字符。<br>示例:in_store_purchases。<br><p><span style="color:darkred"><b>注意</b></span>:不支持指定其他线下事件组已使用的名称。否则,将出现报错。|
|description|string|线下事件组描述。<br>示例:in_store_purchases_blackfriday。|
|auto_tracking|boolean|是否开启自动监测。<br>枚举值:`true`,`false`。<br>如果本字段设置为`true`,今后在本广告主账户下新建的所有推广系列都会将该事件组用于广告监测和归因。<br><p><span style="color:darkred"><b>注意</b></span>:单个广告账户下最多创建10个开启自动监测的线下事件组。若达到上限,将无法再新建开启自动监测的线下事件组。|
示例
注意
您需要将示例中的虚拟数据替换为自己的数据。
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/offline/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"advertiser_id": "123456",
"name": "EVENT_SET_NAME",
"description": "In_store_purchases_blackfriday_2021",
"auto_tracking": true
}
'
(/code)
返回
|字段|类型|描述|
|---|---|---|---|
|event_set_id |string|您刚创建的事件组的ID。|
示例
(code)
HTTPS/1.1 200 OK
{
"event_set_id": "{{event_set_id}}"
}
(/code)