[GA4] Offline gebeurtenissen importeren

Over gegevens van offline gebeurtenissen

U kunt offline gebeurtenissen importeren van bronnen die geen internetverbinding hebben of die realtime verzameling van gebeurtenissen via de SDK's of Measurement Protocol niet ondersteunen. Nadat u gebeurtenissen heeft geüpload, worden ze verwerkt alsof ze zijn verzameld via onze SDK's. We gebruiken het tijdstempel dat u heeft opgegeven of, als u geen tijdstempel heeft opgegeven, het tijdstip van uploaden.

U kunt elke gebeurtenis importeren die overeenkomt met de gebeurtenissen die Analytics automatisch verzamelt of met de gebeurtenissen die we aanbevelen voor verschillende branches, of elke aangepaste gebeurtenis, parameter of gebruikersproperty die correct is gevormd. Meer informatie

Als u deze gegevens wilt verwijderen, moet u een verzoek voor gegevensverwijdering of gebruikersverwijdering indienen.

Hoe de import van offline gebeurtenisgegevens werkt

Als u offline gebeurtenissen wilt importeren, maakt u een csv-bestand dat overeenkomt met het gebeurtenisschema van Analytics. Bekijk de voorbeeldtemplate hieronder.

De aangepaste dimensies maken

Als u waarden importeert voor dimensies die nog niet in Analytics bestaan en u deze gegevens in rapporten wilt bekijken, maakt u die dimensies voordat u de gegevens uploadt. Meer informatie

Als u de aangepaste dimensies heeft gemaakt, duurt het maximaal 4 uur voordat de gegevens die u importeert, door Analytics kunnen worden herkend. (U kunt bevestigen of de aangepaste dimensies zijn verwerkt door een verkenning te openen en te controleren of de dimensies beschikbaar zijn in de dimensiekiezer.)

Een csv-bestand maken

Maak een csv-bestand met gebeurtenisgegevens op basis van onderstaande template.

Gegevens uploaden

De algemene uploadprocedure wordt beschreven in Over Gegevens importeren.

Wanneer u de gegevensbron maakt, selecteert u Offline gebeurtenisgegevens.

Voor offline gebeurtenissen worden geïmporteerde velden automatisch toegewezen aan Analytics-velden.

Nadat u de gegevens heeft geüpload, kan het 24 uur duren voordat Analytics de gegevens beschikbaar heeft gemaakt in rapporten, doelgroepen en verkenningen.

Als u een gegevensbron verwijdert uit de gegevensuploadservice, worden de geüploade waarden niet verwijderd. Indien nodig, en zoals bij alle andere methoden voor gegevensverzameling het geval is, moet u dit mogelijk opvolgen en een gegevensverwijderingsverzoek indienen om gegevens te verwijderen die zijn geüpload via Gegevens importeren.

Details van gegevensbron

Legenda

Bereik Gebeurtenis
Verplichte velden

[een van] client_id of app_instance_id

[een van] tag_id of firebase_app_id

(tag_id en client_id) of (firebase_app_id en app_instance_id)

event_name

Geïmporteerde gegevens

