← 返回目录
📁 API Reference › TikTok One

创建或更新 TTO Creator Marketplace 营销活动

你可以使用本接口创建或更新 TikTok One（TTO）Creator Marketplace营销活动。

您可以同时创建以下任一类型的邀请链接：
- 营销活动级别邀请链接，用于将视频关联到特定营销活动。
- 品牌级别邀请链接，用于将视频关联到您的品牌账户。

欲了解更多关于邀请链接类型的信息，参见 TTO Creator Marketplace 内容链接。

注意
- 不再使用订单功能。营销活动报告将提供单个视频的表现数据，而非订单数据。 - 不再使用营销活动代码。达人应使用邀请链接关联视频。 - 通过此接口创建的营销活动将在 TTO Creator Marketplace 平台 上展示。 - 创建营销活动后，若达人希望在您的平台发布视频，可在发布时通过 /business/video/publish/ 接口的 tto_invite_link 参数，直接将视频与该营销活动相关联。

TCM 与 TTO Creator Marketplace 接口对比

下表概述了 TikTok Creator Marketplace（TCM）与 TTO Creator Marketplace接口之间的差异。

| 变化内容 {24%}| TCM 接口{36%} | TTO Creator Marketplace 接口{40%} |
|---|---|---|
|接口路径 | /v1.3/tcm/order/create/v2/ | /v1.3/tto/tcm/campaign/create/ |
|相同请求参数 | `brand_name`<br>`handle_names`<br> `default_spark_ads_requested_authorization_days`| `brand_name`<br>`handle_names`<br> `default_spark_ads_requested_authorization_days` |
|废弃请求参数 | N/A| `tcm_account_id`  <br>`description` <br> `campaign_code` <br>`order_source`  <br> `deliverables`  <br>`deliverables.deliverable_name` <br> `deliverables.spark_ads_requested_authorization_days` <br>`video_number`  |
|新增请求参数   |  N/A|`tto_tcm_account_id`<br> `campaign_name`<br> `campaign_description` <br>`campaign_id`<br>`advertiser_ids`<br>`anchor_id`<br>`campaign_type`<br>`brand_profile_id`<<br>`send_notification`<br>`business_account_handle`|
|相同返回参数 | `invite_link` | `invite_link`|
|废弃返回参数 |  N/A| `campaign_code` <br> `remaining_orders`<br> `orders`  <br> `orders.order_id`  <br>`orders.handle_name` |
|新增返回参数   | N/A|`campaign_id`<br> `brand_name`<br>`campaign_name` <br>`handle_names`<br>`campaign_description` <br>`spark_ads_requested_authorization_days` <br>`create_time` <br>`advertiser_ids`<br>`anchor_id`<br>`campaign_type`<br>`brand_profile_id`<br> `dm_info`<br>`business_account_handle`<br>`dm_allowed`|

请求

地址 https://business-api.tiktok.com/open_api/v1.3/tto/tcm/campaign/create/

方法 POST

Header

