- Stap 1: Een nieuw Google Cloud Console-project maken en BigQuery aanzetten
- Stap 2: Uw project voorbereiden op BigQuery Export
- Stap 3: BigQuery koppelen aan Google Analytics 4-property's
- Een koppeling met BigQuery verwijderen
- Limieten voor BigQuery Export
- Gegevens filteren
- Prijzen en facturering
- Wanneer er gegevens worden getoond
- Redenen voor koppelingsfouten
- Redenen voor fouten met exporteren
- Gerelateerde bronnen
Stap 1: Een Google API Console-project maken en BigQuery aanzetten
- Log in bij de Google Cloud Console.
- Maak een nieuw Google Cloud Console-project of selecteer een bestaand project.
- Navigeer naar de tabel met API's.
Open linksboven het menu Navigatie, klik op API's en services en klik op Bibliotheek. - Activeer BigQuery.
Klik onder Google Cloud API's op BigQuery API. Klik op de volgende pagina op Aanzetten. - Als hierom wordt gevraagd, leest u de Servicevoorwaarden en gaat u ermee akkoord.
Stap 2: Uw project voorbereiden op BigQuery Export
U kunt Google Analytics-gegevens kosteloos exporteren naar de BigQuery-sandbox (er zijn sandbox-limieten van toepassing).
Meer informatie over hoe u upgradet vanaf de sandbox en over BigQuery-prijzen
Stap 3: Een Google Analytics 4-property aan BigQuery koppelen
Als u de eerste 2 stappen heeft afgerond, kunt u BigQuery Export aanzetten op de pagina Beheerder in Google Analytics.
Voor BigQuery Export gelden dezelfde verzamelings- en configuratielimieten als voor Google Analytics. Als u uw limieten wilt verhogen, kunt u uw property upgraden naar 360.
- In Beheerder klikt u onder Productkoppelingen op BigQuery-koppelingen.
De link Vorige opent de laatste Analytics-property waartoe u toegang heeft gehad. U kunt de property wijzigen met de propertykiezer.
- U moet bewerker of hoger zijnop propertyniveau omom een Analytics-property aan BigQuery te koppelen.
- Gebruik ook een e-mailadres met de toegang EIGENAAR voor het BigQuery-project (ga naar Rechten hieronder voor gedetailleerde toegangsvereisten).
- Klik op Koppelen.
- Klik op Een BigQuery-project kiezen om een lijst met projecten te tonen waartoe u toegang heeft.
Als u Analytics en Firebase heeft gekoppeld (of dat van plan bent), kunt u ook exporteren naar hetzelfde Cloud-project, zodat u makkelijker kunt samenwerken met andere Firebase-gegevens. - Selecteer een project in de lijst en klik op Bevestigen.
- Selecteer een locatie voor de gegevens. (Als uw project al een dataset heeft voor de Analytics-property, kunt u deze optie niet instellen.)
- Klik op Volgende.
- Kies Gegevensstreams en gebeurtenissen instellen om te selecteren welke gegevensstreams u in de export wilt opnemen en welke specifieke gebeurtenissen u ervan wilt uitsluiten. U kunt gebeurtenissen uitsluiten door op Toevoegen te klikken om een keuze te maken uit een lijst met bestaande gebeurtenissen of door op Gebeurtenis specificeren op naam te klikken om bestaande gebeurtenissen te selecteren op naam of om gebeurtenisnamen op te geven die nog niet worden verzameld in de property.
- Klik op Gereed.
- Kies Advertentie-ID's opnemen voor mobiele app-streams als u advertentie-ID's wilt opnemen.
- Selecteer een of beide opties voor Dagelijks (1 keer per dag) of Streaming (doorlopend). Voor Analytics 360-property's kunt u ook Dagelijks nieuw selecteren.
- Klik op Volgende.
- Controleer de instellingen en klik op Sturen.
Rechten
getIamPolicy/setIamPolicy-rechten voor projecten en get/enable-rechten voor services
EIGENAAR is een superset van deze rechten.Als u een BigQuery-koppeling wilt maken, heeft u minimaal de volgende rechten nodig:
resourcemanager.projects.get- Het project ophalen
resourcemanager.projects.getIamPolicy- Een lijst met rechten ophalen
resourcemanager.projects.setIamPolicy- Controleren of een gebruiker rechten heeft om de koppeling in dit project te maken
serviceusage.services.enable- De BigQuery API aanzetten
serviceusage.services.get- Controleren of de BigQuery API aanstaat
Het serviceaccount bevestigen
Als u Analytics en BigQuery koppelt, wordt tijdens dat proces het volgende serviceaccount gemaakt:
firebase-measurement@system.gserviceaccount.com
Ga na of het account is toegevoegd als lid van het project en de rol van BigQuery-gebruiker (roles/bigquery.user) heeft gekregen.
Als u eerder BigQuery Export heeft ingesteld om uw serviceaccount de rol Bewerker te geven voor het Google Cloud-project, kunt u die rol beperken tot BigQuery-gebruiker. Ontkoppel Analytics en koppel het daarna opnieuw aan uw BigQuery-project als u de rol voor het serviceaccount wilt wijzigen. Ontkoppel eerst Analytics en BigQuery, en verwijder het serviceaccount met de rol Bewerker. Koppel daarna Analytics en BigQuery opnieuw aan de hand van de bovenstaande instructies om het nieuwe serviceaccount te maken met de juiste rechten voor het project.
Nadat u het account opnieuw heeft gekoppeld, zorgt u dat het serviceaccount de rol Eigenaar (bigquery.dataOwner) heeft voor de bestaande exportdataset. U doet dit door het toegangsbeleid van de dataset te bekijken.
Regio's wijzigen
Als u de verkeerde regio kiest en deze moet wijzigen nadat u de koppeling heeft gemaakt, doet u het volgende:
- Verwijder de koppeling met BigQuery (zie hieronder).
- Maak een back-up van de gegevens in een andere dataset in BigQuery (verplaatsen of kopiëren).
- Verwijder de oorspronkelijke dataset. Noteer de naam: deze heeft u nodig in de volgende stap.
- Maak een nieuwe dataset met dezelfde naam als de dataset die u net heeft verwijderd en selecteer de locatie voor de gegevens.
- Deel de nieuwe dataset met firebase-measurement@system.gserviceaccount.com en geef het serviceaccount de rol BigQuery-gegevenseigenaar.
- Kopieer de back-upgegevens naar de nieuwe dataset.
- Herhaal de bovenstaande procedure om een nieuwe koppeling te maken met BigQuery.
Nadat u de locatie heeft gewijzigd, is er een lacune in uw gegevens ontstaan: In de tijd tussen het moment dat de bestaande koppeling wordt verwijderd en de nieuwe koppeling wordt gemaakt, vinden er geen streaming en dagelijkse exports van gegevens plaats.
Een koppeling met BigQuery verwijderen
- In Beheerder klikt u onder Productkoppelingen op BigQuery-koppelingen.
De link Vorige opent de laatste Analytics-property waartoe u toegang heeft gehad. U kunt de property wijzigen met de propertykiezer.U moet bewerker of hoger zijnop propertyniveau omom een koppeling met BigQuery te verwijderen.
- Klik op de rij voor de koppeling.
- Klik rechtsboven op
> Verwijderen.
> Verwijderen.Limieten voor BigQuery Export
Voor standaard GA4-property's geldt een BigQuery Export-limiet van 1 miljoen gebeurtenissen voor dagelijkse (batch)exports. Er geldt geen limiet voor het aantal gebeurtenissen voor Streaming-export. Als uw property de exportlimiet consequent overschrijdt, wordt de dagelijkse BigQuery-export onderbroken en worden exports van eerdere dagen niet opnieuw verwerkt.
Voor Analytics 360-property's bevat de dagelijkse nieuwe export alle gegevensvelden en -kolommen die in de dagelijkse export worden gebruikt, waaronder waargenomen gegevens over gebruikersattributie en advertentievertoningen. Meer informatie over de dagelijkse nieuwe export.
Bewerkers en beheerders van property's krijgen een e-mailmelding telkens wanneer een property die ze beheren, de daglimiet overschrijdt. In die melding staat wanneer de export wordt onderbroken als er geen actie wordt ondernomen. Als een standaardproperty de daglimiet van 1 miljoen gebeurtenissen aanzienlijk overschrijdt, kan Analytics de dagelijkse exports bovendien onmiddellijk onderbreken. Als u een melding krijgt, gebruikt u de opties voor gegevensfiltering (export van gegevensstreams en gebeurtenisuitsluiting) om de hoeveelheid gebeurtenissen die elke dag worden geëxporteerd, te verminderen en ervoor te zorgen dat de dagelijkse export blijft werken.
Meer informatie over de hogere limieten die beschikbaar zijn voor 360-property's
Gegevens filteren
U kunt specifieke gegevensstreams en gebeurtenissen uitsluiten van de export om de grootte van de export te beperken of om alleen relevante gebeurtenissen naar BigQuery te exporteren.
Gegevensstreams en gebeurtenissen uitsluiten tijdens het koppelingsproces
Als u tijdens het koppelingsproces de gegevensstreams selecteert die u wilt exporteren, kunt u ook gebeurtenissen selecteren die u wilt uitsluiten van de export. Zie stap 9 in het koppelingsproces.
Gegevensstreams of gebeurtenissen toevoegen of verwijderen nadat u de koppeling heeft ingesteld
Nadat u de BigQuery-koppeling heeft ingesteld, kunt u gegevensstreams toevoegen aan of verwijderen uit gebeurtenissen, en gebeurtenissen toevoegen aan of verwijderen uit de lijst met uitzonderingen.
- In Beheerder klikt u onder Productkoppelingen op BigQuery-koppelingen.
De link Vorige opent de laatste Analytics-property waartoe u toegang heeft gehad. U kunt de property wijzigen met de propertykiezer.
- U moet bewerker of hoger zijnop propertyniveau omom gegevensstreams en gebeurtenissen toe te voegen of te verwijderen.
- Gebruik ook een e-mailadres met de toegang EIGENAAR voor het BigQuery-project.
- Klik op de rij voor het project waarvan u de koppeling wilt aanpassen.
- Klik onder Gegevensstreams en gebeurtenissen op Gegevensstreams en gebeurtenissen tonen.
- Onder Te exporteren gegevensstreams kunt u aanvullende gegevensstreams selecteren om bestaande gegevensstreams te exporteren of uit de lijst te verwijderen.
- Klik in de lijst Gebeurtenissen die moeten worden uitgesloten op Toevoegen om een keuze te maken uit een lijst met bestaande gebeurtenissen. U kunt ook op Gebeurtenis specificeren op naam klikken om bestaande gebeurtenissen op naam te kiezen of om gebeurtenisnamen op te geven die nog niet worden verzameld in de property.
- Als u een gebeurtenis uit de lijst wilt verwijderen, klikt u op het minteken aan het einde van die rij.
Prijzen en facturering
Voor het gebruik van BigQuery worden kosten in rekening gebracht. Hierbij spelen 2 prijscomponenten een rol: de kosten voor opslag en de kosten voor verwerking van query's. Neem de prijstabel door en krijg meer informatie over de verschillen tussen interactieve en batchzoekopdrachten.
U moet een geldige betaalmethode instellen in de Google Cloud Platform Console voordat de export kan worden uitgevoerd. Als de export wordt onderbroken als gevolg van een ongeldige betaalmethode, kunnen we de gegevens voor deze periode niet opnieuw exporteren.
U kunt Analytics-gegevens ook kosteloos exporteren naar de BigQuery-sandbox, maar houd er rekening mee dat er sandbox-limieten van toepassing zijn.
Wanneer er gegevens worden getoond
Nadat de koppeling tot stand is gebracht, komt de gegevensstroom naar uw BigQuery-project binnen 24 uur op gang. Als u dagelijkse export aanzet, wordt 1 bestand per dag met de gegevens van de vorige dag geëxporteerd (meestal 's morgens vroeg in de tijdzone die u heeft ingesteld voor rapportage).
Redenen voor koppelingsfouten
De koppeling met BigQuery kan om een van de volgende 2 redenen mislukken:
- Uw organisatiebeleid verbiedt exporteren naar de Verenigde Staten. Als u de Verenigde Staten heeft gekozen als de locatie van uw gegevens, kiest u een andere locatie.
- Uw organisatiebeleid verbiedt serviceaccounts van het domein waarvan u gegevens wilt exporteren. In dit geval moet u het beleid van uw organisatie aanpassen.
Redenen voor fouten met exporteren
| Mislukt | Oorzaak | Resultaat |
|---|---|---|
| Geen serviceaccount | Geen serviceaccount in uw Cloud-project met de rol Actieve gebruiker. | Analytics kan geen tabellen maken. Exporteren mislukt. |
| Robotaccount is verwijderd na installatie | Een gebruiker van het Cloud-account heeft het door Google Analytics geïnstalleerde robotserviceaccount verwijderd. | Analytics kan geen tabellen meer maken. Alle exports zijn gestopt. |
| Organisatiebeleid conflicteert met BigQuery Export | Een gebruiker in het Cloud-project heeft een organisatiebeleid gemaakt waardoor Analytics geen gegevens kan exporteren. Er kunnen beleidsregels van toepassing zijn waardoor u geen BigQuery-tabellen kunt maken of niet naar tabellen kunt schrijven. Beleidsmatig kan er ook bezwaar zijn tegen de regio van gegevensopslag. | Tabel wordt niet gemaakt, of wel gemaakt en snel verwijderd (na ongeveer 30 minuten). |
| De gebruiker heeft de factureringsinstellingen gewijzigd | Een gebruiker in het Cloud-project stapt over van de kosteloze versie van BigQuery naar de betaalde. Hoewel dit normaal gesproken werkt, kunnen er fouten optreden, bijvoorbeeld als het project al groter is dan 10 GB (sandbox-limiet). In de praktijk kan de export mislukken. | Tabellen worden niet ingevuld. |
| Quotum voor Cloud-project overschreden | Cloud heeft eindige resources voor de meeste projecten. U kunt het opslagquotum van BigQuery overschrijden en dan geen gegevens meer schrijven. Dit quotum is klein voor kosteloze projecten (10 GB). | Tabellen worden niet ingevuld. |
| Gebruiker wijzigt de tijdzone van de property | Tijdens de export wordt er elke 24 uur een momentopname gemaakt van een property op basis van de tijdzone van de property. Als de tijdzone wordt gewijzigd, kan de exportperiode op een bepaalde dag korter of langer worden (bijv. 1 uur korter worden als de tijdzone wordt gewijzigd van Midden-Europese tijd naar West-Europese tijd). In beide gevallen krijgt de gebruiker een ongebruikelijk aantal gebeurtenissen te zien. | 1 dag met een ongewoon aantal gebeurtenissen. Algemene verwarring bij gebruikers. |
Support
In het geval van problemen met BigQuery, zoals facturering, kunt u contact opnemen met Google Cloud-support.
Gerelateerde bronnen
BigQuery Export
Raadpleeg de documentatie voor BigQuery Export voor meer informatie over exporteren en voor een voorbeeld van een dataset.