Hvordan konfigurerer jeg Google Analytics 4 med Zonos legacy iframe Checkout?

Tilføj standardkodestykket GA4 gtag.js til din side, der er vært for Checkout iframen, og tilføj derefter Zonos analyticsRelayOnInit.js scriptet. Relæscriptet håndterer automatisk kommunikationen på tværs af iframe og videresender checkout-begivenheder til din GA4-ejendom.

Hvilke GA4-begivenheder sporer Zonos Checkout?

Zonos Checkout sporer den fulde checkout-tragt inklusive zonos-checkout-start, zonos-checkout-customer-info, zonos-checkout-shipping-info, zonos-checkout-payment-info, zonos-checkout-payment-fail, zonos-checkout-success, zonos-checkout-theECTZZOS,TZZlose købsbegivenhed med transaktionsdetaljer.

Skal jeg ændre mit createTempCart API-kald til GA4-sporing?

Nej. Relæsystemet fungerer uafhængigt af createTempCart API. Du behøver kun at tilføje GA4-tagget og Zonos-relæscriptet til din side.

Hvordan fejlretter jeg GA4 begivenheder fra Zonos Checkout?

Tilføj zonosDebug=true query-parameteren til din side-URL, og åbn din browsers udviklerkonsol for at se detaljerede logfiler over relæ-håndtrykket og videresendte hændelser. Du kan også bruge GA4 DebugView i Google Analytics til at verificere hændelser i realtid.

Checkout•

HjemAPI reference Checkout REST API Google Analytics 4

Google Analytics 4 til iframe Checkout

Spor hele betalingstragten med GA4, når du bruger en iframe-baseret arv Checkout integration.

Sælgere, der bruger den ældre Checkout-integration (iframe hostet på iglobalstores.com) kan nu spore GA4-analysehændelser på tværs af kassetragt. Zonos Checkout videresender automatisk analysehændelser fra iframe til den overordnede side ved hjælp af et let relæscript, så hændelser vises i din GA4 ejendom, som om de stammede fra dit eget websted.

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

Ønsker du at spore Meta Ads-konverteringer i stedet? Se den Facebook Pixel guide -- det bruger det samme relæscript og kan køre sammen med GA4.

Hvordan det virker

Fordi Zonos Checkout kører inde i en iframe på en anden oprindelse, kan ikke få direkte adgang til din sidegtagfungere. 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.
Forældre anerkender -- Relæscriptet på din side modtager pinget, registrerer din eksisterende GA4-konfiguration og signalerer tilbage, at den er klar til 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 tilgtag.

Alle meddelelser er valideret mod pålidelige Zonos-oprindelser (zonos.comog iglobalstores.com) kun over HTTPS.

Forudsætninger

En GA4 ejendom med et måle-id (format:G-XXXXXXXXXX). Det kan du oprette en i Google Analytics.
En legacy Checkout-integration, der indlæser Zonos Checkout i en iframe på din side.

Opsætning

Trin 1: Tilføj GA4-tagget til din side

Hvis du ikke allerede har GA4 installeret på dit websted, skal du tilføje standard Google Analytics 4-tag til<head>på siden, der er vært for Checkout iframen. ErstatteG-XXXXXXXXXXmed dit eget måle-id.

1

3<script

4 async

5 src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"

6></script>

8<script>

9 window.dataLayer = window.dataLayer || [];

10 function gtag() {

11 dataLayer.push(arguments);

12 }

13 gtag('js', new Date());

14 gtag('config', 'G-XXXXXXXXXX');

15</script>

**Note:**Hvis dit websted allerede har GA4-tagget installeret (f.eks. via Google Tag Manager eller et direkte uddrag), kan du springe dette trin over. Relæ-scriptet vil bruge din eksisterendegtagfungere.

Du kan finde dette uddrag i din GA4-ejendom under Admin -> Data Streams -> vælg din stream -> Se tag-instruktioner -> Installer manuelt.

Trin 2: Send dit måle-id til Zonos Checkout

Fortæl Zonos Checkout hvilket GA4-måle-id, der skal bruges ved at indstille window.Zonos.googleAnalyticIdinde i dine Checkout'ercustomHTML. Zonos dashboard afslører encustomHTMLeditor under Checkout-indstillinger -- tilføj en <script>tag som dette:

