Anwendungsfälle für Measurement Protocol

Mit dem Google Analytics Measurement Protocol können Sie Offlinedaten zusätzlich zu den Daten senden, die Sie bereits mit dem Tagging oder dem Firebase SDK erheben.

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

Zusammenfassung der Anforderungen

Diese 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 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 >= Anfragezeit – 2 Arbeitstage und <= Anfragezeit
Ereignisse oder Nutzereigenschaften zur Zielgruppenerstellung senden Nicht erforderlich Web: <= Uhrzeit des letzten Online-Ereignisses + 30 Tage
App: <= Uhrzeit des letzten Online-Ereignisses + 42 Tage		 >= Anfragezeit – 2 Arbeitstage und <= Anfragezeit

User-ID Ereignissen zuweisen

Verwenden Sie das Measurement Protocol, um Online- oder Offlineereignisse mit einer User-ID zu versehen.

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

  1. Für Ihre Onlinemessung fehlen die Informationen, die zum Abrufen der User-ID für Onlineereignisse erforderlich sind. Sie haben jedoch eine Ereignisverarbeitungspipeline, mit der eine Onlinesitzung einer User-ID zugeordnet werden kann.

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

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

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

Folgende Anforderungen müssen erfüllt sein, damit einem Ereignis eine User-ID hinzugefügt werden kann:

  • Fügen Sie 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 Onlineereignisse angeben möchten, setzen Sie die user_id in der Anfrage.
  • 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. geografischen Informationen, Quelle, Medium und Kampagne) wie Onlineereignisse aus derselben Sitzung angezeigt.

Für die Sitzungsattribution gelten folgende Anforderungen:

  • Fügen Sie 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, 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 Exporten in verknüpfte Werbeprodukte wie Google Ads oder Campaign Manager 360 aufgenommen.

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

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

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

  • Senden Sie die Anfrage spätestens am Ende des Arbeitstags, der 63 Tage nach dem letzten Onlineereignis liegt, auch wenn das Attributionsfenster des Schlüsselereignisses länger als 63 Tage ist.

    Wenn das letzte Onlineereignis für den client_id oder app_instance_id beispielsweise am 1. März stattgefunden hat, senden Sie das Measurement Protocol-Ereignis spätestens am Ende des Arbeitstags am 3. Mai.

  • Wenn Sie timestamp_micros überschreiben, geben Sie einen Zeitstempel aus den letzten drei Arbeitstagen an.

Ereignisse oder Nutzereigenschaften zur Zielgruppenerstellung senden

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

Folgende Anforderungen gelten für das Senden von Ereignissen oder Nutzereigenschaften zur Zielgruppenerstellung:

  • Senden Sie die Anfrage spätestens am Ende des Arbeitstags, der auf den 30. Tag nach dem letzten Onlineereignis für dieselbe client_id folgt, an einen Webstream.

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

  • Senden Sie die Anfrage bis zum Ende des Arbeitstags 42 Tage nach dem letzten Onlineereignis für dieselbe app_instance_id an einen App-Stream.

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

  • Wenn Sie timestamp_micros überschreiben, geben Sie einen Zeitstempel aus den letzten drei Arbeitstagen an.