Hvordan setter jeg opp Facebook Pixel med Zonos legacy iframe Checkout?

Legg til standard Meta Pixel-basiskoden på siden som er vert for Checkout iframe-en, angi window.Zonos.facebookPixelId i Checkout customHTML, aktiver Facebook Pixel i Zonos-dashbordet, og legg til Zonos analyticsRelayOnInit.js-skriptet. Reléskriptet håndterer automatisk cross-iframe-kommunikasjonen og viderekoppler checkout-hendelser til Meta.

Hvilke Facebook Pixel-hendelser sporer Zonos Checkout?

For hvert traktsteg sender Zonos både en tilpasset hendelse (zonos-checkout-start, zonos-checkout-customer-info, zonos-checkout-shipping-info, zonos-checkout-payment-info, zonos-checkout-payment-fail, zonos-checkout-success, zonos-checkout-close) og den matchende Meta-standardhendelsen der en finnes: InitiateCheckout for checkout start, AddPaymentInfo for betalingsinformasjon og Purchase for ordregjennomføring.

Kan jeg kjøre Google Analytics og Facebook Pixel samtidig?

Ja. Det samme analyticsRelayOnInit.js-skriptet håndterer begge leverandørene i en enkelt håndtrykking. Legg til begge basistags på siden, angi window.Zonos.googleAnalyticId og window.Zonos.facebookPixelId i customHTML, og aktiver begge leverandørene i Zonos-dashbordet.

Checkout•

HjemAPI-referanse Checkout REST API Facebook Pixel

Facebook Pixel for iframe Checkout

Q: Hvordan feilsøker jeg Facebook Pixel-hendelser fra Zonos Checkout?

Legg til zonosDebug=1-spørreparameteren til side-URLen din og åpne nettleserens utviklerkonsoll for å se detaljerte logger over reléhåndtrykkingen og videresendte hendelser. Meta Pixel Helper Chrome-utvidelsen er også nyttig for å inspektere Pixel-kall i sanntid.

Spor hele checkout-trakten med Meta (Facebook) Pixel når du bruker en iframe-basert legacy Checkout-integrasjon.

Selgere som bruker legacy Checkout-integrasjonen (iframe som er vert på iglobalstores.com) kan spore Meta Pixel-hendelser gjennom hele checkout-trakten. Zonos Checkout videresender automatisk analysehendelser fra iframe-en til den overordnede siden ved hjelp av det samme lette reléskriptet som brukes til Google Analytics 4, så hendelser vises i Meta Events Manager som om de stammer fra ditt eget nettsted.

For hvert trinn i trakten sendes to hendelser:

En tilpasset hendelse navngitt zonos-checkout-... (via fbq('trackCustom', ...)) for egendefinerte målgrupper på tvers av hele trakten.
Den matchende Meta-standardhendelsen (via fbq('track', ...)) for innebygd optimalisering, f.eks. InitiateCheckout, AddPaymentInfo og Purchase.

Native integrasjoner trenger ikke denne veiledningen. Hvis <zonos-checkout> gjengis direkte på nettstedet ditt (ingen iframe), kaller Zonos window.fbq på siden din i stedet — bare aktiver Facebook Pixel i Zonos-dashbordet under Checkout-innstillinger → Sporing og kontroller at din vanlige Meta Pixel-basiskode er lastet på siden. Reléoppsettet nedenfor er bare nødvendig når Checkout er vert i en iframe på en annen opprinnelse.

Slik fungerer det

Fordi Zonos Checkout kjører inne i en iframe på en annen opprinnelse, kan det ikke direkte få tilgang til fbq-funksjonen på siden din. Relésystemet løser dette med en to-trinns håndtrykking (trinn 1-2) etterfulgt av viderekobling av hendelser (trinn 3):

Checkout pinger den overordnede siden -- Når checkout lastes inne i iframe-en, sender det en melding til det overordnede vinduet som indikerer at det er klart til å videresende hendelser, inkludert Pixel-ID-en.
Den overordnede siden bekrefter -- Reléskriptet på siden din mottar pingingen, oppdager (eller injiserer) Meta Pixel-basiskoden din, og signaliserer tilbake at det er klart til å motta hendelser.
Hendelser videresendes -- Etter hvert som kjøpere gjennomgår checkout, sendes hver analysehendelse via postMessage til siden din, der reléskriptet videresender den til fbq med passende track / trackCustom modus.

Alle meldinger valideres mot klarerte Zonos-opprinnelser (zonos.com og iglobalstores.com) bare over HTTPS.

Forutsetninger

En Meta Pixel med en Pixel-ID (en numerisk streng, typisk 15-16 siffer). Du kan opprette en i Meta Events Manager.
En legacy Checkout-integrasjon som laster Zonos Checkout i en iframe på siden din.
Facebook Pixel aktivert i Zonos Checkout-innstillingene dine (i Zonos-dashbordet, under Checkout-innstillinger -> Sporing).

