创建广告账户

您可以使用本接口为代理商或直客商务中心创建竞价广告账户。您必须是商务中心管理员用户。

若想创建竞价广告账户，请在advertiser_info下的type字段指定AUCTION。

若广告账户的注册地在中国大陆、中国香港地区、法国、巴西或墨西哥，那么在创建广告账户之前，您需要使用/bc/image/upload/上传营业执照或其他认证资质的图片。

若广告账户的注册地在中国大陆，则您可能需要为营业执照提交银联验证。若想了解银联验证和在商务中心创建广告账户的详情，可查看创建广告账户。

重要提示
自 2024 年 9 月26 日起，为确保广告账户安全，我们已为中国出海广告主通过/bc/advertiser/create/在商务中心的广告账户创建实施了银联验证。在 2025 年 1 月 8 日之前，您可以继续使用现有的 API 工作流程。为支持银联验证的相关功能，我们已在 2024 年 10 月中旬发布了 API 变更以及详细的 API 文档。受影响的开发者需要在 2025 年 1 月 8 日前搭建新的工作流程。 2025 年 1 月 8 日之后，您的现有集成可能无法正常运行。

注意
本接口不支持在同一商务中心中同时创建多个广告账户。请等待一个广告账户创建完成后，再创建下一个广告账户。
单个用户在所有商务中心中创建的广告账户总数最多为10,000。此外，每个商务中心还有广告账户每日创建配额和广告账户创建总配额限制，具体配额根据商务中心类型而有所不同。若您达到了商务中心层级或用户层级的配额上限，可使用 /bc/advertiser/disable/ 永久停用现有的活跃广告账户，从而释放广告账户的配额。
欲使用此接口，您必须位于已开启广告功能的地方。目前，该功能在以下国家或地区可用：
阿拉伯联合酋长国、奥地利、澳大利亚、比利时、巴西、加拿大、瑞士、智利、哥伦比亚、捷克共和国、德国、丹麦、厄瓜多尔、埃及、西班牙、芬兰、法国、英国、希腊、匈牙利、印度尼西亚、爱尔兰、以色列、印度、意大利、日本、柬埔寨、韩国、科威特、摩洛哥、墨西哥、马来西亚、荷兰、挪威、新西兰、秘鲁、菲律宾、波兰、葡萄牙、卡塔尔、罗马尼亚、俄罗斯、沙特阿拉伯、瑞典、新加坡、泰国、土耳其、台湾省、乌克兰、美国、越南、南非。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径| /v1.2/bc/advertiser/create/| /v1.3/bc/advertiser/create/| |请求参数类型|bc_id: number<br>billing_group_id: number |bc_id: string<br>billing_group_id: string | |请求参数名称|recon_object|invoice_group_by| |新增请求参数|/|qualification_id<br>payment_info| |返回参数名称和类型|advertiser_id: number |advertiser_id: string | | 新增返回参数 | / |payment_portfolio_binding_result<br>budget_setup_result` |


## 请求

**地址** https://business-api.tiktok.com/open_api/v1.3/bc/advertiser/create/

**方法** POST

**Header**

```xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。  |
|Content-Type {必填}|string|请求消息类型。<br>允许值: `"application/json"`。 |

参数

