Mengirim peristiwa Measurement Protocol ke Google Analytics

Panduan ini menjelaskan cara mengirim peristiwa aliran data web dan aplikasi Measurement Protocol Google Analytics ke server Google Analytics, sehingga Anda dapat melihat peristiwa Measurement Protocol di laporan Google Analytics.

Pilih platform yang ingin Anda lihat dalam panduan ini:

Memformat permintaan

Measurement Protocol untuk Google Analytics 4 hanya mendukung permintaan POST HTTP.

Untuk mengirim peristiwa, gunakan format berikut:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>

Anda harus menyediakan hal berikut dalam URL permintaan:

  • api_secret: RAHASIA API yang dibuat di UI Google Analytics.

    Untuk membuat rahasia baru, buka Admin > Aliran Data > pilih aliran data Anda > Measurement Protocol > Buat.

  • measurement_id: ID pengukuran yang terkait dengan aliran data, yang ditemukan di UI Google Analytics pada bagian Admin > Aliran Data > pilih aliran data Anda > ID Pengukuran.

    measurement_id bukan merupakan ID Aliran Data.

Lihat parameter kueri untuk mendapatkan referensi lengkap.

Anda harus menyediakan hal berikut dalam isi permintaan:

  • client_id: ID unik untuk klien. ID ini berbeda dengan app_instance_id Firebase. Gunakan gtag.js('get').

  • user_id: Opsional. ID unik untuk pengguna. Hanya dapat berisi karakter UTF-8. Lihat artikel User-ID untuk analisis lintas platform guna mendapatkan informasi lebih lanjut tentang ID ini.

  • consent: Opsional. Pelajari cara menetapkan setelan izin.

  • events: Array item peristiwa. Anda dapat menyertakan beberapa peristiwa dalam satu permintaan.

    Agar aktivitas pengguna ditampilkan dalam laporan seperti laporan Real-Time, engagement_time_msec dan session_id harus dimasukkan sebagai bagian dari params untuk event. Parameter engagement_time_msec harus mencerminkan waktu engagement peristiwa dalam milidetik.

    Berikut contohnya:

  {
   "client_id": "123456.7654321",
   "events": [
     {
        "name": "campaign_details",
        "params": {
          "campaign_id": "google_1234",
          "campaign": "Summer_fun",
          "source": "google",
          "medium": "cpc",
          "term": "summer+travel",
          "content": "logolink",
          "session_id": "123",
          "engagement_time_msec": "100"
        }
     }
   ]
  }

Meskipun session_start adalah nama peristiwa yang dicadangkan, pembuatan session_id baru akan membuat sesi baru tanpa perlu mengirim session_start. Pahami cara sesi dihitung.

Coba

Berikut contoh yang dapat Anda gunakan untuk mengirim peristiwa tutorial_begin ke server Google Analytics:

const measurement_id = `G-XXXXXXXXXX`;
const api_secret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurement_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    client_id: 'XXXXXXXXXX.YYYYYYYYYY',
    events: [{
      name: 'tutorial_begin',
      params: {},
    }]
  })
});

Batasan

Batasan berikut berlaku untuk mengirim peristiwa Measurement Protocol ke Google Analytics:

  • Permintaan dapat memiliki maksimal 25 peristiwa.
  • Peristiwa dapat memiliki maksimal 25 parameter.
  • Peristiwa dapat memiliki maksimal 25 properti pengguna.
  • Nama properti pengguna harus terdiri dari maksimal 24 karakter.
  • Nilai properti pengguna harus terdiri dari maksimal 36 karakter.
  • Nama peristiwa harus terdiri dari maksimal 40 karakter, hanya boleh berisi karakter alfanumerik dan garis bawah, serta harus diawali dengan karakter alfabet.
  • Nama parameter (termasuk parameter item) harus terdiri dari maksimal 40 karakter, hanya boleh berisi karakter alfanumerik dan garis bawah, serta harus diawali dengan karakter alfabet.
  • Nilai parameter yang mencakup nilai parameter item harus terdiri dari maksimal 100 karakter untuk properti Google Analytics 4 standar, dan maksimal 500 karakter untuk properti Google Analytics 360.
  • Parameter item dapat memiliki maksimal 10 parameter kustom.
  • Isi POST harus lebih kecil dari 130 KB.
  • Atribusi tingkat peristiwa dari peristiwa Measurement Protocol didukung hingga 63 hari setelah peristiwa online pemberian tag terbaru untuk ekspor konversi ke Iklan dan integrasi media lainnya, meskipun jika periode konversi untuk peristiwa konversi lebih besar dari 63 hari. Sebaliknya, atribusi tingkat peristiwa untuk pemberian tag pada peristiwa online didukung untuk seluruh periode konversi.
  • Untuk tujuan pemasaran ulang, Anda dapat bergabung ke peristiwa Measurement Protocol hingga jumlah hari berikut setelah peristiwa online terbaru dengan cookie atau ID perangkat terkait:
    • Aliran data web: 30 hari
    • Aliran data aplikasi: 42 hari
  • Peristiwa Measurement Protocol aplikasi yang dikirim ke Google Analytics 4 tidak mengisi audiens Penelusuran di Google Ads untuk pengguna aplikasi.