GTM配置Facebook像素事件：数组形式设置属性参数是否合规？

结论先行：完全可以把color、gender、size这类商品属性以数组形式传入Facebook像素的AddToCart、BeginCheckout、Purchase等电商事件中，这是符合Facebook规范的正确配置方式。

一、为什么数组形式是合规的 #

Facebook电商事件的核心参数content_items本身就是数组结构，每个数组元素对应一件商品。你可以在每个商品对象里直接添加color、gender、size这类属性——其中size、color属于Facebook官方推荐的标准商品属性，gender可以作为自定义属性传递，Facebook会正常接收并处理这些数据。

二、GTM中的具体配置步骤 #

1. 确保数据层输出正确结构 #

首先要让网站的 dataLayer 能输出包含目标属性的商品数组，比如触发AddToCart事件时，数据层应该推类似这样的结构：

dataLayer.push({
  'event': 'addToCart',
  'ecommerce': {
    'add': {
      'products': [
        {
          'id': 'PROD-123',
          'name': '男士纯棉短袖',
          'price': '89.9',
          'color': '藏青',
          'gender': 'male',
          'size': 'XL'
        },
        {
          'id': 'PROD-456',
          'name': '女士针织开衫',
          'price': '159.9',
          'color': '米白',
          'gender': 'female',
          'size': 'M'
        }
      ]
    }
  }
});

2. 在GTM中配置变量与标签 #

• 创建数据层变量：分别提取ecommerce.add.products（或对应事件的商品数组路径），确保能获取到包含color、gender、size的商品数组。
• 配置Facebook像素标签：在标签的「事件参数」中，将content_items的值设置为刚才创建的数据层变量。如果是自定义事件，也可以手动构建数组参数，但推荐直接复用数据层的结构。

3. 验证配置有效性 #

用GTM预览模式触发事件，查看标签发送的请求；或者用Facebook事件管理器的测试工具，检查事件详情里的content_items是否包含所有目标属性，确认没有遗漏或格式错误。

三、关键注意事项 #

• 统一属性命名：尽量用Facebook标准属性名（比如size、color），自定义属性（如gender）保持命名一致，避免大小写、拼写差异导致数据混乱。
• 多商品场景适配：如果购物车中有多件商品，数组必须包含每件商品的对应属性，不能只传单一商品的属性。
• 数据层稳定性：确保网站每次触发电商事件时，数据层都能稳定输出包含目标属性的数组，避免因数据层缺失导致参数传递失败。

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