Skip to main content

Tracking Spec — Biosphere Skincare

This documentation tells the Biosphere dev team what to push into window.dataLayer so the agency can wire Meta Conversions API, GA4, and Google Ads through a server-side GTM container hosted on Stape.

TL;DR

You only have one job: push events into window.dataLayer at the right moment with the right parameters. Everything else (Meta Pixel, GA4 tags, Google Ads conversions, CAPI, deduplication, server deployment) is wired by the agency in GTM + Stape.

window.dataLayer = window.dataLayer || [];
window.dataLayer.push({ ecommerce: null });
window.dataLayer.push({
event: 'purchase',
ecommerce: {
transaction_id: 'ORD-2026-00123',
value: 91.00,
currency: 'EUR',
tax: 7.18,
shipping: 4.95,
items: [
{ item_id: 'BIO-CRM-001', item_name: 'Day Cream', price: 42.00, quantity: 2 }
]
},
user_data: {
email: 'jane.doe@example.com',
phone: '+33612345678',
first_name: 'Jane',
last_name: 'Doe'
}
});

Implementation phases

🔴 Phase 1 — Core funnel (10 events) · Mandatory. Implement before going live.

The full e-commerce funnel. Every event listed below is required.

Funnel stepEvent
Product list shownview_item_list
Product clicked in listselect_item
Product detail pageview_item
Add to cartadd_to_cart
Cart pageview_cart
Remove from cartremove_from_cart
Start checkoutbegin_checkout
Shipping submittedadd_shipping_info
Payment submittedadd_payment_info
Order confirmedpurchase

🟡 Phase 2 — Acquisition (3 events) · Implement after Phase 1 is validated.

sign_up, generate_lead, search.

🟣 Phase 3 — Optional (3 events) · Implement when business-relevant.

refund, view_promotion, page_view (SPA only).

What you don't have to do

  • ❌ Install Meta Pixel — the agency injects it via GTM.
  • ❌ Install gtag.js / GA4 — same.
  • ❌ Hash emails or phones — server-side GTM does it.
  • ❌ Manage _fbp / _fbc cookies — Pixel and GTM Server handle it.
  • ❌ Handle consent (CMP) — managed via GTM Consent Mode v2.

What you must do

  1. Add the GTM snippet (provided by the agency) to <head> + <body>.
  2. Push dataLayer events as documented in this spec.
  3. Create CNAMEs for analytics.biosphereskincare.com and load.analytics.biosphereskincare.com (values from the agency).
  4. (Optional but recommended) Expose a product feed for the Meta Catalog.

Server-side subdomains

SubdomainRole
analytics.biosphereskincare.comServer-side GTM endpoint (Meta/GA4/Ads forwarding)
load.analytics.biosphereskincare.comServes gtm.js first-party (bypasses ad blockers)

Details: Stape subdomain setup.

Contacts

  • Agency — Charles Remy · charles@agence-bb.ch
  • Open an issue or ping on the shared Slack for implementation questions.