Ringkasan
Ada dua bagian dalam pengiriman data ke Google Analytics menggunakan Measurement Protocol:
Dokumen ini menjelaskan cara transpor dan payload diformat.
Transpor
Endpoint URL
Anda mengirim data menggunakan Measurement Protocol dengan membuat permintaan POST HTTP pada endpoint berikut:
https://www.google-analytics.com/mp/collect
Untuk mengirim peristiwa, berikan permintaan POST
berikut:
POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>
BODY
permintaan. Lihat Payload.
Kode respons
Measurement Protocol selalu menampilkan kode status 2xx
jika permintaan HTTP
diterima. Measurement Protocol tidak menampilkan kode error jika
format data payload salah, atau jika data dalam payload salah atau
tidak diproses oleh Google Analytics.
Payload
Data dikirim ke Google Analytics menggunakan Data Measurement Protocol dalam dua bagian:
- Parameter kueri
- Isi
JSON
POST
Parameter kueri
Nama Parameter | Deskripsi |
---|---|
|
Wajib.
Untuk membuat secret baru, buka di UI Google Analytics:
Sebaiknya Anda tetap merahasiakannya untuk organisasi Anda. Jika
Anda men-deploy Measurement Protocol di sisi klien, Anda harus
merotasi |
|
Wajib. ID Aplikasi Firebase. ID untuk aplikasi Firebase.
Terdapat di Firebase console di bagian:
Setelan Project > Umum > Aplikasi Anda > ID Aplikasi |
Isi JSON POST
Kunci | Jenis | Deskripsi |
---|---|---|
|
string |
Wajib. Secara unik mengidentifikasi penginstalan tertentu dari aplikasi Firebase. Nilai ini perlu diambil melalui Firebase SDK. |
|
string |
Opsional. ID unik untuk pengguna. Lihat artikel User-ID untuk analisis lintas platform guna mendapatkan informasi lebih lanjut tentang ID ini. |
|
number |
Opsional. Stempel waktu Unix (dalam mikrodetik) untuk waktu yang berkaitan
dengan peristiwa. Stempel waktu ini hanya boleh disetel untuk mencatat peristiwa yang terjadi
di masa lalu. Nilai ini dapat diganti melalui
|
|
object |
Opsional. Properti pengguna untuk pengukuran. Lihat Properti pengguna untuk informasi lebih lanjut. |
|
object |
Opsional. Menetapkan setelan izin untuk permintaan. Lihat bagian izin untuk mengetahui informasi selengkapnya. |
|
boolean |
Opsional. Tetapkan ke true untuk menunjukkan bahwa data pengguna tidak boleh
digunakan untuk iklan yang dipersonalisasi.
|
|
array |
Wajib. Array item peristiwa. Maksimal 25 peristiwa dapat dikirim per permintaan. Lihat referensi peristiwa untuk semua peristiwa yang valid. |
|
string |
Wajib. Nama peristiwa. Lihat referensi peristiwa untuk semua opsi. |
|
object |
Opsional. Parameter peristiwa. Lihat peristiwa untuk mengetahui parameter yang disarankan untuk setiap peristiwa. |
Izin
Atribut consent
mengonfigurasi jenis dan status izin.
Jika Anda tidak menentukan consent
, Google Analytics akan menggunakan izin tersebut
setelan dari interaksi online yang sesuai untuk klien atau instance aplikasi.
Kunci | Jenis | Deskripsi |
---|---|---|
|
string |
Opsional. Menetapkan izin untuk mengirim data pengguna dari permintaan peristiwa dan properti pengguna ke Google untuk tujuan periklanan. Harus |
|
string |
Opsional. Menetapkan izin untuk iklan yang dipersonalisasi bagi pengguna. Harus |
Parameter kustom
Selain parameter yang ditentukan, Anda dapat menyertakan cakupan pengguna kustom, cakupan peristiwa, dan cakupan item parameter di dalam payload Measurement Protocol.
- Parameter kustom cakupan pengguna dapat disertakan dalam objek
user_properties
payload. - Parameter kustom cakupan peristiwa dapat disertakan dalam
events[].params
payload. - Parameter kustom cakupan item dapat disertakan dalam
Array
items
untuk setiap peristiwa.
Nilai yang direkomendasikan untuk peristiwa tertentu
Beberapa peristiwa memiliki parameter yang direkomendasikan. Lihat peristiwa untuk parameter yang direkomendasikan untuk semua peristiwa yang didukung.
Nama yang dicadangkan
Nama peristiwa yang dicadangkan
Nama peristiwa berikut dicadangkan dan tidak dapat digunakan:
ad_activeview
ad_click
ad_exposure
ad_query
ad_reward
adunit_exposure
app_clear_data
app_exception
app_install
app_remove
app_store_refund
app_update
app_upgrade
dynamic_link_app_open
dynamic_link_app_update
dynamic_link_first_open
error
firebase_campaign
firebase_in_app_message_action
firebase_in_app_message_dismiss
firebase_in_app_message_impression
first_open
first_visit
in_app_purchase
notification_dismiss
notification_foreground
notification_open
notification_receive
notification_send
os_update
session_start
user_engagement
Nama parameter yang dicadangkan
Nama parameter berikut dicadangkan dan tidak dapat digunakan:
firebase_conversion
Selain itu, nama parameter tidak boleh diawali dengan:
_ (underscore)
firebase_
ga_
google_
gtag.
Nama properti pengguna yang dicadangkan
Nama properti pengguna berikut dicadangkan dan tidak dapat digunakan:
first_open_time
first_visit_time
last_deep_link_referrer
user_id
first_open_after_install
Selain itu, nama properti pengguna tidak dapat diawali dengan:
_ (underscore)
firebase_
ga_
google_