Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Google Analytics Measurement Protocol memungkinkan Anda mengirim data offline ke aliran Web atau Aplikasi, selain data yang sudah Anda kumpulkan dengan pemberian tag atau Firebase SDK.
Panduan ini menjelaskan kasus penggunaan umum Measurement Protocol Google Analytics dan persyaratannya.
Ringkasan persyaratan
Tabel ini memberikan referensi cepat untuk persyaratan setiap kasus penggunaan. Perhatikan praktik terbaik berikut:
timestamp_micros peristiwa dan properti pengguna ditetapkan secara default pada waktu permintaan. Saat mengirim perubahan properti pengguna atau peristiwa yang terjadi di masa lalu, ganti stempel waktu seperti yang dijelaskan dalam panduan mengirim peristiwa dan panduan properti pengguna.
Untuk metrik engagement dan laporan Real-Time yang akurat, sertakan parameter peristiwa
engagement_time_msec yang ditetapkan ke milidetik yang telah berlalu sejak
peristiwa sebelumnya.
Kasus penggunaan
ID Sesi
Persyaratan waktu permintaan
Persyaratan timestamp_micros
Menetapkan User-ID ke peristiwa
Wajib
<= akhir hari kerja saat sesi dimulai
>= sesi dimulai dan <= sesi berakhir
Atribusi sesi
Wajib
<= sesi dimulai + 24 jam
>= sesi dimulai dan <= sesi berakhir
Mengekspor peristiwa ke platform periklanan
Tidak wajib
<= hari kerja sesi terakhir + 63 hari
>= waktu permintaan dikurangi dua hari kerja dan <= waktu permintaan
Mengirim peristiwa atau properti pengguna untuk pembuatan audiens
Tidak wajib
Web: <= waktu peristiwa online terakhir + 30 hari
Aplikasi: <= waktu peristiwa online terakhir + 42 hari
>= waktu permintaan dikurangi dua hari kerja dan <= waktu permintaan
Menetapkan User-ID ke peristiwa
Gunakan Measurement Protocol untuk memberikan peristiwa online atau offline dengan
User-ID.
Berikut adalah beberapa contoh kasus penggunaan untuk menambahkan User-ID ke peristiwa:
Pengukuran online Anda tidak memiliki informasi yang diperlukan untuk mencari User-ID untuk peristiwa online, tetapi Anda memiliki pipeline pemrosesan peristiwa yang dapat membuat pengaitan antara sesi online dan User-ID.
Dalam skenario ini, Anda menggunakan Measurement Protocol untuk menyediakan peristiwa online dengan User-ID.
Anda tidak memiliki ID Pengguna untuk peristiwa yang Anda kirim dengan Measurement Protocol, tetapi Anda ingin peristiwa tersebut dikaitkan dengan ID Pengguna jika pengguna login secara online selama sesi.
Dalam skenario ini, Anda menggunakan peristiwa online untuk menyediakan peristiwa Measurement Protocol dengan User-ID.
Berikut adalah persyaratan untuk menambahkan User-ID ke peristiwa:
Sertakan session_id dalam daftar parameter peristiwa.
Kirim peristiwa Measurement Protocol pada hari kerja yang sama dengan sesi online.
Jika Anda mengganti timestamp_micros, tetapkan ke stempel waktu antara
waktu mulai dan waktu berakhir sesi online.
Jika sasaran Anda adalah memberikan User-ID untuk peristiwa online, tetapkan user_id dalam permintaan.
Jika sasaran Anda adalah agar setiap peristiwa Measurement Protocol memiliki User-ID
dari sesi online yang sesuai, Anda tidak perlu menetapkan user_id.
Atribusi sesi
Peristiwa Measurement Protocol yang memenuhi persyaratan tertentu muncul dalam laporan dengan atribut sesi yang sama (seperti informasi geografis, sumber, media, dan kampanye) dengan peristiwa online dari sesi yang sama.
Berikut adalah persyaratan untuk atribusi sesi:
Sertakan session_id dalam daftar parameter peristiwa.
Kirim permintaan paling lambat 24 jam setelah sesi online dimulai.
Misalnya, jika sesi dimulai pada pukul 11.15 pada hari Senin di zona waktu properti Anda, kirim permintaan sebelum pukul 11.15 pada hari Selasa.
Jika Anda mengganti timestamp_micros, tetapkan ke stempel waktu antara
waktu mulai dan waktu berakhir sesi online.
Mengekspor peristiwa ke platform periklanan
Google Analytics menyertakan peristiwa yang Anda kirim menggunakan Measurement Protocol dalam ekspor ke produk iklan tertaut seperti Google Ads atau Campaign Manager 360.
Beberapa skenario umum yang cocok untuk fitur ini adalah:
Bisnis Anda memiliki acara offline yang ingin Anda sertakan dalam atribusi dan pelaporan iklan.
Anda memiliki peristiwa tambahan dalam sistem yang tidak tersedia untuk pemberian tag atau Firebase SDK, tetapi Anda tetap ingin menyertakan peristiwa tersebut dalam produk tertaut.
Berikut persyaratan untuk mengekspor peristiwa ke platform periklanan:
Kirim permintaan paling lambat pada akhir hari kerja 63 hari setelah
peristiwa online terakhir, meskipun periode atribusi peristiwa utama lebih
dari 63 hari.
Misalnya, jika peristiwa online terbaru untuk client_id atau
app_instance_id terjadi pada 1 Maret, kirim peristiwa Measurement Protocol
paling lambat pada akhir hari kerja pada 3 Mei.
Jika Anda mengganti timestamp_micros, tetapkan ke stempel waktu dalam tiga hari kerja terakhir.
Mengirim peristiwa atau properti pengguna untuk pembuatan audiens
Peristiwa dan properti pengguna yang dikirim menggunakan Measurement Protocol disertakan dalam evaluasi kondisi audiens jika Anda mematuhi beberapa persyaratan.
Berikut persyaratan untuk mengirim peristiwa atau properti pengguna untuk pembuatan audiens:
Kirim permintaan ke streaming Web paling lambat pada akhir hari kerja
30 hari setelah acara online terbaru untuk client_id yang sama.
Misalnya, jika acara online terbaru untuk client_id terjadi pada
1 Maret, kirim peristiwa Measurement Protocol paling lambat pada akhir
hari kerja pada 31 Maret.
Kirim permintaan ke aliran Aplikasi paling lambat pada akhir hari kerja
42 hari setelah acara online terakhir untuk app_instance_id yang sama.
Misalnya, jika acara online terbaru untuk app_instance_id terjadi pada 1 Maret, kirim peristiwa Measurement Protocol paling lambat pada akhir hari kerja pada 12 April.
Jika Anda mengganti timestamp_micros, tetapkan ke stempel waktu dalam 3 hari kerja terakhir.
[null,null,["Terakhir diperbarui pada 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."]]
