← 返回目录
📁 Marketing API › Ad Measurement › Guides › Pixel

高级匹配

关于高级匹配

高级匹配将客户信息与 TikTok 用户相匹配,从而帮助您优化 TikTok 广告,提高广告表现。经加密的客户信息可通过任意 TikTok 事件共享,进而增加归因的转化数,构建规模更大的受众群,优化推广系列效果。

您可以通过两种方式启用高级匹配:手动或自动。 - 手动高级匹配指手动将客户信息从您的网站传到TikTok。这需要您为网站上的每个事件执行代码,或者若您正在使用合作伙伴集成,您可以通过合作伙伴平台的数据分享设置启用手动高级匹配。如果选择手动选项,您可以灵活地配置将哪些信息传到 TikTok 以及归因到哪些事件。 - 自动高级匹配会自动识别客户信息,例如电子邮件、电话号码和其他用户输入的其他标识符,网站上的静态文本和关键网站变量(例如 window.dataLayer、window.utag)。这些信息在发送到 TikTok 用于广告测量和归因之前,会使用行业标准算法(SHA-256)在浏览器中进行哈希处理。

如果可能,我们建议广告主同时使用手动和自动高级匹配,因为这种设置能最大限度地发挥高级匹配的全部性能。

本指南旨在介绍如何通过 TikTok Pixel 启用手动高级匹配。启用自动高级匹配可在事件管理平台进行相应设置。若想了解并启用自动高级匹配,请查看帮助中心文档。

隐私保护

根据标准行业做法,客户电子邮件和电话号码在传到 TikTok 服务器进行匹配之前,会使用 SHA256 算法进行散列处理。TikTok 在美国和英国通过了 ISO 27001 认证。若想了解这些客户信息将如何使用,请查看TikTok 商业产品(数据)条款。

手动高级匹配快速入门

使用须知

  • 您必须具备技术资源才能成功部署。
  • 您必须能够访问网站的代码。
  • 您必须具备将确保隐私安全的受众数据添加到参数中的能力。
  • 到这个阶段,您应当已经在网站的代码中设置了各类事件。如果尚未完成设置,请参阅使用代码安装Pixel,进一步了解如何设置事件。
  1. 导航到您想实现高级匹配的事件(或事件代码)。以下是一个包含参数的 "Add to Cart"(添加到购物车)事件的例子。
(code JavaScript JavaScript)
ttq.track('AddToCart', {
    contents: [
    {
      content_id: '301',
      content_name: 'running shoes',
      content_category: 'Shoes > Sneakers > running shoes',
      brand: 'your brand name',
      quantity: 1,
      price: 8,
    }],
    content_type: 'product',
    value: 9.2,
    currency: 'USD',  
});
(/code)
  1. 在事件代码(即ttq.track)前,使用ttq.identify开始编写高级匹配代码。
  2. 在ttq.identify函数下,有两种通过email和phone_number参数传入邮箱和电话号码的方式:
  • a. 传入未经过散列处理的原始身份信息,我们会在用户侧对原值进行散列处理
(code JavaScript JavaScript)
ttq.identify({
    email: 'email@example.com',
    phone_number: '+15551234567',
})
(/code)
  • 传入未经过散列处理的原始身份信息时的重要提示

  • b. 传入经过散列处理的身份信息

 (code JavaScript JavaScript)
ttq.identify({
    email: '0c7e6a405862e402eb76a70f8a26fc732d07c32931e9fae9ab1582911d2e8a3b', 
    phone_number: '9f7ec22d72092cd3c0b58726ed9c2d91b92e51a3f29837508fb2948bb22dd2fd',
    external_id: '936a185caaa266bb9cbe981e9e05cb78cd732b0b3280eb944412bb6f8f8f07af',
})
(/code)
  • 传入经过散列处理的身份信息时的重要提示
    • 邮件地址
      • 在散列处理前需将字母统一处理为小写
      • 在散列处理前需去掉首尾空格
      • 在散列处理前不要对邮件地址进行其他预处理
      • 仅接受使用SHA256算法进行散列处理。推荐使用处理包:https://github.com/emn178/js-sha256
    • 电话号码
    • 外部ID
      • 在散列处理前需去掉首尾空格 4. 将高级匹配的代码放在事件代码之上。确保当事件被触发时,事件可以接收到高级匹配的数据。
(code JavaScript JavaScript)
//Always Advanced Matching code before event code, see below for a sample event.
//Repeat for each page where event(s)take place.

ttq.identify({
    email: '0c7e6a405862e402eb76a70f8a26fc732d07c32931e9fae9ab1582911d2e8a3b',
    phone_number: '9f7ec22d72092cd3c0b58726ed9c2d91b92e51a3f29837508fb2948bb22dd2fd',
    external_id: '936a185caaa266bb9cbe981e9e05cb78cd732b0b3280eb944412bb6f8f8f07af',
})

ttq.track('ViewContent', {
    contents: [
    {
      content_id: '301',
      content_name: 'running shoes',
      content_category: 'Shoes > Sneakers > running shoes',
      brand: 'your brand name',
      quantity: 1,
      price: 8,
    }],
    content_type: 'product',
    value: 9.2,
    currency: 'USD',  
});

