Anwendungsfälle für Measurement Protocol

Mit dem Google Analytics Measurement Protocol können Sie Offlinedaten an Ihren Web- oder App-Stream senden, zusätzlich zu den Daten, die Sie bereits mit Tagging oder dem Firebase SDK erfassen.

In diesem Leitfaden werden gängige Anwendungsfälle für das Google Analytics Measurement Protocol und die entsprechenden Anforderungen beschrieben.

Zusammenfassung der Anforderungen

Die nachstehende Tabelle gibt einen kurzen Überblick über die Anforderungen der einzelnen Anwendungsfälle. Beachten Sie die folgenden Best Practices:

  1. Für die timestamp_micros von Ereignissen und Nutzereigenschaften wird standardmäßig die Uhrzeit der Anfrage verwendet. Wenn Sie eine Änderung für ein Ereignis oder eine Nutzereigenschaft senden, die in der Vergangenheit vorgenommen wurde, überschreiben Sie den Zeitstempel wie in den Leitfäden zum Senden von Ereignissen und für Nutzereigenschaften beschrieben.

  2. Um genaue Echtzeitberichte und Engagement-Messwerte zu erhalten, verwenden Sie den Ereignisparameter engagement_time_msec (auf die Anzahl der Millisekunden seit dem vorherigen Ereignis eingestellt).

Anwendungsfall Sitzungs-ID Anforderung an Anfrageuhrzeit Anforderung für timestamp_micros
User-ID Ereignissen zuweisen Erforderlich <= Ende des Arbeitstags, an dem die Sitzung begann >= Start der Sitzung und <= Ende der Sitzung
Sitzungsattribution Erforderlich <= Start der Sitzung + 24 Stunden >= Start der Sitzung und <= Ende der Sitzung
Ereignisse auf Werbeplattformen exportieren Nicht erforderlich <= Tag der letzten Sitzung + 63 Tage >= Anfrageuhrzeit minus 72 Stunden und <= Anfrageuhrzeit
Ereignisse oder Nutzereigenschaften zur Zielgruppenerstellung senden Nicht erforderlich Web: <= Uhrzeit des letzten Online-Ereignisses + 30 Tage
App: <= Uhrzeit des letzten Online-Ereignisses + 42 Tage
>= Anfrageuhrzeit minus 72 Stunden und <= Anfrageuhrzeit

User-ID Ereignissen zuweisen

Mit dem Measurement Protocol können Sie Online- oder Offline-Ereignisse mit einer User-ID versehen.

Hier einige Anwendungsbeispiele für das Hinzufügen einer User-ID zu einem Ereignis:

  1. Bei der Onlinemessung fehlen die Informationen, die zum Suchen der User-ID für Onlineereignisse erforderlich sind. Sie haben jedoch eine Pipeline zur Ereignisverarbeitung, mit der die Verknüpfung zwischen einer Onlinesitzung und einer User-ID hergestellt werden kann.

    In diesem Szenario verwenden Sie das Measurement Protocol, um Onlineereignisse mit einer User-ID zu versehen.

  2. Sie haben keine User-ID für Ereignisse, die Sie mit dem Measurement Protocol senden, möchten aber, dass diese Ereignisse mit einer User-ID verknüpft werden, wenn sich der Nutzer im Laufe der Sitzung online angemeldet hat.

    In diesem Szenario verwenden Sie Online-Ereignisse, um Measurement Protocol-Ereignisse mit einer User-ID zu versehen.

Anforderungen für das Hinzufügen einer User-ID zu einem Ereignis:

  • Fügen Sie den session_id in die Parameterliste des Ereignisses ein.
  • Senden Sie die Measurement Protocol-Ereignisse am selben Arbeitstag wie die Onlinesitzung.
  • Wenn Sie timestamp_micros überschreiben, legen Sie einen Zeitstempel zwischen der Start- und Endzeit der Onlinesitzung fest.
  • Wenn Sie eine User-ID für Online-Ereignisse angeben möchten, legen Sie die user_id in der Anfrage fest.
  • Wenn Sie möchten, dass jedes Measurement Protocol-Ereignis die User-ID aus der entsprechenden Onlinesitzung hat, müssen Sie user_id nicht festlegen.

