使用Google Tag Manager部署GA4时view_item_list事件商品与列表信息映射异常问题咨询

I ran into this exact issue a while back when setting up GA4 via GTM—turns out the problem comes from misplacing list-level metadata in your dataLayer structure and potential misconfiguration in your GTM tags. Let's break down the fix step by step:

Why You're Seeing 4 Entries Instead of 2 #

Right now, you're including item_list_name and item_list_id inside each individual item object in your items array. But according to GA4's view_item_list specification, these are properties of the entire product list, not each individual item. When you nest them inside items, GA4's debugger (and event processing logic) misinterprets these as extra "dummy" items, hence the duplicate entries you're seeing.

Step 1: Correct Your DataLayer Structure #

Move the item_list_name and item_list_id up to the top level of the ecommerce object, not inside each item. Here's the fixed code:

dataLayer.push({ 
  'event': 'view_item_list', 
  'ecommerce': { 
    'item_list_name': 'Search Results', // List-level metadata here
    'item_list_id': 'SR123', // List-level metadata here
    'items': [ 
      { 
        'item_name': 'Triblend Android T-Shirt', 
        'item_id': '12345', 
        'price': '15.25', 
        'item_brand': 'Google', 
        'item_category': 'Apparel', 
        'item_category2': 'Mens', 
        'item_category3': 'Shirts', 
        'item_category4': 'Tshirts', 
        'item_variant': 'Gray', 
        'index': 1, 
        'quantity': '1' 
      }, 
      { 
        'item_name': 'Donut Friday Scented T-Shirt', 
        'item_id': '67890', 
        'price': '33.75', 
        'item_brand': 'Google', 
        'item_category': 'Apparel', 
        'item_category2': 'Mens', 
        'item_category3': 'Shirts', 
        'item_category4': 'Tshirts', 
        'item_variant': 'Black', 
        'index': 2, 
        'quantity': '1' 
      }
    ] 
  } 
});

Step 2: Fix Your GTM GA4 Tag Configuration #

Make sure your GTM tag maps the data correctly:

1. Create Data Layer Variables:
   • A variable named ecommerce-items pointing to ecommerce.items
   • A variable named ecommerce-item_list_name pointing to ecommerce.item_list_name
   • A variable named ecommerce-item_list_id pointing to ecommerce.item_list_id
2. Configure the GA4 Event Tag:
   • Set the Event Name to view_item_list
   • Under Event Parameters, add:
     • item_list_name → Value: ecommerce-item_list_name
     • item_list_id → Value: ecommerce-item_list_id
   • Under Items, select "Data Layer Variable" and choose ecommerce-items
3. Check for Duplicate Configurations:
   • Ensure you aren't accidentally adding item_list_name or item_list_id as part of the Items parameter mapping (this would reintroduce duplicate entries)
   • Confirm no duplicate GA4 tags are firing for the same view_item_list event

Step 3: Test the Fix #

Push the updated dataLayer, then open the GA4 Debugger. You should now see only 2 product entries, each with their correct attributes. The item_list_name and item_list_id will appear as top-level parameters of the view_item_list event, not as separate items.

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