|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|bc_id {必填}|string| 商务中心 ID。<br><br>若想获取您可访问的商务中心，可使用[/bc/get/](1737115687501826.html)。|
|tied_to_billing_group|boolean| 是否将此账号添加到一个账单组。默认值: `False`。<br><br><p><span style="color:darkred"><b>注意</b></span>：该字段目前为白名单功能。如需使用此功能，请联系您的TikTok销售代表。|
|advertiser_info {必填}|object| 广告账户信息 。|
#|name {必填}|string| 广告账户名称，长度不能超过100个字符。 |
#|currency {必填}|string| 广告账户币种，注意：需与商务中心保持一致，取值范围见[附录-币种](https://ads.tiktok.com/marketing_api/docs?id=1737585839634433)。 |
#|timezone {必填}|string| 广告账户时区代码，取值范围见[附录-时区信息](https://ads.tiktok.com/marketing_api/docs?id=1737586324313089)。|
#|type|string|您想创建的广告账户类型。枚举值: `RESERVATION`（合约广告）, `AUCTION` (竞价广告，默认值）。<br><p><span style="color:darkred"><b>注意</b></span>：`DIRECT`类型的商务中心只能创建`AUCTION`广告账户。|
|customer_info {必填}|object| 业务信息。 |
#|company {必填}|string| 广告账户公司名称，长度不能超过255个字符。 |
#|industry {必填}|number| 广告账户行业ID，取值范围见[附录-行业信息](https://ads.tiktok.com/marketing_api/docs?id=1739357589575681)。|
#|registered_area {必填}|string| 广告账户注册地代码， 取值范围见[附录-地区代码](https://ads.tiktok.com/marketing_api/docs?id=1737585867307010)。|
|qualification_info {+条件必填}|object| 当商务中心类型为`AGENCY`或`SELF_SERVICE_AGENCY`时必填。<br><br>资质信息。<br><br><p><span style="color:darkred"><b>注意</b></span>：当商务中心类型为`DIRECT`时，请不要填入该字段，否则会报错。 |
#|promotion_link {+条件必填}|string| 当商务中心类型为`AGENCY`或`SELF_SERVICE_AGENCY`时必填。<br><br>推广链接。该值必须为公司网站 URL。<br><br>长度限制：255 个字符。 |
#|license_no{+条件必填} |string| 广告账户注册地为中国大陆，中国香港地区，巴西或墨西哥时必填。<br><br>营业执照编号。<br><br><p><span style="color:darkred"><b>注意</b></span>：若广告账户的注册地在中国大陆，则您可能需要为营业执照提交银联验证。若想查询您的营业执照是否需要银联验证，可使用 [/bc/advertiser/unionpay_info/check/](1813772238056449.html)。若想了解银联验证和在商务中心创建广告账户的详情，可查看[创建广告账户](https://business-api.tiktok.com/portal/docs?id=1754705407307777#item-link-创建广告账户)。 |
#|license_image_id{+条件必填} |string| 广告账户注册地为中国大陆或中国香港地区时必填。<br><br>资质证书图片 ID。<br><br>可由[上传资质证书](https://ads.tiktok.com/marketing_api/docs?rid=jkeb7xz4kqc&id=1739938996913218)接口获取。 |
#|qualification_image_ids{+条件必填} |string[]| 广告账户或商务中心注册地为法国、巴西或墨西哥时必填。<br><br>其他资质图片 ID。<br><br>可由[上传资质证书](https://ads.tiktok.com/marketing_api/docs?rid=jkeb7xz4kqc&id=1739938996913218)接口获取。|
#|qualification_id|string|资质 ID。<br>您可以通过该字段复用其他广告账户的资质信息。<br><br>资质 ID 可以通过[/bc/advertiser/qualification/get/](https://ads.tiktok.com/marketing_api/docs?id=1770118680584194) 接口的返回获得。 <br><br><p><span style="color:darkred"><b>注意</b></span>: 若传入该字段，则不能传入`qualification_info`下的其他字段。|
|contact_info |object| 联系信息。 |
#|name |string| 联系人姓名，长度不能超过100个字符。 |
#|email {+条件必填} |string| 联系人邮箱。注册地为法国、巴西或墨西哥的代理商创建广告账户或者创建的广告账户注册地为法国、巴西或墨西哥时必填。 |
#|number |string| 联系人电话。 |
|billing_info{+条件必填} |object| 账单信息。注册地为法国、巴西或墨西哥的代理商创建广告账户或者创建的广告账户注册地为法国、巴西或墨西哥时必填。<br>创建墨西哥广告账户代码示例： `"billing_info":&#123;"address":"xxxx","tax_field_dict": &#123;"tax_id": "xxxx", "tax_regime": "xxxx"&#125;&#125;` |
#|address |string| 账单开票地址，长度不能超过512个字符。  |
#|tax_field_dict |dict| 账单开票税号。不同国家使用不同的税号字段。<ul><li>欧洲国家，例如法国，使用税号字段`vat` 。</li><li>巴西，墨西哥，阿联酋，埃及，沙特阿拉伯，以色列，土耳其，加拿大，美国使用税号字段`tax_id`。且对于巴西和墨西哥`tax_id`为必填字段。</li><li>澳大利亚和新西兰使用税号字段`abn`。</li></ul> |
|billing_group_info|object| 账单组信息。|
#|invoice_group_by {必填}|string|出账模式。枚举值: `ACCOUNT`: 合并出账。`ADVERTISER`: 分别出账。|
#|billing_group_id|string|账单组ID。在`invoice_group_by` 为`ACCOUNT`时有效。|
#|invoice_payer {+条件必填}|string|账单付费方。枚举 `AGENCY` （代理商）, `ADVERTISER` （广告主）。在广告账户注册地为`FR`（法国）时必填。 |
| payment_info | object | 支付信息。 |
#| payment_portfolio_id | string | 仅当启用了多财务资产组合功能时生效。<br><br>此广告账号要关联的财务资产组合 ID。<br><br>如果关联财务资产组合失败，广告账号仍会创建成功。<br>如需确认关联结果，可检查返回参数 `payment_portfolio_binding_result`。<br><br><p><span style="color:darkred"><b>注意</b></span>：</p><ul><li>单客户的多财务资产组合目前为白名单功能。如需使用此功能，请联系您的 TikTok 销售代表。</li></ul> |
#| budget_info | object | 广告账号的预算设置详情。<br><br>如果预算设置失败，广告账号仍会创建成功。<br>如需确认最终预算设置，可检查返回参数 `budget_setup_result`。 |
##| budget_mode | string | 广告账号的预算模式。<br><br>枚举值：<ul><li>`UNLIMITED`：不限。广告账号无预算限制。</li><li>`MONTHLY_BUDGET`：月预算。广告账号在月度预算内消耗信用额度。</li><li>`DAILY_BUDGET`：日预算。广告账号在日预算内消耗信用额度。</li><li>`CUSTOM_BUDGET`：自定义预算。广告账号在单次自定义预算内消耗信用额度。</li></ul>默认值：`MONTHLY_BUDGET`。 |
##| budget {+条件必填} | number | `budget_mode` 为 `MONTHLY_BUDGET`、`DAILY_BUDGET` 或 `CUSTOM_BUDGET` 时本字段必填。<br><br>广告账号预算，保留两位小数。<ul><li>若 `budget_mode` 设置为 `MONTHLY_BUDGET`，传入月预算。</li><li>若 `budget_mode` 设置为 `DAILY_BUDGET`，传入日预算。</li><li>若 `budget_mode` 设置为 `CUSTOM_BUDGET`，传入一次性自定义预算。</li></ul> |

