Feldzuordnungen

Verwenden Sie die Zuordnungen in den Tabellen, um eine Datenerhebungsanfrage des Measurement Protocol (/mp/collect) dem entsprechenden IngestEventsRequest-Äquivalent in der Data Manager API zuzuordnen.

Authentifizierung

Für die Data Manager API sind OAuth-Anmeldedaten anstelle von api_secret erforderlich. Folgen Sie der Anleitung unter API-Zugriff einrichten, um neue Anmeldedaten zu generieren, die den Bereich der Data Manager API enthalten.

Anfragefelder

/mp/collect-Anfrage (Measurement Protocol) IngestEventsRequest (Data Manager API) Hinweise
measurement_id (Suchparameter) destinations Zuordnung zu product_destination_id für Web-Ereignisse Weitere Informationen finden Sie unter Zielfelder.
firebase_app_id (Suchparameter) destinations product_destination_id für App-Ereignisse zuordnen Weitere Informationen finden Sie unter Zielfelder.
api_secret (Suchparameter) Kein Äquivalent Unter API-Zugriff einrichten erfahren Sie, wie Sie Anfragen in der Data Manager API authentifizieren.
consent consent Auf ein Consent-Objekt festgelegt.
events events Legen Sie eine Liste von Event-Ressourcen fest. Weitere Informationen finden Sie im Abschnitt Ereignisfelder.
client_id events.client_id Erforderlich für Webereignisse.
app_instance_id events.app_instance_id Erforderlich für App-Ereignisse.
user_id events.user_id Optional. Eine eindeutige Kennung für einen Nutzer.
timestamp_micros events.event_timestamp Im Measurement Protocol kann dies auf Anfrageebene oder für ein einzelnes Ereignis angegeben werden. In der Data Manager API gibt es keinen Zeitstempel auf Anfrageebene. Legen Sie event_timestamp für jedes Ereignis auf den Zeitpunkt fest, zu dem das Ereignis eingetreten ist.
  • Wenn Sie das JSON-Format verwenden, legen Sie einen Wert im RFC 3339-Format fest.
  • Wenn Sie Protokollzwischenspeicher verwenden, verwenden Sie einen Timestamp und legen Sie die Felder seconds und (optional) nanoseconds fest.

Weitere Informationen finden Sie unter Zeitstempelformat.
user_properties events.user_properties

Legen Sie ein UserProperties-Objekt fest. Wenn Sie den Typ oder den Wert-Bucket des Nutzers senden, verwenden Sie das Feld customer_type bzw. customer_value_bucket von UserProperties. Erstellen Sie für andere Nutzereigenschaften ein separates UserProperty-Objekt, legen Sie die Felder property_name und value fest und fügen Sie es der Liste additional_user_properties hinzu.

Die Data Manager API unterstützt das Festlegen von Zeitstempeln für einzelne Nutzereigenschaften nicht. Zeitstempel, die mit Änderungen an Nutzereigenschaften verknüpft sind, werden aus dem Zeitstempel des Ereignisses (event_timestamp) abgeleitet.
user_data events.user_data Auf ein UserData-Objekt festgelegt. Weitere Informationen finden Sie unter Felder für Nutzer-IDs.
non_personalized_ads events.consent.ad_personalization Wenn non_personalized_ads true ist, setzen Sie ad_personalization auf CONSENT_DENIED.
user_location events.event_location Weitere Informationen finden Sie unter Felder für Nutzerstandort.
ip_override events.event_device_info.ip_address
device events.event_device_info Weitere Informationen finden Sie unter Gerätefelder.
user_agent events.event_device_info.user_agent
validation_behavior Kein Äquivalent Mit der Diagnose können Sie den Status Ihres Uploads sowie Fehler und Warnungen für einzelne Ereignisse während der nachgelagerten Verarbeitung abrufen. Wenn der IngestEventsRequest fehlschlägt (z. B. aufgrund fehlender Pflichtfelder), werden keine Ereignisse verarbeitet. Sie müssen den Fehler beheben und die Anfrage noch einmal senden. Weitere Informationen finden Sie unter API-Fehler verstehen.
/debug/mp/collect validate_only Legen Sie validate_only auf true fest, um Ereignisse zu validieren, ohne Daten aufzunehmen. Das funktioniert ähnlich wie beim Measurement Protocol-Validierungsserver.
Kein Äquivalent encoding Erforderlich für UserData-Uploads. Legen Sie den Wert auf Encoding fest, der für UserIdentifier-Werte verwendet wird.

Zielfelder

Mit dem Measurement Protocol werden Ereignisse direkt an einen bestimmten Datenstream gesendet. Dazu wird der Abfrageparameter measurement_id oder firebase_app_id verwendet.

In der Data Manager API wird ein Destination-Objekt verwendet, um anzugeben, wohin Daten gesendet werden sollen. Weitere Informationen zu Zielen finden Sie unter Ziele konfigurieren.

So ordnen Sie die Measurement Protocol-Felder den entsprechenden Feldern in einem Destination zu:

Measurement Protocol Destination (Data Manager API) Hinweise
measurement_id (Suchparameter) product_destination_id Auf die Mess-ID des Web-Datenstreams in Google Analytics festgelegt
firebase_app_id (Suchparameter) product_destination_id Auf die Firebase-App-ID des Google Analytics-App-Datenstreams festgelegt
Kein Äquivalent operating_account Legen Sie account_id auf die Google Analytics-Property-ID fest. Setze account_type auf GOOGLE_ANALYTICS_PROPERTY.
Kein Äquivalent login_account Legen Sie account_id auf die Google Analytics-Property-ID fest. Setze account_type auf GOOGLE_ANALYTICS_PROPERTY.

Ereignisfelder