Oppsett

Trinn 1: Legg til Meta Pixel-basiskoden på siden

Hvis du ikke allerede har Meta Pixel installert på nettstedet ditt, legger du til standard Pixel-basiskoden i <head> på siden som er vert for Checkout iframe-en. Erstatt YOUR_PIXEL_ID med din egen numeriske Pixel-ID.

1

3<script>

4 !(function (f, b, e, v, n, t, s) {

5 if (f.fbq) return;

6 n = f.fbq = function () {

7 n.callMethod ? n.callMethod.apply(n, arguments) : n.queue.push(arguments);

8 };

9 if (!f._fbq) f._fbq = n;

10 n.push = n;

11 n.loaded = !0;

12 n.version = '2.0';

13 n.queue = [];

14 t = b.createElement(e);

15 t.async = !0;

16 t.src = v;

17 s = b.getElementsByTagName(e)[0];

18 s.parentNode.insertBefore(t, s);

19 })(

20 window,

21 document,

22 'script',

23 'https://connect.facebook.net/en_US/fbevents.js',

24 );

25 fbq('init', 'YOUR_PIXEL_ID');

26 fbq('track', 'PageView');

27</script>

Merknad: Hvis nettstedet ditt allerede har Meta Pixel installert (f.eks. gjennom Google Tag Manager, Shopify sin native integrasjon eller et direkte utdrag), kan du hoppe over dette trinnet. Reléskriptet vil bruke din eksisterende fbq-funksjon.

Du finner dette utdraget i Meta Events Manager under Pixel-innstillingene dine Innstillinger -> Fortsett Pixel-oppsett -> Installer kode manuelt.

Trinn 2: Overfør Pixel-ID-en til Zonos Checkout

Fortell Zonos Checkout hvilken Pixel-ID som skal brukes ved å angi window.Zonos.facebookPixelId inne i Checkout-en din customHTML. Zonos-dashbordet viser en customHTML-editor under Checkout-innstillinger -- legg til en <script>-tag slik:

1<script>

2 window.Zonos.facebookPixelId = 'YOUR_PIXEL_ID';

3</script>

Denne verdien sendes til den overordnede siden under reléhåndtrykkingen. Hvis den overordnede siden din ikke allerede har fbq lastet, vil reléskriptet injisere Meta Pixel-basiskoden for deg ved hjelp av denne ID-en.

Trinn 3: Legg til Zonos-analyserelé-skriptet

Legg til følgende script-tag på samme side som laster Checkout iframe-en, etter Meta Pixel-basiskoden. Dette er det samme skriptet som brukes til Google Analytics 4 -- ett enkelt relé håndterer begge leverandørene, så hvis du allerede har lagt det til for GA4, kan du hoppe over dette trinnet.

1<script

2 async

3 src="https://cdn.jsdelivr.net/npm/@zonos/elements/dist/scripts/analyticsRelayOnInit.js"

4></script>

Fullstendig eksempel

Her er hva det fullstendige oppsettet ser ut som i siden din <head>:

1<head>

2 

4 

6 <script>

7 !(function (f, b, e, v, n, t, s) {

8 if (f.fbq) return;

9 n = f.fbq = function () {

10 n.callMethod

11 ? n.callMethod.apply(n, arguments)

12 : n.queue.push(arguments);

13 };

14 if (!f._fbq) f._fbq = n;

15 n.push = n;

16 n.loaded = !0;

17 n.version = '2.0';

18 n.queue = [];

19 t = b.createElement(e);

20 t.async = !0;

21 t.src = v;

22 s = b.getElementsByTagName(e)[0];

23 s.parentNode.insertBefore(t, s);

24 })(

25 window,

26 document,

27 'script',

28 'https://connect.facebook.net/en_US/fbevents.js',

29 );

30 fbq('init', 'YOUR_PIXEL_ID');

31 fbq('track', 'PageView');

32 </script>

34 

36 <script

37 async

38 src="https://cdn.jsdelivr.net/npm/@zonos/elements/dist/scripts/analyticsRelayOnInit.js"

39 ></script>

40</head>

Det er det. Når begge skriptene er på siden din, Facebook Pixel er aktivert i Zonos-dashbordet, og customHTML angir Pixel-ID-en, videresender reléet automatisk alle checkout-trakthendelser til Meta.

Meta Pixel-referanse for hendelser

For hvert trinn i trakten sender Zonos Checkout både en tilpasset hendelse (slik at du kan bygge presise målgrupper) og den matchende Meta-standardhendelsen (slik at den vises i Meta-optimalisering og konverteringsrapportering). Alle hendelser inkluderer et isTestMode-flagg og checkoutSessionId.

