Hvordan konfigurerer jeg Facebook Pixel med Zonos legacy iframe Checkout?

Tilføj standard Meta Pixel basiskoden til din side, der er vært for Checkout iframe, sæt window.Zonos.facebookPixelId i din Checkout customHTML, aktiver Facebook Pixel i din Facebook Pixel i dit ZZZPROTECTZZZPROTECT3ZZTZ, og tilføj ZZZPROTECTZZZ analyticsRelayOnInit.js script. Relæ-scriptet håndterer automatisk kommunikationen på tværs af iframe og videresender checkout-begivenheder til Meta.

Hvilke Facebook Pixel-begivenheder sporer Zonos Checkout?

For hvert tragttrin 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-closea: standard, og den matchende begivenhed findes) Start Checkout for start af kassen, AddPaymentInfo for betalingsoplysninger og Køb for ordreafslutning.

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.

Sælgere, der bruger den ældre Checkout-integration (iframe hostet på iglobalstores.com) kan spore Meta Pixel begivenheder på tværs af hele kassen tragt. Zonos Checkout videresender automatisk analysehændelser fra iframen til den overordnede side ved hjælp af det samme lette relæscript, der blev brugt til Google Analytics 4, så begivenheder vises i din Meta Events Manager, som om de stammede fra din egen websted.

For hvert tragttrin udsendes to hændelser:

En tilpasset begivenhed navngivetzonos-checkout-...(viafbq('trackCustom', ...)) for tilpassede målgrupper i fuld tragt.
Den matchende Meta standard begivenhed (viafbq('track', ...)) til indbygget optimering, f.eks.InitiateCheckout,AddPaymentInfo, ogPurchase.

**Native integrationer behøver ikke denne vejledning.**Hvis<zonos-checkout>gengiver direkte på dit websted (ingen iframe), kalder Zonos din sidewindow.fbqi placer — aktiver blot Facebook Pixel i Zonos-dashboardet under Checkout indstillinger→ Sporing og sørg for din sædvanlige Meta Pixel base kode er indlæst på siden. Relæopsætningen nedenfor er kun påkrævet når Checkout hostes i en iframe med en anden oprindelse.

Hvordan det virker

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

Checkout pinger forælderen -- Når kassen indlæses inde i iframen, den sender en besked til forældrevinduet, der angiver, at den er klar til at videresende begivenheder, herunder Pixel ID.
Forældre anerkender -- Relæscriptet på din side modtager pinget, registrerer (eller injicerer) din Meta Pixel-basiskode og signalerer tilbage, at det er klar til at modtage arrangementer.
Begivenheder videresendes -- Efterhånden som kunderne går gennem kassen, hver analytics hændelse sendes viapostMessagetil din side, hvor relæet script videresender det tilfbqmed passendetrack/trackCustom mode.