ttq.track('AddToCart', {
    contents: [
    {
      content_id: '301',
      content_name: 'running shoes',
      content_category: 'Shoes > Sneakers > running shoes',
      brand: 'your brand name',
      quantity: 1,
      price: 8,
    }],
    content_type: 'product',
    value: 9.2,
    currency: 'USD', 
});
(/code)
  1. 在您的网站上每个设置了事件代码的网页完成步骤1-4。
  2. 一旦您将高级匹配代码添加到所有的事件中,使用Pixel Helper Chrome扩展程序检查是否安装成功。以下是检查方法:
    1. 安装Pixel Helper,然后进入您的网站。
    2. 依次测试各个事件。检测到的每个事件都会显示在Pixel Helper中。
    3. 打开每个事件的细节,若显示绿色对号,代表事件没有检测到问题。
    4. 打开事件详情下的Parameter Details部分。
    5. 打开Advanced Matching,查看是否同时显示email和phone。若显示,意味着我们的系统已经检测到电子邮件和电话号码的有效高级匹配代码。

获取更多关于Pixel Helper的信息,参阅TikTok Pixel 自检器 2.0 简介。

支持的身份信息

|身份信息{22%}|格式要求{38%} |示例{15%}|
|---|---|---|
| email |未经散列处理的值,或字母处理为小写后进行了散列处理的值。<br><br>对于未经散列处理的值:<ul><li>TikTok 将自动使用 SHA256 算法对值进行散列处理,然后将加密值传入系统。</li></ul><br>对于经散列处理的值:<ul><li>在散列处理前需去掉首尾空格,且将字母统一处理为小写。</li><li>在散列处理前不要对邮件地址进行其他预处理。</li><li>仅接受使用SHA256算法进行散列处理。推荐使用处理包: [https://github.com/emn178/js-sha256](https://github.com/emn178/js-sha256)</li></ul> | `email@example.com` |
| phone_number | 未经散列处理的值,或经散列处理的值。<br><br><ul><li>电话号码需格式化为E.164格式,即+&#91;国家电话区号&#93; &#91;去掉国家电话区号的电话号码&#93;。E.164格式的美国电话号码示例:+12133734253。</li><li>推荐使用 [https://github.com/catamphetamine/libphonenumber-js](https://github.com/catamphetamine/libphonenumber-js)  解析E.164格式的电话号码。</li></ul><br>对于未经散列处理的值:<ul><li>TikTok 将自动使用 SHA256 算法对值进行散列处理,然后将加密值传入系统。</li></ul><br>对于经散列处理的值: <ul><li>仅接受使用SHA256算法进行散列处理。推荐使用处理包: [https://github.com/emn178/js-sha256](https://github.com/emn178/js-sha256)。</li></ul> | `+15551234567` |
|external_id<br><br>来自广告主的唯一 ID,例如客户 ID、会员 ID、用户 ID 和外部 Cookie ID。|未经散列处理的值,或经散列处理的值。<br><br>在散列处理前需去掉首尾空格,并确保与要使用的外部ID保持一致。<br><br>对于经散列处理的值: <ul><li>仅接受使用SHA256算法进行散列处理。推荐使用处理包: [https://github.com/emn178/js-sha256](https://github.com/emn178/js-sha256)。</li></ul>| |

最佳实践

以下为实现高级匹配时的最佳实践: - 如果可能,同时使用手动和自动高级匹配。这能够确保最大限度地发挥高级匹配的优点。手动选项需要代码开发,所以您需准备开发资源。点击这里查看如何设置手动高级匹配。 - 使用 Cookie,最大化高级匹配的性能。我们推荐将手动和自动高级匹配与Cookie搭配使用,从而实现最优性能。需确保第一方Cookie已通过事件管理中心的设置开启。请查看通过 TikTok Pixel 使用 Cookie了解详情。 - 对于手动高级匹配,我们建议您为所有访客活动发送电子邮件和电话号码数据。我们也建议您在漏斗事件的早期阶段获取访客的电子邮件和电话号码,以确保最佳效果。这将增加将顾客和TikTok用户匹配的概率。实现高级匹配时,还需注意以下最佳实践的提示:

手动高级匹配
  1. 为每个网页事件发送邮箱地址和电话号码数据,或尽最大可能频繁发送电子邮件和电话号码数据。
  2. 确保您采用动态代码,从而将与事件有关的值或信息动态传递至TikTok。高级匹配的代码中应避免使用非法值或静态值(即采用硬编码)。
  3. 若未采集到用户信息,请传入空字符串,避免传入空格,未定义值("undefined")或其他硬编码值。
  4. 传入邮箱地址及电话号码时,请检查高级匹配相关参数是否正确。

  5. 请注意,若您传入未经过散列处理(加密)的原始身份信息,TikTok会自动对身份信息进行散列处理。
    若您传入已经过散列处理的身份信息(邮箱地址和/或电话号码),TikTok仅接受使用SHA256算法处理过的数据。

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