更新Pixel
您可以使用本接口更新 Pixel 名称。像素名称建议为对应网站名称或域名，长度不宜超过40字符且不能与已创建的像素名称重复。
重要提示
使用事件 API 接口代表您同意遵守TikTok 商业产品（数据）条款，并且不会与 TikTok 分享敏感数据。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径| /v1.2/pixel/update/| /v1.3/pixel/update/|
|请求参数类型|advertiser_id: number |advertiser_id: string |
|新增请求参数|/|automatic_advanced_matching_fields<br>enable_first_party_cookies<br>enable_expanded_data_sharing|
|返回参数类型|pixel_id: number |pixel_id`: string |
## 请求
**地址** https://business-api.tiktok.com/open_api/v1.3/pixel/update/
**方法** POST
**Header**
```xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
|Content-Type {必填}|string|请求信息类型<br>允许格式：`application/json`。|
参数
|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string| 广告主 ID。 |
|pixel_name {必填}|string| Pixel 名称。<br><br>长度限制：40 个字符且不能包含 emoji。<br><br><p><span style="color:darkred"><b>注意</b></span>：如果要保持名称不变，将此字段设置为空字符串 (`""`)。|
|pixel_id {必填}|string| Pixel ID。 |
|advanced_matching_fields|object| Pixel 的手动高级匹配设置。<br><br>此设置仅适用于通过合作伙伴集成生成的 Pixel，不适用于手动配置的 Pixel。|
#|phone_number {+条件必填}|boolean|传入 `advanced_matching_fields` 时必填。<br><br>是否为电话号码启用手动高级匹配。<br><br>默认值：`true`。|
#|email{+条件必填}|boolean| 传入 `advanced_matching_fields` 时必填。<br><br>是否为电子邮件启用手动高级匹配。<br><br>默认值：`true`。|
|automatic_advanced_matching_fields|object|该 Pixel 的自动高级匹配设置。<br><br>自动高级匹配功能自动使用通过 TikTok Pixel 收集的客户信息，如电子邮箱、姓名和电话号码，从而改善匹配率、转化监测和再营销。<br><br><p><span style="color:darkred"><b>Note</b></span>:为帮助保护客户隐私，敏感信息将先经过散列处理，再与 TikTok 共享。如果你是在受到较多监管的行业或敏感行业（例如金融服务或医疗保健行业）开展业务，请考虑使用手动高级匹配 (MAM)，而不是自动高级匹配 (AAM)。|
#|phone_number {+条件必填}|boolean|传入 `automatic_advanced_matching_fields` 时必填。<br><br>是否为电话号码启用自动高级匹配。<br><br>支持的值： `true`，`false`。|
#|email {+条件必填}|boolean|传入 `automatic_advanced_matching_fields` 时必填。<br><br>是否为电子邮箱启用自动高级匹配。<br><br>支持的值： `true`，`false`。|
#|name {+条件必填}|boolean|传入 `automatic_advanced_matching_fields` 时必填。<br><br>是否为姓名启用自动高级匹配。<br><br>支持的值： `true`，`false`。|
#|address {+条件必填}|boolean|传入 `automatic_advanced_matching_fields` 时必填。<br><br>是否为地址启用自动高级匹配。<br><br>地址包含用户的基本位置详细信息，包括城市、州或省/自治区/直辖市、邮政编码和国家/地区。系统不会收集街道级信息。共享此类信息有助于 TikTok 更准确地匹配用户。<br><br>支持的值： `true`，`false`。|
#|external_id {+条件必填}|boolean|传入 `automatic_advanced_matching_fields` 时必填。<br><br>是否为外部 ID 启用自动高级匹配。<br><br>外部 ID 即能代表广告主平台上用户的身份信息，例如客户 ID、订单 ID 或会员卡号。共享这些信息有助于 TikTok 更准确地匹配用户。<br><br>支持的值： `true`，`false`。|
|enable_first_party_cookies|boolean|是否允许第一方 Cookie。<br><br>允许第一方 Cookie 将与 TikTok 共享来自你网站的第一方 Cookie 数据，可改善衡量效果并帮助触达更多用户。[了解关于通过 TikTok Pixel 使用 Cookie](https://ads.tiktok.com/help/article/using-cookies-with-tiktok-pixel)。<br><br>支持的值： `true`，`false`。|
|enable_expanded_data_sharing|boolean|是否启用扩展数据共享。<br><br>启用扩展数据共享将允许此 Pixel 收集来自你的网站的更多信息，包括页面内容（如元标记和商品详情）、访客操作（如点击、按钮互动和使用时长）和网站性能（如页面加载速度和响应能力）。此数据可用于提升 TikTok 的广告投放成效和推广系列成效。你可以通过 TikTok Pixel 助手查看收集的所有数据。[了解通过 TikTok Pixel 实现扩展型数据共享功能](https://ads.tiktok.com/help/article/enhance-data-postback-with-the-tiktok-pixel)。<br><br>支持的值： `true`，`false`。|
示例
(code curl http)
curl -H "Access-Token:xxx" -H "Content-Type:application/json" -X POST \
-d '{
"advertiser_id": "ADVERTISER_ID",
"pixel_name": "PIXEL_NAME",
"pixel_id": "PIXEL_ID"
}' \
https://business-api.tiktok.com/open_api/v1.3/pixel/update/
(/code)
返回
|字段|类型|描述|
|---|---|---|
|code |number|返回码，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)|
|message |string|返回信息，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)|
|data|object|返回数据|
|request_id |string|请求的日志 ID，唯一标识一个请求。|
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"message": "OK",
"code": 0,
"data": {},
"request_id": "202003181255150101890492232F45E5EA"
}
(/code);