Hvordan konfigurerer jeg Facebook Pixel med Zonos legacy iframe Checkout?

Tilføj standard Meta Pixel-basiskoden til den side, der er vært for Checkout-iframen, angiv window.Zonos.facebookPixelId i din Checkouts customHTML, aktivér Facebook Pixel i dit Zonos-dashboard, og tilføj Zonos' analyticsRelayOnInit.js-script. Relæscriptet håndterer automatisk kommunikationen på tværs af iframen og videresender checkout-hændelser til Meta.

Hvilke Facebook Pixel-begivenheder sporer Zonos Checkout?

For hvert trin i tragten udløser Zonos både en tilpasset hændelse (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 tilsvarende Meta-standardhændelse, hvor en sådan findes: InitiateCheckout, når Checkout åbnes, AddPaymentInfo for betalingsoplysninger og Purchase for gennemført ordre.

Kan jeg køre Google Analytics og Facebook Pixel på samme tid?

Ja. Det samme analyticsRelayOnInit.js-script håndterer begge udbydere i et enkelt håndtryk. Tilføj begge basistags til din side, indstil window.Zonos.googleAnalyticId og window.Zonos.facebookPixelId i customHTML, og aktiver begge udbydere i dit Zonos-dashboard.

Hvordan fejlretter jeg Facebook Pixel begivenheder fra Zonos Checkout?

Tilføj zonosDebug=1-forespørgselsparameteren til din side-URL, og åbn din browsers udviklerkonsol for at se detaljerede logfiler over relæ-håndtrykket og videresendte hændelser. Meta Pixel Helper Chrome-udvidelsen er også nyttig til at inspicere Pixel-opkald i realtid.

Checkout•

HjemAPI reference Checkout REST API Facebook Pixel

Facebook Pixel til iframe Checkout

Spor hele betalingstragten med Meta (Facebook) Pixel, når du bruger en iframe-baseret, ældre Checkout-integration.

Forhandlere, der bruger den ældre Checkout-integration (iframe hostet på iglobalstores.com), kan spore Meta Pixel-hændelser gennem hele betalingstragten. Zonos Checkout videresender automatisk analysehændelser fra iframen til den overordnede side ved hjælp af det samme lette relæscript, som bruges til Google Analytics 4, så hændelserne vises i din Meta Events Manager, som om de stammede fra dit eget websted.

For hvert trin i tragten udsendes to hændelser:

En tilpasset hændelse ved navn zonos-checkout-... (via fbq('trackCustom', ...)) til tilpassede målgrupper i hele tragten.
Den tilsvarende Meta-standardhændelse (via fbq('track', ...)) til indbygget optimering, f.eks. InitiateCheckout, AddPaymentInfo og Purchase.

Native integrationer har ikke brug for denne vejledning. Hvis <zonos-checkout> gengives direkte på dit websted (ingen iframe), kalder Zonos window.fbq direkte på din side — aktivér blot Facebook Pixel i Zonos-dashboardet under Checkout-indstillinger → Sporing, og sørg for, at din sædvanlige Meta Pixel-basiskode er indlæst på siden. Relæopsætningen nedenfor er kun nødvendig, når Checkout hostes i en iframe med en anden oprindelse.

Hvordan det virker

Fordi Zonos Checkout kører inde i en iframe med en anden oprindelse, kan den ikke få direkte adgang til din sides fbq-funktion. Relæsystemet løser dette med et to-trins håndtryk (trin 1-2) efterfulgt af videresendelse af hændelser (trin 3):

Checkout pinger den overordnede side -- Når Checkout indlæses inde i iframen, sender den en besked til det overordnede vindue om, at den er klar til at videresende hændelser, herunder Pixel-ID'et.
Den overordnede side bekræfter -- Relæscriptet på din side modtager pinget, registrerer (eller indsætter) din Meta Pixel-basiskode og sender besked tilbage om, at den er klar til at modtage hændelser.
Hændelser videresendes -- Efterhånden som kunderne bevæger sig gennem Checkout, sendes hver analysehændelse via postMessage til din side, hvor relæscriptet videresender den til fbq med den relevante track / trackCustom-tilstand.

Alle beskeder valideres mod pålidelige Zonos-oprindelser (zonos.com og iglobalstores.com) udelukkende over HTTPS.

Forudsætninger

En Meta Pixel med et Pixel-ID (en numerisk streng, typisk 15-16 cifre). Du kan oprette en i Meta Events Manager.
En ældre Checkout-integration, der indlæser Zonos Checkout i en iframe på din side.
Facebook Pixel aktiveret i dine Zonos Checkout-indstillinger (i Zonos-dashboardet under Checkout-indstillinger -> Sporing).

Opsætning

Trin 1: Tilføj Meta Pixel-basiskoden til din side

Hvis du ikke allerede har Meta Pixel installeret på dit websted, skal du tilføje standard Pixel-basiskoden til <head> på den side, der er vært for Checkout-iframen. Erstat YOUR_PIXEL_ID med dit eget 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>

Bemærk: Hvis dit websted allerede har Meta Pixel installeret (f.eks. via Google Tag Manager, Shopifys indbyggede integration eller et direkte kodestykke), kan du springe dette trin over. Relæscriptet vil bruge din eksisterende fbq-funktion.

Du kan finde dette kodestykke i din Meta Events Manager under din Pixel Indstillinger -> Fortsæt Pixel-opsætning -> Installer kode manuelt.

Trin 2: Send dit Pixel-ID til Zonos Checkout

Fortæl Zonos Checkout, hvilket Pixel-ID der skal bruges, ved at indstille window.Zonos.facebookPixelId inde i din Checkouts customHTML. Zonos-dashboardet stiller en customHTML-editor til rådighed under Checkout-indstillinger -- tilføj et <script>-tag som dette:

1<script>

2 window.Zonos.facebookPixelId = 'YOUR_PIXEL_ID';

3</script>

Denne værdi sendes til den overordnede side under relæhåndtrykket. Hvis din overordnede side ikke allerede har fbq indlæst, indsætter relæscriptet Meta Pixel-basiskoden for dig ved hjælp af dette ID.

Trin 3: Tilføj Zonos' analytics-relæscript

Tilføj følgende script-tag til den samme side, som indlæser Checkout-iframen, efter Meta Pixel-basiskoden. Dette er det samme script, som bruges til Google Analytics 4 -- ét enkelt relæ håndterer begge udbydere, så hvis du allerede har tilføjet det for GA4, kan du springe dette trin over.

1<script

2 async

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

4></script>

Komplet eksempel

Sådan ser den fulde opsætning ud på din sides <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 scripts er på din side, Facebook Pixel er aktiveret i dit Zonos-dashboard, og customHTML angiver Pixel-ID'et, videresender relæet automatisk alle betalingstragtens hændelser til Meta.

Meta Pixel-hændelsesreference

For hvert trin i tragten udløser Zonos Checkout både en tilpasset hændelse (så du kan opbygge præcise målgrupper) og den tilsvarende Meta-standardhændelse (så den vises i Metas optimerings- og konverteringsrapportering). Alle hændelser inkluderer et isTestMode-flag og checkoutSessionId.

Udløser↕	Tilpasset hændelse (`fbq('trackCustom', ...)`)↕	Standardhændelse (`fbq('track', ...)`)↕	Yderligere metadata↕
Checkout åbner	`zonos-checkout-start`	`InitiateCheckout`	--
Kunden indtaster kundeoplysninger	`zonos-checkout-customer-info`	ingen	--
Kunden vælger en forsendelsesmetode	`zonos-checkout-shipping-info`	ingen	`serviceLevelId`
Kunden indtaster betalingsoplysninger	`zonos-checkout-payment-info`	`AddPaymentInfo`	`paymentMethod`
Betalingsforsøg mislykkes	`zonos-checkout-payment-fail`	ingen	--
Ordren gennemføres	`zonos-checkout-success`	ingen	`order_id`, `currency`, `value`, `contents`, `content_ids`
Ordren gennemføres (e-handelshændelse)	`purchase`	`Purchase`	`order_id`, `currency`, `value`, `contents`, `content_ids`
Kunden lukker Checkout	`zonos-checkout-close`	ingen	--

Trin uden en Meta-standardækvivalent (f.eks. kundeoplysninger, forsendelsesoplysninger) udløser kun den tilpassede zonos-checkout-...-hændelse. Du kan målrette disse i Meta Ads Manager via tilpassede målgrupper ved hjælp af "Event = zonos-checkout-customer-info", osv.

Metadata for Purchase-hændelsen

Standardhændelsen Purchase følger skemaet for Meta Pixel-hændelsen Purchase. Varer i kurven mappes fra GA-stilens items-array til Metas contents-array:

Felt↕	Beskrivelse↕
`value`	Samlet ordreværdi
`currency`	Trebogstavs valutakode (f.eks. `USD`)
`order_id`	Zonos-ordre-ID eller checkout-session-ID
`contents`	Array af kurvvarer, hver med `id`, `quantity` og `item_price`
`content_ids`	Array af vare-ID'er (SKU'et, produkt-ID'et eller produktnavnet som reserve)
`content_type`	Altid `"product"`
`num_items`	Samlet antal på tværs af alle varer

Fejlretning

For at aktivere debug-logning for relæscriptet skal du tilføje forespørgselsparameteren zonosDebug=1 til din side-URL:

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

Åbn din browsers udviklerkonsol for at se detaljerede logs for relæhåndtrykket og de videresendte hændelser. Dette er nyttigt til at bekræfte, at:

Relæscriptet modtager pinget fra Checkout-iframen.
Meta Pixel er konfigureret med det korrekte Pixel-ID.
Hændelser videresendes til fbq med den forventede track / trackCustom-tilstand.

Chrome-udvidelsen Meta Pixel Helper er også nyttig til at inspicere Pixel-kald i realtid.

Almindelige spørgsmål

Hvorfor udløses der to hændelser for det samme trin (f.eks. `zonos-checkout-start` og `InitiateCheckout`)?

Metas standardhændelser driver konverteringsoptimering, annoncerapportering og lookalike-målgrupper ud af boksen. De tilpassede zonos-checkout-...-hændelser giver dig mulighed for at opbygge mere detaljerede tilpassede målgrupper på det præcise trin i tragten, selv når der ikke findes en Meta-standardækvivalent (f.eks. kundeoplysninger, forsendelsesoplysninger). Ved at udløse begge får du det bedste fra begge verdener uden at miste noget signal.

Hvad hvis jeg kører både Google Analytics og Facebook Pixel?

Du behøver ikke to relæscripts -- det samme analyticsRelayOnInit.js håndterer begge udbydere i ét enkelt håndtryk. Tilføj GA4-basistagget og Meta Pixel-basiskoden til din <head>, angiv både window.Zonos.googleAnalyticId og window.Zonos.facebookPixelId i customHTML, og aktivér begge udbydere i dit Zonos-dashboard. Hver hændelse sendes ud til, hvilke udbydere der end er aktiveret.

Hvad hvis min overordnede side ikke har Meta Pixel installeret?

Hvis din customHTML angiver window.Zonos.facebookPixelId, og relæscriptet ikke registrerer nogen fbq på siden, indsætter det Meta Pixel-basiskoden for dig under håndtrykket ved hjælp af det Pixel-ID, du har angivet. Du kan også selv forudinstallere Meta Pixel-basiskoden, hvis du vil udløse PageView og andre hændelser uden for betalingstragten.

Spores testordrer?

Alle hændelser inkluderer et isTestMode-felt. Når Checkout er i testtilstand, videresendes hændelser stadig til Meta, men markeres med isTestMode: true. Du kan filtrere disse fra i Meta Ads Manager eller udelukke dem med tilpassede konverteringsregler.

Erstatter Conversions API (CAPI) dette?

Nej -- dette er en Pixel-integration på browsersiden, der kører i dine kunders browsere. Meta Conversions API er en separat server-til-server-kanal, som nogle forhandlere bruger sammen med Pixel'en til redundans. De to supplerer hinanden, og Zonos' relæ håndterer kun Pixel-integrationen på browsersiden.

Book en demo