[GA4] Over Gegevens importeren

Gegevens uit externe bronnen uploaden en samenvoegen met uw Analytics-gegevens

Waarom 'Gegevens importeren' gebruiken?

Elk bedrijfssysteem dat u gebruikt, produceert eigen gegevens. Uw CRM-systeem kan informatie als loyaliteitsbeoordelingen, lifetime values en productvoorkeuren van klanten bevatten. Als u een webuitgever bent, kan uw contentmanagementsysteem dimensies zoals auteur en artikelcategorie opslaan. Als u een e-commercebedrijf heeft, slaat u kenmerken van artikelen op zoals prijs, stijl en maat.

Bovendien gebruikt u Analytics om verkeer en prestaties te meten voor uw websites en apps.

Meestal is deze set gegevens opgeslagen in een eigen silo, die niet verbonden is met de andere gegevens. Met 'Gegevens importeren' kunt u al deze gegevens volgens een vastgesteld schema samenvoegen in Analytics om deze silo's te verwijderen, nieuwe inzichten te verkrijgen en uw gegevens breed toegankelijk te maken.

Hoe 'Gegevens importeren' werkt

Gegevens uploaden

U uploadt csv-bestanden met externe gegevens naar een Analytics-property. U kunt die csv-bestanden exporteren vanuit een offline zakelijke tool, zoals uw CRM- of CMS-systeem, of voor een kleinere hoeveelheid gegevens door de bestanden handmatig te maken in een teksteditor of spreadsheet.

Met 'Gegevens importeren' worden de offline gegevens die u uploadt, samengevoegd met de gebeurtenisgegevens die Analytics verzamelt. Op basis van de geïmporteerde gegevens kunnen rapporten, vergelijkingen en doelgroepen worden verbeterd. Hierdoor krijgt u een vollediger beeld van alle online en offline activiteit.

Gegevens samenvoegen

Gegevens worden op 2 verschillende manieren samengevoegd, afhankelijk van het type geïmporteerde gegevens:

Verzamelings-/verwerkingstijd: Uw geïmporteerde gegevens worden samengevoegd met Analytics-gegevens terwijl de Analytics-gegevens worden verzameld en verwerkt alsof ze worden verzameld met de gebeurtenis. De samengevoegde gegevens worden in Analytics-verzameltabellen gezet. De geïmporteerde gegevens worden niet samengevoegd met historische Analytics-gegevens (gegevens die al zijn verwerkt). Als u het geïmporteerde gegevensbestand verwijdert, vindt er geen verdere samenvoeging plaats. Samenvoegingen die al plaats hebben gevonden, blijven wel bestaan.

Gebruikersgegevens en gegevens over offline gebeurtenissen worden samengevoegd op het moment dat de gegevens worden verzameld of verwerkt.

Rapportage-/querytijd: Uw geïmporteerde gegevens worden samengevoegd met Analytics-gegevens als u een rapport opent en Analytics een query uitvoert voor de rapportgegevens. Dit type samenvoeging is tijdelijk: als u het geïmporteerde gegevensbestand verwijdert, vinden er geen verdere samenvoegingen plaats. Ook zijn de samengevoegde gegevens niet meer toegankelijk in Analytics.

Gegevens over kosten, artikelen en aangepaste gebeurtenissen worden samengevoegd op het moment van de rapportage of query.

Gegevens op het moment van de rapportage of query zijn niet beschikbaar wanneer u doelgroepen maakt in Analytics of segmenten maakt in Verkenningen.

Als u gegevens importeert, blijven eerder geïmporteerde gegevens behouden terwijl nieuwe geïmporteerde gegevens worden toegevoegd. Als de geïmporteerde gegevens dezelfde sleutels hebben als eerder geïmporteerde gegevens, worden de gegevens overschreven.

Typen metadata die u kunt importeren

Metadata

Als u metadata importeert, worden gegevens toegevoegd die al zijn verzameld en verwerkt door een property. Metadata worden meestal opgeslagen in een aangepaste dimensie of statistiek. In sommige gevallen wilt u de al verzamelde standaardgegevens misschien overschrijven (bijvoorbeeld als u een productcatalogus importeert met geüpdatete categorieën).

U kunt de volgende gegevenstypen importeren:

