如何将GA4 items正确传递给服务端GTM的Facebook CAPI标签

正确传参逻辑 #

你使用的官方Google服务端Facebook CAPI标签模板，支持两种商品数据传递方式，不存在字段名识别错误的问题，你遇到的报错是参数传递链路的配置问题：

方式一：GA4电子商务自动映射（推荐） #

不需要在客户端配置额外自定义字段，按以下步骤配置即可：

• 客户端GTM的GA4事件标签中，在「要发送的事件参数」栏手动添加参数：参数名填items，值绑定dataLayer中的ecommerce.items变量，确保数组能被传输到服务端GTM
• 服务端GTM的Facebook CAPI标签配置中，找到「电子商务设置」区块，勾选从GA4电子商务数据自动映射商品信息选项，模板会自动将GA4标准items数组转换为Facebook要求的contents格式，同时自动提取item_id生成content_ids参数

方式二：自定义字段手动映射 #

如果你需要自行控制参数传递，不要在客户端传x-fb-cd-contents字段，按以下步骤操作：

• 客户端按上述方式把items数组作为事件参数发送到服务端
• 服务端Facebook CAPI标签的「自定义数据」配置中，新增一行映射：键填contents，值绑定入站事件中的items参数即可

你之前的问题原因 #

• 使用x-fb-cd-contents报错：HTTP请求传输自定义参数时会默认将数组序列化为JSON字符串，服务端模板拿到的是字符串类型数据，直接传给Facebook接口就会触发「必须为数组」的报错，如果你要使用该字段，需要在服务端额外添加变量将字符串反序列化为数组再传入
• 使用items字段无数据：默认GA4客户端标签不会自动发送items参数到服务端，你没有在客户端标签的事件参数配置中添加items项，导致服务端根本没有收到该参数，自然contents显示为null

排查验证步骤 #

1. 打开服务端GTM预览模式，触发事件后查看入站请求的「事件参数」列表，确认items数组存在且格式正确
2. 检查Facebook CAPI标签的参数映射配置，确认GA4电子商务映射开关已开启，或者手动映射了contents参数
3. 查看服务端GTM预览中Facebook标签的「出站请求」，确认contents字段为数组格式而非字符串或null

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