Utløser↕	Tilpasset hendelse (`fbq('trackCustom', ...)`)↕	Standardhendelse (`fbq('track', ...)`)↕	Tilleggsmetadata↕
Checkout åpnes	`zonos-checkout-start`	`InitiateCheckout`	--
Kjøper oppgir kundeinformasjon	`zonos-checkout-customer-info`	ingen	--
Kjøper velger en leveringsmetode	`zonos-checkout-shipping-info`	ingen	`serviceLevelId`
Kjøper oppgir betalingsdetaljer	`zonos-checkout-payment-info`	`AddPaymentInfo`	`paymentMethod`
Betalingsforsøk mislykkes	`zonos-checkout-payment-fail`	ingen	--
Ordre fullføres vellykket	`zonos-checkout-success`	ingen	`order_id`, `currency`, `value`, `contents`, `content_ids`
Ordre fullføres (e-handelshendelse)	`purchase`	`Purchase`	`order_id`, `currency`, `value`, `contents`, `content_ids`
Kjøper lukker checkout	`zonos-checkout-close`	ingen	--

Trinn uten Meta-standardekvivalent (f.eks. kundeinformasjon, leveringsinformasjon) sender bare den tilpassede zonos-checkout-...-hendelsen. Du kan målrette disse i Meta Ads Manager via egendefinerte målgrupper ved å bruke "Hendelse = zonos-checkout-customer-info", osv.

Metadata for Purchase-hendelse

Purchase-standardhendelsen følger Meta Pixel Purchase-hendelse skjemaet. Handlekurvvarer blir kartlagt fra GA-stilen items-matrisen inn i Meta sin contents-matrise:

Felt↕	Beskrivelse↕
`value`	Samlet ordrebeløp
`currency`	Tresifret valutakode (f.eks. `USD`)
`order_id`	Zonos ordre-ID eller checkout-sesjons-ID
`contents`	Matrise med handlekurvvarer, hver med `id`, `quantity` og `item_price`
`content_ids`	Matrise med vare-ID-er (SKU, produkt-ID eller produktnavn fallback)
`content_type`	Alltid `"product"`
`num_items`	Samlet mengde på tvers av alle varer

Feilsøking

For å aktivere feilsøkingslogging for reléskriptet, legger du til zonosDebug=1-spørreparameteren til side-URLen din:

1https://www.yourstore.com/checkout?zonosDebug=1

Åpne nettleserens utviklerkonsoll for å se detaljerte logger over relé-håndtrykkingen og videresendte hendelser. Dette er nyttig for å verifisere at:

Reléskriptet mottar pingingen fra checkout iframe-en.
Meta Pixel er konfigurert med riktig Pixel-ID.
Hendelser videresendes til fbq med forventet track / trackCustom-modus.

Meta Pixel Helper Chrome-utvidelsen er også nyttig for å inspektere Pixel-kall i sanntid.

Vanlige spørsmål

Hvorfor sendes to hendelser for samme trinn (f.eks. `zonos-checkout-start` og `InitiateCheckout`)?

Metas standardhendelser driver konverteringsoptimalisering, annonserapportering og lookalike-målgrupper automatisk. De tilpassede zonos-checkout-...-hendelsene lar deg bygge mer granulære egendefinerte målgrupper på det nøyaktige trakttrinnet, selv når det ikke finnes noen Meta-standardekvivalent (f.eks. kundeinformasjon, leveringsinformasjon). Å sende begge gir deg det beste fra begge verdener uten å miste noe signal.

Hva hvis jeg kjører både Google Analytics og Facebook Pixel?

Du trenger ikke to reléskripter -- det samme analyticsRelayOnInit.js håndterer begge leverandørene i en enkelt håndtrykking. Legg til GA4-basistagen og Meta Pixel-basiskoden til din <head>, angi både window.Zonos.googleAnalyticId og window.Zonos.facebookPixelId i customHTML, og aktiver begge leverandørene i Zonos-dashbordet. Hver hendelse blir spredt til hvilken som helst leverandører som er aktivert.

Hva hvis siden min ikke har Meta Pixel installert?

Hvis customHTML angir window.Zonos.facebookPixelId og reléskriptet ikke oppdager noen fbq på siden, vil det injisere Meta Pixel-basiskoden for deg under håndtrykkingen ved hjelp av Pixel-ID-en du oppgav. Du kan også pre-installere Meta Pixel-basiskoden selv hvis du vil sende PageView og andre hendelser utenfor checkout-trakten.

Blir testordrene sporet?

Alle hendelser inkluderer et isTestMode-felt. Når Checkout er i testmodus, blir hendelser fortsatt videresendt til Meta, men flagget med isTestMode: true. Du kan filtrere disse ut i Meta Ads Manager eller ekskludere dem med egendefinerte konverteringsregler.

Erstatter Conversions API (CAPI) dette?

Nei -- dette er en Pixel-integrasjon på klientsiden som kjører i kjøpernes nettlesere. Meta Conversions API er en separat server-til-server-kanal som noen selgere bruker ved siden av Pixel for redundans. De to er komplementære, og Zonos sitt relé håndterer bare Pixel på klientsiden.

Bestill en demo