🟣 Phase 3 — Optional · Internal promotion analytics.

view_promotion & select_promotion

When to push

• view_promotion: when a promotional banner / internal push appears (homepage hero, sale ribbon, etc.).
• select_promotion: when the user clicks it.

view_promotion example

window.dataLayer.push({ ecommerce: null });
window.dataLayer.push({
  event: 'view_promotion',
  ecommerce: {
    items: [
      {
        promotion_id: 'sale_summer_2026',
        promotion_name: 'Summer Sale -20%',
        creative_name: 'hero_banner_summer_v1',
        creative_slot: 'homepage_hero',
        location_id: 'home_top'
      }
    ]
  }
});

select_promotion example

Same shape, different event name:

window.dataLayer.push({ ecommerce: null });
window.dataLayer.push({
  event: 'select_promotion',
  ecommerce: {
    items: [
      {
        promotion_id: 'sale_summer_2026',
        promotion_name: 'Summer Sale -20%',
        creative_name: 'hero_banner_summer_v1',
        creative_slot: 'homepage_hero',
        location_id: 'home_top'
      }
    ]
  }
});

Parameters

Parameter	Required
promotion_id	required*
promotion_name	required*
creative_name	recommended
creative_slot	recommended — placement
location_id	optional

* At least one of the two.

Platforms

Platform	Native event
GA4	view_promotion / select_promotion
Meta	—
Google Ads	—

Multiple banners

When several banners appear at once (e.g. 3 hero slots): either 3 separate view_promotion events or 1 event with 3 items.

Recommended: 3 separate events — easier to attribute later.

Pitfalls

• ❌ Pushing on every scroll → use Intersection Observer: fire once when ≥ 50% visible.
• ❌ Confusing with a product (view_item) — a promotion is a marketing asset, not a product.