Measurement Protocol Google Analytics memungkinkan Anda mengirim data offline ke aliran data Web atau Aplikasi, di 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 singkat tentang persyaratan untuk setiap penggunaan ini masalahnya atau bukan. Ingatlah praktik terbaik berikut:
timestamp_micros
peristiwa dan properti pengguna ditetapkan secara default ke permintaan baik. Saat mengirim perubahan peristiwa atau properti pengguna yang terjadi di berlalu, ganti stempel waktu seperti yang dijelaskan dalam panduan peristiwa pengiriman dan panduan properti pengguna.Untuk mendapatkan laporan Real-Time dan metrik engagement yang akurat, sertakan Parameter peristiwa
engagement_time_msec
disetel ke milidetik yang berlalu sejak peristiwa sebelumnya.
Kasus penggunaan | ID Sesi | Persyaratan waktu permintaan | Persyaratan timestamp_micros |
---|---|---|---|
Menetapkan User-ID ke peristiwa | Wajib | <= akhir hari kerja awal sesi | >= awal sesi dan <= akhir sesi |
Atribusi sesi | Wajib | <= awal sesi + 24 jam | >= awal sesi dan <= akhir sesi |
Mengekspor peristiwa ke platform periklanan | Tidak wajib | <= hari kerja sesi terakhir + 63 hari | <= waktu permintaan |
Mengirim peristiwa atau properti pengguna untuk audiens kreasi | Tidak wajib | Web: <= waktu acara online terbaru + 30 hari Aplikasi: <= waktu acara online terbaru + 42 hari |
<= 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 mampu mengaitkan sesi online dengan User-ID.
Dalam skenario ini, Anda menggunakan Measurement Protocol untuk memberikan peristiwa online dengan User-ID.
Anda tidak memiliki User-ID untuk peristiwa yang Anda kirim dengan Measurement Protocol, tetapi Anda ingin peristiwa tersebut dikaitkan dengan User-ID jika pengguna login secara online selama sesi berlangsung.
Dalam skenario ini, Anda menggunakan acara {i>online<i} 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
, setel ke stempel waktu antara waktu mulai dan berakhir sesi online. - Jika sasaran Anda adalah memberikan User-ID untuk acara online, tetapkan
user_id
di terhadap permintaan. - Jika sasaran Anda adalah agar setiap peristiwa Measurement Protocol memiliki User-ID
dari sesi online terkaitnya, Anda tidak perlu menetapkan
user_id
.
Atribusi sesi
Peristiwa Measurement Protocol yang memenuhi persyaratan tertentu akan muncul di laporan dengan atribut sesi yang sama (seperti informasi geografis, sumber, media, dan kampanye) sebagai 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 dimulainya koneksi online sesi.
Misalnya, jika sesi dimulai pada pukul 11.15 pada hari Senin di properti Anda zona waktu Anda, kirim permintaan sebelum pukul 11.15 pada hari Selasa.
Jika Anda mengganti
timestamp_micros
, setel ke stempel waktu antara waktu mulai dan 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 dapat memanfaatkan hal ini meliputi:
- Bisnis Anda memiliki acara offline yang ingin disertakan dalam iklan atribusi dan pelaporan.
- Anda memiliki peristiwa tambahan dalam sistem yang tidak tersedia untuk pemberian tag atau Firebase SDK, tetapi Anda tetap ingin menyertakan peristiwa tersebut di halaman Google.
Berikut adalah persyaratan untuk mengekspor peristiwa ke platform periklanan:
Kirimkan permintaan paling lambat pada akhir hari kerja 63 hari setelahnya peristiwa online terbaru, meskipun periode atribusi peristiwa utama lebih dari 63 hari.
Misalnya, jika acara online terbaru untuk
client_id
atauapp_instance_id
terjadi pada 1 Maret, kirim Measurement Protocol selambat-lambatnya pada akhir hari kerja tanggal 3 Mei.Jika Anda mengganti
timestamp_micros
, tetapkan ke stempel waktu yang lebih kecil dari atau sama dengan terhadap waktu permintaan.
Mengirim peristiwa atau properti pengguna untuk pembuatan audiens
Peristiwa dan properti pengguna yang dikirim menggunakan Measurement Protocol disertakan dalam evaluasi kondisi audiens jika Anda memenuhi beberapa persyaratan.
Berikut adalah persyaratan untuk mengirim peristiwa atau properti pengguna untuk audiens pembuatan:
Mengirim permintaan ke aliran data Web selambat-lambatnya 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 tanggal 31 Maret.Mengirimkan permintaan ke aliran data Aplikasi paling lambat pada akhir hari kerja 42 hari setelah acara online terbaru 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 akhir hari kerja pada tanggal 12 April.Jika Anda mengganti
timestamp_micros
, tetapkan ke stempel waktu yang lebih kecil dari atau sama dengan terhadap waktu permintaan.