Sitzungsattribution

Measurement Protocol-Ereignisse, die bestimmte Anforderungen erfüllen, werden in Berichten mit denselben Sitzungsattributen (z. B. geografische Informationen, Quelle, Medium und Kampagne) wie Online-Ereignisse aus derselben Sitzung aufgeführt.

Für die Sitzungsattribution gelten folgende Anforderungen:

  • Fügen Sie den session_id in die Parameterliste des Ereignisses ein.
  • Senden Sie die Anfrage spätestens 24 Stunden nach Beginn der Onlinesitzung.

    Wenn die Sitzung beispielsweise am Montag um 11:15 Uhr in der Zeitzone Ihrer Property begonnen hat, senden Sie die Anfrage vor Dienstag um 11:15 Uhr.

  • Wenn Sie timestamp_micros überschreiben, legen Sie einen Zeitstempel zwischen der Start- und Endzeit der Onlinesitzung fest.

Ereignisse auf Werbeplattformen exportieren

In Google Analytics werden die Ereignisse, die Sie über das Measurement Protocol senden, in Exporte an verknüpfte Werbeprodukte wie Google Ads oder Campaign Manager 360 einbezogen.

Hier sind einige gängige Szenarien, in denen dies nützlich ist:

  • Ihr Unternehmen hat Offline-Ereignisse, die Sie in die Werbeattribution und -berichte einbeziehen möchten.
  • Sie haben zusätzliche Ereignisse in einem System, das nicht für das Tagging oder das Firebase SDK verfügbar ist, möchten diese Ereignisse aber trotzdem in verknüpfte Produkte einbeziehen.

Für den Export von Ereignissen auf Werbeplattformen gelten folgende Anforderungen:

  • Senden Sie die Anfrage spätestens 63 Tage nach dem letzten Online-Ereignis, auch wenn der Attributionszeitraum des Schlüsselereignisses mehr als 63 Tage beträgt. Das Ereignis muss außerdem innerhalb des Attributionszeitraums des Schlüsselereignisses eintreffen. Informationen zum Konfigurieren der Einstellungen für den Attributionszeitraum

    Wenn das letzte Online-Ereignis für die client_id oder app_instance_id beispielsweise am 1. März aufgetreten ist, senden Sie das Measurement Protocol-Ereignis spätestens am 3. Mai.

  • Wenn Sie timestamp_micros überschreiben, legen Sie einen Zeitstempel innerhalb der letzten 72 Stunden fest.

Ereignisse oder Nutzereigenschaften zur Zielgruppenerstellung senden

Ereignisse und Nutzereigenschaften, die über das Measurement Protocol gesendet werden, werden bei der Auswertung von Zielgruppenbedingungen berücksichtigt, wenn Sie einige Anforderungen erfüllen.

Hier sind die Anforderungen zum Senden von Ereignissen oder Nutzereigenschaften für die Zielgruppenerstellung:

  • Senden Sie die Anfrage spätestens 30 Tage nach dem letzten Online-Ereignis für dieselbe client_id an einen Webstream.

    Wenn das letzte Online-Ereignis für die client_id beispielsweise am 1. März aufgetreten ist, senden Sie das Measurement Protocol-Ereignis spätestens am 31. März.

  • Senden Sie die Anfrage spätestens 42 Tage nach dem letzten Online-Ereignis für dieselbe app_instance_id an einen App-Stream.

    Wenn das letzte Online-Ereignis für die app_instance_id beispielsweise am 1. März aufgetreten ist, senden Sie das Measurement Protocol-Ereignis spätestens am 12. April.

  • Wenn Sie timestamp_micros überschreiben, legen Sie einen Zeitstempel innerhalb der letzten 72 Stunden fest.