Verbind Google Analytics 4 (GA4) met je Atoms-project om websiteverkeer te volgen en te begrijpen hoe gebruikers met je gepubliceerde site omgaan.

Deze handleiding leidt je door het volledige installatieproces: de GA4-verbinding openen, het juiste Google-account autoriseren, de property voor je live site selecteren, de trackingupdate publiceren, bevestigen dat gegevens worden verzameld en de verbinding voorbereiden voor verificatie van Google Search Console.

Hoe de GA4-verbinding werkt

Een GA4-property is de Google Analytics-resource die gegevens voor een website of app verzamelt en rapporteert. Atoms gebruikt het Google-account dat je autoriseert om de Analytics-accounts en properties te vinden waartoe dat account toegang heeft. Verbind de property die door de gepubliceerde site voor je huidige Atoms-project wordt gebruikt.

De installatie bestaat uit drie onderdelen:

1. Autoriseer een Google-account. Meld je aan bij het account dat toegang heeft tot de juiste GA4-property en keur de gevraagde Google-machtigingen goed.
2. Verbind de overeenkomende property. Selecteer het Analytics-account en de GA4-property die door de live website van je project worden gebruikt.
3. Voeg de trackinginstelling toe, publiceer en controleer de rapportage. Wacht tot Atoms de trackingconfiguratie toevoegt, controleer en publiceer vervolgens de bijgewerkte site en bevestig daarna dat de juiste property is verbonden en gegevens ontvangt.

De GA4-verbinding staat los van Sarah’s SEO-contentworkflow. Sarah kan SEO-pagina’s plannen en genereren zonder GA4. De verbinding wordt gebruikt voor Analytics-rapportage.

Een door de gebruiker geautoriseerde GA4-verbinding kan ook automatische siteverificatie ondersteunen wanneer je later Google Search Console verbindt, als de verbinding voldoet aan de vereisten van Google.

Voordat je begint

Voordat je Google Analytics 4 (GA4) verbindt, moet je ervoor zorgen dat:

• Je de projecteigenaar bent. Andere medewerkers kunnen het project mogelijk bekijken, maar alleen de eigenaar kan de GA4-verbinding beheren.
• Je een Google-account hebt met toegang tot de GA4-property die door je website wordt gebruikt.
• Je weet welke GA4-property bij de gepubliceerde site hoort. Als meerdere properties vergelijkbare namen hebben, controleer dan eerst de website of webgegevensstream in Google Analytics.
• Je website is gegenereerd en is gepubliceerd of klaar om te publiceren. Als Marketing → Analytics aangeeft dat je eerst de site moet bouwen, voltooi dan eerst het genereren voordat je doorgaat.
• Je Browser Google-autorisatie-pop-ups van Atoms toestaat.
• Elke huidige taak van Sarah of Alex is voltooid voordat je de Marketing-verbinding wijzigt.

Je kunt GA4 verbinden voordat je aangepaste domein live is. Je gepubliceerde site moet echter gegevens naar de verbonden property sturen voordat Analytics-rapporten kunnen verschijnen.

Als je van plan bent GA4 te gebruiken om je site te helpen verifiëren in Google Search Console, gebruik dan voor beide verbindingen hetzelfde Google-account. Dat account moet ook bewerkingstoegang hebben tot de GA4-property.

Als je geen toegang hebt tot de property, vraag dan de Google Analytics-beheerder om je de vereiste toegang te geven. Zie Google’s handleiding voor gebruikerstoegang tot Analytics.

Als je Google-account nog geen Analytics-account, property of webgegevensstream heeft, kan Atoms je tijdens de installatie begeleiden bij het maken ervan. Je kunt deze ook rechtstreeks in Google Analytics maken met Google’s handleiding voor het instellen van website-Analytics.

Google Analytics-machtiging: Gebruik een Google-account dat toegang heeft tot het Analytics-account en de GA4-property voor deze site. Het selecteren van een bestaande property of webgegevensstream vereist toegang tot die resource. Voor het maken van een Analytics-account, GA4-property of webgegevensstream tijdens de installatie is de machtiging Editor (of gelijkwaardig) vereist op het relevante Analytics-niveau. Als een resource ontbreekt of je niet over de vereiste machtiging beschikt, vraag dan een Analytics-beheerder om toegang te verlenen of maak de resource eerst in Google Analytics aan en ga daarna terug naar Atoms en selecteer Refresh.

