Dokumen ini menjelaskan cara mengirim hit umum ke Measurement Protocol.
Ringkasan
Dokumen ini menunjukkan cara memformat permintaan HTTP untuk mengirim jenis hit umum ke Measurement Protocol Google Analytics. Baca:
- Referensi protokol – deskripsi lengkap tentang cara memformat permintaan Protokol.
- Referensi parameter – daftar semua parameter yang diterima oleh Protokol.
Mengirim Nilai yang Diperlukan
Untuk mengirim data interaksi pengguna, buat permintaan POST HTTP ke endpoint ini.
POST /collect HTTP/1.1 Host: www.google-analytics.com payload_data
Parameter berikut diperlukan untuk setiap payload:
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t= // Hit Type.
Setiap payload harus berisi jenis hit yang valid, dan setiap jenis hit memiliki kumpulan kolom wajib diisinya sendiri. Jadi, untuk mengirim kunjungan halaman untuk
halaman /home, gunakan payload berikut:
v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fhome
Bagian di bawah ini memberikan contoh jenis hit umum.
Mengelompokkan beberapa klik dalam satu permintaan
Untuk mengirim beberapa hit dalam satu permintaan, gunakan endpoint /batch, bukan /collect, dan tentukan setiap payload di barisnya masing-masing.
Misalnya, untuk mengirim klik kunjungan halaman untuk halaman "Beranda", "Tentang Kami", dan "Kontak" di situs, Anda dapat mengirim permintaan batch berikut.
POST /batch HTTP/1.1 Host: www.google-analytics.com v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fhome v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fabout v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fcontact
Batasan batch
Selain batasan standar hit Measurement Protocol, permintaan batch memiliki batasan tambahan berikut:
- Maksimum 20 hit dapat ditentukan per permintaan.
- Ukuran total semua payload hit tidak boleh lebih dari 16 ribu byte.
- Tidak ada payload hit tunggal yang dapat lebih besar dari 8K byte.
Mengirim Jenis Hit Umum
Berikut adalah contoh cara mengirim jenis hit umum ke Google Analytics.
Selain contoh tersebut, Anda dapat mengombinasikan berbagai parameter
untuk mencapai hubungan data baru. Misalnya, untuk memahami
halaman mana yang terjadi dalam suatu peristiwa, kirim parameter pagePath,
p, bersama dengan parameter pelacakan peristiwa seperti yang dijelaskan di bawah.
Baca referensi parameter untuk melihat daftar lengkap semua parameter yang dapat Anda kirim ke Google Analytics.
Pelacakan Halaman
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=pageview // Pageview hit type. &dh=mydemo.com // Document hostname. &dp=/home // Page. &dt=homepage // Title.
Lihat klik ini di Measurement Protocol Hit Builder.
Pelacakan Peristiwa
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type &ec=video // Event Category. Required. &ea=play // Event Action. Required. &el=holiday // Event label. &ev=300 // Event value.
Lihat klik ini di Measurement Protocol Hit Builder.
Pelacakan Enhanced E-commerce
Hit Enhanced E-commerce harus digunakan sebagai pengganti hit E-commerce. Jika Anda telah menerapkan pelacakan E-commerce dan ingin mulai menggunakan pelacakan Enhanced E-commerce, ada dua opsi:
Menggunakan properti baru
Anda dapat membuat properti baru dan mengirim hit Enhanced E-commerce ke properti baru.
Melakukan migrasi properti yang ada
Migrasikan hit E-commerce ke hit Enhanced E-commerce, dengan mengikuti contoh di bawah. Data transaksi dan item yang sebelumnya dikumpulkan menggunakan hit E-commerce tidak akan terpengaruh dan akan tetap tersedia di properti dan tampilan yang menjadi tujuan pengirimannya.
Mengukur Tayangan
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=pageview // Pageview hit type. &dh=mydemo.com // Document hostname. &dp=/home // Page. &dt=homepage // Title. &il1nm=Search%20Results // Impression list 1. Required. &il1pi1id=P12345 // Product Impression 1 ID. Either ID or name must be set. &il1pi1nm=Android%20Warhol%20T-Shirt // Product Impression 1 name. Either ID or name must be set. &il1pi1ca=Apparel%2FT-Shirts // Product Impression 1 category. &il1pi1br=Google // Product Impression 1 brand. &il1pi1va=Black // Product Impression 1 variant. &il1pi1ps=1 // Product Impression 1 position. &il1pi1cd1=Member // Custom dimension. &il2nm=Recommended%20Products // Impression list 2. &il2pi1nm=Yellow%20T-Shirt // Product Impression 1 name. &il2pi2nm=Red%20T-Shirt // Product Impression 2 name.
Lihat klik ini di Measurement Protocol Hit Builder.
Mengukur Tindakan
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type. &ec=UX // Event Category. Required. &ea=click // Event Action. Required. &el=Results // Event label. &pa=click // Product action (click). Required. &pal=Search%20Results // Product Action List. &pr1id=P12345 // Product 1 ID. Either ID or name must be set. &pr1nm=Android%20Warhol%20T-Shirt // Product 1 name. Either ID or name must be set. &pr1ca=Apparel // Product 1 category. &pr1br=Google // Product 1 brand. &pr1va=Black // Product 1 variant. &pr1ps=1 // Product 1 position.
Lihat klik ini di Measurement Protocol Hit Builder.
Menggabungkan Tayangan dan Tindakan
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type. &ec=UX // Event Category. Required. &ea=click // Event Action. Required. &el=Results // Event label. &pa=detail // Product action (detail). Required. &pr1id=P12345 // Product 1 ID. Either ID or name must be set. &pr1nm=Android%20Warhol%20T-Shirt // Product 1 name. Either ID or name must be set. &pr1ca=Apparel // Product 1 category. &pr1br=Google // Product 1 brand. &pr1va=Black // Product 1 variant. &pr1ps=1 // Product 1 position. &il1nm=Related%20Products // Impression list. &il1pi1id=P12345 // Product Impression 1 ID. &il1pi1nm=Android%20Warhol%20T-Shirt // Product Impression 1 name. &il1pi1ca=Apparel%2FT-Shirts // Product Impression 1 category. &il1pi1br=Google // Product Impression 1 brand. &il1pi1va=Black // Product Impression 1 variant. &il1pi1ps=1 // Product Impression 1 position.
Lihat klik ini di Measurement Protocol Hit Builder.
Mengukur Pembelian
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=pageview // Pageview hit type. &dh=mydemo.com // Document hostname. &dp=/receipt // Page. &dt=Receipt%20Page // Title. &ti=T12345 // Transaction ID. Required. &ta=Google%20Store%20-%20Online // Affiliation. &tr=37.39 // Revenue. &tt=2.85 // Tax. &ts=5.34 // Shipping. &tcc=SUMMER2013 // Transaction coupon. &pa=purchase // Product action (purchase). Required. &pr1id=P12345 // Product 1 ID. Either ID or name must be set. &pr1nm=Android%20Warhol%20T-Shirt // Product 1 name. Either ID or name must be set. &pr1ca=Apparel // Product 1 category. &pr1br=Google // Product 1 brand. &pr1va=Black // Product 1 variant. &pr1ps=1 // Product 1 position.
Lihat klik ini di Measurement Protocol Hit Builder.
Mengukur Pengembalian Dana
Jika Anda perlu mengirim data pengembalian dana menggunakan peristiwa dan peristiwa tersebut bukan bagian dari perilaku di tempat yang diukur secara normal (yaitu bukan dimulai oleh pengguna), sebaiknya Anda mengirim peristiwa non-interaksi. Hal ini akan mencegah metrik seperti rasio pantulan, durasi sesi, dsb. terpengaruh oleh peristiwa tersebut.
// Refund an entire transaction and send with a non-interaction event. v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type. &ec=Ecommerce // Event Category. Required. &ea=Refund // Event Action. Required. &ni=1 // Non-interaction parameter. &ti=T12345 // Transaction ID. Required. &pa=refund // Product action (refund). Required.
Lihat klik ini di Measurement Protocol Hit Builder.
// Refund a single product. v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type. &ec=Ecommerce // Event Category. Required. &ea=Refund // Event Action. Required. &ni=1 // Non-interaction parameter. &ti=T12345 // Transaction ID. Required. &pa=refund // Product action (refund). Required. &pr1id=P12345 // Product 1 ID. Required. &pr1qt=1 // Product 1 quantity. Required.
Lihat klik ini di Measurement Protocol Hit Builder.
Mengukur Proses Checkout
1. Mengukur Langkah Checkout
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=pageview // Pageview hit type. &dh=mydemo.com // Document hostname. &dp=/checkout // Page. &dt=Checkout // Title. &pa=checkout // Product action (checkout). &pr1id=P12345 // Product 1 ID. Either ID or name must be set. &pr1nm=Android%20Warhol%20T-Shirt // Product 1 name. Either ID or name must be set. &pr1ca=Apparel // Product 1 category. &pr1br=Google // Product 1 brand. &pr1va=Black // Product 1 variant. &pr1pr=29.20 // Product 1 Price. &pr1qt=1 // Product 1 quantity. &cos=1 // Checkout step #1. &col=Visa // Checkout step option.
Lihat klik ini di Measurement Protocol Hit Builder.
2. Mengukur Opsi Checkout
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type &ec=Checkout // Event Category. Required. &ea=Option // Event Action. Required. &pa=checkout_option // Product action (checkout_option). &cos=2 // Checkout step. &col=FedEx // Checkout step option.
Lihat klik ini di Measurement Protocol Hit Builder.
Mengukur Promosi Internal
Tayangan Promosi
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=pageview // Pageview hit type. &dh=mydemo.com // Document hostname. &dp=/home // Page. &dt=homepage // Title. &promo1id=PROMO_1234 // Promotion 1 ID. Either ID or name must be set. &promo1nm=Summer%20Sale // Promotion 1 name. Either ID or name must be set. &promo1cr=summer_banner2 // Promotion Creative. &promo1ps=banner_slot1 // Promotion Position.
Lihat klik ini di Measurement Protocol Hit Builder.
Klik Promosi
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type &ec=Internal%20Promotions // Event Category. Required. &ea=click // Event Action. Required. &el=Summer%20Sale // Event label. &promoa=click // Promotion action (click). Required. &promo1id=PROMO_1234 // Promotion 1 ID. Either ID or name must be set. &promo1nm=Summer%20Sale // Promotion 1 name. Either ID or name must be set. &promo1cr=summer_banner2 // Promotion Creative. &promo1ps=banner_slot1 // Promotion Position.
Lihat klik ini di Measurement Protocol Hit Builder.
Pelacakan E-commerce
Untuk mengirim data e-commerce, kirim satu hit transaction untuk
mewakili seluruh transaksi, lalu kirim hit item
untuk setiap item dalam transaksi. ID transaksi ti
menautkan semua hit untuk mewakili seluruh pembelian.
Hit Transaksi
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=transaction // Transaction hit type. &ti=12345 // transaction ID. Required. &ta=westernWear // Transaction affiliation. &tr=50.00 // Transaction revenue. &ts=32.00 // Transaction shipping. &tt=12.00 // Transaction tax. &cu=EUR // Currency code.
Lihat klik ini di Measurement Protocol Hit Builder.
Hit Item
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=item // Item hit type. &ti=12345 // Transaction ID. Required. &in=sofa // Item name. Required. &ip=300 // Item price. &iq=2 // Item quantity. &ic=u3eqds43 // Item code / SKU. &iv=furniture // Item variation / category. &cu=EUR // Currency code.
Lihat klik ini di Measurement Protocol Hit Builder.
Interaksi Sosial
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=social // Social hit type. &sa=like // Social Action. Required. &sn=facebook // Social Network. Required. &st=/home // Social Target. Required.
Lihat klik ini di Measurement Protocol Hit Builder.
Pelacakan Pengecualian
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=exception // Exception hit type. &exd=IOException // Exception description. &exf=1 // Exception is fatal?
Lihat klik ini di Measurement Protocol Hit Builder.
Pelacakan Waktu Pengguna
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=timing // Timing hit type. &utc=jsonLoader // Timing category. &utv=load // Timing variable. &utt=5000 // Timing time. &utl=jQuery // Timing label. // These values are part of browser load times &dns=100 // DNS load time. &pdt=20 // Page download time. &rrt=32 // Redirect time. &tcp=56 // TCP connect time. &srt=12 // Server response time.
Lihat klik ini di Measurement Protocol Hit Builder.
Pelacakan Aplikasi / Layar
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=screenview // Screenview hit type. &an=funTimes // App name. &av=1.5.0 // App version. &aid=com.foo.App // App Id. &aiid=com.android.vending // App Installer Id. &cd=Home // Screen name / content description.
Lihat klik ini di Measurement Protocol Hit Builder.
Menggunakan Server Proxy
Beberapa lingkungan tidak dapat mengirim hit ke Google Analytics secara langsung. Contohnya adalah ponsel lama yang tidak dapat menjalankan JavaScript atau intranet perusahaan di balik firewall. Dalam kasus ini, merupakan hal yang umum untuk mengirimkan permintaan ke server proxy yang kemudian menggunakan Measurement Protocol untuk meneruskan hit ke Google Analytics.
Untuk mengumpulkan IP dan agen pengguna dari perangkat klien, bukan server proxy, Anda dapat menentukan kedua nilai dalam Measurement Protocol, dan keduanya akan menggantikan nilai yang biasanya diperoleh Google Analytics dari header permintaan.
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=pageview // Pageview hit type. &uip=1.2.3.4 // IP address override. &ua=Opera/9.80 // User agent override.
Lihat klik ini di Measurement Protocol Hit Builder.