|字段{40%}|类型{10%}|描述{50%}|
|---|---|---|
|Access-Token {必填}|string|由 TTO Creator Marketplace账户授权的访问令牌。<br>详情参见[从 TTO Creator Marketplace 账户获取授权和访问令牌](https://business-api.tiktok.com/portal/docs/obtain-authorization-and-authentication-from-a-tto-creator-marketplace-account/v1.3)。|
|Content-Type {必填}|string|请求消息类型。<br>允许的格式：`application/json`。  |

参数

针对带有营销活动级别的邀请链接

|字段{40%}|类型{10%}|描述{50%}|
|--- |--- |--- |
| tto_tcm_account_id {必填} | string | TTO Creator Marketplace 账户的 ID。<br><br>要获取您通过访问令牌 `Access-Token` 可访问的账户 ID，使用接口 [/tto/oauth2/tcm/](1815693478150146.html)。 |
| campaign_type | string | TTO Creator Marketplace 营销活动的类型。<br><br>枚举值：<ul><li>`CAMPAIGN`：带有营销活动级别邀请链接的营销活动。</li></ul>默认值：`CAMPAIGN`。 |
| brand_profile_id{+条件必填} | string | `brand_profile_id` 和 `brand_name` 必填其一。<br>与营销活动关联的 TTO Creator Marketplace账户中的品牌主页 ID。<br><br>要创建品牌主页并获取品牌主页 ID，使用接口 [/tto/tcm/brand/profile/create/](1830335387914241.html)。<br>要获取已有的品牌主页 ID，使用接口 [/tto/tcm/brand/profile/get/](1830335437705217.html)。 |
| brand_name {+条件必填} | string | `brand_profile_id` 和 `brand_name` 必填其一。<br><br>品牌名称。<br><br>长度限制：60 个字符。<br><br><span style="color:darkred"><b>注意</b></span>：如果您正在更新已有营销活动（请求中指定了 `campaign_id`），将忽略本字段传入值，使用当前营销活动的 `brand_name` 值。 |
| campaign_name {必填} | string | 营销活动名称。<br><br>您的营销活动名称应简洁明了，能够吸引达人关注。您可以采用 “[产品名称 - 产品描述]” 的格式，向达人介绍品牌或产品的基本信息。<br><br>长度限制：120 个字符。<br><br>示例：`CapCut - video editor`<br><br><span style="color:darkred"><b>注意</b></span>：如果您正在更新已有营销活动（请求中指定了 `campaign_id`），将忽略本字段传入值，使用当前营销活动的 `campaign_name` 值。 |
| campaign_description| string | 营销活动描述。<br><br>提供有关营销活动的相关信息，例如产品定位、目标受众和核心功能。<br><br>长度限制：1000 个字符。<br><br><span style="color:darkred"><b>注意</b></span>：如果您正在更新已有营销活动（请求中指定了 `campaign_id`），将忽略本字段传入值，使用当前营销活动的 `campaign_description` 值将被使用。 |
|anchor_id|string|与营销活动关联的锚点 ID。<br>锚点是您添加到帖子中的链接，可帮助受众了解您的产品或服务。<br>锚点仅对锚点目标国家的受众可见。<br><br>只有当达人所在国家与锚点目标国家一致时，锚点的表现数据才可被度量。视频仍对达人的所有受众可见，但关联的锚点仅对锚点所在国家的受众可见。<br><br>要获取您 TTO Creator Marketplace账户中的锚点，可使用接口 [/tto/tcm/anchor/get/](1826564965840066.html)。|
| advertiser_ids | string[] | 营销活动要关联的广告账户列表。<br><br>当达人的视频与营销活动关联时，这些广告账户将自动获得该视频的 Spark Ads 授权，且视频将自动同步至这些广告账户的素材库。<br><br>当您指定 `advertiser_ids` 时，必须提供 `default_spark_ads_requested_authorization_days`。<br><br>最大数量：50。<br><br>要获取您通过 `Access-Token` 可访问的广告账户 ID，可使用接口 [/oauth2/advertiser/get/](1738455508553729.html)。 |
| default_spark_ads_requested_authorization_days {+条件必填}| integer | 仅在创建新营销活动时有效。<br>当指定 `advertiser_ids` 时必填。<br>当未指定 `advertiser_ids` 时可选。<br>更新已有营销活动时忽略此字段。<br><br>默认 Spark Ads 授权天数，即您想要向达人申请的、将达人上传至营销活动的视频作为 Spark Ads 推广的默认授权天数。<br>枚举值：0、7、30、60、180、365。<br>默认值：0。<br><br>一旦此字段设置为非 0 值，当达人接受邀请并将视频上传至营销活动时，达人将自动授予您对应天数的视频 Spark Ads 权限权。 |
| handle_names {必填} | string[] | 您希望邀请加入营销活动的 TikTok 达人用户名列表。<br><br>最大数量：100。<br><br>新建营销活动时，需指定要邀请的 TikTok 达人用户名。<br>更新已有营销活动时，需指定额外邀请的达人用户名，新达人将被添加至现有列表。<br>例如，若您创建的营销活动中 ``handle_names 为 ["{{handle_name_1}}","{{handle_name_2}}”]，想再邀请两位达人，可传入 `campaign_id` 并将 `handle_names` 设为 [“{{handle_name_3}}”, “{{handle_name_4}}”]。更新后，营销活动的 `handle_names` 将为 [“{{handle_name_1}}”, “{{handle_name_2}}”, “{{handle_name_3}}”, “{{handle_name_4}}”]。 |
|send_notification|boolean|是否将有关 TTO Creator Marketplace 营销活动邀请的通知发送至受邀 TikTok 达人（`handle_names`)的收件箱。<br> 创作者可以打开该通知以加入活动。<br><br> 支持的值：`true`，`false`。<br>默认值：`false`。 |
| campaign_id | string | 仅在更新已有营销活动时有效。<br>如果传入此字段，除 `tto_tcm_account_id` 和 `handle_names` 外，其他字段将被忽略。<br><br>已有的 TikTok One Creator Marketplace营销活动的 ID。<br><br>传入此字段时，需同时传入 `handle_names`，以向已有营销活动添加新达人。 |
| business_account_handle | string |企业号的用户名。 <br><br>若在创建营销活动时传入了此参数，达人在打开生成的邀请链接（`invite_link`）时将可以直接向品牌发送消息。<br><br><ul><li>仅适用于非欧盟企业号。</ul><p><span style="color:darkred"><b>注意</b></span>： 创建 TTO Creator Marketplace营销活动时关联企业号目前为白名单功能。如需访问该功能，请联系您的 TikTok 代表。|

示例

创建带有营销活动级别邀请链接的新营销活动
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/tto/tcm/campaign/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "tto_tcm_account_id": "{{tto_tcm_account_id}}",
    "brand_name": "{{brand_name}}",
    "campaign_name": "{{campaign_name}}",
    "campaign_description": "{{campaign_description}}",
    "default_spark_ads_requested_authorization_days":60,
    "handle_names": ["{{handle_name}}","{{handle_name}}"]
}'
(/code)
更新带有营销活动级别邀请链接的已有营销活动
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/tto/tcm/campaign/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "tto_tcm_account_id": "{{tto_tcm_account_id}}",
    "campaign_id": "{{campaign_id}}"
    "handle_names": ["{{handle_name}}","{{handle_name}}"],
    "brand_name": "", 
    "campaign_name": "",
    "campaign_description": ""
}'
(/code)

