Anwendungsfälle für Measurement Protocol

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:

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

  1. 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.

  2. 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_id der 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_id in der Anfrage fest.
  • Wenn jedes Measurement Protocol-Ereignis die User-ID aus der entsprechenden Online-Sitzung haben soll, 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 Online-Ereignisse aus derselben Sitzung angezeigt.

Folgende Anforderungen müssen für die Sitzungsattribution erfüllt sein:

  • Fügen Sie session_id der 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_id oder app_instance_id beispielsweise 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_id an einen Web-Datenstream.

    Wenn das letzte Online-Ereignis für die client_id beispielsweise 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_id an einen App-Datenstream.

    Wenn das letzte Online-Ereignis für die app_instance_id beispielsweise 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.