手动设置事件

若要手动设置 TikTok 事件而不使用数据层，您可以使用模板的参数覆盖。本文档中提供的说明对 TikTok Pixel 模板和事件 API 模板均适用。

注意
建议您切换到 Google 跟踪代码管理器数据层，因为它提供了更可靠、可扩展的事件设置方法，尤其当您的网站已经使用 Google 跟踪代码管理器数据层向其他广告平台（如 Google Analytics）发送事件时。若想了解更多详情，请参阅使用数据层设置 TikTok 事件。

事件名称配置

选择要通过代码发送的 TikTok 事件名称。事件名称应取决于您打算与代码相关联的触发器。您可以使用变量作为事件，或从 TikTok 标准网站事件名称列表中进行选择（例如，ViewContent 和 AddToCart）。详细了解 TikTok 支持的 Pixel 事件（网站事件）。

用户数据

若要手动配置用于高级匹配的用户信息，导航至 TikTok Pixel 和事件 API 模板代码中的 Parameter Override （参数覆盖）> Advanced Matching Configurations（高级匹配配置）部分。您可以选择将用户数据以经 SHA256 散列处理的字符串或普通字符串（模板在将普通字符串发送到 TikTok 前对字符串进行 SHA256 散列处理）发送。

SHA256 AM Parameters （经 SHA256 散列处理的高级匹配参数）格式