Kostengegevens: gegevens met betrekking tot klikken, kosten en vertoningen in advertentienetwerken van derden (niet-Google)
Artikelgegevens: metadata van producten, zoals maat, kleur, stijl of andere productgerelateerde dimensies
Gebruikersgegevens: Metadata van gebruikers, zoals een loyaliteitspercentage of lifetime value van de klant, die u kunt gebruiken om segmenten en remarketinglijsten te maken
Offline gebeurtenissen: offline gebeurtenissen van bronnen die geen internetverbinding hebben of die geen realtime verzameling van gebeurtenissen ondersteunen
Aangepaste gebeurtenisgegevens: u kunt metadata van gebeurtenissen importeren via standaardvelden en/of aangepaste dimensies

Limieten

Grootte van gegevensbron	1 GB
Dagelijkse uploads	120 uploads per property per dag

Gegevenstype import	Limiet aantal gegevensbronnen per property	Opslaglimiet per gegevenstype
Kostengegevens	Maximaal 5	1 GB voor alle importbronnen
Itemgegevens	Maximaal 5	1 GB voor alle importbronnen
Gebruikersgegevens	Maximaal 10	Niet van toepassing
Offline gebeurtenissen	Maximaal 10	Niet van toepassing
Aangepaste gebeurtenisgegevens	Maximaal 5	1 GB voor alle importbronnen

U vindt het huidige quotumgebruik in het product via de knop Informatie over quotum.

Gegevens importeren

Als u gegevens importeert, maakt u een gegevensbron. Een gegevensbron is de combinatie van het csv-bestand dat u wilt uploaden en een toewijzing van bestaande Analytics-velden aan de velden in uw csv-bestand. Voorbeeld:

Upload geen bestand met dubbele sleutels (bijvoorbeeld 2 velden met de naam user_id)

Neem dit artikel door voor meer informatie over gegevensbronnen

Vereisten voor het gebruik van SFTP om gegevens te uploaden

Als u in stap 5 de SFTP-optie wilt gebruiken, gaat u na of uw SFTP-server de hostsleutelalgoritmen ssh-rsa en ssh-dss ondersteunt. Meer informatie over hoe u kunt verifiëren welke hostsleutelalgoritmen u gebruikt en hoe u de URL van de SFTP-server opmaakt

Het importproces starten

In Beheerder klikt u onder Verzameling en wijziging van gegevens op Gegevens importeren.

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 het importeerproces te starten.
Maak een nieuwe gegevensbron of selecteer een bestaande gegevensbron. (Controleer de volgende gedeelten.)

Een nieuwe gegevensbron maken

Klik op Gegevensbron maken.
Voer een naam in voor uw gegevensbron.
Selecteer het gegevenstype:
- Kostengegevens (alleen importmodus 'op het moment van de query')
- Itemgegevens (rapportage/importmodus 'op het moment van de query')
- Gebruikersgegevens op basis van gebruikers-ID (verzameling/importmodus 'op het moment van de verwerking')
- Gebruikersgegevens op basis van client-ID (verzameling/importmodus Op het moment van de verwerking)
- Gegevens over offline gebeurtenissen (verzameling/importmodus 'op het moment van de verwerking')
- Aangepaste gebeurtenisgegevens (rapportage/importmodus 'op het moment van de query')
Klik op Voorwaarden bekijken als hierom wordt gevraagd. Deze vraag wordt getoond als u apparaat- of gebruikersgegevens importeert.
Voer een van de volgende acties uit:
- Selecteer Handmatige csv-upload, selecteer het csv-bestand op uw computer en klik dan op Openen.
Of
- Selecteer SFTP.
- Gebruikersnaam SFTP-server: vul uw gebruikersnaam voor uw SFTP-server in.
- URL SFTP-server: vul de URL voor uw SFTP-server in.
- Frequentie: kies de uploadfrequentie (Dagelijks, Wekelijks, Maandelijks).
- Begintijd: selecteer het tijdstip waarop de upload moet starten.
- Nadat de gegevensbron is gemaakt, is de openbare sleutel voor uw SFTP-server zichtbaar in de interface waar u de gegevensbron maakt. De sleutel is ook beschikbaar in de details van de gegevensbron (raadpleeg hieronder).
Klik op Volgende om door te gaan naar het toewijzingsvenster.
Selecteer de Analytics-velden en de geïmporteerde velden die u aan elkaar wilt toewijzen. Bewerk zo nodig de veldnamen.
Klik op Importeren.

