Measurement Protocol-Referenz

Übersicht

Das Senden von Daten an Google Analytics mit dem Messwert „Messung“ erfolgt in zwei Schritten. Protokoll:

  1. Die Übertragung – wohin und wie Sie Daten senden
  2. Nutzlast: die Daten, die Sie senden

In diesem Dokument wird beschrieben, wie Transport und Nutzlast formatiert werden.

Transport

URL-Endpunkt

Sie senden Daten mithilfe des Measurement Protocol, indem Sie HTTP POST-Anfragen an den folgenden Endpunkt:

https://www.google-analytics.com/mp/collect

Um ein Ereignis zu senden, senden Sie die folgende POST-Anfrage:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>

Antwortcodes

Das Measurement Protocol gibt immer den Statuscode 2xx zurück, wenn die HTTP Anfrage ist eingegangen. Das Measurement Protocol gibt keinen Fehlercode zurück, wenn waren die Nutzlastdaten fehlerhaft oder die Daten in der Nutzlast waren falsch oder nicht von Google Analytics verarbeitet.

Nutzlast

<ph type="x-smartling-placeholder"></ph>

Die Daten werden in zwei Wochen mithilfe des Measurement Protocol an Google Analytics gesendet. Teile:

  1. Abfrageparameter
  2. Einen JSON-POST-Text

Suchparameter

Parametername Beschreibung

api_secret

Erforderlich. Ein API Secret, das durch der Google Analytics-Benutzeroberfläche.

So erstellen Sie ein neues Secret in der Google Analytics-Benutzeroberfläche:
Verwaltung > Datenstreams > Stream auswählen &gt; Measurement Protocol > Erstellen

Wir empfehlen, diese auf Ihre Organisation zu beschränken. Wenn stellen Sie das Measurement Protocol auf Clientseite bereit, Rotieren Sie regelmäßig api_secret, um übermäßigen SPAM zu vermeiden.

JSON-Beitragstext

Schlüssel Typ Beschreibung

user_id

 string

Optional. Eine eindeutige Kennung für einen Nutzer. Siehe User-ID für plattformübergreifende Analyse.

<ph type="x-smartling-placeholder">

timestamp_micros

 number

Optional. Ein Unix-Zeitstempel (in Mikrosekunden) für die zu verknüpfende Zeit mit dem Ereignis. Diese Option sollte nur festgelegt werden, um Ereignisse aufzuzeichnen, die stattgefunden haben in der Vergangenheit liegen. Dieser Wert kann überschrieben werden durch user_property oder Ereigniszeitstempel. Ereignisse können rückdatiert werden Bis zu 3 Kalendertage je nach Zeitzone der Property.

<ph type="x-smartling-placeholder">

user_properties

 object Optional. Die Nutzereigenschaften für die Messung. Siehe Nutzer .
object Optional. Legt die Einwilligungseinstellungen für die Anfrage fest. Weitere Informationen finden Sie im Abschnitt zur Einwilligung.

non_personalized_ads

 boolean Optional. Legen Sie true fest, um anzugeben, dass die Daten des Nutzers nicht für personalisierte Anzeigen verwendet werden. <ph type="x-smartling-placeholder">

events[]

 array Erforderlich. Ein Array von Ereigniselementen. Pro können bis zu 25 Ereignisse gesendet werden. Veranstaltungen ansehen Referenz für alle gültigen Ereignisse.

events[].name

 string Erforderlich. Der Name des Ereignisses. Veranstaltungen ansehen für alle Optionen.

events[].params

 object Optional. Die Parameter für das Ereignis. Ereignisse ansehen für die vorgeschlagenen Parameter für jedes Ereignis.

Mit dem Attribut consent werden Einwilligungsarten und -status konfiguriert. Wenn Sie consent nicht angeben, verwendet Google Analytics die Einwilligung Einstellungen aus den entsprechenden Onlineinteraktionen für den Client oder die App-Instanz.

Schlüssel Typ Beschreibung

ad_user_data

 string

Optional. Legt die Einwilligung zum Senden von Nutzerdaten aus dem zu Werbezwecken an Google senden.

Muss entweder GRANTED oder DENIED sein.

ad_personalization

 string

Optional. Legt die Einwilligung für personalisierte Anzeigen für den Nutzer fest.

Muss entweder GRANTED oder DENIED sein.

Benutzerdefinierte Parameter

Zusätzlich zu den vorgeschriebenen Parametern können Sie benutzerdefiniert auf Nutzer-, Ereignis- und Artikelebene Parameter in einer Measurement Protocol-Nutzlast.

  • Benutzerdefinierte Parameter auf Nutzerebene können in das user_properties-Objekt der Nutzlast aufgenommen werden.
  • Benutzerdefinierte Parameter auf Ereignisebene können in events[].params aufgenommen werden. -Objekt der Nutzlast.
  • Benutzerdefinierte Parameter auf Artikelebene können in den items-Array für jedes Ereignis.

Für einige Ereignisse sind empfohlene Parameter vorhanden. Unter diesem Link finden Sie die empfohlenen Ereignisse. Parameter für alle unterstützten Ereignisse.

Reservierte Namen

Reservierte Ereignisnamen

Die folgenden Ereignisnamen sind reserviert und können nicht verwendet werden:

  • ad_activeview
  • ad_click
  • ad_exposure
  • ad_query
  • ad_reward
  • adunit_exposure
  • app_clear_data
  • app_exception
  • app_install
  • app_remove
  • app_store_refund
  • app_update
  • app_upgrade
  • dynamic_link_app_open
  • dynamic_link_app_update
  • dynamic_link_first_open
  • error
  • firebase_campaign
  • firebase_in_app_message_action
  • firebase_in_app_message_dismiss
  • firebase_in_app_message_impression
  • first_open
  • first_visit
  • in_app_purchase
  • notification_dismiss
  • notification_foreground
  • notification_open
  • notification_receive
  • notification_send
  • os_update
  • session_start
  • user_engagement

Reservierte Parameternamen

Die folgenden Parameternamen sind reserviert und können nicht verwendet werden:

  • firebase_conversion

Außerdem dürfen Parameternamen nicht mit folgenden Zeichen oder Präfixen beginnen:

  • _ (underscore)
  • firebase_
  • ga_
  • google_
  • gtag.

Reservierte Namen von Nutzereigenschaften

Die folgenden Namen von Nutzereigenschaften sind reserviert und können nicht verwendet werden:

  • first_open_time
  • first_visit_time
  • last_deep_link_referrer
  • user_id
  • first_open_after_install

Außerdem dürfen Namen von Nutzereigenschaften nicht mit folgenden Zeichen oder Präfixen beginnen:

  • _ (underscore)
  • firebase_
  • ga_
  • google_