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:
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.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:
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.
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
oderapp_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.