Mengirim peristiwa Measurement Protocol ke Google Analytics

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

Pilih platform yang ingin Anda lihat dalam panduan ini:

Format permintaan

Measurement Protocol Google Analytics 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 secret baru, buka Admin > Pengumpulan dan perubahan data > Aliran data > pilih aliran data Anda > Rahasia API 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.

Anda harus memberikan isi permintaan dalam format isi POST JSON untuk Measurement Protocol. Berikut contohnya:

  {
   "client_id": "CLIENT_ID",
   "events": [
      {
        "name": "login",
        "params": {
          "method": "Google",
          "session_id": "SESSION_ID",
          "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 penghitungan sesi.

Coba

Berikut contoh yang dapat Anda gunakan untuk mengirim beberapa peristiwa sekaligus. Contoh ini mengirimkan peristiwa tutorial_begin dan peristiwa join_group ke server Google Analytics Anda, menyertakan informasi geografis menggunakan kolom user_location, dan menyertakan informasi perangkat menggunakan kolom device.

const measurementId = "MEASUREMENT_ID";
const apiSecret = "API_SECRET";

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    client_id: "CLIENT_ID",
    events: [
      {
        name: "tutorial_begin",
        params: {
          "session_id": "SESSION_ID",
          "engagement_time_msec": 100
        }
      },
      {
        name: "join_group",
        params: {
          "group_id": "G_12345",
          "session_id": "SESSION_ID",
          "engagement_time_msec": 150
        }
      }
    ],
    user_location: {
      city: "Mountain View",
      region_id: "US-CA",
      country_id: "US",
      subcontinent_id: "021",
      continent_id: "019"
    },
    device: {
      category: "mobile",
      language: "en",
      screen_resolution: "1280x2856",
      operating_system: "Android",
      operating_system_version: "14",
      model: "Pixel 9 Pro",
      brand: "Google",
      browser: "Chrome",
      browser_version: "136.0.7103.60"
    }
  })
});

Mengganti stempel waktu

Measurement Protocol menggunakan stempel waktu pertama yang ditemukannya dalam daftar berikut untuk setiap peristiwa dalam permintaan:

1. timestamp_micros acara.
2. timestamp_micros permintaan.
3. Waktu saat Measurement Protocol menerima permintaan.

Contoh berikut mengirimkan stempel waktu tingkat permintaan yang berlaku untuk semua peristiwa dalam permintaan. Akibatnya, Measurement Protocol menetapkan stempel waktu requestUnixEpochTimeInMicros untuk peristiwa tutorial_begin dan join_group.

{
  "timestamp_micros": requestUnixEpochTimeInMicros,
  "events": [
    {
      "name": "tutorial_begin"
    },
    {
      "name": "join_group",
      "params": {
        "group_id": "G_12345",
      }
    }
  ]
}

Contoh berikut mengirimkan stempel waktu tingkat permintaan dan stempel waktu tingkat peristiwa. Akibatnya, Measurement Protocol menetapkan stempel waktu tutorialBeginUnixEpochTimeInMicros untuk peristiwa tutorial_begin dan stempel waktu requestUnixEpochTimeInMicros untuk peristiwa join_group.

{
  "timestamp_micros": requestUnixEpochTimeInMicros,
  "events": [
    {
      "name": "tutorial_begin",
      "timestamp_micros": tutorialBeginUnixEpochTimeInMicros
    },
    {
      "name": "join_group",
      "params": {
        "group_id": "G_12345",
      }
    }
  ]
}

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 36 karakter atau kurang.
• Nama peristiwa harus terdiri dari 40 karakter atau kurang, 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, termasuk nilai parameter item, harus terdiri dari 100 karakter atau kurang untuk properti Google Analytics standar, dan 500 karakter atau kurang untuk properti Google Analytics 360.
• Parameter item dapat memiliki maksimal 10 parameter kustom.
• Isi POST harus lebih kecil dari 130 KB.
• Peristiwa App Measurement Protocol yang dikirim ke Google Analytics tidak mengisi audiens Penelusuran di Google Ads untuk pengguna aplikasi.

Untuk persyaratan tambahan setiap kasus penggunaan, lihat kasus penggunaan umum.