GA4. Tablica items. Poprawna struktura parametrów produktowych w eventach ecommerce.

Na czym to polega w sklepie

Tablica items to wymagany element eventów ecommerce GA4. Każdy element zawiera m.in. item_id, item_name, price, quantity i kategorie. Spójność ID między view_item, add_to_cart i purchase decyduje o jakości raportów produktowych i feedów remarketingowych.

Przykład ze sklepu internetowego

Budujesz wspólną funkcję mapLineItemsToGa4() używaną we wszystkich eventach - ten sam format items w całym lejku:

// Wspólny mapper koszyka → GA4 items (DRY w całym sklepie)
function mapLineItemsToGa4(lines) {
  return lines.map((line, index) => ({
    item_id: line.sku,              // wymagane - zgodne z feedem MC
    item_name: line.name,
    item_brand: line.brand,
    item_category: line.categoryL1,
    item_category2: line.categoryL2,
    item_variant: line.variant,
    price: line.unitPrice,
    quantity: line.qty,
    index: index,
    coupon: line.lineCoupon || undefined,
  }));
}

const items = mapLineItemsToGa4(cart.lines);

gtag('event', 'add_to_cart', { currency: 'PLN', value: cart.total, items });
gtag('event', 'purchase', {
  transaction_id: cart.orderId,
  value: cart.total,
  currency: 'PLN',
  items, // ta sama struktura co wyżej
});

Co zrobić po stronie biznesu

• Audyt spójności item_id - ten sam SKU w całym lejku i w Merchant Center.
• Raport item-scoped w eksploracjach - przychód per produkt bez joinów.
• Import BigQuery - unnest items przy analizie koszyka multi-produktowego.

W skrócie

Jeden mapper items dla całego sklepu eliminuje 80% błędów ecommerce w GA4. item_id musi być stabilny od view_item do purchase.