Mit dem Google Analytics Measurement Protocol können Sie zusätzlich zu den Daten, die Sie bereits mit Tagging oder dem Firebase SDK erheben, Offlinedaten an Ihren Web- oder App-Datenstream senden.
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:
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 an 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-Ereignissen eine User-ID zuweisen.
Hier einige Anwendungsbeispiele für das Hinzufügen einer User-ID zu einem Ereignis:
Ihre Online-Messung enthält nicht die Informationen, die zum Nachschlagen der User-ID für Online-Ereignisse erforderlich sind. Sie haben jedoch eine Pipeline zur Ereignisverarbeitung, mit der die Verknüpfung zwischen einer Online-Sitzung und einer User-ID hergestellt werden kann.
In diesem Szenario verwenden Sie das Measurement Protocol, um Online-Ereignissen eine User-ID zuzuweisen.
Sie haben keine User-ID für Ereignisse, die Sie mit dem Measurement Protocol senden. Sie 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-Ereignissen eine User-ID zuzuweisen.
Folgende Anforderungen müssen erfüllt sein, um einem Ereignis eine User-ID hinzuzufügen:
- Fügen Sie
session_idder Parameterliste des Ereignisses hinzu. - Senden Sie die Measurement Protocol-Ereignisse am gleichen Arbeitstag wie die Online-Sitzung.
- Wenn Sie
timestamp_microsüberschreiben, legen Sie einen Zeitstempel zwischen der Start- und Endzeit der Online-Sitzung fest. - Wenn Sie eine User-ID für Online-Ereignisse angeben möchten, legen Sie
user_idin der Anfrage fest. - Wenn jedes Measurement Protocol-Ereignis die User-ID aus der entsprechenden Online-Sitzung haben soll, 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 angezeigt.
Folgende Anforderungen müssen für die Sitzungsattribution erfüllt sein:
- Fügen Sie
session_idder Parameterliste des Ereignisses hinzu. Senden Sie die Anfrage spätestens 24 Stunden nach Beginn der Online-Sitzung.
Wenn die Sitzung beispielsweise am Montag um 11:15 Uhr in der Zeitzone Ihres Property begonnen hat, müssen Sie die Anfrage vor Dienstag um 11:15 Uhr senden.
Wenn Sie
timestamp_microsüberschreiben, legen Sie einen Zeitstempel zwischen der Start- und Endzeit der Online-Sitzung fest.
Ereignisse auf Werbeplattformen exportieren
Google Analytics berücksichtigt die Ereignisse, die Sie mit dem Measurement Protocol senden, in Exporten in verknüpfte Werbeprodukte wie Google Ads oder Campaign Manager 360.
Einige gängige Szenarien, in denen dies nützlich ist:
- Ihr Unternehmen hat Offline-Ereignisse, die in die Werbeattribution und -berichterstattung einbezogen werden sollen.
- Sie haben zusätzliche Ereignisse in einem System, das für Tagging oder das Firebase SDK nicht verfügbar ist. Sie möchten diese Ereignisse aber trotzdem in verknüpften Produkten verwenden.
Folgende Anforderungen müssen erfüllt sein, um Ereignisse auf Werbeplattformen zu exportieren:
Senden Sie die Anfrage spätestens 63 Tage nach dem letzten Online-Ereignis, auch wenn der Attributionszeitraum des Schlüsselereignisses länger als 63 Tage ist. Das Ereignis muss auch 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 stattgefunden hat, müssen Sie das Measurement Protocol-Ereignis spätestens am 3. Mai senden.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 mit dem Measurement Protocol gesendet werden, werden in die Auswertung der Zielgruppenbedingungen einbezogen, wenn Sie einige Anforderungen erfüllen.
Folgende Anforderungen müssen erfüllt sein, um Ereignisse oder Nutzereigenschaften zur Zielgruppenerstellung zu senden:
Senden Sie die Anfrage spätestens 30 Tage nach dem letzten Online-Ereignis für dieselbe
client_idan einen Web-Datenstream.Wenn das letzte Online-Ereignis für die
client_idbeispielsweise am 1. März stattgefunden hat, müssen Sie das Measurement Protocol-Ereignis spätestens am 31. März senden.Senden Sie die Anfrage spätestens 42 Tage nach dem letzten Online-Ereignis für dieselbe
app_instance_idan einen App-Datenstream.Wenn das letzte Online-Ereignis für die
app_instance_idbeispielsweise am 1. März stattgefunden hat, müssen Sie das Measurement Protocol-Ereignis spätestens am 12. April senden.Wenn Sie
timestamp_microsüberschreiben, legen Sie einen Zeitstempel innerhalb der letzten 72 Stunden fest.