Measurement Protocol events[] Event (Data Manager API) Hinweise
name event_name Wenn für event_name ein reservierter Name verwendet wird, lehnt die API das Ereignis mit dem Fehler INVALID_EVENT_NAME ab.
Kein Äquivalent event_source Legen Sie WEB fest, wenn das Ereignis über einen Webbrowser generiert wurde, und APP, wenn es über eine App generiert wurde.
Kein Äquivalent destination_references Erforderlich, wenn die Liste destinations auf Anfrageebene mehr als ein Google Analytics-Destination enthält. Fügen Sie einen Eintrag hinzu, um anzugeben, an welches Ziel das Ereignis gesendet werden soll.
timestamp_micros event_timestamp
  • Wenn Sie das JSON-Format verwenden, legen Sie einen Wert im RFC 3339-Format fest.
  • Wenn Sie Protocol Buffers verwenden, nutzen Sie ein Timestamp und legen Sie die Felder seconds und (optional) nanoseconds fest.

Weitere Informationen finden Sie unter Zeitstempelformat.
params.currency currency
params.value conversion_value
params.customer_type user_properties.customer_type Im Measurement Protocol wird der Parameter customer_type als Ereignisparameter festgelegt. Legen Sie den Wert in der Data Manager API im Feld customer_type des Objekts UserProperties für das Ereignis fest.
params.transaction_id transaction_id Erforderlich für einige Ereignisse und Anwendungsfälle. Weitere Informationen finden Sie unter Daten in Event-Objekte konvertieren.
params.items cart_data.items Weitere Informationen finden Sie unter Artikelfelder für Warenkorbdaten.
params.coupon cart_data.coupon_codes Verwenden Sie das Feld coupon_codes, um die Gutscheine anzugeben, die auf den Einkaufswagen angewendet wurden. Geben Sie nur einen Gutschein für Google Analytics an. Dies ist unabhängig von Gutscheinen auf Item-Ebene, die mit cart_data.items.additional_item_parameters für einzelne Artikel festgelegt werden können.
params.session_id additional_event_parameters Ordnen Sie einen Eintrag zu, bei dem parameter_name auf session_id festgelegt ist.
params.engagement_time_msec additional_event_parameters Ordnen Sie einen Eintrag zu, bei dem parameter_name auf engagement_time_msec festgelegt ist.
Andere params additional_event_parameters

Ordnen Sie andere Parameter als Liste von Objekten mit parameter_name und value zu.

Hinweis: Fügen Sie hier keine Einträge für transaction_id, currency oder value hinzu. Verwenden Sie stattdessen die Felder auf oberster Ebene in Event.

Felder für Nutzer-IDs

Measurement Protocol user_data UserIdentifier (Data Manager API) Hinweise
sha256_email_address[] email_address Legen Sie die formatierte und gehashte E-Mail-Adresse fest. Sie können die gehashte E-Mail-Adresse auch verschlüsseln.
sha256_phone_number[] phone_number Legen Sie die formatierte und gehashte Telefonnummer fest. Sie können die gehashte Telefonnummer auch verschlüsseln.
address[] address Auf ein AddressInfo-Objekt festgelegt. Folgen Sie den Formatierungs- und Hash-Richtlinien.
address[].sha256_first_name address.given_name Auf den formatierten und gehashten Vornamen festgelegt. Sie können auch den gehashten Vornamen verschlüsseln.
address[].sha256_last_name address.family_name Legen Sie den formatierten und gehashten Nachnamen fest. Sie können auch den gehashten Familiennamen verschlüsseln.
address[].country address.region_code
address[].postal_code address.postal_code
address[].city address.city Legen Sie die normalisierte Stadt fest. Dieses Feld darf nicht gehasht werden.
address[].region address.administrative_area Legen Sie das normalisierte Verwaltungsgebiet (Bundesland oder Provinz) fest. Dieses Feld darf nicht gehasht werden.
address[].sha256_street address.address_line Legen Sie die formatierte und gehashte Adresse fest. Sie können auch die gehashte Adresse verschlüsseln.

Artikelfelder für Warenkorbdaten

Measurement Protocol items[] Item (Data Manager API) Hinweise
item_id item_id Erforderlich.
item_name additional_item_parameters Ordnen Sie einen Eintrag zu, bei dem parameter_name auf item_name festgelegt ist.
quantity quantity Erforderlich.
price unit_price Erforderlich.
Andere Artikel-Felder additional_item_parameters

Ordnen Sie andere Artikelparameter (z. B. discount, affiliation, item_brand usw.) als Liste von Objekten mit parameter_name und value zu.

Hinweis:Fügen Sie hier keine Einträge für quantity, price oder item_id hinzu. Verwenden Sie stattdessen die Felder der obersten Ebene für Item.

Felder für Nutzerstandorte

Measurement Protocol user_location EventLocation (Data Manager API) Hinweise
city city Der Name der Stadt, in der das Ereignis aufgetreten ist.
country_id region_code Legen Sie den zweistelligen CLDR-Regionscode fest.
region_id subdivision_code Legen Sie den Code für die nationale Verwaltungseinheit gemäß ISO 3166-2 fest.
continent_id continent_code Legen Sie den Kontinentcode im UN M49-Format fest.
subcontinent_id subcontinent_code Legen Sie den Subkontinentcode im UN M49-Format fest.

Gerätefelder

Measurement Protocol device DeviceInfo (Data Manager API) Hinweise
category category
language language_code
screen_resolution screen_height und screen_width Im Measurement Protocol wird screen_resolution als String ("1280x720") bereitgestellt. In der Data Manager API werden screen_height und screen_width als separate Ganzzahlwerte gesendet.
operating_system operating_system
operating_system_version operating_system_version
model model
brand brand
browser browser
browser_version browser_version
Zurück
Upgrade ausführen