[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.

    Kosten- en itemgegevens 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.

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)
  • Itemgegevens: metadata van producten, zoals maat, kleur, stijl of andere productgerelateerde dimensies
  • Gebruikersgegevens: metadata van gebruikers, zoals een loyaliteitsbeoordeling 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

Limieten

Totale opslag

10 GB (standaardproperty's)

1 TB (360-property's)

Grootte van gegevensbron 1 GB
Dagelijkse uploads

120 uploads per property per dag

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 dat dubbele sleutels bevat (bijvoorbeeld 2 velden met de naam user_id).

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. Bekijk 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

  1. Klik in de kolom Property op Gegevens importeren.
  2. Maak een nieuwe gegevensbron of selecteer een bestaande gegevensbron. (Zie de volgende gedeelten.)

Een nieuwe gegevensbron maken

  1. Klik op Gegevensbron maken.
  2. Voer een naam in voor uw gegevensbron.
  3. 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')
  4. Klik op Voorwaarden bekijken als hierom wordt gevraagd. Deze vraag wordt getoond als u apparaat- of gebruikersgegevens importeert.
  5. 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 (zie hieronder).
  6. Klik op Volgende om door te gaan naar het toewijzingsvenster.
  7. Selecteer de Analytics-velden en de geïmporteerde velden die u aan elkaar wilt toewijzen. Bewerk zo nodig de veldnamen.
  8. Klik op Importeren.

Gegevens uploaden naar een bestaande gegevensbron

  1. Klik in de rij voor een bestaande gegevensbron op Nu importeren.
  2. 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.

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, ziet 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, ziet de URL er ongeveer zo uit:

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

In dit geval kunt u de volgende typen 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 ziet de correct opgemaakte URL van uw uploadbestand er zo uit:

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

Informatie over gegevensbronnen bekijken, uw openbare SFTP-sleutel ophalen, nieuwe gegevens importeren, een gegevensbron verwijderen

  1. Klik in de kolom Property op Gegevens importeren.
  2. Klik in de rij voor de gegevensbron op en dan.

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.

Doe het volgende om nieuwe gegevens te importeren:

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

De gegevensbron verwijderen:

  1. Klik op Meer > Gegevensbron verwijderen.
  2. 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 (Meer informatie). 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.

 

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
  • error
  • 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?
false
Zoeken
Zoekopdracht wissen
Zoekfunctie sluiten
Google-apps
Hoofdmenu
2883707306682777132
true
Zoeken in het Helpcentrum
true
true
true
true
true
69256
false
false