U kunt gegevens van gebeurtenissen, parameters, items of gebruikersproperty's uploaden met de volgende kopindelingen:

  • timestamp_micros (optioneel; moeten binnen 72 uur na de gebeurtenis liggen, tijdstempel van upload indien niet opgegeven)
  • user_id (optioneel, maar aanbevolen wanneer deze beschikbaar is)
  • toestemmingssignalen (optioneel, maar sterk aanbevolen wanneer deze beschikbaar zijn. Meer informatie)
  • event_param.<xxxxx> (importeer parameters met elke willekeurige naam)
  • user_property.<yyyyy> (importeer gebruikersproperty's met elke willekeurige naam)
  • item<x>.<item_param> (bijvoorbeeld: item2.item_name)
Opmerkingen Bij de import van offline gebeurtenissen mag u geen persoonlijk identificeerbare informatie uploaden of koppelen. Meer informatie

 

Template

Hier ziet u een voorbeeld van een csv-template voor gebeurtenisgegevens. Als u handmatig uploadbestanden moet maken, kunt u dit voorbeeld gebruiken als richtlijn.

measurement_id client_id user_id timestamp_micros ad_personalization ad_user_data event_name event_param.page_location event_param.page_referrer event_param.page_title event_param.screen_resolution user_property.color_score event_param.foo item1.item_id item1.item_name item1.category item1.item_list_id item1.item_list_name item1.index item1.quantity item1.price item2.item_id item2.item_name item2.quantity item2.price event_param.transaction_id event_param.value event_param.tax event_param.shipping event_param.currency
G-12345ABCDE 1234567890.0987654321 1000001 1609488000000000 TOEGEWEZEN GEWEIGERD page_view /home referrer.com Homepage 1600x900 blauw 1-2                                  
G-12345ABCDE 1234567890.0987654321 1000001 1609488060000000 GEWEIGERD GEWEIGERD page_view /video_detail   Videoviewer 1600x900 blauw 1-4                                  
G-12345ABCDE 1234567890.0987654321 1000001 1609488120000000 GEWEIGERD TOEGEWEZEN video_play /video_detail   Videoviewer 1600x900 blauw                                    
G-67890ABCDE 2345678901.9876543210 1000002 1609574400000000 GEWEIGERD TOEGEWEZEN page_view /home referrer.com Homepage 2560x1440 groen 2-2                                  
G-67890ABCDE 2345678901.9876543210 1000002 1609574460000000 GEWEIGERD TOEGEWEZEN page_view /product_detail   Productdetail 2560x1440 groen 2-16                                  
G-67890ABCDE 2345678901.9876543210 1000002 1609574520000000 TOEGEWEZEN TOEGEWEZEN page_view /product_detail   Productdetail 2560x1440 groen                                    
G-67890ABCDE 121212.3434 1000003 1609574520000000 TOEGEWEZEN TOEGEWEZEN page_view /camp_lp_1 referrer.com Zomeruitverkoop! 2560x1440 blauw 3-1                                  
G-67890ABCDE 121212.3434 1000003 1609660801000000 TOEGEWEZEN GEWEIGERD view_item_list /camp_lp_1   Zomeruitverkoop! 2560x1440 blauw   123abc red_shoe schoen list_123 colorful_shoes 1 1   234bcd blue_shoe 1 30,00          
G-67890ABCDE 121212.3434 1000003 1609660860000000 TOEGEWEZEN TOEGEWEZEN select_item /camp_lp_1   Zomeruitverkoop! 2560x1440 blauw   234bcd blue_shoe schoen list_123 colorful_shoes 2 1 30,00                  
G-67890ABCDE 121212.3434 1000003 1609660870000000 TOEGEWEZEN TOEGEWEZEN page_view /product_detail   Productdetail 2560x1440 blauw 3-5 234bcd blue_shoe schoen list_123 colorful_shoes 2 1 30,00                  
G-67890ABCDE 121212.3434 1000003 1609660930000000 GEWEIGERD TOEGEWEZEN view_item /product_detail   Productdetail 2560x1440 blauw 3-17 234bcd blue_shoe schoen list_123 colorful_shoes 2 1 30,00                  
G-67890ABCDE 121212.3434 1000003 1609660950000000 GEWEIGERD GEWEIGERD add_to_cart /product_detail   Productdetail 2560x1440 blauw   234bcd blue_shoe schoen list_123 colorful_shoes 2 1 30,00                  
G-67890ABCDE 121212.3434 1000003 1609660970000000 TOEGEWEZEN GEWEIGERD begin_checkout /product_detail   Productdetail 2560x1440 blauw   234bcd blue_shoe schoen list_123 colorful_shoes 2 1 30,00                  
G-67890ABCDE 121212.3434 1000003 1609660975000000 TOEGEWEZEN GEWEIGERD page_view /purchase_confirmation   Gefeliciteerd. 2560x1440 blauw 3-21 234bcd blue_shoe schoen list_123 colorful_shoes 2 1 30,00                  
G-67890ABCDE 121212.3434 1000003 1609660980000000 TOEGEWEZEN GEWEIGERD purchase /purchase_confirmation   Gefeliciteerd. 2560x1440 paars 3-21 234bcd blue_shoe schoen list_123 colorful_shoes 2 1 30,00         t12345 37,49 2,50 4,99 USD

 

Limieten

Gebeurtenissen, parameters en gebruikersproperty's die gereserveerde namen gebruiken, worden afgekeurd.

Parameters voor itemgebeurtenissen (zoals item_list_name) zonder waarden worden afgekeurd. Parameters voor itemgebeurtenissen worden ondersteund voor een aanbevolen subset van gebeurtenissen (bijvoorbeeld E-commerce, Vacatures en Reizen).

Gebeurtenis- en parameternamen moeten aan de volgende regels voldoen:

  • Gebeurtenissen mogen maximaal 25 parameters hebben.
  • Gebeurtenissen mogen maximaal 25 gebruikersproperty's hebben.
  • Namen voor gebruikersproperty's mogen maximaal 24 tekens bevatten.
  • Waarden van gebruikersproperty's mogen maximaal 36 tekens bevatten.
  • Gebeurtenisnamen mogen maximaal 40 tekens hebben, mogen alleen alfanumerieke tekens en underscores bevatten en moeten beginnen met een alfabetisch teken.
  • Parameternamen (inclusief itemparameters) mogen maximaal 40 tekens hebben, mogen alleen alfanumerieke tekens en underscores bevatten en moeten beginnen met een alfabetisch teken.
  • Parameterwaarden (waaronder itemparameterwaarden) mogen maximaal 100 tekens bevatten.

Was dit nuttig?

Hoe kunnen we dit verbeteren?
Zoeken
Zoekopdracht wissen
Zoekfunctie sluiten
Hoofdmenu
16322351945269640633
true
Zoeken in het Helpcentrum
true
true
true
true
true
69256
false
false