资产
您(商务中心管理员)可以使用商务中心 API 管理资产。资产包括广告账户、商品库、Pixel、线索、TikTok 账号和商店。下文列举了资产的常见使用案例。
创建广告账户
代理商或直客商务中心的管理员用户可以使用/bc/advertiser/create/ 接口,创建竞价或合约类型的广告账户。
重要提示
自 2024 年 9 月26 日起,为确保广告账户安全,我们已为中国出海广告主通过/bc/advertiser/create/在商务中心的广告账户创建实施了银联验证。在 2025 年 1 月 8 日之前,您可以继续使用现有的 API 工作流程。为支持银联验证的相关功能,我们在 2024 年 10 月中旬已发布 API 变更以及详细的 API 文档。受影响的开发者需要在 2025 年 1 月 8 日前搭建新的工作流程。 2025 年 1 月 8 日之后,您的现有集成可能无法正常运行。注意
只有代理商类型的商务中心可以创建合约广告账户。创建合约广告账户目前为白名单功能。如需使用此功能,请联系您的TikTok销售代表。
若想创建广告账号,需遵循以下步骤。具体的步骤根据注册地域和营业执照类型而有所不同。
对于中国大陆的广告主
若广告账号注册地为中国大陆,您可使用新营业执照或复用已验证的营业执照。
方式一:使用新营业执照
- 使用/bc/image/upload/上传营业执照的图片。返回中将包括每个营业执照的
image_id。 - 使用/bc/advertiser/unionpay_info/check/查询营业执照的银联验证要求。
- 若返回的
unionpay_verification_required为false,可随后使用 /bc/advertiser/create/ 创建广告账户并在请求中将image_id的值传给license_image_id字段。 - 若返回的
unionpay_verification_required为true,则需遵循以下步骤:
i. 使用/bc/advertiser/create/创建广告账户并传入同一license_no和license_image_id值。此操作将对广告账户和需要银联验证的营业执照进行绑定。
ii. 使用/bc/advertiser/unionpay_info/submit/提交银联验证。
iii. 等待约 20 秒,随后使用/advertiser/info/ 查询广告账户的status。
iv.
○ 若广告账户由于银联验证失败被拒审:先使用/bc/image/upload/上传同一营业执照图片,返回中将为该营业执照生成一个新的image_id。随后使用/advertiser/update/重新提交您的营业执照信息(相同的license_no和新的license_image_id)。再使用/bc/advertiser/unionpay_info/submit/重新提交银联验证。若想了解具体拒审原因及对应解决措施,可查看银联验证失败的拒审原因。
○ 若广告账户由于其他原因被拒审:需使用/advertiser/update/根据拒审原因更新广告账户信息。
v. 若广告账户仍旧被拒审,返回第 iv 步。
- 若返回的
注意
若您在广告账号待审核时多次提交银联验证,仅会接收第一次银联验证请求,后续请求将被忽略。
银联验证失败的拒审原因
下表列出了银联验证失败的拒审原因详情,并给出了使用/bc/advertiser/unionpay_info/submit/重新提交银联验证时如何解决这些问题的指引。
| 拒审原因 | 如何解决 |
|---|---|
| "Your UnionPay verification failed because your name and ID number do not match." | 通过 representative_name 和 representative_id 字段指定法人正确的中文名字和身份证号。 |
| "Your UnionPay verification failed due to invalid ID number." | 通过 representative_id 字段指定法人正确的身份证号。 |
| "Your UnionPay verification failed because your name does not match the info provided when opening your bank account." | 通过 representative_name 字段指定与银行账号(unionpay_account)相匹配的法人正确中文名字。 |
| "Your UnionPay verification failed due to invalid phone number." | 通过 representative_phone_number 字段指定法人正确的手机号码。 |
| "Your UnionPay verification failed because your legal representative name does not match the name on your document." | 通过 representative_name 字段指定与营业执照上的名字相匹配的法人正确中文名字。 |
方式二:复用已验证的营业执照
前提条件
您已按照方式一:使用新营业执照中的步骤使用该营业执照创建过广告账户。
步骤
1. 使用/bc/advertiser/qualification/get/获取与您的商务中心绑定的已验证的资质。请求中需包括filtering={"verified": true} 。
请求
(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/bc/advertiser/qualification/get/?bc_id={{bc_id}}&filtering={"verified": true}' \
--header 'Access-Token: {{Access-Token}}'
(/code)
返回
(code curl http)
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"page_info": {
"page_size": 10,
"page": 1,
"total_page": 1,
"total_number": 2
},
"qualifications": [
{
"status": "VERIFIED",
"region_code": "CN",
"linked_advertiser_count": 1,
"qualification_id": "{{qualification_id}}",
"owner_advertiser_id": "{{owner_advertiser_id}}",
"company_name": "{{company_name}}"
},
{
"status": "VERIFIED",
"region_code": "CN",
"linked_advertiser_count": 1,
"qualification_id": "{{qualification_id}}",
"owner_advertiser_id": "{{owner_advertiser_id}}",
"company_name": "{{company_name}}"
}
]
}
}
(/code)
- 使用/bc/advertiser/create/创建广告账户。在请求中将第 1 步获取的
qualification_id值传给qualification_id字段。无需传入license_no和license_image_id。由于您使用的是已验证的资质,您可跳过银联验证的步骤。
请求
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/bc/advertiser/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"bc_id": "{{bc_id}}",
"advertiser_info": {
"name": "{{name}}",
"currency": "{{currency}}",
"timezone": "{{timezone}}",
"type": "AUCTION"
},
"customer_info": {
"company": "{{company}}",
"industry": "{{industry}}",
"registered_area": "CN"
},
"qualification_info": {
"qualification_id": "{{qualification_id}}"
},
"contact_info": {
"name": "{{name}}"
}
}'
(/code)
返回
(code curl http)
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"advertiser_id": "{{advertiser_id}}"
}
}
(/code)
- 等待约 20 秒,随后使用/advertiser/info/ 查询广告账户的
status。 - 若广告账户被拒审,需使用//advertiser/update/根据拒审原因更新广告账户信息。
- 若广告账户仍旧被拒审,返回第 4 步。
对于中国香港地区、法国、巴西或墨西哥的广告主
若广告账号注册地为中国香港地区、法国、巴西或墨西哥:
1. 使用/bc/image/upload/上传营业执照或其他资质文件的图片。返回中将包括每个资质文件的image_id 。
2. 使用/bc/advertiser/create/创建广告账户。在请求中将第 1 步获取的 image_id 值传给 license_image_id 或 qualification_image_ids 字段。
注意
您可在创建新广告账户时复用其他广告账户的资质信息,从而节省广告账户的创建时间。若要复用资质信息,可在 /bc/advertiser/create/ 中传入qualification_id。若想获取商务中心中某个广告账户的资质信息,可使用/bc/advertiser/qualification/get/。
对于非中国大陆、中国香港地区、法国、巴西或墨西哥的广告主
若广告账号注册地非中国大陆、中国香港地区、法国、巴西或墨西哥,可直接通过 /bc/advertiser/create/ 创建广告账户。
修改被拒广告账户并提交审核
如果广告账户未通过审核,您可以使用/advertiser/update/接口修改广告账户。在请求中将 need_submit_certificate 字段设置为 true 来表示该账号需要重新审核。
永久停用广告账户
有时,您可能需要将广告账户从TikTok商务中心账户中删除。例如,当您完成了与代理机构或供应商的合作,您可能需要在他们的TikTok商务中心账户中删除您的广告账户。
使用/bc/advertiser/disable/永久停用广告账户。在开始之前,请检查您是否已满足接口文章中的前提条件。
迁移商品库至商务中心
请参阅管理商务中心下的商品库-迁移商品库至商务中心,了解如何将您现有的商品库数据迁移至商务中心。
管理商务中心下的商品库
请参阅管理商务中心下的商品库,了解如何管理商品库。
在商务中心中创建和管理商店
请参阅TikTok商店,了解如何在商务中心中创建和管理商店。
管理商务中心中的像素
使用/bc/pixel/transfer/接口并传入Pixel代码(pixel_code)将Pixel作为资产转移至您的商务中心。
使用/bc/pixel/link/update/接口将Pixel与您的广告账户绑定或解绑。
注意
要成功转移Pixel,您需要拥有商务中心的管理员权限。了解更多关于用户角色与访问权限的信息,请参阅商务中心中的“Pixel 共享”。
- 对于非代理商客户: 要使用的商务中心应具有对 Pixel 所属的广告账户的管理员权限。
- 对于代理商合作伙伴:您只能从通过该商务中心创建的广告账户中转出 Pixel。
# 与商务中心合作伙伴共享资产 您可以与商务中心合作伙伴共享资产。合作伙伴不能将共享给他们的资产分享给第三个商务中心。
欲添加一个合作伙伴并向其分配资产,请使用/bc/partner/add/接口。目前,asset_type 字段仅支持ADVERTISER。您也可以通过 advertiser_role字段,设置授予合作伙伴的广告账户角色。
如果您希望停止与商务中心合作伙伴共享资产,请使用/bc/partner/asset/delete/接口。
相关接口
获取商务中心资产的可用接口,请参阅API参考。