Alle meddelelser er valideret mod pålidelige Zonos-oprindelser (zonos.comog iglobalstores.com) kun 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 legacy Checkout-integration, der indlæser Zonos Checkout i en iframe på din side.
Facebook Pixel aktiveret i dine Zonos Checkout-indstillinger (i Zonos dashboard 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 standarden Pixel basiskode til<head>på siden, der er vært for Checkout iframen. ErstatteYOUR_PIXEL_IDmed 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>

**Note:**Hvis dit websted allerede har Meta Pixel installeret (f.eks. via Google Tag Manager, Shopifys indbyggede integration eller et direkte uddrag), kan du springe over dette trin. Relæscriptet vil bruge din eksisterendefbqfungere.

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

Trin 2: Giv dit Pixel ID til Zonos Checkout

Fortæl Zonos Checkout, hvilket Pixel ID der skal bruges ved at indstillewindow.Zonos.facebookPixelId inde i dine Checkout'ercustomHTML. Zonos instrumentbrættet afslører en customHTMLeditor under Checkout-indstillinger -- tilføj en<script>tag som dette:

1<script>

2 window.Zonos.facebookPixelId = 'YOUR_PIXEL_ID';

3</script>

Denne værdi sendes til forælderen under relæhåndtrykket. Hvis din forælder siden ikke allerede harfbqindlæst, vil relæscriptet injicere Meta Pixel-basiskode til dig, der bruger dette id.

Trin 3: Tilføj Zonos analytics relay 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, der bruges til Google Analytics 4 -- et enkelt relæ håndterer begge udbydere, så hvis du allerede har tilføjet for GA4, spring 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 side<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, er Facebook Pixel aktiveret i din Zonos instrumentbræt, ogcustomHTMLindstiller Pixel ID, relæet automatisk videresender alle kassetragtbegivenheder til Meta.

Meta Pixel begivenhedsreference

For hvert trin i tragten udløser Zonos Checkout både en tilpasset begivenhed (så du kan opbygge præcise målgrupper) og den matchende Meta-standardbegivenhed (så det fremgår op i Metas optimerings- og konverteringsrapportering). Alle arrangementer inkluderer en isTestModeflag ogcheckoutSessionId.

Udløser↕	Tilpasset begivenhed (`fbq('trackCustom', ...)`)↕	Standard begivenhed (`fbq('track', ...)`)↕	Yderligere metadata↕
Checkout åbner	`zonos-checkout-start`	`InitiateCheckout`	--
Shopper indtaster kundeoplysninger	`zonos-checkout-customer-info`	ingen	--
Shopper vælger en forsendelsesmetode	`zonos-checkout-shipping-info`	ingen	`serviceLevelId`
Shopper indtaster betalingsoplysninger	`zonos-checkout-payment-info`	`AddPaymentInfo`	`paymentMethod`
Betalingsforsøg mislykkedes	`zonos-checkout-payment-fail`	ingen	--
Ordren er gennemført med succes	`zonos-checkout-success`	ingen	`order_id`,`currency`,`value`,`contents`,`content_ids`
Ordren fuldføres (e-handelsbegivenhed)	`purchase`	`Purchase`	`order_id`,`currency`,`value`,`contents`,`content_ids`
Shopper lukker kassen	`zonos-checkout-close`	ingen	--

Trin uden en Meta-standardækvivalent (f.eks. kundeoplysninger, forsendelsesoplysninger) fyr kun skikzonos-checkout-...tilfælde. Du kan målrette mod disse i Meta Annonceadministrator via tilpassede målgrupper ved hjælp af "Begivenhed =zonos-checkout-customer-info", osv.

Køb hændelsesmetadata

DePurchasestandardbegivenheden følger Meta PixelPurchasebegivenhed skema. Indkøbskurvsartikler er kortlagt fra GA-stilenitemsarray til Meta's contentsarray:

Felt↕	Beskrivelse↕
`value`	Samlet ordreværdi
`currency`	Valutakode på tre bogstaver (f.eks.`USD`)
`order_id`	Zonos ordre ID eller checkout session ID
`contents`	Række af vogn varer, hver med`id`,`quantity`, og`item_price`
`content_ids`	Matrix af vare-id'er (SKU'en, produkt-id'et eller produktnavnet som reserve)
`content_type`	Altid`"product"`
`num_items`	Samlet mængde på tværs af alle varer

Fejlretning

For at aktivere debug-logning for relæscriptet skal du tilføjezonosDebug=1forespørgsel parameter til din side-URL:

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

Åbn din browsers udviklerkonsol for at se detaljerede logfiler for relæet håndtryk og videresendte begivenheder. Dette er nyttigt til at verificere, at:

Relæ-scriptet modtager ping fra checkout-iframen.
Meta Pixel er konfigureret med det korrekte Pixel ID.
Arrangementer videresendes tilfbqmed det forventedetrack/trackCustom mode.

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

Almindelige spørgsmål

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

Metas standardhændelser giver mulighed for konverteringsoptimering, annoncerapportering og lookalike publikum ud af boksen. Skikkenzonos-checkout-...begivenheder lader dig bygge mere detaljerede tilpassede målgrupper på det nøjagtige tragttrin, selv når der ikke er nogen Meta der findes standardækvivalenter (f.eks. kundeoplysninger, forsendelsesoplysninger). Affyrer begge giver dig 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 sammeanalyticsRelayOnInit.jshåndtag begge udbydere i et enkelt håndtryk. Tilføj GA4-grundmærket og Meta Pixel basiskode til din<head>, indstil begge delewindow.Zonos.googleAnalyticIdog window.Zonos.facebookPixelIdicustomHTML, og aktivere begge udbydere i dit Zonos dashboard. Hvert arrangement spredes ud til, uanset hvilken udbyder der er aktiveret.

Hvad hvis min overordnede side ikke har Meta Pixel installeret?

Hvis dincustomHTMLsætwindow.Zonos.facebookPixelIdog relæscriptet opdager nejfbqpå siden, vil den injicere Meta Pixel-basiskoden for dig under håndtrykket ved hjælp af det Pixel-id, du har angivet. Du kan også forudinstallere Meta Pixel basiskoden selv, hvis du vil fyrePageViewog andet begivenheder uden for kassetragten.

Spores testordrer?

Alle arrangementer inkluderer enisTestModefelt. Når Checkout er i testtilstand, hændelser er stadig videresendt til Meta, men markeret medisTestMode: true. Du kan filtrere disse ud i Meta Ads Manager eller ekskluder 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, der nogle sælgere bruger sammen med Pixel til redundans. De to er komplementære og Zonos's relæ håndterer kun pixel på browsersiden.

Book en demo