Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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 oder app_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.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-07-29 (UTC)."],[[["\u003cp\u003eThe Google Analytics Measurement Protocol allows you to send offline data, supplementing your existing online data collection.\u003c/p\u003e\n"],["\u003cp\u003eThis protocol enables you to assign User IDs to events, attribute sessions, export events for advertising, and leverage data for audience creation within Google Analytics.\u003c/p\u003e\n"],["\u003cp\u003eSpecific requirements, including session IDs and timestamps, must be met for each use case to ensure data accuracy and integration with online data.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the provided tables and guidelines for detailed requirements and best practices for each use case, such as session attribution and audience creation.\u003c/p\u003e\n"],["\u003cp\u003eAdhering to these guidelines ensures accurate reporting, attribution, and audience creation based on both online and offline data within your Google Analytics property.\u003c/p\u003e\n"]]],["The Google Analytics Measurement Protocol allows sending offline data to web or app streams. Key actions include: assigning User-IDs to events (requiring a `session_id`, same-day processing, and specific `timestamp_micros`), attributing sessions (requiring `session_id` and submission within 24 hours of session start), exporting events to advertising platforms (no `session_id` required, must be sent within 63 days of the last online event), and using data for audience creation (no `session_id`, web data must be sent within 30 days and app data within 42 days of the last event).\n"],null,["# Measurement protocol use cases\n\nThe Google Analytics Measurement Protocol lets you send offline data to your Web or App stream, in\naddition to the data you're already collecting with tagging or the Firebase SDK.\n\nThis guide describes common Google Analytics Measurement Protocol use cases and their requirements.\n| **Key Term:** In this guide, \"business day\" is the business day of an event or session in the [time zone of your property](//support.google.com/adsense/answer/9830725).\n\nSummary of requirements\n-----------------------\n\nThis table provides a quick reference of the requirements for each use\ncase. Keep the following best practices in mind:\n\n1. The `timestamp_micros` of events and user properties defaults to the request\n time. When sending an event or user property change that occurred in the\n past, override the timestamp as described in the [sending events](/analytics/devguides/collection/protocol/ga4/sending-events) guide and\n the [user properties](/analytics/devguides/collection/protocol/ga4/user-properties) guide.\n\n2. For accurate Realtime reports and engagement metrics, include the\n `engagement_time_msec` event parameter set to the milliseconds elapsed since\n the preceding event.\n\n| Use case | Session ID | Request time requirement | `timestamp_micros` requirement |\n|------------------------------------------------------|--------------|-----------------------------------------------------------------------------------------|---------------------------------------------------------------|\n| Assign User-ID to events | Required | \\\u003c= end of the session start's business day | \\\u003e= session start and \\\u003c= session end |\n| Session attribution | Required | \\\u003c= session start + 24 hours | \\\u003e= session start and \\\u003c= session end |\n| Export events to advertising platforms | Not required | \\\u003c= last session business day + 63 days | \\\u003e= request time minus two business days and \\\u003c= request time |\n| Send events or user properties for audience creation | Not required | Web: \\\u003c= latest online event time + 30 days App: \\\u003c= latest online event time + 42 days | \\\u003e= request time minus two business days and \\\u003c= request time |\n\nAssign User-ID to events\n------------------------\n\nUse the Measurement Protocol to provide online or offline events with a\n[User-ID](//support.google.com/analytics/answer/9213390).\n\nHere are some example use cases for adding a User-ID to an event:\n\n1. Your online measurement lacks the information needed to look up the\n User-ID for online events, but you have an event-processing pipeline that\n is able to make the association between an online session and a User-ID.\n\n In this scenario, you are using the Measurement Protocol to provide\n *online* events with a User-ID.\n2. You don't have the User-ID for events you are sending with the\n Measurement Protocol, but you want those events to be associated with a\n User-ID if the user logged in online over the course of the session.\n\n In this scenario, you are using online events to provide\n *Measurement Protocol* events with a User-ID.\n\nHere are the requirements to add a User-ID to an event:\n\n- Include the `session_id` in the event's parameter list.\n- Send the Measurement Protocol events on the *same business day* as the online session.\n- If you override `timestamp_micros`, set it to a timestamp between the start and end time of the online session.\n- If your goal is to provide User-ID for online events, set the `user_id` in the request.\n- If your goal is for each Measurement Protocol event to have the User-ID from its corresponding online session, you don't need to set `user_id`.\n\nSession attribution\n-------------------\n\nMeasurement Protocol events that meet specific requirements appear in reports\nwith the same session attributes (such as geographic information, source,\nmedium, and campaign) as online events from the same session.\n\nHere are the requirements for session attribution:\n\n- Include the `session_id` in the event's parameter list.\n- Send the request no later than 24 hours after the start of the online\n session.\n\n For example, if the session started at 11:15 AM on Monday in your property's\n time zone, send the request before 11:15 AM on Tuesday.\n- If you override `timestamp_micros`, set it to a timestamp between the\n start and end time of the online session.\n\nExport events to advertising platforms\n--------------------------------------\n\nGoogle Analytics includes the events you send using Measurement Protocol\nin exports to linked advertising products such as Google Ads or Campaign Manager\n360.\n| **Tip:** This use case doesn't require `session_id`.\n\nA few common scenarios where this is useful include:\n\n- Your business has offline events that you want included in advertising attribution and reporting.\n- You have additional events in a system that is not available to tagging or the Firebase SDK, but you still want to include those events in linked products.\n\nHere are the requirements to export events to advertising platforms:\n\n- Send the request no later than the end of the business day 63 days after\n the latest online event, even if the key event's attribution window is more\n than 63 days.\n\n For example, if the latest online event for the `client_id` or\n `app_instance_id` occurred on March 1, send the Measurement Protocol\n event no later than the end of the business day on May 3.\n- If you override `timestamp_micros`, set it to a timestamp within the last\n three business days.\n\nSend events or user properties for audience creation\n----------------------------------------------------\n\nEvents and user properties sent using Measurement Protocol are included in\nthe evaluation of [audience conditions](//support.google.com/analytics/answer/9267572) if you adhere to a few requirements.\n| **Tip:** This use case doesn't require `session_id`.\n\nHere are the requirements to send events or user properties for audience\ncreation:\n\n- Send the request to a Web stream no later than the end of the business day\n 30 days after the latest online event for the same `client_id`.\n\n For example, if the latest online event for the `client_id` occurred on\n March 1, send the Measurement Protocol event no later than the end of the\n business day on March 31.\n- Send the request to an App stream no later than the end of the business day\n 42 days after the latest online event for the same `app_instance_id`.\n\n For example, if the latest online event for the `app_instance_id` occurred\n on March 1, send the Measurement Protocol event no later than the end of\n the business day on April 12.\n- If you override `timestamp_micros`, set it to a timestamp within the last 3\n business days."]]