|字段 {25%}| 格式要求 {65%}|
|---|---|
| SHA256 Hashed Email <br>（经 SHA256 散列处理的电子邮件地址）| <ul><li>在散列处理前需<b>去掉首尾空格</b>。</li><li><b>在散列处理前需<b>将字母统一处理为小写</b>。</li><li>对预处理后的电子邮件地址值<b>使用 SHA256 算法进行散列处理</b>。</li></ul>|
| SHA256 Hashed Phone<br>（经 SHA256 散列处理的电话号码） | <ul><li>需将电话号码<b>格式化</b>为 [E.164 格式](https://www.twilio.com/docs/glossary/what-e164)，即+&#123;国家电话区号&#125;&#123;去掉国家电话区号的电话号码&#125;。示例："+12133734253"。<ul><li>必须包含<b>国家电话区号</b>，且带有 `+` 前缀，不使用括号和结尾的`0`。例如，美国的电话号码需带有国家电话区号`+1`。 </li><li>除了国家电话区号中的`+`外，<b>不使用空格、字母或符号</b>。</li></ul></li><li>对预处理后的手机号码值<b>使用 SHA256 算法进行散列处理</b>。</li></ul>|
| SHA256 Hashed External ID<br>（经 SHA256 散列处理的外部 ID） | 在使用 SHA256 算法进行散列处理前需<b>去掉首尾空格</b>。 |

Plain AM parameters（未经 SHA256 散列处理的高级匹配参数）格式

|字段 {25%}| 格式要求 {65%}|
|---|---|
| Email<br>（电子邮件地址） | <ul><li><b>去掉首尾空格</b>。</li><li><b>将字母统一处理为小写</b>。</li></ul>|
| Phone<br>（电话号码） | <ul><li>需将电话号码<b>格式化</b>为 [E.164 格式](https://www.twilio.com/docs/glossary/what-e164)，即+&#123;国家电话区号&#125;&#123;去掉国家电话区号的电话号码&#125;。示例："+12133734253"。<ul><li>必须包含<b>国家电话区号</b>，且带有 `+` 前缀，不使用括号和结尾的`0`。例如，美国的电话号码需带有国家电话区号`+1`。 </li><li>除了国家电话区号中的`+`外，<b>不使用空格、字母或符号</b>。</li></ul></li></ul>|
| External ID<br>（外部 ID） | <b>去掉首尾空格</b>。|

商品数据

本小节包含商品信息的相关内容。若您在推广某一网站售卖的商品，商品信息不可或缺。发送完整的商品信息使度量和优化成为可能，例如通过启用用于商业场景的 TikTok 视频购物广告，价值优化，以及广告支出回报率（ROAS）追踪。

| 参数 {15%}|  描述{45%} |对于 ROAS 或价值优化是否为必填参数 {20%} |对于视频购物广告是否为必填参数{20%} |
|---|---|---|---|
| currency | <strong>推荐为营收相关事件传入本字段。</strong> <br><br>  ISO 4217 币种代码。<br>示例：  `EUR`， `USD`， `JPY`。<br><strong>目前支持的币种清单</strong>：`AED`， `ARS`， `AUD`， `BDT`， `BHD`， `BIF`， `BOB`， `BRL`， `CAD`， `CHF`， `CLP`， `CNY`， `COP`， `CRC`， `CZK`， `DKK`， `DZD`， `EGP`， `EUR`， `GBP`， `GTQ`， `HKD`， `HNL`， `HUF`， `IDR`， `ILS`， `INR`， `ISK`， `JPY`， `KES`， `KHR`， `KRW`， `KWD`， `KZT`， `MAD`， `MOP`， `MXN`， `MYR`， `NGN`， `NIO`， `NOK`， `NZD`， `OMR`， `PEN`， `PHP`， `PHP`， `PKR`， `PLN`， `PYG`， `QAR`， `RON`， `RUB`， `SAR`， `SEK`， `SGD`， `THB`， `TRY`， `TWD`， `UAH`， `USD`， `VES`， `VND`， `ZAR`。 | ✅ |  |
| value |  <strong>推荐为营收相关事件传入本字段。</strong> <br> <br>订单或所售商品的价值。 <br> 价值的格式需为整数或小数（例如10.00），不论地域和币种。同时不允许包含币种符号，特殊字符，字母或逗号。<br><p><span style="color:darkred"><b>注意</b></span>：`price` 是单件商品的价格，而`value`指订单的总价。例如，如果您有两件商品，每件商品的销售价格是 10 美元，那么 `price`参数需要设置为 `10.00` ，`value` 参数需要设置为 `20.00`。  |  ✅|  |
| query | 用户输入的文本字符串。<br>例如，如果有人在您的网站上搜索产品时，您可以发送被搜索的关键词。如果有人在结账时输入优惠券代码，您可以发送该代码。  |  |  |
| description |  商品或页面的描述。  |  |  |
| contents | content 对象数组。  <br>若想查看`contents`参数中包含的字段，参见下文的"<a href="#item-link-contents 参数">`contents` 参数</a>"小节。    |  |  |

`contents` 参数

| 参数 {15%}| 描述{45%} |对于 ROAS 或价值优化是否为必填参数 {20%} | 对于视频购物广告是否为必填参数{20%} |
|---|---|---|---|
| price | 商品价格。 <br><p><span style="color:darkred"><b>注意</b></span>：`price` 是单件商品的价格，而`value`指订单的总价。例如，如果您有两件商品，每件商品的销售价格是 10 美元，那么 `price`参数需要设置为 `10.00` ，`value` 参数需要设置为 `20.00`。 <br> 示例：`10`，`10.5`。  |  |  |
| quantity |  商品数量。   |  |  |
| content_id |  商品或内容的唯一ID。<br>推荐使用 `sku id` 或 `item_group_id`。<br>若商品库中的商品设置了 `sku_id` 或 `item_group_id`，则需保持一致。  |  | ✅ |
| content_type| 事件中的内容类型。  <br> 枚举值：`product`（商品），`product_group`（商品组）。<ul><li> 若`contents`中的`content_id`参数设置为`sku_id`，本参数需设置为`product`。 </li><li> 若`contents`中的`content_id`参数设置为`item_group_id`，本参数需设置为`product_group`。</li></ul> |  |  ✅|
| content_category| 页面或商品的类别。   |  |  |
| content_name |页面或商品的名称。   |  |  |
| brand | 商品的品牌名称。   |  |  |

若要手动配置要发送到 TikTok 的商品数据，请在配置中的 Parameter Override （参数覆盖）> Object Properties （对象属性）部分下选择 Use Custom Data（使用自定义数据），并使用变量填写表单的其余部分。

Custom Data Settings（自定义数据设置）： - Single Content（单一内容）：将此事件与单个商品相关联。

Multiple Contents（多个内容）：将此事件与多个商品相关联。"contents" 字段必须填入 JSON 编码的商品字符串。

示例：[{ "price": 100.0, "quantity": 2, "content_id": "12345", "content_type": "product", "content_name": "Fancy-MaxSpeed2.0 Black", "content_category": "Shoes - Running Shoes", "brand": "Fancy Sneakers" }, { "price": 40.0, "quantity": 1, "content_id": "45678", "content_type": "product", "content_name": "Fancy-MaxSpeed2.0 White", "content_category": "Shoes - Running Shoes", "brand": "Fancy Sneakers" }]。
若想了解该 JSON 对象支持的结构，请查看这里。

Order Info Only（仅订单信息）：仅将 value 和 currency 信息发送回 TikTok。

验证事件设置

在 TikTok Pixel 或事件 API 模板中配置 TikTok 事件和参数后，您可以按照验证跟踪代码管理器的设置中的步骤进行验证。

获取支持

若您遇到任何需要支持的问题，请在相应的 GitHub 项目中提交议题： - TikTok Pixel 模板 GitHub - TikTok 事件 API 模板 GitHub