Feldzuordnungen

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

Anfragefelder

/mp/collect-Anfrage (Measurement Protocol) IngestEventsRequest (Data Manager API) Hinweise
measurement_id (Suchparameter) destinations Ordnen Sie product_destination_id Web-Ereignissen zu. Weitere Informationen finden Sie unter Zielfelder.
firebase_app_id (Suchparameter) destinations App-Ereignisse product_destination_id 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 Auf eine Liste von Event-Ressourcen festgelegt. Weitere Informationen finden Sie im Abschnitt zu Ereignisfeldern.
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 Protocol Buffers verwenden, nutzen Sie ein Timestamp und legen Sie die Felder seconds und (optional) nanoseconds fest.

Weitere Informationen finden Sie unter Zeitstempelformat.
user_properties events.user_properties Auf ein UserProperties-Objekt festgelegt. Die Data Manager API unterstützt keine Zeitstempel für einzelne Nutzerattribute. Zeitstempel für Änderungen an Nutzereigenschaften 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, legen Sie ad_personalization auf DENIED fest.
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 Diagnose können Sie den Status Ihres Uploads sowie Fehler und Warnungen für einzelne Ereignisse während der Downstream-Verarbeitung abrufen. Wenn IngestEventsRequest fehlschlägt (z. B. aufgrund fehlender erforderlicher Felder), 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 ist ähnlich wie beim Measurement Protocol-Validierungsserver.
Kein Äquivalent encoding Erforderlich für UserData-Uploads. Auf die Encoding für UserIdentifier-Werte festgelegt.

Zielfelder

Mit dem Measurement Protocol werden Ereignisse mithilfe des Abfrageparameters measurement_id oder firebase_app_id direkt an einen bestimmten Datenstream gesendet.

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 Google Analytics-Web-Datenstreams festgelegt
firebase_app_id (Suchparameter) product_destination_id Auf die Firebase-App-ID des Google Analytics-App-Datenstreams festgelegt
Kein Äquivalent operating_account Setzen Sie account_id auf die Google Analytics-Property-ID. Setzen Sie account_type auf GOOGLE_ANALYTICS_PROPERTY.
Kein Äquivalent login_account Setzen Sie account_id auf die Google Analytics-Property-ID. Setzen Sie account_type auf GOOGLE_ANALYTICS_PROPERTY.

Ereignisfelder

Measurement Protocol events[] Event (Data Manager API) Hinweise
name event_name Wenn event_name einen reservierten Namen verwendet, lehnt die API das Ereignis mit einem INVALID_EVENT_NAME-Fehler ab.
Kein Äquivalent event_source Auf WEB setzen, wenn das Ereignis über einen Webbrowser generiert wurde, und auf APP, wenn das Ereignis ü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 im Objekt 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 auf den Einkaufswagen angewendeten Gutscheine anzugeben. Geben Sie nur einen Gutschein für Google Analytics an. Das 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 den Eintrag mit parameter_name auf session_id zu.
params.engagement_time_msec additional_event_parameters Ordnen Sie den Eintrag mit parameter_name auf engagement_time_msec zu.
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 der obersten Ebene auf der Event.

Felder für Nutzerkennungen

Measurement Protocol user_data UserIdentifier (Data Manager API) Hinweise
sha256_email_address[] email_address Auf die formatierte und gehashte E-Mail-Adresse festgelegt. Sie können die gehashte E‑Mail-Adresse auch verschlüsseln.
sha256_phone_number[] phone_number Auf die formatierte und gehashte Telefonnummer festgelegt. Sie können die gehashte Telefonnummer auch verschlüsseln.
address[] address Auf ein AddressInfo-Objekt festgelegt. Halten Sie sich an die Formatierungs- und Hashing-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 Auf den formatierten und gehashten Familiennamen festgelegt. Sie können auch den gehashten Familiennamen verschlüsseln.
address[].country address.region_code
address[].postal_code address.postal_code
address[].city Kein Äquivalent Wird in der aktuellen Version der Data Manager API nicht unterstützt.
address[].region Kein Äquivalent Wird in der aktuellen Version der Data Manager API nicht unterstützt.
address[].sha256_street Kein Äquivalent Wird in der aktuellen Version der Data Manager API nicht unterstützt.

Artikelfelder für Warenkorbdaten

Measurement Protocol items[] Item (Data Manager API) Hinweise
item_id item_id Erforderlich.
item_name additional_item_parameters Ordnen Sie den Eintrag mit parameter_name auf item_name zu.
quantity quantity Erforderlich.
price unit_price Erforderlich.
Andere Artikel-Felder additional_item_parameters

Ordnen Sie andere Artikelparameter (z. B. discount, affiliation, item_brand) 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 auf der Item.

Felder für Nutzerstandorte

Measurement Protocol user_location EventLocation (Data Manager API) Hinweise
city city Der Name der Stadt, in der das Ereignis stattgefunden hat.
country_id region_code Auf den 2‑Buchstaben-CLDR-Regionscode festgelegt.
region_id subdivision_code Auf den Code für die nationale Verwaltungseinheit gemäß ISO 3166-2 festgelegt.
continent_id continent_code Auf den Kontinentcode im UN M49-Format festgelegt.
subcontinent_id subcontinent_code Auf den Unterkontinentcode im UN M49-Format festgelegt.

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") angegeben. 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