GA4 verbinden

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

Hoe de GA4-verbinding werkt

Een GA4-property is de Google Analytics-bron 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.

Er zijn drie onderdelen van de installatie:

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, zorg ervoor 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 gepubliceerd is of klaar is om te publiceren. Als Marketing → Analytics aangeeft dat je moet beginnen met het bouwen van de site, voltooi dan eerst het genereren voordat je doorgaat.
• Je browser Google-autorisatiepop-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 hetzelfde Google-account voor beide verbindingen. 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 bron. Voor het maken van een Analytics-account, GA4-property of webgegevensstream tijdens de installatie is Editor-machtiging (of gelijkwaardig) vereist op het relevante Analytics-niveau. Als een bron ontbreekt of je niet over de vereiste machtiging beschikt, vraag dan een Analytics-beheerder om toegang te verlenen of de bron eerst in Google Analytics te maken, en keer daarna terug naar Atoms en selecteer Vernieuwen.

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. Keer 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 dat dan om verder te gaan in een nieuw tabblad.

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 variëren afhankelijk van hoeveel Analytics-bronnen 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 de property dan eerst in Google Analytics.
3. Als 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: Selecteer indien beschikbaar Laat Atoms het snel voor je maken, voltooi de Google-installatie en keer daarna terug naar Atoms en selecteer Vernieuwen.
• Geen GA4-property: Selecteer het juiste Analytics-account, kies daarna Property maken in Atoms en wacht tot de nieuwe property verschijnt.
• Geen webgegevensstream: Selecteer de property en kies Snel maken 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 Vernieuwen.

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

Voltooi de trackingupdate en publiceer

Het verbinden van de Google-bron 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. Keer 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 maakt geen historische gegevens aan voor activiteit die plaatsvond voordat het verzamelen begon.

Controleer of de verbinding werkte

1. Keer terug naar Marketing → Analytics.
2. Bevestig dat de installatie van Google Analytics 4 niet langer de initiële verbindingsprompt toont.
3. Controleer of het verbonden account of de verbonden property overeenkomt met de live site.
4. Als het Analytics-rapportagegebied beschikbaar is, open het dan en kies een recent datumbereik.
5. Als de site nieuw is, bezoek dan de gepubliceerde site en keer 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 ontvangt van de live website. Google merkt op dat veel standaard GA4-rapporten 24–48 uur kunnen duren voordat ze worden gevuld nadat het verzamelen is begonnen; gebruik Google Analytics Realtime wanneer je een eerdere controle van de gegevensverzameling nodig hebt. 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 bronnenlijst vereist meestal een nieuw autorisatievenster, de juiste Google-identiteit of een vernieuwing 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 dat wordt aangeboden, bevestig de bedoelde Google-identiteit en probeer het één keer opnieuw.
• Een account, property of stream ontbreekt: Bevestig de vereiste toegang en Editor-machtiging voor het maken, en selecteer daarna Vernieuwen zodra een recent gemaakte of gedeelde bron beschikbaar wordt.
• De property wordt verbonden 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, geschatte tijd 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 geschikte door de gebruiker geautoriseerde GA4-verbinding. Een door Atoms gemaakte 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 Search Console-property met URL-prefix, niet op een domeinproperty. Als automatische verificatie niet beschikbaar is omdat de GA4-instelling door Atoms wordt beheerd of omdat niet aan een Google-vereiste 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.