如何为Facebook Conversion API实现客户端与服务端event_id无通信同步

核心逻辑是使用两端可共同获取的确定性输入因子，结合统一的哈希算法生成唯一ID，不需要服务端和客户端提前通信同步ID，也无需调整现有事件触发的先后顺序，不需要做大规模代码重构。

实现步骤 #

• 第一步：确定双方可无差别获取的事件关联因子，优先选择稳定、唯一的属性：
  • 必选通用因子：Facebook写入用户Cookie的_fbp（所有安装了像素的站点都可获取，服务端可直接从请求Cookie中读取）、事件标准名称（两端约定统一大小写、命名规则）
  • 业务场景因子：对应事件的唯一业务标识，比如订单支付事件用订单号、商品浏览事件用商品ID+页面URL、表单提交事件用表单ID+用户手机号哈希值等
  • 兜底补充因子：如果没有明确的业务唯一标识，可补充精确到秒的事件触发Unix时间戳、用户UserAgent哈希值等属性，进一步降低重复概率
• 第二步：两端约定完全一致的因子拼接顺序、哈希规则，直接生成event_id即可，无需通信

代码示例 #

浏览器端（JS）生成示例 #

// 读取Cookie中的指定参数
function getCookie(name) {
  const value = `; ${document.cookie}`;
  const parts = value.split(`; ${name}=`);
  if (parts.length === 2) return parts.pop().split(';').shift();
}
// 按约定规则拼接原始字符串
const fbp = getCookie('_fbp') || (navigator.userAgent + window.location.hostname); // 无fbp时用UA+域名兜底
const eventName = 'Purchase';
const businessKey = '2024052000123'; // 对应事件的业务唯一标识，示例为订单号
const rawIdStr = `${fbp}|${eventName}|${businessKey}`;
// 用SHA256哈希生成最终event_id，可引入crypto-js等库实现
const eventId = CryptoJS.SHA256(rawIdStr).toString();

服务端（Python）生成示例 #

import hashlib
from flask import request # 示例为Flask框架，可替换为你所用的服务端框架

# 读取请求Cookie中的_fbp参数
fbp = request.cookies.get('_fbp', request.headers.get('User-Agent', '') + request.host)
event_name = 'Purchase'
business_key = '2024052000123' # 同一份业务唯一标识，和客户端取同源数据
raw_id_str = f"{fbp}|{event_name}|{business_key}"
# 相同哈希规则生成event_id
event_id = hashlib.sha256(raw_id_str.encode('utf-8')).hexdigest()

注意事项 #

• 所有因子的取值规则、拼接顺序、分隔符、哈希算法必须两端严格对齐，否则会出现ID不一致的问题
• 不要在拼接因子中加入随机值、动态生成的临时参数，否则会导致两端生成ID不一致
• 该方案生成的ID完全符合Facebook官方去重规则，只要是同一个事件对应的因子组合相同，生成的ID就唯一且一致，可正常完成去重处理

内容的提问来源于stack exchange，提问作者Fabian Lurz