针对带有品牌级别邀请链接的营销活动

|字段{40%}|类型{10%}|描述{50%}|
|--- |--- |--- |
| tto_tcm_account_id {必填} | string | TTO Creator Marketplace账户的 ID。<br><br>要获取您通过访问令牌 `Access-Token` 可访问的账户 ID，使用接口 [/tto/oauth2/tcm/](1815693478150146.html)。 |
| campaign_type {必填} | string | TTO Creator Marketplace 营销活动的类型。<br><br>枚举值：<ul><li>`BRAND_LINK`：带有 [品牌级别邀请链接](https://business-api.tiktok.com/portal/docs?id=1830337139853313#item-link-Brand-level%20invite%20link) 的营销活动。</li></ul> |
| brand_profile_id {必填} | string | 与营销活动关联的 TTO Creator Marketplace 账户中的品牌主页 ID。<br>要创建品牌主页并获取品牌主页 ID，使用接口 [/tto/tcm/brand/profile/create/](1830335387914241.html)。<br>要获取已有品牌主页 ID，使用接口 [/tto/tcm/brand/profile/get/](1830335437705217.html)。 |
| advertiser_ids | string[] | 营销活动要关联的广告账户列表。<br><br>当达人的视频与该营销活动相关联时，这些广告账户将自动获得该视频的 Spark Ads 授权。<br>您可以指定属于同一商务中心、法人实体或登录邮箱的广告账户。<br><br>当指定 `advertiser_ids` 时，必须提供 `default_spark_ads_requested_authorization_days`。<br><br>最大数量：50。<br><br>要获取您通过 `access_token` 可访问的广告账户 ID，请使用接口 [/oauth2/advertiser/get/](1738455508553729.html)。 |
| default_spark_ads_requested_authorization_days {+条件必填} | integer | 仅在创建新营销活动时有效。<br>当指定 advertiser_ids 时必填。<br>未指定 advertiser_ids 时可选。<br>更新已有营销活动时忽略此字段。<br><br>默认 Spark Ads 授权天数，即您想要向达人申请的、将达人上传至营销活动的视频作为 Spark Ads 推广的默认授权天数。<br><br>枚举值：0、7、30、60、180、365。<br>默认值：0。<br><br>一旦此字段设置为非 0 值，当达人接受邀请并上传视频至营销活动时，达人将自动授予您对应天数的视频 Spark Ads 授权。 |
| business_account_handle | string |企业号的用户名。 <br><br>若在创建营销活动时传入了此参数，达人在打开生成的邀请链接（`invite_link`）时将可以直接向品牌发送消息。<br><br><ul><li>仅适用于非欧盟企业号。</ul><p><span style="color:darkred"><b>注意</b></span>： 创建 TTO Creator Marketplace营销活动时关联企业号目前为白名单功能。如需访问该功能，请联系您的 TikTok 代表。|

示例

创建带有品牌级别邀请链接的新营销活动
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/tto/tcm/campaign/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "tto_tcm_account_id": "{{tto_tcm_account_id}}",
    "campaign_type": "BRAND_LINK",
    "brand_profile_id": "{{brand_profile_id}}",
    "advertiser_ids": ["{{advertiser_id}}"],
    "default_spark_ads_requested_authorization_days": 7
}'
(/code)

返回