Plak nooit Google-wachtwoorden, verificatiecodes, toegangstokens of andere inloggegevens in Chat.

Google Analytics 4 verbinden

Open de GA4-connector

1. Open het Atoms-project waarvan je de gepubliceerde website wilt meten.
2. Selecteer Marketing in de projectwerkbalk.
3. Open Analytics. Als je begint vanuit Overzicht, kun je ook de kaart Analytics onder Marketing vinden en Analytics instellen selecteren.
4. Selecteer GA4 autoriseren. Hiermee autoriseer je het Google-account; je verbindt de property in een latere stap.

Google Analytics 4 autoriseren vanuit Marketing

Autoriseer het Google-account

1. Meld je in het Google-autorisatievenster aan bij het Google-account dat toegang heeft tot de GA4-property voor deze site.
2. Controleer of het juiste Google-account is geselecteerd.
3. Controleer de toegang die door Atoms wordt gevraagd. Ga alleen verder als je hiermee akkoord gaat.
4. Ga terug naar Atoms en wacht tot de autorisatiestap is voltooid.

Als de Browser het autorisatievenster blokkeert, sta dan pop-ups voor Atoms toe en probeer het opnieuw. Als Atoms Autorisatiepagina openen aanbiedt, gebruik die dan om in een nieuw tabblad verder te gaan.

Verbind de property voor de live site

Nadat je je Google-account hebt geautoriseerd, toont Atoms de Google Analytics-accounts en properties waartoe je toegang hebt. Wat je hierna ziet, kan verschillen afhankelijk van hoeveel Analytics-resources aan je account zijn gekoppeld.

1. Als Atoms je vraagt een Analytics-account te kiezen, selecteer dan het account dat de property voor je website bevat.
2. Selecteer de GA4-property die door je gepubliceerde site wordt gebruikt. Als je niet zeker weet welke je moet kiezen, controleer dan eerst de property in Google Analytics.
3. Als er een webgegevensstream verschijnt, bevestig dan dat deze het juiste live websiteadres gebruikt.
4. Selecteer Property verbinden.
5. Houd de pagina open totdat Atoms bevestigt dat de verbinding is voltooid.

Als een deel van de Analytics-installatie ontbreekt:

• Geen Analytics-account: Als beschikbaar, selecteer Laat Atoms het snel voor je maken, voltooi de Google-installatie en ga daarna terug naar Atoms en selecteer Refresh.
• Geen GA4-property: Selecteer het juiste Analytics-account en kies vervolgens Property maken in Atoms en wacht tot de nieuwe property verschijnt.
• Geen webgegevensstream: Selecteer de property en kies Snel aanmaken onder Webstream maken, of maak er handmatig een in Google Analytics Admin.

Als een account, property of gegevensstream die al zou moeten bestaan niet verschijnt, controleer dan of je het juiste Google-account gebruikt en er toegang toe hebt. Als deze pas onlangs is gemaakt of met je is gedeeld, wacht dan even en selecteer Refresh.

Verbind de GA4-property die door de live site wordt gebruikt

Voltooi de trackingupdate en publiceer

Het verbinden van de Google-resource zorgt er op zichzelf niet voor dat de gepubliceerde website gegevens begint te verzamelen. Nadat Atoms de propertyverbinding heeft bevestigd, start het een projecttaak om de Analytics-trackingconfiguratie aan de website toe te voegen.

1. Wacht tot de trackingtaak is voltooid. Start geen andere build- of Marketing-taak terwijl de update wordt uitgevoerd.
2. Controleer de voltooide wijziging en bekijk een voorbeeld van de website. Bevestig dat de site nog steeds laadt en zich gedraagt zoals verwacht.
3. Publiceer het bijgewerkte project. Als de site al live was, zorg er dan voor dat de nieuw bijgewerkte versie nu de gepubliceerde versie is.
4. Open de gepubliceerde homepage in een nieuw tabblad en gebruik de site normaal om een testbezoek te genereren.
5. Ga terug naar Marketing → Analytics om de verbinding te controleren en, nadat Google het bezoek heeft verwerkt, de rapportagestatus te bekijken.

