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