Gegevens uploaden naar een bestaande gegevensbron

Klik in de rij voor een bestaande gegevensbron op Nu importeren.
Als de gegevensbron is ingesteld voor csv-import, selecteert u het csv-bestand dat u wilt importeren en klikt u op Openen.

Het csv-bestand moet dezelfde velden of subsets van velden bevatten als het originele bestand. Als u verschillende velden voor hetzelfde gegevenstype wilt importeren, moet u de bestaande gegevensbron verwijderen en een nieuwe gegevensbron maken.

Gegevens die in de bronproperty worden geïmporteerd, worden automatisch geëxporteerd naar zowel de overzichts- als de subproperty's.

SFTP-hostsleutelalgoritmen verifiëren, URL van SFTP-server opmaken

Algoritmen verifiëren

U kunt op verschillende manieren verifiëren of uw SFTP-server het hostsleutelalgoritme ssh-rsa of ssh-dss gebruikt. U kunt bijvoorbeeld uw serverlogboeken controleren met de OpenSSH-client voor externe aanmelding. Gebruik hiervoor de volgende opdracht:

ssh -vv <naam van uw sftp-server>

Als uw server een van deze algoritmen ondersteunt, vindt u als het goed is een regel als deze in uw serverlogboek:

debug2: host key algorithms: rsa-sha2-512, rsa-sha2-256, ssh-rsa

URL van SFTP-server opmaken

Als de URL van de SFTP-server niet de juiste indeling heeft, mislukt de import met een interne foutmelding.

Voor de URL van een SFTP-server moet u meestal met 3 onderdelen rekening houden voor de upload van gegevensimportbestanden: Voorbeeld:

sftp://example.com//home/jon/upload.csv bestaat uit de volgende onderdelen:

Domein: example.com
Homedirectory: //home/jon
Bestandspad: /upload.csv

In het bovenstaande voorbeeld bevindt het uploadbestand zich in de homedirectory.

U kunt het domeingedeelte van de URL op verschillende manieren opmaken, waarbij u de domeinnaam of het IPv4- of IPv6-adres van de server gebruikt, met of zonder poortnummer:

Domeinnaam: sftp://example.com
IPv4 (met poortnummer): sftp://142.250.189.4:1234
IPv4 (zonder poortnummer): sftp://142.250.189.4
IPv6 (met poortnummer): sftp://[2607:f8b0:4007:817::2004]:1234
IPv6 (zonder poortnummer): sftp://[2607:f8b0:4007:817::2004]

Als u het poortnummer niet opgeeft, is de standaardpoort 22.

U kunt de URL zowel met als zonder de homedirectory correct opmaken. In de volgende voorbeelden van correct opgemaakte URL's wordt een andere indeling gebruikt om het domein te bepalen. De voorbeelden bevatten poortnummers, maar u hoeft het poortnummer niet te gebruiken.

Homedirectory opnemen:
- sftp://example.com//home/jon/upload.csv (domeinnaam)
- sftp://142.250.189.4:1234//home/jon/upload.csv (IPv4 met poortnummer)
Homedirectory uitsluiten:
- sftp://example.com/upload.csv (domeinnaam)
- sftp://[2607:f8b0:4007:817::2004]:1234/upload.csv (IPv6 met poortnummer)

Als het uploadbestand in een subdirectory van uw homedirectory staat, heeft de URL een indeling zoals deze:

sftp://example.com//home/jon/data/upload.csv

In dit geval kunt u de volgende soorten indelingen gebruiken:

Homedirectory opnemen:
- sftp://example.com//home/jon/data/upload.csv
- sftp://142.250.189.4:1234//home/jon/data/upload.csv (IPv4 met poortnummer)
Homedirectory uitsluiten:
- sftp://example.com/data/upload.csv
- sftp://[2607:f8b0:4007:817::2004]:1234/data/upload.csv (IPv6 met poortnummer)

