Bekerja dengan Measurement Protocol

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:

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 diisi sendiri. Jadi, untuk mengirim kunjungan halaman untuk halaman /home, Anda harus menggunakan 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 hit 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 hit kunjungan halaman untuk halaman "Beranda", "Tentang Kami", dan "Kontak" di suatu 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:

  • Maksimal 20 hit dapat ditentukan per permintaan.
  • Ukuran total semua payload hit tidak boleh lebih dari 16 ribu byte.
  • Tidak ada payload hit tunggal yang boleh lebih dari 8 ribu byte.

Mengirim Jenis Hit Umum

Berikut adalah contoh cara mengirim jenis hit umum ke Google Analytics. Selain contoh ini, Anda dapat mencampur dan mencocokkan berbagai parameter untuk memperoleh hubungan data baru. Misalnya, untuk memahami di halaman mana peristiwa terjadi, 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 hit ini di Builder Hit Measurement Protocol.

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 hit ini di Builder Hit Measurement Protocol.

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 awalnya 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 hit ini di Builder Hit Measurement Protocol.

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 hit ini di Builder Hit Measurement Protocol.

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 hit ini di Builder Hit Measurement Protocol.

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 hit ini di Builder Hit Measurement Protocol.

Mengukur Pengembalian Dana

Jika Anda perlu mengirim data pengembalian dana menggunakan peristiwa dan peristiwa tersebut bukan bagian dari perilaku di tempat yang biasa diukur (yaitu, bukan dimulai oleh pengguna), sebaiknya Anda mengirim peristiwa non-interaksi. Dengan tindakan ini, metrik seperti rasio pantulan, durasi sesi, dll. tidak akan 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 hit ini di Builder Hit Measurement Protocol.

 // 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 hit ini di Builder Hit Measurement Protocol.

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 hit ini di Builder Hit Measurement Protocol.

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 hit ini di Builder Hit Measurement Protocol.

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 hit ini di Builder Hit Measurement Protocol.

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 hit ini di Builder Hit Measurement Protocol.

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 bersama-sama 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 hit ini di Builder Hit Measurement Protocol.

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 hit ini di Builder Hit Measurement Protocol.

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 hit ini di Builder Hit Measurement Protocol.

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 hit ini di Builder Hit Measurement Protocol.

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 hit ini di Builder Hit Measurement Protocol.

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 hit ini di Builder Hit Measurement Protocol.

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 belakang firewall. Dalam kasus ini, biasanya permintaan dikirim ke server proxy yang kemudian menggunakan Measurement Protocol untuk meneruskan hit ke Google Analytics.

Untuk mengumpulkan IP dan agen pengguna dari perangkat klien dan bukan dari server proxy, Anda dapat menentukan kedua nilai dalam Measurement Protocol, dan keduanya akan mengganti 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 hit ini di Builder Hit Measurement Protocol.