客户信息参数

客户信息参数是您随事件信息一同分享的一组用户标识符。如需详细了解必要参数与推荐参数,请参阅最佳实践 — 转化 API:发送必要参数与推荐参数

图谱 API v13.0 版本针对被视为有效的客户信息参数组合作出了新要求。请参阅最佳实践,以确保您的转化 API 集成不会遭到中断。

请访问 Meta 隐私和数据使用指南,了解使用转化 API 时会发送的数据。

我们系统的经过设计,不会接受客户信息中未经哈希处理的联系方式,除非下文另有说明。联系方式指可识别个人身份的信息(如姓名、邮箱和手机号),我们仅会将此等信息用于用户匹配。如果您使用 Meta Business SDK,系统将自动完成哈希处理。

Pixel 像素代码比较

您可以通过 Meta Pixel 像素代码发送多个客户信息参数,不过一些参数(如 client_user_agent)会作为互联网运作协议的一部分,由系统自动发送。例如,如要通过 Pixel 像素代码发送 external_id,您可以使用以下代码:

fbq('init', 'PIXEL_ID', {'external_id': 12345});

请阅读高级匹配文档,了解其他可以通过 Pixel 像素代码传递的参数。

反之亦然,请您务必也要将系统当前分享至浏览器端的同一组客户信息参数应用到服务器端。

设置 user_data 参数的格式

发出请求时,请务必以正确格式至少提供以下其中一项 user_data 参数。

请下载此 CSV 文件

,获取以下参数的经过适当标准化和散列处理的数据示例。



下载(点击右键 > 将链接另存为)
参数描述
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 格式,其中涵盖各类月、日、年组合,带不带标点均可。

  • 年份:使用 YYYY 格式,范围从 1900 年至当前年份。
  • 月份:使用 MM 格式,范围从 01 至 12。
  • 日期:使用 DD 格式,范围从 01 至 31。

示例:

输入:2/16/1997
标准化格式:19970216
预期的 SHA256 输出:01acdbf6ec7b4f478a225f1a246e5d6767eeab1a7ffa17f025265b5b94f40f0c

ge

性别

字符串或 list<string>

必须进行哈希处理。
我们接受以小写首字母表示性别的做法。


示例:

  • f 表示女性
  • m 表示男性
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_addressclient_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 中。请参阅管理 fbcfbp 参数,了解如何获取此值或从 fbclid 查询参数生成此值。

格式为 fb.${subdomain_index}.${creation_time}.${fbclid}


示例:
fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890

fbp

浏览器编号

字符串

无需进行哈希处理。
Facebook 浏览器编号值存储在您网域下的 _fbp 浏览器 Cookie 中。请参阅管理 fbcfbp 参数,了解如何获取此值。

格式为 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。