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:
Für die
timestamp_microsvon 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 | 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:
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.
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_idin 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_idin der Anfrage fest. - Wenn Sie möchten, dass jedes Measurement Protocol-Ereignis die User-ID aus der entsprechenden Onlinesitzung hat, müssen Sie
user_idnicht 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_idin 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_idoderapp_instance_idbeispielsweise 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_idan einen Webstream.Wenn das letzte Online-Ereignis für die
client_idbeispielsweise 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_idan einen App-Stream.Wenn das letzte Online-Ereignis für die
app_instance_idbeispielsweise 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.