|字段{32%}|类型{15%}|描述{53%}|
|---|---|---|
|code |number|返回码。完整返回码列表及描述参见 [附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message|string|返回信息。更多信息参见 [附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|request_id |string|请求的日志 ID，唯一标识一个请求。|
|data |object|返回数据。|
#| campaign_id | string |TTO Creator Marketplace 营销活动的 ID。|
#| brand_name | string |品牌名称。|
#| campaign_name | string |营销活动名称。|
#| handle_names | string[] |该营销活动关联的 TikTok 达人账号名称列表。<br><br><p><span style="color:darkred"><b>注意</b></span>：由于数据处理的延迟，当达人受邀参与营销活动时，`handle_names` 可能是一个空列表 `&#91;&#93;`)。如果遇到空列表，可以等待一段时间，然后使用 [/tto/tcm/campaign/](1815693562720258.html) 接口来确认受邀参与该活动的达人的用户名列表。|
#| campaign_description | string |营销活动描述。|
#|anchor_id|string|与营销活动关联的锚点 ID。|
#| advertiser_ids | string[] |营销活动关联的广告账户列表。<br>当达人的视频关联到该营销活动时，这些广告账户将自动获得视频的 Spark Ads 授权。|
#| spark_ads_requested_authorization_days | integer |上传到营销活动的视频的默认 Spark Ads 授权天数。<br><br>枚举值：0、7、30、60、180、365。|
#| invite_link | string |与 TTO Creator Marketplace 营销活动关联的邀请链接。<br><br>邀请链接不会过期。|
#| create_time| string |营销活动创建时间，格式为 `YYYY-MM-DD HH:MM:SS`（UTC+0 时间）。<br><br>示例：`2024-01-01 00:00:01`。|
#| campaign_type | string |TTO Creator Marketplace 营销活动的类型。<br><br>枚举值：<ul><li>`CAMPAIGN`：带有 [营销活动级别邀请链接](https://business-api.tiktok.com/portal/docs?id=1830337139853313#item-link-Campaign-level%20invite%20link) 的营销活动。</li><li>`BRAND_LINK`：带有 [品牌级别邀请链接](https://business-api.tiktok.com/portal/docs?id=1830337139853313#item-link-Brand-level%20invite%20link) 的营销活动。</li></ul>|
#| brand_profile_id | string |与营销活动关联的品牌主页 ID。|
#|country_codes|string[]|当请求参数 `handle_names` 中指定的至少一名达人被成功邀请参与营销活动时返回。<br><br>与营销活动关联的国家或地区代码列表。<br>示例：`["US"]`。|
#|failed_handle_names|string[]|当请求参数 `handle_names` 中指定的至少一名达人未能成功受邀参与营销活动时返回。<br><br>未能成功加入营销活动中的用户名列表。<br><br>例如，如果在请求参数 `handle_names` 中提供了 `["handle_name_1","handle_name_2"]`，并且 `handle_name_1` 加入成功，而 `handle_name_2` 加入失败，则返回将显示 `handle_names` 为 `["handle_name_1"]`，`failed_handle_names` 为 `["handle_name_2"]`。|
#|dm_info|string|私信链接详情。|
##|business_account_handle|string|企业号的用户名。|
##|dm_allowed|boolean|是否允许发送私信。<br>支持的值： `true`（允许），`false`（不允许）。|

示例

创建带有营销活动级别邀请链接的新营销活动

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "campaign_description": "{{campaign_description}}",
        "campaign_id": "{{campaign_id}}",
        "brand_name": "{{brand_name}}",
        "campaign_name": "{{campaign_name}}",
        "create_time": "2024-10-03 19:32:04",
        "handle_names": [
            "{{handle_name}}",
            "{{handle_name}}"
        ],
        "invite_link": "https://www.tiktok.com/t/111111/",
        "spark_ads_requested_authorization_days": 60,
        "campaign_type": "CAMPAIGN"
    }
}
(/code)

使用营销活动级别邀请链接更新已有营销活动

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "campaign_description": "{{campaign_description}}",
        "campaign_id": "{{campaign_id}}",
        "brand_name": "{{brand_name}}",
        "campaign_name": "{{campaign_name}}",
        "create_time": "{{create_time}}",
        "handle_names": [
            "{{handle_name}}",
            "{{handle_name}}"
        ],
        "invite_link": "{{invite_link}}",
        "spark_ads_requested_authorization_days": 60,
        "campaign_type": "CAMPAIGN"
    }
}

(/code)

创建带有品牌级别邀请链接的新营销活动

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "advertiser_ids": ["{{advertiser_id}}"],
        "brand_name": "{{brand_name}}",
        "brand_profile_id": "{{brand_profile_id}}",
        "campaign_id": "{{campaign_id}}",
        "campaign_type": "BRAND_LINK",
        "create_time": "{{create_time}}",
        "invite_link": "{{invite_link}}",
        "spark_ads_requested_authorization_days": 7
    }
}
(/code)
← 作为品牌方获取 TTO 视频关联请求发送或撤销 TTO 视频关联请求 →

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