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 eines 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 Webereignisse. Weitere Informationen finden Sie unter Zielfelder. |
firebase_app_id (Suchparameter) |
destinations |
Ordnen Sie product_destination_id für App-Ereignisse zu. 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 |
Legen Sie ein Consent-Objekt fest. |
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 für jedes Ereignis event_timestamp auf den Zeitpunkt fest, zu dem das Ereignis aufgetreten ist.
Weitere Informationen finden Sie unter Zeitstempelformat. |
user_properties |
events.user_properties |
Legen Sie ein 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 ( |
user_data |
events.user_data |
Legen Sie ein UserData-Objekt fest. 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 den 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 für validate_only den Wert 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 Encoding fest, der für UserIdentifier-Werte verwendet wird. |
Zielfelder
Mit dem Measurement Protocol werden Ereignisse über den Suchparameter 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 einer Destination zu:
| Measurement Protocol | Destination (Data Manager API) |
Hinweise |
|---|---|---|
measurement_id (Suchparameter) |
product_destination_id |
Legen Sie die Mess-ID des Web-Datenstreams von Google Analytics fest. |
firebase_app_id (Suchparameter) |
product_destination_id |
Legen Sie die Firebase-App-ID des App-Datenstreams von Google Analytics fest. |
| Kein Äquivalent | operating_account |
Legen Sie für account_id die Google Analytics-Property-ID fest. Setze account_type auf GOOGLE_ANALYTICS_PROPERTY. |
| Kein Äquivalent | login_account |
Legen Sie für account_id 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 event_name einen reservierten Namen verwendet, 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 destinations-Liste auf Anfrageebene mehr als eine Google Analytics-Destination enthält. Fügen Sie einen Eintrag hinzu, um anzugeben, welches Ziel das Ereignis empfangen 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. In der Data Manager API legen Sie sie im Feld customer_type des Objekts UserProperties für das Ereignis fest. |
params.transaction_id |
transaction_id |
Für einige Ereignisse und Anwendungsfälle erforderlich. 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 |
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 |
Wird auf ein AddressInfo-Objekt festgelegt. Folgen Sie den Formatierungs- und Hash-Richtlinien. |
address[].sha256_first_name |
address.given_name |
Legen Sie den formatierten und gehashten Vornamen fest. Sie können den gehashten Vornamen auch verschlüsseln. |
address[].sha256_last_name |
address.family_name |
Legen Sie den formatierten und gehashten Nachnamen fest. Sie können den gehashten Nachnamen auch verschlüsseln. |
address[].country |
address.region_code |
|
address[].postal_code |
address.postal_code |
|
address[].city |
address.city |
Legen Sie die normalisierte Stadt fest. Hashen Sie dieses Feld nicht. |
address[].region |
address.administrative_area |
Legen Sie das normalisierte Verwaltungsgebiet (Bundesland oder Provinz) fest. Hashen Sie dieses Feld nicht. |
address[].sha256_street |
address.address_line |
Legen Sie die formatierte und gehashte Adresse fest. Sie können die gehashte Adresse auch 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 Artikelfelder | additional_item_parameters |
Ordnen Sie andere Artikelparameter (z. B. |
Felder für den Nutzerstandort
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") 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 |