Is uw uploadbestand niet opgeslagen in de homedirectory (//home/jon) of een subdirectory hiervan (//home/jon/data), maar in de directory /foo/bar? Dan heeft de URL voor uw uploadbestand deze indeling:

sftp.example.com//foo/bar/upload.csv (//foo/bar vervangt de homedirectory)

Details van gegevensbronnen bekijken, uw openbare SFTP-sleutel ophalen, nieuwe gegevens importeren, een gegevensbron verwijderen

In Beheerder klikt u onder Verzameling en wijziging van gegevens op Gegevens importeren.

De link Vorige opent de laatste Analytics-property waartoe u toegang heeft gehad. U kunt de property wijzigen met de propertykiezer.
U moet de rol kijker of hoger hebbenop propertyniveau omom informatie over de gegevensbron te bekijken.
Klik in de rij voor de gegevensbron op .

U kunt de naam, het gegevenstype, de openbare sleutel en de geschiedenis van elke upload bekijken.

Openbare sleutel: De openbare SFTP-serversleutel die overeenkomt met een overeenkomende privésleutel die Analytics opslaat (en nooit deelt) die wordt gebruikt om een veilige, privéverbinding te garanderen tussen uw server en de Analytics-servers voor gegevensimport. Het is erg belangrijk dat u deze openbare sleutel autoriseert op uw server om te zorgen dat 'Gegevens importeren' veilig en betrouwbaar kan functioneren.
% geïmporteerd: Het aantal geïmporteerde rijen, gedeeld door het aantal rijen in het importbestand. 100% betekent dat alle rijen zijn geïmporteerd.
Overeenkomstpercentage: Het percentage sleutels in het importbestand dat in de afgelopen 90 dagen in uw property is gevonden. 100% betekent dat het nut en de relevantie van de gegevens optimaal zijn voor uw gegevens in de afgelopen 90 dagen.

Opmerking: het % geïmporteerd en overeenkomstpercentage zijn relevant voor de import van kosten-, artikel- en aangepaste gebeurtenisgegevens, maar zijn niet van toepassing op de import van gebruikersgegevens of de import van gegevens van offline gebeurtenissen.

Doe het volgende om nieuwe gegevens te importeren:

Klik op Nu importeren en kies het relevante csv-bestand op uw computer.

De gegevensbron verwijderen:

Klik op > Gegevensbron verwijderen.
Lees de verwijderingsmelding en klik op Gegevensbron verwijderen.

U kunt gegevens voor de verzamelings-/verwerkingstijd verwijderen, maar als u de gegevens wilt verwijderen die eerder zijn geüpload voor alle door Analytics verwerkte gebeurtenissen, moet u misschien ook een gebruiker of gebruikersproperty verwijderen. Als u een al geïmporteerd bestand verwijdert, worden de verwerkte gegevens die zijn gekoppeld aan gebeurtenissen die zijn verzameld sinds de import is afgerond, niet verwijderd. In dit artikel vindt u meer informatie over gegevensverwijderingsverzoeken.

Gereserveerde namen en voorvoegsels

De volgende voorvoegsels en namen voor gebeurtenissen, gebeurtenisparameters en gebruikersproperty's zijn gereserveerd voor gebruik in Analytics. Als u gegevens probeert te uploaden die een van de gereserveerde namen of voorvoegsels bevatten, worden die gegevens niet geüpload.

Voorbeeld:

Als u een gebeurtenis met een gereserveerde naam probeert te importeren, worden die gebeurtenis en de bijbehorende parameters niet geïmporteerd.
Als u een gebeurtenis met een geldige naam maar met een gereserveerde parameter probeert te importeren, wordt de gebeurtenis wel, maar de betreffende parameter niet geïmporteerd.

Gereserveerde gebeurtenisnamen

ad_activeview
ad_activeview
ad_exposure
ad_impression
ad_query
adunit_exposure
app_clear_data
app_install
app_remove
app_update
fout
first_open
first_visit
in_app_purchase
notification_dismiss
notification_foreground
notification_open
notification_receive
os_update
screen_view
session_start
user_engagement

Gereserveerde namen voor gebeurtenisparameters

firebase_conversion

Gereserveerde namen voor gebruikersproperty's

first_open_after_install
first_open_time
first_visit_time
last_deep_link_referrer
user_id

Gereserveerde voorvoegsels (van toepassing op gebeurtenisparameters en gebruikersproperty's)

ga_
google_
firebase_

Was dit nuttig?

Hoe kunnen we dit verbeteren?