跨境电商广告不是“建个广告就等出单”,而是一套数据系统:账户结构、转化追踪、受众管理、素材测试、归因分析、预算控制和合规审核。专业视角下,核心是数据准确、事件可信、授权合法、可观测。
典型结构:
关键原则:Pixel 和 CAPI 使用同一 event_id 去重;用户数据必须获得同意;敏感信息哈希后传输。
用 Flask 接收订单事件,哈希邮箱和手机号,发送到 Graph API。
import os, hashlib, time, requests
from flask import Flask, request, jsonify
app = Flask(__name__)
PIXEL_ID = os.getenv("FB_PIXEL_ID")
TOKEN = os.getenv("FB_ACCESS_TOKEN")
API_VERSION = "v20.0"
def sha256(v: str) -> str:
return hashlib.sha256(v.strip().lower().encode()).hexdigest()
@app.post("/capi/order")
def capi_order():
data = request.get_json(force=True)
user_data = {}
if data.get("email"):
user_data["em"] = [sha256(data["email"])]
if data.get("phone"):
user_data["ph"] = [sha256(data["phone"])]
if data.get("fbp"):
user_data["fbp"] = data["fbp"]
if data.get("fbc"):
user_data["fbc"] = data["fbc"]
event = {
"event_name": "Purchase",
"event_time": int(time.time()),
"event_id": data["order_id"],
"action_source": "website",
"user_data": user_data,
"custom_data": {
"currency": data.get("currency", "USD"),
"value": float(data.get("value", 0))
}
}
url = f"https://graph.facebook.com/{API_VERSION}/{PIXEL_ID}/events"
r = requests.post(
url,
params={"access_token": TOKEN},
json={"data": [event]},
timeout=10
)
return jsonify(r.json()), r.status_code生产环境要加:用户同意校验、事件幂等、失败重试、日志脱敏、审核记录。
import os, requests
TOKEN = os.getenv("FB_ACCESS_TOKEN")
AD_ACCOUNT = os.getenv("FB_AD_ACCOUNT_ID")
API = "v20.0"
params = {
"access_token": TOKEN,
"fields": "campaign_name,adset_name,ad_name,spend,impressions,clicks,ctr,cpc,cpm,actions,action_values",
"level": "ad",
"date_preset": "last_7d",
"time_increment": 1,
"limit": 500
}
url = f"https://graph.facebook.com/{API}/act_{AD_ACCOUNT}/insights"
resp = requests.get(url, params=params, timeout=30)
resp.raise_for_status()
for row in resp.json().get("data", []):
print(row)这段代码用于自动化报表,不涉及用户隐私。注意 API 配额、分页、错误重试和时区。
event_id,防止重复上报。跨境电商 Facebook 广告的专业流程是:合规采集 → Pixel/CAPI 双通道 → 受众与排除 → 素材测试 → 数据报表 → 归因复盘 → 预算保护。代码可以简单,但用户同意、事件去重、Token 安全、日志脱敏和平台合规不能省。先跑通一个事件的准确上报,再扩展多账户、多币种和自动化报表。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。