Kasus penggunaan Measurement Protocol

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:

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

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

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

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