Verwacht resultaat: Atoms toont de bedoelde property als verbonden, de trackingupdate is aanwezig in de gepubliceerde versie en de live site begint nieuwe activiteit naar die property te sturen. Het verbinden van GA4 creëert geen historische gegevens voor activiteit die plaatsvond voordat de verzameling begon.

Controleer of de verbinding werkte

1. Ga terug naar Marketing → Analytics.
2. Bevestig dat de installatie van Google Analytics 4 niet langer de eerste verbindingsprompt toont.
3. Controleer of het verbonden account of de verbonden property overeenkomt met de live site.
4. Als het gebied voor Analytics-rapportage beschikbaar is, open het dan en kies een recent datumbereik.
5. Als de site nieuw is, bezoek dan de gepubliceerde site en kom later terug om te controleren op verwerkte gegevens.

Een leeg rapport betekent niet noodzakelijk dat de autorisatie is mislukt. Behandel de status van de verbonden property en de rapportagestatus als afzonderlijke controlepunten. Bevestig dat de trackingtaak is voltooid, dat de bijgewerkte versie is gepubliceerd en dat dezelfde property gebeurtenissen van de live website ontvangt. Google merkt op dat het 24–48 uur kan duren voordat veel standaard GA4-rapporten zijn gevuld nadat de verzameling is begonnen; gebruik Google Analytics Realtime wanneer je eerder wilt controleren of gegevens worden verzameld. Zie Google’s handleiding voor verificatie van gegevensverzameling.

Controleer Analytics-rapportage nadat GA4-gegevens beschikbaar zijn

Herstel van een mislukte GA4-verbinding

Gebruik de status die is mislukt om de volgende veilige actie te kiezen. Een mislukte autorisatie of resourcelijst heeft meestal een nieuw autorisatievenster, de juiste Google-identiteit of een vernieuwing nodig nadat toegang is verleend. Een verbonden property zonder rapportagegegevens vereist een controle van de trackingtaak en publicatie voordat je de verbinding opnieuw probeert.

• Autorisatie of laden van account mislukt: Sta pop-ups toe, open Autorisatiepagina openen opnieuw als die wordt aangeboden, bevestig de bedoelde Google-identiteit en probeer het één keer opnieuw.
• Een account, property of stream ontbreekt: Bevestig de vereiste toegang en de machtiging Editor voor het aanmaken en selecteer daarna Refresh zodra een recent aangemaakte of gedeelde resource beschikbaar wordt.
• De property verbindt, maar tracking of rapportage mislukt: Wacht tot de trackingtaak is voltooid, bekijk een voorbeeld en publiceer de nieuwste versie, bevestig dat de verbonden property overeenkomt met de live site en gebruik Google Analytics Realtime of de gedocumenteerde rapportagevertraging voordat je het opnieuw probeert.

Als dezelfde fase na één nieuwe poging nog steeds mislukt, neem dan contact op met Atoms Support of je werkruimtebeheerder. Vermeld de projectnaam, de naam van de verbonden property indien getoond, de mislukte fase, zichtbare status- of fouttekst, het geschatte tijdstip en een geredigeerde screenshot. Voeg nooit wachtwoorden, verificatiecodes, toegangstokens, OAuth-codes of andere inloggegevens toe.

Gebruik GA4 met Google Search Console

Op Google Analytics gebaseerde Search Console-verificatie is voorwaardelijk. In Atoms vereist Automatisch verifiëren via Google Analytics een in aanmerking komende door de gebruiker geautoriseerde GA4-verbinding. Een door Atoms aangemaakte beheerde GA4-instelling kan deze automatische verificatieactie niet gebruiken. GA4 is niet vereist als je een van Google’s handmatige verificatiemethoden gebruikt.

Zie Google Search Console verbinden voor de volledige stappen en vereisten om je site in Search Console in te stellen en te verifiëren.

Google’s Analytics-verificatiemethode vereist ook een openbare homepage die de ondersteunde Analytics-tag bevat en is van toepassing op een URL-prefix Search Console-property, niet op een domeinproperty. Als automatische verificatie niet beschikbaar is omdat de GA4-instelling door Atoms wordt beheerd of omdat niet aan een vereiste van Google wordt voldaan, ga dan verder met Handmatig verifiëren in Google Search Console. Zie Google’s vereisten voor verificatie van site-eigendom.

Zie SEO Agent voor de gerelateerde workflow voor content en rapportage.