🟡 Phase 2 — Extended · On-site search queries → Meta Search + GA4.

search

When to push

When an on-site search is run and results are displayed (not on keystroke).

Example

window.dataLayer.push({ ecommerce: null });
window.dataLayer.push({
  event: 'search',
  search_term: 'hydrating cream',
  ecommerce: {
    items: [
      // top 10 results max
      { item_id: 'BIO-CRM-001', item_name: 'Day Cream', price: 42.00, index: 1 },
      // ...
    ]
  }
});

Parameters

Parameter	Required
search_term	required — the query
ecommerce.items	optional — displayed results

Platforms

Platform	Native event	Notes
GA4	search	search_term is a standard GA4 parameter
Meta	Search	maps to search_string
Google Ads	—

Recommended combo

search (for the query) + view_item_list with item_list_id: 'search_results' (for the results).

Pitfalls

• ❌ Pushing on every keystroke → spam.
• ❌ Skip zero-result searches? No, push them — valuable merchandising insight.