1<script>

2 window.Zonos.googleAnalyticId = 'G-XXXXXXXXXX';

3</script>

Denne værdi sendes til forælderen under relæhåndtrykket. Hvis din forælder siden ikke allerede hargtagindlæst, vil relæscriptet injicere GA4 base tag til dig, der bruger dette ID.

Trin 3: Tilføj Zonos analytics relay script

Tilføj følgende script-tag til den samme side efter GA4-tagget. Dette script lytter efter analysehændelser fra Zonos Checkout iframen og videresender dem til dinegtag.

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 async

8 src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"

9 ></script>

11 <script>

12 window.dataLayer = window.dataLayer || [];

13 function gtag() {

14 dataLayer.push(arguments);

15 }

16 gtag('js', new Date());

17 gtag('config', 'G-XXXXXXXXXX');

18 </script>

20 

22 <script

23 async

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

25 ></script>

26</head>

Det er det. Når begge scripts er på din side, relæ-scriptet automatisk afslutter håndtrykket med checkout iframe og videresender al checkout tragt begivenheder til din GA4 ejendom.

GA4 begivenhedsreference

Zonos Checkout udsender følgende hændelser gennem relæet. Alle arrangementer inkluderer enisTestModeflag ogcheckoutSessionId.

Begivenhed↕	Udløser↕	Yderligere metadata↕
`zonos-checkout-start`	Checkout åbner	--
`zonos-checkout-customer-info`	Shopper indtaster kundeoplysninger	--
`zonos-checkout-shipping-info`	Shopper vælger en forsendelsesmetode	`serviceLevelId`
`zonos-checkout-payment-info`	Shopper indtaster betalingsoplysninger	`paymentMethod`
`zonos-checkout-payment-fail`	Betalingsforsøg mislykkedes	--
`zonos-checkout-success`	Ordren er gennemført med succes	`transaction_id`,`currency`,`value`,`items`
`zonos-checkout-close`	Shopper lukker kassen	--
`purchase`	Ordren fuldføres (GA4 standard e-handelshændelse)	`transaction_id`,`currency`,`value`,`items`

Køb hændelsesmetadata

Depurchasebegivenheden følger GA4 e-handelpurchasebegivenhed skema:

Felt↕	Beskrivelse↕
`transaction_id`	Zonos ordre-id eller checkout-session-id
`currency`	Valutakode på tre bogstaver (f.eks.`USD`)
`value`	Samlet ordreværdi
`items`	Række af vogn varer, hver med`item_id`,`item_name`,`price`, og`quantity`

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.
GA4 er konfigureret med det korrekte måle-id.
Arrangementer videresendes tilgtag.

Almindelige spørgsmål

Skal jeg ændre mit `createTempCart` API-kald?

Nej. Relæsystemet fungerer uafhængigt afcreateTempCartAPI. Kun dig skal du tilføje GA4-tagget og relæscriptet til din side.

Hvad hvis jeg allerede bruger `footerHTML` til Google Analytics?

DefooterHTMLparameter i createTempCart API injicerer scripts i checkout-iframen, som er begrænset til sporing hændelser på sideniveau inden for iframe-oprindelsen. Relætilgangen anbefales fordi det sender begivenheder til din egen GA4 ejendom på dit domæne, hvilket giver dig fuld tragtsynlighed i en enkelt ejendom.

Du kan sikkert fjerne alle GA4-scripts frafooterHTMLefter opsætning af relæ.

Virker dette med GA4 debug-tilstand i Google Analytics?

Ja. You can usezonosDebug=1for at aktivere relæscriptlogfiler i din browsers udviklerkonsol, og brug GA4 DebugView i Google Analytics til at verificere hændelser i realtid.

Spores testordrer?

Alle arrangementer inkluderer enisTestModefelt. Når Checkout er i testtilstand, hændelser sendes stadig til GA4, men markeres medisTestMode: true. Du kan filtrere disse ud i GA4 ved at bruge tilpassede dimensioner, hvis det er nødvendigt.

Book en demo