Anwendungsfälle für Measurement Protocol

Mit dem Google Analytics Measurement Protocol können Sie Offline-Daten an Ihren Web- oder App-Datenstrom senden. Das ist eine Ergänzung zu den Daten, die Sie bereits mit Tagging oder dem Firebase SDK erfassen.

In diesem Leitfaden werden häufige Anwendungsfälle für das Google Analytics Measurement Protocol und die zugehörigen Anforderungen beschrieben.

Zusammenfassung der Anforderungen

In dieser Tabelle finden Sie 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 timestamp_micros-Anforderung
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 <= Arbeitstag der letzten Sitzung + 63 Tage >= Anfrageuhrzeit minus zwei Arbeitstage 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 zwei Arbeitstage und <= Anfrageuhrzeit

User-ID Ereignissen zuweisen

Mit dem Measurement Protocol können Sie Online- oder Offlineereignissen eine User-ID zuweisen.

Hier einige Beispiele für Anwendungsfälle, in denen Sie einem Ereignis eine Nutzer-ID hinzufügen können:

  1. Für Ihre Onlinemessung fehlen die Informationen, die zum Nachschlagen der User-ID für Onlineereignisse erforderlich sind. Sie haben jedoch eine Pipeline zur Ereignisverarbeitung, mit der die Zuordnung zwischen einer Onlinesitzung und einer User-ID möglich ist.

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

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

    In diesem Szenario verwenden Sie Onlineereignisse, um Measurement Protocol-Ereignisse mit einer User-ID bereitzustellen.

So fügen Sie einem Ereignis eine User-ID hinzu:

  • Füge session_id in die Parameterliste des Ereignisses ein.
  • Senden Sie die Measurement Protocol-Ereignisse am selben Werktag wie die Onlinesitzung.
  • Wenn Sie timestamp_micros überschreiben, legen Sie es auf einen Zeitstempel zwischen dem Start- und Endzeitpunkt der Onlinesitzung fest.
  • Wenn Sie die User-ID für Online-Ereignisse angeben möchten, legen Sie user_id in der Anfrage fest.
  • Wenn Sie möchten, dass jedes Measurement Protocol-Ereignis die User-ID 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 Onlineereignisse aus derselben Sitzung angezeigt.

Dies sind die Anforderungen für die Sitzungsattribution:

  • Füge 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 es auf einen Zeitstempel zwischen dem Start- und Endzeitpunkt der Onlinesitzung fest.

Ereignisse auf Werbeplattformen exportieren

Google Analytics berücksichtigt die Ereignisse, die Sie über das Measurement Protocol senden, in Exporten in verknüpfte Werbeprodukte wie Google Ads oder Campaign Manager 360.

Einige häufige Szenarien, in denen dies nützlich ist:

  • Ihr Unternehmen hat Offlineereignisse, die in die Attribution und Berichterstellung von Werbung einbezogen werden sollen.
  • Sie haben zusätzliche Ereignisse in einem System, das für das Tagging oder das Firebase SDK nicht verfügbar ist, möchten diese Ereignisse aber trotzdem in verknüpften Produkten verwenden.

Voraussetzungen für den Export von Ereignissen auf Werbeplattformen:

  • Senden Sie die Anfrage spätestens am Ende des Arbeitstags 63 Tage nach dem letzten Online-Ereignis, auch wenn das Attributionszeitfenster des Schlüsselereignisses länger als 63 Tage ist.

    Wenn das letzte Online-Ereignis für client_id oder app_instance_id beispielsweise am 1. März stattgefunden hat, müssen Sie das Measurement Protocol-Ereignis bis zum Ende des Arbeitstags am 3. Mai senden.

  • Wenn Sie timestamp_micros überschreiben, legen Sie den Wert auf einen Zeitstempel innerhalb der letzten drei Arbeitstage fest.

Ereignisse oder Nutzereigenschaften zur Zielgruppenerstellung senden

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

Hier finden Sie die Anforderungen zum Senden von Ereignissen oder Nutzereigenschaften zur Zielgruppenerstellung:

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

    Wenn das letzte Online-Ereignis für client_id beispielsweise am 1. März stattgefunden hat, müssen Sie das Measurement Protocol-Ereignis spätestens am Ende des Arbeitstags am 31. März senden.

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

    Wenn das letzte Onlineereignis für app_instance_id beispielsweise am 1. März stattgefunden hat, müssen Sie das Measurement Protocol-Ereignis spätestens am Ende des Arbeitstags am 12. April senden.

  • Wenn Sie timestamp_micros überschreiben, legen Sie für den Parameter einen Zeitstempel innerhalb der letzten drei Werktage fest.