示例

(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": {
        "currency": "USD",
        "name": "{{name}}",
        "timezone": "America/Los_Angeles"
    },
    "customer_info": {
        "company": "{{company}}",
        "industry": 290501,
        "registered_area": "US"
    }
}'
(/code)

|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|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|返回数据  |
#|advertiser_id |string| 广告账号 ID。|
#| payment_portfolio_binding_result | object | 将新创建的广告账号绑定到请求中指定的财务资产组合（`payment_portfolio_id`）的结果。 |
##| status | string | 绑定状态。<br><br>枚举值：<ul><li>`SUCCESS`：广告账号成功绑定到财务资产组合。</li><li>`FAILED`：广告账号未能绑定到财务资产组合。</li></ul> |
##| error_msg | string | 错误信息。<br><br>当 `status` 为 `SUCCESS` 时，此字段的值将为 null。 |
#| budget_setup_result | object | 为新创建的广告账号设置预算的结果。 |
##| status | string | 预算设置状态。<br><br>枚举值：<ul><li>`SUCCESS`：广告账号已成功配置预算。</li><li>`FAILED`：广告账号未能成功配置预算。</li></ul> |
##| error_msg | string | 错误信息。<br><br>当 `status` 为 `SUCCESS` 时，此字段的值将为 null。 |

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "advertiser_id": "{{advertiser_id}}"
    }
}
(/code);