em 邮箱 字符串或 list<string> | 必须进行哈希处理。 去除所有前导和尾部空格。将所有字符转换为小写形式。
示例: 输入:John_Smith@gmail.com 标准化格式:john_smith@gmail.com 预期的 SHA256 输出:62a14e44f765419d10fea99367361a727c12365e2520f32218d505ed9aa0f62f |
ph 电话号码 字符串或 list<string> | 必须进行哈希处理。 移除符号、字母及任何前导零。手机号必须包含用于匹配的国家/地区代码(例如,美国手机号前面必须带有数字 1)。始终在客户的手机号中加入国家/地区代码,即便所有数据都来自同一国家/地区亦是如此。
示例: 输入:美国手机号 (650)555-1212 标准化格式:16505551212 预期的 SHA256 输出: e323ec626319ca94ee8bff2e4c87cf613be6ea19919ed1364124e16807ab3176 |
fn 名字 字符串或 list<string> | 必须进行哈希处理。 推荐使用罗马字母字符 a 至 z。仅限小写字母,且不可包含标点符号。若使用特殊字符,则须按 UTF-8 格式对文本进行编码。
示例: 输入:Mary 标准化格式:mary 预期的 SHA256 输出:6915771be1c5aa0c886870b6951b03d7eafc121fea0e80a5ea83beb7c449f4ec
输入:정 标准化格式:UTF-8 字符“정” 预期的 SHA256 输出:8fa8cd9c440be61d0151429310034083132b35975c4bea67fdd74158eb51db14
输入:Valéry 标准化格式:valéry 预期的 SHA256 输出:08e1996b5dd49e62a4b4c010d44e4345592a863bb9f8e3976219bac29417149c |
ln 姓氏 字符串或 list<string> | 必须进行哈希处理。 推荐使用罗马字母字符 a 至 z。仅限小写字母,且不可包含标点符号。若使用特殊字符,则须按 UTF-8 格式对文本进行编码。
示例请参见“名字 (fn )”部分。 |
db 出生日期 字符串或 list<string> | 必须进行哈希处理。 我们接受 YYYYMMDD 格式,其中涵盖各类月、日、年组合,带不带标点均可。
示例: 输入:2/16/1997 标准化格式:19970216 预期的 SHA256 输出:01acdbf6ec7b4f478a225f1a246e5d6767eeab1a7ffa17f025265b5b94f40f0c |
ge 性别 字符串或 list<string> | 必须进行哈希处理。 我们接受以小写首字母表示性别的做法。
示例: |
ct 城市 字符串或 list<string> | 必须进行哈希处理。 推荐使用罗马字母 a-z 字符。仅限小写字母,且不可包含标点符号、特殊字符和空格。若使用特殊字符,则须按 UTF-8 格式对文本进行编码。
示例: paris london newyork |
st 州/省/自治区/直辖市 字符串或 list<string> | 必须进行哈希处理。 使用 2 个字符的 ANSI 缩写代码,必须为小写字母。请使用小写字母对美国境外的州/省/自治区/直辖市名称作标准化处理,且不可包含标点符号、特殊字符和空格。
示例: az ca |
zp 邮编 字符串或 list<string> | 必须进行哈希处理。 使用小写字母,且不可包含空格和破折号。美国邮编只限使用前 5 位数。英国邮编请使用邮域 + 邮区 + 邮政部门格式。
示例: 美国邮编:94035 澳大利亚邮编:1987 法国邮编:75018 英国邮编:m11ae |
country 国家/地区 字符串或 list<string> | 必须进行哈希处理。 请按照 ISO 3166-1 二位字母代码表示方式使用小写二位字母国家/地区代码。 重要提示:请始终包含客户的国家/地区代码,即使所有国家/地区代码均来自同一国家/地区亦是如此。我们会在全球范围内进行匹配,这个简单步骤将有助我们根据您的名单匹配尽可能多的账户中心账户。
示例: 输入:United States 标准化格式:us 预期的 SHA256 输出:79adb2a2fce5c6ba215fe5f27f532d4e7edbac4b6a5e09e1ef3a08084a904621 |
external_id 外部编号 字符串或 list<string> | 推荐进行哈希处理。 可以是广告主提供的任何唯一编号,如会员编号、用户编号和外部 Cookie 编号。您可以为给定事件发送一或多个外部编号。 如果是通过其他渠道发送外部编号,此编号的格式应与通过转化 API 发送时的格式相同。 |
client_ip_address 客户端 IP 地址 字符串 | 无需进行哈希处理。 与事件对应的浏览器 IP 地址必须是有效的 IPV4 或 IPV6 地址。若用户启用了 IPV6,请优先使用 IPV6,而非 IPV4。切勿对 client_ip_address 用户数据参数进行哈希处理。 请勿包含空格。始终提供真实的 IP 地址,确保事件报告准确无误。 请注意:此信息会自动添加到通过浏览器发送的事件中,但对于通过服务器发送的事件,您必须手动配置该信息。
示例: IPV4:168.212.226.204 IPV6:2001:0db8:85a3:0000:0000:8a2e:0370:7334 |
client_user_agent 客户端用户代理程序 字符串 | 无需进行哈希处理。 与事件对应的浏览器的用户代理程序。对于使用转化 API 分享的网站事件,必须填写 client_user_agent 参数。 为您通过转化 API 发送的所有事件同时发送 client_ip_address 和 client_user_agent 参数可能有助于改进事件匹配;而对于针对您通过转化 API 发送的事件进行优化的任何广告营销活动,此举还有助提升此类广告营销活动的广告投放成效。 请注意:此信息会自动添加到通过浏览器发送的事件中,但对于通过服务器发送的事件,您必须手动配置该信息。
示例: Mozilla/5.0 (Windows NT 10.0;Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.141 Safari/537.36 |
fbc 点击编号 字符串 | 无需进行哈希处理。 Facebook 点击编号值存储在您网域下的 _fbc 浏览器 Cookie 中。请参阅管理 fbc 和 fbp 参数,了解如何获取此值或从 fbclid 查询参数生成此值。 格式为 fb.${subdomain_index}.${creation_time}.${fbclid} 。
示例: fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890 |
fbp 浏览器编号 字符串 | 无需进行哈希处理。 Facebook 浏览器编号值存储在您网域下的 _fbp 浏览器 Cookie 中。请参阅管理 fbc 和 fbp 参数,了解如何获取此值。 格式为 fb.${subdomain_index}.${creation_time}.${random_number} 。
示例: fb.1.1596403881668.1116446470 |
subscription_id 订阅编号 字符串 | 无需进行哈希处理。 此交易中用户的订阅编号;类似于单件商品的订单编号。 |
fb_login_id Facebook 登录编号 整数 | 无需进行哈希处理。 在用户首次登录应用实例时,Meta 会分发此编号。此编号也称为“应用范围编号”。 |
lead_id 线索编号 整数 | 无需进行哈希处理。 此编号与 Meta 线索广告生成的线索相关联。 |
anon_id 字符串 | 无需进行哈希处理。 您的安装编号。此字段表示唯一的应用程序安装实例。
注意:此参数仅用于应用事件 |
madid 字符串 | 移动广告客户编号、Android 设备中的广告编号或 Apple 设备中的广告 ID (IDFA)。 |
page_id 字符串 | 无需进行哈希处理。 您的公共主页编号。指定与事件关联的公共主页编号。使用与智能助手关联的公共主页的 Facebook 公共主页编号。 |
page_scoped_user_id 字符串 | 无需进行哈希处理。 指定与记录事件的 Messenger 智能助手关联的公共主页范围用户编号。使用提供给 Webhooks 的公共主页范围用户编号。 |
ctwa_clid 字符串 | 无需进行哈希处理。 点击 Meta 为 WhatsApp 直达广告生成的编号。 |
ig_account_id 字符串 | 无需进行哈希处理。 与商家关联的 Instagram 账户编号。 |
ig_sid 字符串 | 无需进行哈希处理。 根据 Instagram 范围用户编号 (IGSID) 识别与 Instagram 互动的用户。可以从此 Webhooks 获取 IGSID。 |