Peristiwa yang direkomendasikan Google Analytics

Berikut adalah daftar peristiwa yang direkomendasikan. Anda juga dapat membuat dan mengirim peristiwa kustom Anda sendiri.

Penting: Gunakan app_instance_id, bukan client_id untuk peristiwa yang dikirim ke aliran data aplikasi.

Saat membuat nama peristiwa kustom, Anda harus:

1. Ikuti Aturan penamaan peristiwa.
2. Hindari Nama dan awalan yang dicadangkan.
3. Tetap dalam Batas pengumpulan peristiwa, seperti batas 40 karakter untuk nama peristiwa dan parameter.

Lihat Memulai untuk mengetahui detailnya.

Jika Anda melakukan upgrade dari Measurement Protocol, lihat Mengupgrade dari Measurement Protocol untuk mengetahui petunjuknya.

Untuk semua properti

ad_impression

Peristiwa ini hanya tersedia untuk aliran Aplikasi.

Gunakan peristiwa ini saat pengguna melihat tayangan iklan.

• ad_impression yang dikirim menggunakan Measurement Protocol tidak akan disertakan dalam ekspor ke platform periklanan lain seperti Google Ads.
• Mengirim peristiwa ad_impression menggunakan Measurement Protocol dapat menyebabkan tayangan iklan duplikat jika Anda telah mengonfigurasi pemberian tag atau SDK untuk produk iklan Google yang tertaut. Kirim peristiwa ad_impression menggunakan Measurement Protocol hanya jika peristiwa tersebut tidak direkam oleh pemberian tag atau SDK.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
currency	string	Tidak	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Jika Anda menetapkan conversion_value, currency diperlukan agar metrik pendapatan bisa dihitung secara akurat.
conversion_value	number	Tidak	3,99	Nilai tayangan iklan. * conversion_value biasanya diperlukan agar pelaporan relevan. * currency diperlukan jika Anda menetapkan conversion_value.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
ad_platform	string	Tidak	MoPub	Platform iklan.
ad_source	string	Tidak	AdColony	Sumber iklan.
ad_format	string	Tidak	Banner	Format iklan.
ad_unit_name	string	Tidak	Banner_03	Nama unit iklan.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa ad_impression menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "ad_impression",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 3.99,
      "additionalEventParameters": [
        {
          "parameterName": "ad_platform",
          "value": "MoPub"
        },
        {
          "parameterName": "ad_source",
          "value": "AdColony"
        },
        {
          "parameterName": "ad_format",
          "value": "Banner"
        },
        {
          "parameterName": "ad_unit_name",
          "value": "Banner_03"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "app_instance_id": "app_instance_id",
    "events": [{
      "name": "ad_impression",
      "params": {
        "ad_platform": "MoPub",
        "ad_source": "AdColony",
        "ad_format": "Banner",
        "ad_unit_name": "Banner_03",
        "currency": "USD",
        "value": 3.99
      }
    }]
  })
});

earn_virtual_currency

Peristiwa ini mengukur saat pengguna mendapatkan mata uang virtual dalam game. Catat peristiwa ini bersama dengan spend_virtual_currency agar dapat memahami perputaran uang virtual Anda dengan lebih baik.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
conversion_value	number	Tidak	5	Nilai mata uang virtual.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
virtual_currency_name	string	Tidak	Gems	Nama mata uang virtual.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa earn_virtual_currency menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "earn_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "earn_virtual_currency",
      "params": {
        "virtual_currency_name": "Gems",
        "value": 5
      }
    }]
  })
});

join_group

Catat peristiwa ini saat pengguna bergabung dengan grup seperti guild, tim, atau keluarga. Gunakan peristiwa ini untuk menganalisis seberapa populer grup atau fitur sosial tertentu.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
group_id	string	Tidak	G_12345	ID grup.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa join_group menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "join_group",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "group_id",
          "value": "G_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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":"join_group",
      "params":{
        "group_id":"G_12345"
      }
    }]
  })
});

login

Kirim peristiwa ini untuk menandakan bahwa pengguna telah login ke situs atau aplikasi Anda.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
method	string	Tidak	Google	Metode yang digunakan untuk login.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa login menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "login",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "login",
      "params": {
        "method": "Google"
      }
    }]
  })
});

screen_view

Peristiwa ini hanya tersedia untuk aliran Aplikasi.

Gunakan peristiwa ini untuk menandakan bahwa transisi layar telah terjadi.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
screen_class	string	Tidak	MainActivity	Class layar.
screen_name	string	Tidak	About	Nama layar.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa screen_view menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "screen_view",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "additionalEventParameters": [
        {
          "parameterName": "screen_class",
          "value": "MainActivity"
        },
        {
          "parameterName": "screen_name",
          "value": "About"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "app_instance_id": "app_instance_id",
    "events": [{
      "name": "screen_view",
      "params": {
        "screen_class": "MainActivity",
        "screen_name": "About"
      }
    }]
  })
});

search

Catat peristiwa ini untuk mendeteksi waktu pengguna melakukan penelusuran. Anda dapat menggunakan peristiwa ini untuk mengidentifikasi hal yang ditelusuri pengguna di situs atau aplikasi Anda. Misalnya, Anda dapat mengirim peristiwa ini saat pengguna melihat halaman hasil penelusuran setelah melakukan penelusuran.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
search_term	string	Ya	t-shirts	Istilah yang ditelusuri.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa search menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "search",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "t-shirts"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "search",
      "params": {
        "search_term": "t-shirts"
      }
    }]
  })
});

select_content

Peristiwa ini menandakan bahwa pengguna telah memilih beberapa konten dari jenis tertentu. Peristiwa ini dapat membantu Anda mengidentifikasi konten populer dan kategori konten di situs atau aplikasi Anda.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
content_type	string	Tidak	product	Jenis konten yang dipilih.
content_id	string	Tidak	C_12345	ID untuk konten yang dipilih. Nilai harus menyertakan setidaknya satu karakter non-numerik.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa select_content menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_content",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "content_type",
          "value": "product"
        },
        {
          "parameterName": "content_id",
          "value": "C_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "select_content",
      "params": {
        "content_type": "product",
        "content_id": "C_12345"
      }
    }]
  })
});

share

Gunakan peristiwa ini saat pengguna membagikan konten.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
cart_data.items	Item[]	Tidak		Item untuk peristiwa. Tetapkan kolom cart_data.items pada objek Event.

Kolom item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_id	string	Ya	I_12345	ID unik untuk item. Tetapkan kolom item_id pada objek Item.
unit_price	number	Ya	27,67	Harga satuan tidak termasuk pajak, pengiriman, dan diskon cakupan peristiwa (tingkat transaksi) untuk item ini. Jika item memiliki diskon cakupan item, gunakan harga per unit yang didiskon. Misalnya, jika item memiliki harga satuan 27,67 dan diskon satuan 6,66, tetapkan unitPrice ke 21,01.
quantity	number	Ya	1	Jumlah unit yang dibeli untuk item tertentu ini.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
method	string	Tidak	Twitter	Metode yang digunakan untuk membagikan konten.
content_type	string	Tidak	image	Jenis konten yang dibagikan.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa share menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "share",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "C_12345",
            "quantity": 1,
            "unitPrice": 27.67
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Twitter"
        },
        {
          "parameterName": "content_type",
          "value": "image"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "share",
      "params": {
        "method": "Twitter",
        "content_type": "image",
        "item_id": "C_12345"
      }
    }]
  })
});

sign_up

Peristiwa ini menandakan bahwa pengguna telah mendaftar untuk membuat akun. Gunakan peristiwa ini untuk memahami berbagai perilaku pengguna yang login dan logout.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
method	string	Tidak	Google	Metode yang digunakan untuk mendaftar.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa sign_up menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "sign_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "sign_up",
      "params": {
        "method": "Google"
      }
    }]
  })
});

spend_virtual_currency

Peristiwa ini mengukur penjualan item virtual di aplikasi dan membantu Anda mengidentifikasi item virtual yang paling populer.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
conversion_value	number	Ya	5	Nilai mata uang virtual.
cart_data.items	Item[]	Tidak		Item untuk peristiwa. Tetapkan kolom cart_data.items pada objek Event.

Kolom item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_id	string	Ya	I_12345	ID unik untuk item. Tetapkan kolom item_id pada objek Item.
unit_price	number	Ya	27,67	Harga satuan tidak termasuk pajak, pengiriman, dan diskon cakupan peristiwa (tingkat transaksi) untuk item ini. Jika item memiliki diskon cakupan item, gunakan harga per unit yang didiskon. Misalnya, jika item memiliki harga satuan 27,67 dan diskon satuan 6,66, tetapkan unitPrice ke 21,01.
quantity	number	Ya	1	Jumlah unit yang dibeli untuk item tertentu ini.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_name	string	Tidak	Starter Boost	Nama item yang dibeli dengan mata uang virtual.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
virtual_currency_name	string	Ya	Gems	Nama mata uang virtual.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa spend_virtual_currency menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "spend_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "I_12345",
            "quantity": 1,
            "unitPrice": 27.67,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Starter Boost"
              }
            ]
          }
        ]
      },
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "spend_virtual_currency",
      "params": {
        "value": 5,
        "virtual_currency_name": "Gems",
        "item_name": "Starter Boost"
      }
    }]
  })
});

tutorial_begin

Peristiwa ini menandakan bahwa proses orientasi dimulai. Gunakan peristiwa ini dalam funnel bersama dengan peristiwa tutorial_complete untuk mengetahui jumlah pengguna yang menyelesaikan tutorial.

Parameter

Tidak ada parameter yang disarankan untuk peristiwa ini.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa tutorial_begin menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_begin",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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"
    }]
  })
});

tutorial_complete

Peristiwa ini menandakan bahwa proses orientasi pengguna telah selesai. Gunakan peristiwa ini dalam funnel bersama dengan peristiwa tutorial_begin untuk mengetahui jumlah pengguna yang menyelesaikan tutorial.

Parameter

Tidak ada parameter yang disarankan untuk peristiwa ini.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa tutorial_complete menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_complete",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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_complete"
    }]
  })
});

view_search_results

Catat peristiwa ini saat pengguna melihat hasil penelusuran. Perhatikan bahwa Anda dapat mengaktifkan peristiwa view_search_results untuk pengumpulan otomatis melalui Pengukuran peristiwa yang ditingkatkan di Google Analytics.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
search_term	string	Tidak	Clothing	Istilah yang digunakan untuk penelusuran.

Catatan: Peristiwa view_search_results mengirimkan parameter unique_search_term dengan nilai 1 jika istilah penelusuran bersifat unik pada sesi saat ini. Jika istilah penelusuran telah dikirimkan pada sesi saat ini, nilai parameternya adalah 0.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa view_search_results menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_search_results",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "Clothing"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "view_search_results",
      "params": {
        "search_term": "Clothing"
      }
    }]
  })
});

campaign_details

Gunakan peristiwa ini untuk mengirim detail kampanye yang akan diterapkan ke peristiwa dengan stempel waktu yang lebih besar dari atau sama dengan stempel waktu peristiwa campaign_details.

Catatan: Peristiwa campaign_details tidak akan terlihat di laporan Google Analytics atau DebugView. Jika Anda telah mengaktifkan ekspor BigQuery, peristiwa ini akan ada di data ekspor peristiwa BigQuery Anda.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
campaign_id	string	Tidak	google_1234	ID kampanye.
campaign	string	Tidak	Summer_fun	Nama yang digunakan untuk mengidentifikasi promosi atau kampanye strategis tertentu.
source	string	Tidak	google	Sumber traffic kampanye (mis. google, email, dll.).
medium	string	Tidak	cpc	Media kampanye (mis. email, biaya per klik, dll.)
term	string	Tidak	summer+travel	Istilah kampanye yang digunakan dengan penelusuran berbayar untuk menyediakan kata kunci untuk iklan.
content	string	Tidak	logolink	Konten kampanye yang digunakan untuk pengujian A/B dan iklan bertarget konten untuk membedakan iklan atau link yang mengarah ke URL yang sama.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa campaign_details menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "campaign_details",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "campaign_id",
          "value": "google_1234"
        },
        {
          "parameterName": "campaign",
          "value": "Summer_fun"
        },
        {
          "parameterName": "source",
          "value": "google"
        },
        {
          "parameterName": "medium",
          "value": "cpc"
        },
        {
          "parameterName": "term",
          "value": "summer+travel"
        },
        {
          "parameterName": "content",
          "value": "logolink"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "campaign_details",
      "params": {
        "campaign_id": "google_1234",
        "campaign": "Summer_fun",
        "source": "google",
        "medium": "cpc",
        "term": "summer+travel",
        "content": "logolink"
      }
    }]
  })
});

Penjualan online

add_payment_info

Peristiwa ini menandakan bahwa pengguna telah mengirimkan informasi pembayarannya dalam proses checkout e-commerce.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
currency	string	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Metrik nilai pada peristiwa view_item tidak berkontribusi pada pendapatan * Jika Anda menetapkan conversion_value, currency diperlukan agar metrik pendapatan dapat dihitung secara akurat.
conversion_value	number	Ya*	30.03	Nilai uang dari peristiwa. * Tetapkan conversion_value ke jumlah (price * quantity) untuk semua item di items. Jangan sertakan shipping atau tax. * conversion_value biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai peristiwa utama, sebaiknya tetapkan conversion_value. * currency diperlukan jika Anda menetapkan conversion_value.
cart_data.items	Item[]	Ya		Item untuk peristiwa. Tetapkan kolom cart_data.items pada objek Event.
cart_data.coupon_codes	string[]	Tidak	SUMMER_FUN	Kode kupon yang terkait dengan acara. Tetapkan kolom coupon_codes pada objek CartData. * Hanya berikan satu kode kupon dalam daftar ini. * Ini tidak bergantung pada kode kupon tingkat item.

Kolom item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_id	string	Ya	I_12345	ID unik untuk item. Tetapkan kolom item_id pada objek Item.
unit_price	number	Ya	27,67	Harga satuan tidak termasuk pajak, pengiriman, dan diskon cakupan peristiwa (tingkat transaksi) untuk item ini. Jika item memiliki diskon cakupan item, gunakan harga per unit yang didiskon. Misalnya, jika item memiliki harga satuan 27,67 dan diskon satuan 6,66, tetapkan unitPrice ke 21,01.
quantity	number	Ya	1	Jumlah unit yang dibeli untuk item tertentu ini.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
payment_type	string	Tidak	Credit Card	Metode pembayaran yang dipilih.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa add_payment_info menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_payment_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "payment_type",
          "value": "Credit Card"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "add_payment_info",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "payment_type": "Credit Card",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_shipping_info

Peristiwa ini menandakan bahwa pengguna telah mengirimkan informasi pengirimannya dalam proses checkout e-commerce.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
currency	string	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Metrik nilai pada peristiwa view_item tidak berkontribusi pada pendapatan * Jika Anda menetapkan conversion_value, currency diperlukan agar metrik pendapatan dapat dihitung secara akurat.
conversion_value	number	Ya*	30.03	Nilai uang dari peristiwa. * Tetapkan conversion_value ke jumlah (price * quantity) untuk semua item di items. Jangan sertakan shipping atau tax. * conversion_value biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai peristiwa utama, sebaiknya tetapkan conversion_value. * currency diperlukan jika Anda menetapkan conversion_value.
cart_data.items	Item[]	Ya		Item untuk peristiwa. Tetapkan kolom cart_data.items pada objek Event.
cart_data.coupon_codes	string[]	Tidak	SUMMER_FUN	Kode kupon yang terkait dengan acara. Tetapkan kolom coupon_codes pada objek CartData. * Hanya berikan satu kode kupon dalam daftar ini. * Ini tidak bergantung pada kode kupon tingkat item.

Kolom item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_id	string	Ya	I_12345	ID unik untuk item. Tetapkan kolom item_id pada objek Item.
unit_price	number	Ya	27,67	Harga satuan tidak termasuk pajak, pengiriman, dan diskon cakupan peristiwa (tingkat transaksi) untuk item ini. Jika item memiliki diskon cakupan item, gunakan harga per unit yang didiskon. Misalnya, jika item memiliki harga satuan 27,67 dan diskon satuan 6,66, tetapkan unitPrice ke 21,01.
quantity	number	Ya	1	Jumlah unit yang dibeli untuk item tertentu ini.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
shipping_tier	string	Tidak	Ground	Jenis pengiriman (misalnya, Ground, Air, Next-day) yang dipilih untuk pengiriman item yang dibeli.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa add_shipping_info menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_shipping_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping_tier",
          "value": "Ground"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "add_shipping_info",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping_tier": "Ground",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_cart

Peristiwa ini menandakan bahwa item telah ditambahkan ke keranjang untuk dibeli.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
currency	string	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Metrik nilai pada peristiwa view_item tidak berkontribusi pada pendapatan * Jika Anda menetapkan conversion_value, currency diperlukan agar metrik pendapatan dapat dihitung secara akurat.
conversion_value	number	Ya*	30.03	Nilai uang dari peristiwa. * Tetapkan conversion_value ke jumlah (price * quantity) untuk semua item di items. Jangan sertakan shipping atau tax. * conversion_value biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai peristiwa utama, sebaiknya tetapkan conversion_value. * currency diperlukan jika Anda menetapkan conversion_value.
cart_data.items	Item[]	Ya		Item untuk peristiwa. Tetapkan kolom cart_data.items pada objek Event.

Kolom item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_id	string	Ya	I_12345	ID unik untuk item. Tetapkan kolom item_id pada objek Item.
unit_price	number	Ya	27,67	Harga satuan tidak termasuk pajak, pengiriman, dan diskon cakupan peristiwa (tingkat transaksi) untuk item ini. Jika item memiliki diskon cakupan item, gunakan harga per unit yang didiskon. Misalnya, jika item memiliki harga satuan 27,67 dan diskon satuan 6,66, tetapkan unitPrice ke 21,01.
quantity	number	Ya	1	Jumlah unit yang dibeli untuk item tertentu ini.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_name	string	Ya*	Stan and Friends Tee	Nama item. *item_id atau item_name harus ada.
affiliation	string	Tidak	Google Store	Afiliasi produk untuk menetapkan perusahaan pemasok atau lokasi toko fisik. Catatan: affiliation hanya tersedia di cakupan item.
coupon	string	Tidak	SUMMER_FUN	Nama/kode kupon yang terkait dengan item. Parameter coupon tingkat peristiwa dan tingkat item bersifat independen.
discount	number	Tidak	2.22	Nilai diskon uang per unit yang terkait dengan item.
index	number	Tidak	5	Indeks/posisi item dalam daftar.
item_brand	string	Tidak	Google	Merek item.
item_category	string	Tidak	Apparel	Kategori item. Jika digunakan sebagai bagian dari taksonomi atau hierarki kategori, ini akan menjadi kategori pertama.
item_category2	string	Tidak	Adult	Hierarki kategori kedua atau taksonomi tambahan untuk item.
item_category3	string	Tidak	Shirts	Hierarki kategori ketiga atau taksonomi tambahan untuk item.
item_category4	string	Tidak	Crew	Hierarki kategori keempat atau taksonomi tambahan untuk item.
item_category5	string	Tidak	Short sleeve	Hierarki kategori kelima atau taksonomi tambahan untuk item.
item_list_id	string	Tidak	related_products	ID daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_id tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_id tingkat peristiwa akan digunakan, jika ada.
item_list_name	string	Tidak	Related products	Nama daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_name tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_name tingkat peristiwa akan digunakan, jika ada.
item_variant	string	Tidak	green	Varian item atau kode unik atau deskripsi item untuk detail/opsi item tambahan.
location_id	string	Tidak	ChIJIQBpAG2ahYAR_6128GcTUEo (ID Tempat Google untuk San Francisco)	Lokasi fisik yang dikaitkan dengan item (misalnya lokasi toko fisik). Sebaiknya gunakan ID Tempat Google yang sesuai dengan item terkait. ID lokasi kustom juga dapat digunakan. Catatan: location_id hanya tersedia di cakupan item.

Selain parameter yang telah ditentukan, Anda dapat menyertakan hingga 27 parameter kustom dalam array items.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa add_to_cart menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "add_to_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_wishlist

Peristiwa ini menandakan bahwa item telah ditambahkan ke wishlist. Gunakan peristiwa ini untuk mengidentifikasi item hadiah populer di aplikasi Anda.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
currency	string	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Metrik nilai pada peristiwa view_item tidak berkontribusi pada pendapatan * Jika Anda menetapkan conversion_value, currency diperlukan agar metrik pendapatan dapat dihitung secara akurat.
conversion_value	number	Ya*	30.03	Nilai uang dari peristiwa. * Tetapkan conversion_value ke jumlah (price * quantity) untuk semua item di items. Jangan sertakan shipping atau tax. * conversion_value biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai peristiwa utama, sebaiknya tetapkan conversion_value. * currency diperlukan jika Anda menetapkan conversion_value.
cart_data.items	Item[]	Ya		Item untuk peristiwa. Tetapkan kolom cart_data.items pada objek Event.

Kolom item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_id	string	Ya	I_12345	ID unik untuk item. Tetapkan kolom item_id pada objek Item.
unit_price	number	Ya	27,67	Harga satuan tidak termasuk pajak, pengiriman, dan diskon cakupan peristiwa (tingkat transaksi) untuk item ini. Jika item memiliki diskon cakupan item, gunakan harga per unit yang didiskon. Misalnya, jika item memiliki harga satuan 27,67 dan diskon satuan 6,66, tetapkan unitPrice ke 21,01.
quantity	number	Ya	1	Jumlah unit yang dibeli untuk item tertentu ini.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_name	string	Ya*	Stan and Friends Tee	Nama item. *item_id atau item_name harus ada.
affiliation	string	Tidak	Google Store	Afiliasi produk untuk menetapkan perusahaan pemasok atau lokasi toko fisik. Catatan: affiliation hanya tersedia di cakupan item.
coupon	string	Tidak	SUMMER_FUN	Nama/kode kupon yang terkait dengan item. Parameter coupon tingkat peristiwa dan tingkat item bersifat independen.
discount	number	Tidak	2.22	Nilai diskon uang per unit yang terkait dengan item.
index	number	Tidak	5	Indeks/posisi item dalam daftar.
item_brand	string	Tidak	Google	Merek item.
item_category	string	Tidak	Apparel	Kategori item. Jika digunakan sebagai bagian dari taksonomi atau hierarki kategori, ini akan menjadi kategori pertama.
item_category2	string	Tidak	Adult	Hierarki kategori kedua atau taksonomi tambahan untuk item.
item_category3	string	Tidak	Shirts	Hierarki kategori ketiga atau taksonomi tambahan untuk item.
item_category4	string	Tidak	Crew	Hierarki kategori keempat atau taksonomi tambahan untuk item.
item_category5	string	Tidak	Short sleeve	Hierarki kategori kelima atau taksonomi tambahan untuk item.
item_list_id	string	Tidak	related_products	ID daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_id tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_id tingkat peristiwa akan digunakan, jika ada.
item_list_name	string	Tidak	Related products	Nama daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_name tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_name tingkat peristiwa akan digunakan, jika ada.
item_variant	string	Tidak	green	Varian item atau kode unik atau deskripsi item untuk detail/opsi item tambahan.
location_id	string	Tidak	ChIJIQBpAG2ahYAR_6128GcTUEo (ID Tempat Google untuk San Francisco)	Lokasi fisik yang dikaitkan dengan item (misalnya lokasi toko fisik). Sebaiknya gunakan ID Tempat Google yang sesuai dengan item terkait. ID lokasi kustom juga dapat digunakan. Catatan: location_id hanya tersedia di cakupan item.

Selain parameter yang telah ditentukan, Anda dapat menyertakan hingga 27 parameter kustom dalam array items.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa add_to_wishlist menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_wishlist",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "add_to_wishlist",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

begin_checkout

Peristiwa ini menandakan bahwa pengguna telah memulai proses checkout.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
currency	string	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Metrik nilai pada peristiwa view_item tidak berkontribusi pada pendapatan * Jika Anda menetapkan conversion_value, currency diperlukan agar metrik pendapatan dapat dihitung secara akurat.
conversion_value	number	Ya*	30.03	Nilai uang dari peristiwa. * Tetapkan conversion_value ke jumlah (price * quantity) untuk semua item di items. Jangan sertakan shipping atau tax. * conversion_value biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai peristiwa utama, sebaiknya tetapkan conversion_value. * currency diperlukan jika Anda menetapkan conversion_value.
cart_data.items	Item[]	Ya		Item untuk peristiwa. Tetapkan kolom cart_data.items pada objek Event.
cart_data.coupon_codes	string[]	Tidak	SUMMER_FUN	Kode kupon yang terkait dengan acara. Tetapkan kolom coupon_codes pada objek CartData. * Hanya berikan satu kode kupon dalam daftar ini. * Ini tidak bergantung pada kode kupon tingkat item.

Kolom item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_id	string	Ya	I_12345	ID unik untuk item. Tetapkan kolom item_id pada objek Item.
unit_price	number	Ya	27,67	Harga satuan tidak termasuk pajak, pengiriman, dan diskon cakupan peristiwa (tingkat transaksi) untuk item ini. Jika item memiliki diskon cakupan item, gunakan harga per unit yang didiskon. Misalnya, jika item memiliki harga satuan 27,67 dan diskon satuan 6,66, tetapkan unitPrice ke 21,01.
quantity	number	Ya	1	Jumlah unit yang dibeli untuk item tertentu ini.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_name	string	Ya*	Stan and Friends Tee	Nama item. *item_id atau item_name harus ada.
affiliation	string	Tidak	Google Store	Afiliasi produk untuk menetapkan perusahaan pemasok atau lokasi toko fisik. Catatan: affiliation hanya tersedia di cakupan item.
coupon	string	Tidak	SUMMER_FUN	Nama/kode kupon yang terkait dengan item. Parameter coupon tingkat peristiwa dan tingkat item bersifat independen.
discount	number	Tidak	2.22	Nilai diskon uang per unit yang terkait dengan item.
index	number	Tidak	5	Indeks/posisi item dalam daftar.
item_brand	string	Tidak	Google	Merek item.
item_category	string	Tidak	Apparel	Kategori item. Jika digunakan sebagai bagian dari taksonomi atau hierarki kategori, ini akan menjadi kategori pertama.
item_category2	string	Tidak	Adult	Hierarki kategori kedua atau taksonomi tambahan untuk item.
item_category3	string	Tidak	Shirts	Hierarki kategori ketiga atau taksonomi tambahan untuk item.
item_category4	string	Tidak	Crew	Hierarki kategori keempat atau taksonomi tambahan untuk item.
item_category5	string	Tidak	Short sleeve	Hierarki kategori kelima atau taksonomi tambahan untuk item.
item_list_id	string	Tidak	related_products	ID daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_id tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_id tingkat peristiwa akan digunakan, jika ada.
item_list_name	string	Tidak	Related products	Nama daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_name tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_name tingkat peristiwa akan digunakan, jika ada.
item_variant	string	Tidak	green	Varian item atau kode unik atau deskripsi item untuk detail/opsi item tambahan.
location_id	string	Tidak	ChIJIQBpAG2ahYAR_6128GcTUEo (ID Tempat Google untuk San Francisco)	Lokasi fisik yang dikaitkan dengan item (misalnya lokasi toko fisik). Sebaiknya gunakan ID Tempat Google yang sesuai dengan item terkait. ID lokasi kustom juga dapat digunakan. Catatan: location_id hanya tersedia di cakupan item.

Selain parameter yang telah ditentukan, Anda dapat menyertakan hingga 27 parameter kustom dalam array items.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa begin_checkout menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "begin_checkout",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "begin_checkout",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

in_app_purchase

Peristiwa ini hanya tersedia untuk aliran Aplikasi.

Gunakan peristiwa ini saat pengguna melakukan pembelian dalam aplikasi.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
currency	string	Ya*	USD	Mata uang conversion_value acara, dalam format ISO 4217 3 huruf. * Jika Anda menetapkan conversion_value, currency diperlukan agar metrik pendapatan dapat dihitung secara akurat.
conversion_value	number	Ya*	30.03	Nilai uang dari peristiwa. * conversion_value biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai peristiwa utama, sebaiknya tetapkan conversion_value. * currency diperlukan jika Anda menetapkan conversion_value.
cart_data.items	Item[]	Tidak		Item untuk peristiwa. Tetapkan kolom cart_data.items pada objek Event.

Kolom item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_id	string	Ya	I_12345	ID unik untuk item. Tetapkan kolom item_id pada objek Item.
unit_price	number	Ya	27,67	Harga satuan tidak termasuk pajak, pengiriman, dan diskon cakupan peristiwa (tingkat transaksi) untuk item ini. Jika item memiliki diskon cakupan item, gunakan harga per unit yang didiskon. Misalnya, jika item memiliki harga satuan 27,67 dan diskon satuan 6,66, tetapkan unitPrice ke 21,01.
quantity	number	Ya	1	Jumlah unit yang dibeli untuk item tertentu ini.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
product_id	string	Tidak	ABC123456789	ID produk.
subscription	boolean	Tidak	true	Menunjukkan apakah pembelian adalah langganan. Jika tidak disetel, nilai defaultnya adalah false.
free_trial	boolean	Tidak	true	Menunjukkan apakah acara ini untuk uji coba gratis langganan. Jika tidak disetel, nilai defaultnya adalah false.
price_is_discounted	boolean	Tidak	false	Menunjukkan apakah price didiskon. Jika tidak disetel, nilai defaultnya adalah false.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa in_app_purchase menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "in_app_purchase",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "cartData": {
        "items": [
          {
            "itemId": "ABC123456789",
            "quantity": 3,
            "unitPrice": 10.01
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "subscription",
          "value": true
        },
        {
          "parameterName": "free_trial",
          "value": false
        },
        {
          "parameterName": "price_is_discounted",
          "value": false
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "app_instance_id": "app_instance_id",
    "events":[{
      "name":"in_app_purchase",
      "params":{
        "currency": "USD",
        "value": 30.03,
        "quantity": 3,
        "product_id": "ABC123456789",
        "subscription": true,
        "free_trial": false,
        "price_is_discounted": false
      }
    }]
  })
});

purchase

Peristiwa ini menandakan bahwa satu item atau lebih dibeli oleh pengguna.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
currency	string	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Metrik nilai pada peristiwa view_item tidak berkontribusi pada pendapatan * Jika Anda menetapkan conversion_value, currency diperlukan agar metrik pendapatan dapat dihitung secara akurat.
conversion_value	number	Ya*	30.03	Nilai uang dari peristiwa. * Tetapkan conversion_value ke jumlah (price * quantity) untuk semua item di items. Jangan sertakan shipping atau tax. * conversion_value biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai peristiwa utama, sebaiknya tetapkan conversion_value. * currency diperlukan jika Anda menetapkan conversion_value.
transaction_id	string	Ya	T_12345	ID unik transaksi. Parameter transaction_id membantu Anda agar tidak ada peristiwa duplikat untuk satu pembelian. Tetapkan kolom transaction_id pada objek Event.
user_properties.customer_type	CustomerType	Tidak	NEW	Apakah konversi berasal dari pelanggan NEW atau RETURNING.
cart_data.items	Item[]	Ya		Item untuk peristiwa. Tetapkan kolom cart_data.items pada objek Event.
cart_data.coupon_codes	string[]	Tidak	SUMMER_FUN	Kode kupon yang terkait dengan acara. Tetapkan kolom coupon_codes pada objek CartData. * Hanya berikan satu kode kupon dalam daftar ini. * Ini tidak bergantung pada kode kupon tingkat item.

Kolom item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_id	string	Ya	I_12345	ID unik untuk item. Tetapkan kolom item_id pada objek Item.
unit_price	number	Ya	27,67	Harga satuan tidak termasuk pajak, pengiriman, dan diskon cakupan peristiwa (tingkat transaksi) untuk item ini. Jika item memiliki diskon cakupan item, gunakan harga per unit yang didiskon. Misalnya, jika item memiliki harga satuan 27,67 dan diskon satuan 6,66, tetapkan unitPrice ke 21,01.
quantity	number	Ya	1	Jumlah unit yang dibeli untuk item tertentu ini.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
shipping	number	Tidak	3.33	Biaya pengiriman yang terkait dengan transaksi.
tax	number	Tidak	1.11	Biaya pajak yang terkait dengan transaksi.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_name	string	Ya*	Stan and Friends Tee	Nama item. *item_id atau item_name harus ada.
affiliation	string	Tidak	Google Store	Afiliasi produk untuk menetapkan perusahaan pemasok atau lokasi toko fisik. Catatan: affiliation hanya tersedia di cakupan item.
coupon	string	Tidak	SUMMER_FUN	Nama/kode kupon yang terkait dengan item. Parameter coupon tingkat peristiwa dan tingkat item bersifat independen.
discount	number	Tidak	2.22	Nilai diskon uang per unit yang terkait dengan item.
index	number	Tidak	5	Indeks/posisi item dalam daftar.
item_brand	string	Tidak	Google	Merek item.
item_category	string	Tidak	Apparel	Kategori item. Jika digunakan sebagai bagian dari taksonomi atau hierarki kategori, ini akan menjadi kategori pertama.
item_category2	string	Tidak	Adult	Hierarki kategori kedua atau taksonomi tambahan untuk item.
item_category3	string	Tidak	Shirts	Hierarki kategori ketiga atau taksonomi tambahan untuk item.
item_category4	string	Tidak	Crew	Hierarki kategori keempat atau taksonomi tambahan untuk item.
item_category5	string	Tidak	Short sleeve	Hierarki kategori kelima atau taksonomi tambahan untuk item.
item_list_id	string	Tidak	related_products	ID daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_id tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_id tingkat peristiwa akan digunakan, jika ada.
item_list_name	string	Tidak	Related products	Nama daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_name tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_name tingkat peristiwa akan digunakan, jika ada.
item_variant	string	Tidak	green	Varian item atau kode unik atau deskripsi item untuk detail/opsi item tambahan.
location_id	string	Tidak	ChIJIQBpAG2ahYAR_6128GcTUEo (ID Tempat Google untuk San Francisco)	Lokasi fisik yang dikaitkan dengan item (misalnya lokasi toko fisik). Sebaiknya gunakan ID Tempat Google yang sesuai dengan item terkait. ID lokasi kustom juga dapat digunakan. Catatan: location_id hanya tersedia di cakupan item.

Selain parameter yang telah ditentukan, Anda dapat menyertakan hingga 27 parameter kustom dalam array items.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa purchase menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "purchase",
      "transactionId": "TRANSACTION_ID",
      "conversionValue": 83.99,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "userProperties": {
        "customerType": "RETURNING"
      },
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 3,
            "unitPrice": 10.01,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Stan and Friends Tee"
              },
              {
                "parameterName": "affiliation",
                "value": "Google Merchandise Store"
              },
              {
                "parameterName": "discount",
                "value": "2.22"
              },
              {
                "parameterName": "index",
                "value": "0"
              },
              {
                "parameterName": "item_brand",
                "value": "Google"
              },
              {
                "parameterName": "item_category",
                "value": "Apparel"
              },
              {
                "parameterName": "item_category2",
                "value": "Adult"
              },
              {
                "parameterName": "item_category3",
                "value": "Shirts"
              },
              {
                "parameterName": "item_category4",
                "value": "Crew"
              },
              {
                "parameterName": "item_category5",
                "value": "Short sleeve"
              },
              {
                "parameterName": "item_list_id",
                "value": "related_products"
              },
              {
                "parameterName": "item_list_name",
                "value": "Related Products"
              },
              {
                "parameterName": "item_variant",
                "value": "green"
              },
              {
                "parameterName": "location_id",
                "value": "ChIJIQBpAG2ahYAR_6128GcTUEo"
              },
              {
                "parameterName": "google_business_vertical",
                "value": "retail"
              }
            ]
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": "3.33"
        },
        {
          "parameterName": "tax",
          "value": "1.11"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "purchase",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
            {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

refund

Peristiwa ini menandakan bahwa satu atau beberapa item dikembalikan dananya kepada pengguna.

Catatan: Sebaiknya sertakan informasi item dalam peristiwa refund untuk melihat metrik pengembalian dana tingkat item di Analytics.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
currency	string	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Metrik nilai pada peristiwa view_item tidak berkontribusi pada pendapatan * Jika Anda menetapkan conversion_value, currency diperlukan agar metrik pendapatan dapat dihitung secara akurat.
conversion_value	number	Ya*	30.03	Nilai uang dari peristiwa. * Tetapkan conversion_value ke jumlah (price * quantity) untuk semua item di items. Jangan sertakan shipping atau tax. * conversion_value biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai peristiwa utama, sebaiknya tetapkan conversion_value. * currency diperlukan jika Anda menetapkan conversion_value.
transaction_id	string	Ya	T_12345	ID unik transaksi.
cart_data.items	Item[]	Tidak		Item untuk peristiwa. Tetapkan kolom cart_data.items pada objek Event.
cart_data.coupon_codes	string[]	Tidak	SUMMER_FUN	Kode kupon yang terkait dengan acara. Tetapkan kolom coupon_codes pada objek CartData. * Hanya berikan satu kode kupon dalam daftar ini. * Ini tidak bergantung pada kode kupon tingkat item.

Kolom item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_id	string	Ya	I_12345	ID unik untuk item. Tetapkan kolom item_id pada objek Item.
unit_price	number	Ya	27,67	Harga satuan tidak termasuk pajak, pengiriman, dan diskon cakupan peristiwa (tingkat transaksi) untuk item ini. Jika item memiliki diskon cakupan item, gunakan harga per unit yang didiskon. Misalnya, jika item memiliki harga satuan 27,67 dan diskon satuan 6,66, tetapkan unitPrice ke 21,01.
quantity	number	Ya	1	Jumlah unit yang dibeli untuk item tertentu ini.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
shipping	number	Tidak	3.33	Biaya pengiriman yang terkait dengan transaksi.
tax	number	Tidak	1.11	Biaya pajak yang terkait dengan transaksi.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_name	string	Ya*	Stan and Friends Tee	Nama item. *item_id atau item_name harus ada.
affiliation	string	Tidak	Google Store	Afiliasi produk untuk menetapkan perusahaan pemasok atau lokasi toko fisik. Catatan: affiliation hanya tersedia di cakupan item.
coupon	string	Tidak	SUMMER_FUN	Nama/kode kupon yang terkait dengan item. Parameter coupon tingkat peristiwa dan tingkat item bersifat independen.
discount	number	Tidak	2.22	Nilai diskon uang per unit yang terkait dengan item.
index	number	Tidak	5	Indeks/posisi item dalam daftar.
item_brand	string	Tidak	Google	Merek item.
item_category	string	Tidak	Apparel	Kategori item. Jika digunakan sebagai bagian dari taksonomi atau hierarki kategori, ini akan menjadi kategori pertama.
item_category2	string	Tidak	Adult	Hierarki kategori kedua atau taksonomi tambahan untuk item.
item_category3	string	Tidak	Shirts	Hierarki kategori ketiga atau taksonomi tambahan untuk item.
item_category4	string	Tidak	Crew	Hierarki kategori keempat atau taksonomi tambahan untuk item.
item_category5	string	Tidak	Short sleeve	Hierarki kategori kelima atau taksonomi tambahan untuk item.
item_list_id	string	Tidak	related_products	ID daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_id tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_id tingkat peristiwa akan digunakan, jika ada.
item_list_name	string	Tidak	Related products	Nama daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_name tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_name tingkat peristiwa akan digunakan, jika ada.
item_variant	string	Tidak	green	Varian item atau kode unik atau deskripsi item untuk detail/opsi item tambahan.
location_id	string	Tidak	ChIJIQBpAG2ahYAR_6128GcTUEo (ID Tempat Google untuk San Francisco)	Lokasi fisik yang dikaitkan dengan item (misalnya lokasi toko fisik). Sebaiknya gunakan ID Tempat Google yang sesuai dengan item terkait. ID lokasi kustom juga dapat digunakan. Catatan: location_id hanya tersedia di cakupan item.

Selain parameter yang telah ditentukan, Anda dapat menyertakan hingga 27 parameter kustom dalam array items.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa refund menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "refund",
      "conversionValue": 30.03,
      "currency": "USD",
      "transactionId": "T_12345",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": 3.33
        },
        {
          "parameterName": "tax",
          "value": 1.11
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "refund",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

remove_from_cart

Peristiwa ini menandakan bahwa item telah dihapus dari keranjang.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
currency	string	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Metrik nilai pada peristiwa view_item tidak berkontribusi pada pendapatan * Jika Anda menetapkan conversion_value, currency diperlukan agar metrik pendapatan dapat dihitung secara akurat.
conversion_value	number	Ya*	30.03	Nilai uang dari peristiwa. * Tetapkan conversion_value ke jumlah (price * quantity) untuk semua item di items. Jangan sertakan shipping atau tax. * conversion_value biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai peristiwa utama, sebaiknya tetapkan conversion_value. * currency diperlukan jika Anda menetapkan conversion_value.
cart_data.items	Item[]	Ya		Item untuk peristiwa. Tetapkan kolom cart_data.items pada objek Event.

Kolom item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_id	string	Ya	I_12345	ID unik untuk item. Tetapkan kolom item_id pada objek Item.
unit_price	number	Ya	27,67	Harga satuan tidak termasuk pajak, pengiriman, dan diskon cakupan peristiwa (tingkat transaksi) untuk item ini. Jika item memiliki diskon cakupan item, gunakan harga per unit yang didiskon. Misalnya, jika item memiliki harga satuan 27,67 dan diskon satuan 6,66, tetapkan unitPrice ke 21,01.
quantity	number	Ya	1	Jumlah unit yang dibeli untuk item tertentu ini.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_name	string	Ya*	Stan and Friends Tee	Nama item. *item_id atau item_name harus ada.
affiliation	string	Tidak	Google Store	Afiliasi produk untuk menetapkan perusahaan pemasok atau lokasi toko fisik. Catatan: affiliation hanya tersedia di cakupan item.
coupon	string	Tidak	SUMMER_FUN	Nama/kode kupon yang terkait dengan item. Parameter coupon tingkat peristiwa dan tingkat item bersifat independen.
discount	number	Tidak	2.22	Nilai diskon uang per unit yang terkait dengan item.
index	number	Tidak	5	Indeks/posisi item dalam daftar.
item_brand	string	Tidak	Google	Merek item.
item_category	string	Tidak	Apparel	Kategori item. Jika digunakan sebagai bagian dari taksonomi atau hierarki kategori, ini akan menjadi kategori pertama.
item_category2	string	Tidak	Adult	Hierarki kategori kedua atau taksonomi tambahan untuk item.
item_category3	string	Tidak	Shirts	Hierarki kategori ketiga atau taksonomi tambahan untuk item.
item_category4	string	Tidak	Crew	Hierarki kategori keempat atau taksonomi tambahan untuk item.
item_category5	string	Tidak	Short sleeve	Hierarki kategori kelima atau taksonomi tambahan untuk item.
item_list_id	string	Tidak	related_products	ID daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_id tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_id tingkat peristiwa akan digunakan, jika ada.
item_list_name	string	Tidak	Related products	Nama daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_name tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_name tingkat peristiwa akan digunakan, jika ada.
item_variant	string	Tidak	green	Varian item atau kode unik atau deskripsi item untuk detail/opsi item tambahan.
location_id	string	Tidak	ChIJIQBpAG2ahYAR_6128GcTUEo (ID Tempat Google untuk San Francisco)	Lokasi fisik yang dikaitkan dengan item (misalnya lokasi toko fisik). Sebaiknya gunakan ID Tempat Google yang sesuai dengan item terkait. ID lokasi kustom juga dapat digunakan. Catatan: location_id hanya tersedia di cakupan item.

Selain parameter yang telah ditentukan, Anda dapat menyertakan hingga 27 parameter kustom dalam array items.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa remove_from_cart menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "remove_from_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "remove_from_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_item

Peristiwa ini menandakan bahwa item dipilih dari daftar.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
cart_data.items	Item[]	Ya*		Item untuk peristiwa. * Array items kemungkinan akan memiliki satu elemen, yang mewakili item yang dipilih. Jika beberapa elemen tersedia, hanya elemen pertama di items yang akan digunakan. Tetapkan kolom cart_data.items pada objek Event.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_list_id	string	Tidak	related_products	ID daftar tempat item ditampilkan kepada pengguna. Akan diabaikan jika ditetapkan pada tingkat item.
item_list_name	string	Tidak	Related products	Nama daftar tempat item ditampilkan kepada pengguna. Akan diabaikan jika ditetapkan pada tingkat item.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_name	string	Ya*	Stan and Friends Tee	Nama item. *item_id atau item_name harus ada.
affiliation	string	Tidak	Google Store	Afiliasi produk untuk menetapkan perusahaan pemasok atau lokasi toko fisik. Catatan: affiliation hanya tersedia di cakupan item.
coupon	string	Tidak	SUMMER_FUN	Nama/kode kupon yang terkait dengan item. Parameter coupon tingkat peristiwa dan tingkat item bersifat independen.
discount	number	Tidak	2.22	Nilai diskon uang per unit yang terkait dengan item.
index	number	Tidak	5	Indeks/posisi item dalam daftar.
item_brand	string	Tidak	Google	Merek item.
item_category	string	Tidak	Apparel	Kategori item. Jika digunakan sebagai bagian dari taksonomi atau hierarki kategori, ini akan menjadi kategori pertama.
item_category2	string	Tidak	Adult	Hierarki kategori kedua atau taksonomi tambahan untuk item.
item_category3	string	Tidak	Shirts	Hierarki kategori ketiga atau taksonomi tambahan untuk item.
item_category4	string	Tidak	Crew	Hierarki kategori keempat atau taksonomi tambahan untuk item.
item_category5	string	Tidak	Short sleeve	Hierarki kategori kelima atau taksonomi tambahan untuk item.
item_list_id	string	Tidak	related_products	ID daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_id tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_id tingkat peristiwa akan digunakan, jika ada.
item_list_name	string	Tidak	Related products	Nama daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_name tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_name tingkat peristiwa akan digunakan, jika ada.
item_variant	string	Tidak	green	Varian item atau kode unik atau deskripsi item untuk detail/opsi item tambahan.
location_id	string	Tidak	ChIJIQBpAG2ahYAR_6128GcTUEo (ID Tempat Google untuk San Francisco)	Lokasi fisik yang dikaitkan dengan item (misalnya lokasi toko fisik). Sebaiknya gunakan ID Tempat Google yang sesuai dengan item terkait. ID lokasi kustom juga dapat digunakan. Catatan: location_id hanya tersedia di cakupan item.

Selain parameter yang telah ditentukan, Anda dapat menyertakan hingga 27 parameter kustom dalam array items.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa select_item menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_item",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "select_item",
      "params": {
        "item_list_id": "related_products",
        "item_list_name": "Related products",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_promotion

Peristiwa ini menandakan bahwa promosi dipilih dari daftar.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
cart_data.items	Item[]	Tidak		Item untuk peristiwa. Tetapkan kolom cart_data.items pada objek Event.

Kolom item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_id	string	Ya	I_12345	ID unik untuk item. Tetapkan kolom item_id pada objek Item.
unit_price	number	Ya	27,67	Harga satuan tidak termasuk pajak, pengiriman, dan diskon cakupan peristiwa (tingkat transaksi) untuk item ini. Jika item memiliki diskon cakupan item, gunakan harga per unit yang didiskon. Misalnya, jika item memiliki harga satuan 27,67 dan diskon satuan 6,66, tetapkan unitPrice ke 21,01.
quantity	number	Ya	1	Jumlah unit yang dibeli untuk item tertentu ini.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
creative_name	string	Tidak	summer_banner2	Nama materi iklan promosi.
creative_slot	string	Tidak	featured_app_1	Nama slot materi iklan promosi yang dikaitkan dengan peristiwa.
promotion_id	string	Tidak	P_12345	ID promosi yang dikaitkan dengan peristiwa.
promotion_name	string	Tidak	Summer Sale	Nama promosi yang dikaitkan dengan peristiwa.

Untuk mengisi dimensi promosi cakupan item, seperti "ID promosi item" atau "Nama promosi item", di laporan Google Analytics, Google Analytics terlebih dahulu mencari parameter promosi yang sesuai (promotion_id, promotion_name, creative_name, dan creative_slot) dalam setiap objek tertentu di array items peristiwa e-commerce Anda. Jika parameter tidak ditemukan dalam objek item, Google Analytics akan menggunakan nilai dari parameter *tingkat peristiwa* jika ada. Dimensi promosi cakupan item untuk item tertentu hanya akan dilaporkan sebagai "(not set)" jika parameter yang relevan tidak ada di *kedua* objek item dan parameter tingkat peristiwa. Parameter tingkat item selalu lebih diprioritaskan daripada parameter tingkat peristiwa.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_name	string	Ya*	Stan and Friends Tee	Nama item. *item_id atau item_name harus ada.
affiliation	string	Tidak	Google Store	Afiliasi produk untuk menetapkan perusahaan pemasok atau lokasi toko fisik. Catatan: affiliation hanya tersedia di cakupan item.
coupon	string	Tidak	SUMMER_FUN	Nama/kode kupon yang terkait dengan item. Parameter coupon tingkat peristiwa dan tingkat item bersifat independen.
creative_name	string	Tidak	summer_banner2	Nama materi iklan promosi. Jika tidak ditetapkan, defaultnya adalah creative_name tingkat peristiwa.
creative_slot	string	Tidak	featured_app_1	Nama slot materi iklan promosi yang dikaitkan dengan item. Jika tidak ditetapkan, defaultnya adalah creative_slot tingkat peristiwa.
discount	number	Tidak	2.22	Nilai diskon uang per unit yang terkait dengan item.
index	number	Tidak	5	Indeks/posisi item dalam daftar.
item_brand	string	Tidak	Google	Merek item.
item_category	string	Tidak	Apparel	Kategori item. Jika digunakan sebagai bagian dari taksonomi atau hierarki kategori, ini akan menjadi kategori pertama.
item_category2	string	Tidak	Adult	Hierarki kategori kedua atau taksonomi tambahan untuk item.
item_category3	string	Tidak	Shirts	Hierarki kategori ketiga atau taksonomi tambahan untuk item.
item_category4	string	Tidak	Crew	Hierarki kategori keempat atau taksonomi tambahan untuk item.
item_category5	string	Tidak	Short sleeve	Hierarki kategori kelima atau taksonomi tambahan untuk item.
item_list_id	string	Tidak	related_products	ID daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_id tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_id tingkat peristiwa akan digunakan, jika ada.
item_list_name	string	Tidak	Related products	Nama daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_name tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_name tingkat peristiwa akan digunakan, jika ada.
item_variant	string	Tidak	green	Varian item atau kode unik atau deskripsi item untuk detail/opsi item tambahan.
location_id	string	Tidak	ChIJIQBpAG2ahYAR_6128GcTUEo (ID Tempat Google untuk San Francisco)	Lokasi fisik yang dikaitkan dengan item (misalnya lokasi toko fisik). Sebaiknya gunakan ID Tempat Google yang sesuai dengan item terkait. ID lokasi kustom juga dapat digunakan. Catatan: location_id hanya tersedia di cakupan item.
promotion_id	string	Tidak	P_12345	ID promosi yang dikaitkan dengan item. Jika tidak ditetapkan, defaultnya adalah promotion_id tingkat peristiwa.
promotion_name	string	Tidak	Summer Sale	Nama promosi yang dikaitkan dengan item. Jika tidak ditetapkan, defaultnya adalah promotion_name tingkat peristiwa.

Selain parameter yang telah ditentukan, Anda dapat menyertakan hingga 27 parameter kustom dalam array items.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa select_promotion menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "select_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_cart

Peristiwa ini menandakan bahwa pengguna telah melihat keranjangnya.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
currency	string	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Metrik nilai pada peristiwa view_item tidak berkontribusi pada pendapatan * Jika Anda menetapkan conversion_value, currency diperlukan agar metrik pendapatan dapat dihitung secara akurat.
conversion_value	number	Ya*	30.03	Nilai uang dari peristiwa. * Tetapkan conversion_value ke jumlah (price * quantity) untuk semua item di items. Jangan sertakan shipping atau tax. * conversion_value biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai peristiwa utama, sebaiknya tetapkan conversion_value. * currency diperlukan jika Anda menetapkan conversion_value.
cart_data.items	Item[]	Ya		Item untuk peristiwa. Tetapkan kolom cart_data.items pada objek Event.

Kolom item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_id	string	Ya	I_12345	ID unik untuk item. Tetapkan kolom item_id pada objek Item.
unit_price	number	Ya	27,67	Harga satuan tidak termasuk pajak, pengiriman, dan diskon cakupan peristiwa (tingkat transaksi) untuk item ini. Jika item memiliki diskon cakupan item, gunakan harga per unit yang didiskon. Misalnya, jika item memiliki harga satuan 27,67 dan diskon satuan 6,66, tetapkan unitPrice ke 21,01.
quantity	number	Ya	1	Jumlah unit yang dibeli untuk item tertentu ini.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_name	string	Ya*	Stan and Friends Tee	Nama item. *item_id atau item_name harus ada.
affiliation	string	Tidak	Google Store	Afiliasi produk untuk menetapkan perusahaan pemasok atau lokasi toko fisik. Catatan: affiliation hanya tersedia di cakupan item.
coupon	string	Tidak	SUMMER_FUN	Nama/kode kupon yang terkait dengan item. Parameter coupon tingkat peristiwa dan tingkat item bersifat independen.
discount	number	Tidak	2.22	Nilai diskon uang per unit yang terkait dengan item.
index	number	Tidak	5	Indeks/posisi item dalam daftar.
item_brand	string	Tidak	Google	Merek item.
item_category	string	Tidak	Apparel	Kategori item. Jika digunakan sebagai bagian dari taksonomi atau hierarki kategori, ini akan menjadi kategori pertama.
item_category2	string	Tidak	Adult	Hierarki kategori kedua atau taksonomi tambahan untuk item.
item_category3	string	Tidak	Shirts	Hierarki kategori ketiga atau taksonomi tambahan untuk item.
item_category4	string	Tidak	Crew	Hierarki kategori keempat atau taksonomi tambahan untuk item.
item_category5	string	Tidak	Short sleeve	Hierarki kategori kelima atau taksonomi tambahan untuk item.
item_list_id	string	Tidak	related_products	ID daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_id tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_id tingkat peristiwa akan digunakan, jika ada.
item_list_name	string	Tidak	Related products	Nama daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_name tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_name tingkat peristiwa akan digunakan, jika ada.
item_variant	string	Tidak	green	Varian item atau kode unik atau deskripsi item untuk detail/opsi item tambahan.
location_id	string	Tidak	ChIJIQBpAG2ahYAR_6128GcTUEo (ID Tempat Google untuk San Francisco)	Lokasi fisik yang dikaitkan dengan item (misalnya lokasi toko fisik). Sebaiknya gunakan ID Tempat Google yang sesuai dengan item terkait. ID lokasi kustom juga dapat digunakan. Catatan: location_id hanya tersedia di cakupan item.

Selain parameter yang telah ditentukan, Anda dapat menyertakan hingga 27 parameter kustom dalam array items.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa view_cart menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_cart",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "view_cart",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_item

Peristiwa ini menandakan bahwa beberapa konten ditampilkan kepada pengguna. Gunakan peristiwa ini untuk menemukan item terpopuler yang dilihat pengguna.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
currency	string	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Metrik nilai pada peristiwa view_item tidak berkontribusi pada pendapatan * Jika Anda menetapkan conversion_value, currency diperlukan agar metrik pendapatan dapat dihitung secara akurat.
conversion_value	number	Ya*	30.03	Nilai uang dari peristiwa. * Tetapkan conversion_value ke jumlah (price * quantity) untuk semua item di items. Jangan sertakan shipping atau tax. * conversion_value biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai peristiwa utama, sebaiknya tetapkan conversion_value. * currency diperlukan jika Anda menetapkan conversion_value.
cart_data.items	Item[]	Ya		Item untuk peristiwa. Tetapkan kolom cart_data.items pada objek Event.

Kolom item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_id	string	Ya	I_12345	ID unik untuk item. Tetapkan kolom item_id pada objek Item.
unit_price	number	Ya	27,67	Harga satuan tidak termasuk pajak, pengiriman, dan diskon cakupan peristiwa (tingkat transaksi) untuk item ini. Jika item memiliki diskon cakupan item, gunakan harga per unit yang didiskon. Misalnya, jika item memiliki harga satuan 27,67 dan diskon satuan 6,66, tetapkan unitPrice ke 21,01.
quantity	number	Ya	1	Jumlah unit yang dibeli untuk item tertentu ini.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_name	string	Ya*	Stan and Friends Tee	Nama item. *item_id atau item_name harus ada.
affiliation	string	Tidak	Google Store	Afiliasi produk untuk menetapkan perusahaan pemasok atau lokasi toko fisik. Catatan: affiliation hanya tersedia di cakupan item.
coupon	string	Tidak	SUMMER_FUN	Nama/kode kupon yang terkait dengan item. Parameter coupon tingkat peristiwa dan tingkat item bersifat independen.
discount	number	Tidak	2.22	Nilai diskon uang per unit yang terkait dengan item.
index	number	Tidak	5	Indeks/posisi item dalam daftar.
item_brand	string	Tidak	Google	Merek item.
item_category	string	Tidak	Apparel	Kategori item. Jika digunakan sebagai bagian dari taksonomi atau hierarki kategori, ini akan menjadi kategori pertama.
item_category2	string	Tidak	Adult	Hierarki kategori kedua atau taksonomi tambahan untuk item.
item_category3	string	Tidak	Shirts	Hierarki kategori ketiga atau taksonomi tambahan untuk item.
item_category4	string	Tidak	Crew	Hierarki kategori keempat atau taksonomi tambahan untuk item.
item_category5	string	Tidak	Short sleeve	Hierarki kategori kelima atau taksonomi tambahan untuk item.
item_list_id	string	Tidak	related_products	ID daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_id tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_id tingkat peristiwa akan digunakan, jika ada.
item_list_name	string	Tidak	Related products	Nama daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_name tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_name tingkat peristiwa akan digunakan, jika ada.
item_variant	string	Tidak	green	Varian item atau kode unik atau deskripsi item untuk detail/opsi item tambahan.
location_id	string	Tidak	ChIJIQBpAG2ahYAR_6128GcTUEo (ID Tempat Google untuk San Francisco)	Lokasi fisik yang dikaitkan dengan item (misalnya lokasi toko fisik). Sebaiknya gunakan ID Tempat Google yang sesuai dengan item terkait. ID lokasi kustom juga dapat digunakan. Catatan: location_id hanya tersedia di cakupan item.

Selain parameter yang telah ditentukan, Anda dapat menyertakan hingga 27 parameter kustom dalam array items.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa view_item menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "view_item",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ],
      }
    }]
  })
});

view_item_list

Catat peristiwa ini saat pengguna melihat daftar item dari kategori tertentu.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
currency	string	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Metrik nilai pada peristiwa view_item tidak berkontribusi pada pendapatan * Jika Anda menetapkan conversion_value, currency diperlukan agar metrik pendapatan dapat dihitung secara akurat.
cart_data.items	Item[]	Ya		Item untuk peristiwa. Tetapkan kolom cart_data.items pada objek Event.

Kolom item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_id	string	Ya	I_12345	ID unik untuk item. Tetapkan kolom item_id pada objek Item.
unit_price	number	Ya	27,67	Harga satuan tidak termasuk pajak, pengiriman, dan diskon cakupan peristiwa (tingkat transaksi) untuk item ini. Jika item memiliki diskon cakupan item, gunakan harga per unit yang didiskon. Misalnya, jika item memiliki harga satuan 27,67 dan diskon satuan 6,66, tetapkan unitPrice ke 21,01.
quantity	number	Ya	1	Jumlah unit yang dibeli untuk item tertentu ini.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_name	string	Ya*	Stan and Friends Tee	Nama item. *item_id atau item_name harus ada.
affiliation	string	Tidak	Google Store	Afiliasi produk untuk menetapkan perusahaan pemasok atau lokasi toko fisik. Catatan: affiliation hanya tersedia di cakupan item.
coupon	string	Tidak	SUMMER_FUN	Nama/kode kupon yang terkait dengan item. Parameter coupon tingkat peristiwa dan tingkat item bersifat independen.
discount	number	Tidak	2.22	Nilai diskon uang per unit yang terkait dengan item.
index	number	Tidak	5	Indeks/posisi item dalam daftar.
item_brand	string	Tidak	Google	Merek item.
item_category	string	Tidak	Apparel	Kategori item. Jika digunakan sebagai bagian dari taksonomi atau hierarki kategori, ini akan menjadi kategori pertama.
item_category2	string	Tidak	Adult	Hierarki kategori kedua atau taksonomi tambahan untuk item.
item_category3	string	Tidak	Shirts	Hierarki kategori ketiga atau taksonomi tambahan untuk item.
item_category4	string	Tidak	Crew	Hierarki kategori keempat atau taksonomi tambahan untuk item.
item_category5	string	Tidak	Short sleeve	Hierarki kategori kelima atau taksonomi tambahan untuk item.
item_list_id	string	Tidak	related_products	ID daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_id tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_id tingkat peristiwa akan digunakan, jika ada.
item_list_name	string	Tidak	Related products	Nama daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_name tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_name tingkat peristiwa akan digunakan, jika ada.
item_variant	string	Tidak	green	Varian item atau kode unik atau deskripsi item untuk detail/opsi item tambahan.
location_id	string	Tidak	ChIJIQBpAG2ahYAR_6128GcTUEo (ID Tempat Google untuk San Francisco)	Lokasi fisik yang dikaitkan dengan item (misalnya lokasi toko fisik). Sebaiknya gunakan ID Tempat Google yang sesuai dengan item terkait. ID lokasi kustom juga dapat digunakan. Catatan: location_id hanya tersedia di cakupan item.

Selain parameter yang telah ditentukan, Anda dapat menyertakan hingga 27 parameter kustom dalam array items.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa view_item_list menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item_list",
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "view_item_list",
      "params": {
        "item_list_id": "related_products",
        "item_list_name": "Related products",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_promotion

Peristiwa ini menandakan bahwa promosi dilihat dari daftar.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
cart_data.items	Item[]	Ya*		Item untuk peristiwa. * Array items kemungkinan akan memiliki satu elemen, yang mewakili item yang terkait dengan promosi. Jika beberapa elemen tersedia, hanya elemen pertama di items yang akan digunakan. Tetapkan kolom cart_data.items pada objek Event.

Kolom item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_id	string	Ya	I_12345	ID unik untuk item. Tetapkan kolom item_id pada objek Item.
unit_price	number	Ya	27,67	Harga satuan tidak termasuk pajak, pengiriman, dan diskon cakupan peristiwa (tingkat transaksi) untuk item ini. Jika item memiliki diskon cakupan item, gunakan harga per unit yang didiskon. Misalnya, jika item memiliki harga satuan 27,67 dan diskon satuan 6,66, tetapkan unitPrice ke 21,01.
quantity	number	Ya	1	Jumlah unit yang dibeli untuk item tertentu ini.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
creative_name	string	Tidak	summer_banner2	Nama materi iklan promosi.
creative_slot	string	Tidak	featured_app_1	Nama slot materi iklan promosi yang dikaitkan dengan peristiwa.
promotion_id	string	Tidak	P_12345	ID promosi yang dikaitkan dengan peristiwa.
promotion_name	string	Tidak	Summer Sale	Nama promosi yang dikaitkan dengan peristiwa.

Untuk mengisi dimensi promosi cakupan item, seperti "ID promosi item" atau "Nama promosi item", di laporan Google Analytics, Google Analytics terlebih dahulu mencari parameter promosi yang sesuai (promotion_id, promotion_name, creative_name, dan creative_slot) dalam setiap objek tertentu di array items peristiwa e-commerce Anda. Jika parameter tidak ditemukan dalam objek item, Google Analytics akan menggunakan nilai dari parameter *tingkat peristiwa* jika ada. Dimensi promosi cakupan item untuk item tertentu hanya akan dilaporkan sebagai "(not set)" jika parameter yang relevan tidak ada di *kedua* objek item dan parameter tingkat peristiwa. Parameter tingkat item selalu lebih diprioritaskan daripada parameter tingkat peristiwa.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
item_name	string	Ya*	Stan and Friends Tee	Nama item. *item_id atau item_name harus ada.
affiliation	string	Tidak	Google Store	Afiliasi produk untuk menetapkan perusahaan pemasok atau lokasi toko fisik. Catatan: affiliation hanya tersedia di cakupan item.
coupon	string	Tidak	SUMMER_FUN	Nama/kode kupon yang terkait dengan item. Parameter coupon tingkat peristiwa dan tingkat item bersifat independen.
creative_name	string	Tidak	summer_banner2	Nama materi iklan promosi. Jika tidak ditetapkan, defaultnya adalah creative_name tingkat peristiwa.
creative_slot	string	Tidak	featured_app_1	Nama slot materi iklan promosi yang dikaitkan dengan item. Jika tidak ditetapkan, defaultnya adalah creative_slot tingkat peristiwa.
discount	number	Tidak	2.22	Nilai diskon uang per unit yang terkait dengan item.
index	number	Tidak	5	Indeks/posisi item dalam daftar.
item_brand	string	Tidak	Google	Merek item.
item_category	string	Tidak	Apparel	Kategori item. Jika digunakan sebagai bagian dari taksonomi atau hierarki kategori, ini akan menjadi kategori pertama.
item_category2	string	Tidak	Adult	Hierarki kategori kedua atau taksonomi tambahan untuk item.
item_category3	string	Tidak	Shirts	Hierarki kategori ketiga atau taksonomi tambahan untuk item.
item_category4	string	Tidak	Crew	Hierarki kategori keempat atau taksonomi tambahan untuk item.
item_category5	string	Tidak	Short sleeve	Hierarki kategori kelima atau taksonomi tambahan untuk item.
item_list_id	string	Tidak	related_products	ID daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_id tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_id tingkat peristiwa akan digunakan, jika ada.
item_list_name	string	Tidak	Related products	Nama daftar tempat item ditampilkan kepada pengguna. Jika ditetapkan, item_list_name tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, item_list_name tingkat peristiwa akan digunakan, jika ada.
item_variant	string	Tidak	green	Varian item atau kode unik atau deskripsi item untuk detail/opsi item tambahan.
location_id	string	Tidak	ChIJIQBpAG2ahYAR_6128GcTUEo (ID Tempat Google untuk San Francisco)	Lokasi fisik yang dikaitkan dengan item (misalnya lokasi toko fisik). Sebaiknya gunakan ID Tempat Google yang sesuai dengan item terkait. ID lokasi kustom juga dapat digunakan. Catatan: location_id hanya tersedia di cakupan item.
promotion_id	string	Tidak	P_12345	ID promosi yang dikaitkan dengan item. Jika tidak ditetapkan, defaultnya adalah promotion_id tingkat peristiwa.
promotion_name	string	Tidak	Summer Sale	Nama promosi yang dikaitkan dengan item. Jika tidak ditetapkan, defaultnya adalah promotion_name tingkat peristiwa.

Selain parameter yang telah ditentukan, Anda dapat menyertakan hingga 27 parameter kustom dalam array items.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa view_promotion menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "view_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

Game

level_up

Peristiwa ini menandakan bahwa pemain telah naik level dalam game. Gunakan peristiwa ini untuk mengukur distribusi level basis pengguna Anda dan mengidentifikasi level yang sulit diselesaikan.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
level	number	Tidak	5	Level karakter.
character	string	Tidak	Player 1	Karakter yang naik level.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa level_up menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "level_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "level_up",
      "params": {
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

post_score

Kirim peristiwa ini jika pengguna memposting skor. Gunakan peristiwa ini untuk memahami performa pengguna dalam game Anda dan menghubungkan skor tinggi dengan audiens atau perilaku pengguna.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
score	number	Ya	10000	Skor yang diposting.
level	number	Tidak	5	Level untuk skor yang diperoleh.
character	string	Tidak	Player 1	Karakter yang memperoleh skor.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa post_score menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "post_score",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "score",
          "value": 10000
        },
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "post_score",
      "params": {
        "score": 10000,
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

unlock_achievement

Catat peristiwa ini saat pengguna memperoleh pencapaian. Peristiwa ini dapat membantu Anda memahami pengalaman pengguna dalam game Anda.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
achievement_id	string	Ya	A_12345	ID pencapaian yang diperoleh.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa unlock_achievement menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "unlock_achievement",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "achievement_id",
          "value": "A_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "unlock_achievement",
      "params": {
        "achievement_id": "A_12345"
      }
    }]
  })
});

Perolehan prospek

close_convert_lead

Catat peristiwa ini saat prospek yang memenuhi syarat berhasil dikonversi menjadi pelanggan. Hal ini biasanya menandakan akhir dari proses pembinaan prospek, seperti saat kontrak ditandatangani, langganan berbayar dimulai, atau penjualan akhir selesai.

• Catatan: Untuk melacak akuisisi prospek awal, seperti pengiriman formulir, pendaftaran newsletter, atau permintaan demo, gunakan peristiwa generate_lead.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
currency	string	Ya*	USD	Mata uang conversion_value acara, dalam format ISO 4217 3 huruf. * Jika Anda menetapkan conversion_value, currency diperlukan agar metrik pendapatan dapat dihitung secara akurat.
conversion_value	number	Ya*	30.03	Nilai uang dari peristiwa. * conversion_value biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai peristiwa utama, sebaiknya tetapkan conversion_value. * currency diperlukan jika Anda menetapkan conversion_value.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa close_convert_lead menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_convert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "close_convert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

close_unconvert_lead

Peristiwa ini mengukur saat pengguna ditandai sebagai tidak menjadi prospek yang berkonversi, beserta alasannya.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
currency	string	Ya*	USD	Mata uang conversion_value acara, dalam format ISO 4217 3 huruf. * Jika Anda menetapkan conversion_value, currency diperlukan agar metrik pendapatan dapat dihitung secara akurat.
conversion_value	number	Ya*	30.03	Nilai uang dari peristiwa. * conversion_value biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai peristiwa utama, sebaiknya tetapkan conversion_value. * currency diperlukan jika Anda menetapkan conversion_value.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
unconvert_lead_reason	string	Tidak	Tidak pernah merespons	Alasan prospek tidak melakukan konversi.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa close_unconvert_lead menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_unconvert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "unconvert_lead_reason",
          "value": "Never responded"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "close_unconvert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "unconvert_lead_reason": "Never responded"
      }
    }]
  })
});

disqualify_lead

Peristiwa ini mengukur saat pengguna ditandai sebagai tidak berpotensi menjadi lead, beserta alasan mengapa pengguna tersebut tidak berpotensi.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
currency	string	Ya*	USD	Mata uang conversion_value acara, dalam format ISO 4217 3 huruf. * Jika Anda menetapkan conversion_value, currency diperlukan agar metrik pendapatan dapat dihitung secara akurat.
conversion_value	number	Ya*	30.03	Nilai uang dari peristiwa. * conversion_value biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai peristiwa utama, sebaiknya tetapkan conversion_value. * currency diperlukan jika Anda menetapkan conversion_value.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
disqualified_lead_reason	string	Tidak	Tidak ingin membeli	Alasan lead ditandai sebagai tidak berpotensi.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa disqualify_lead menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "disqualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "disqualified_lead_reason",
          "value": "Not looking to buy"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "disqualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "disqualified_lead_reason": "Not looking to buy"
      }
    }]
  })
});

generate_lead

Peristiwa ini mengukur saat prospek dihasilkan (misalnya, melalui formulir). Catat peristiwa ini untuk memahami efektivitas kampanye pemasaran Anda dan jumlah pelanggan yang berinteraksi kembali dengan bisnis Anda setelah pemasaran ulang dilakukan terhadap pelanggan.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
currency	string	Ya*	USD	Mata uang conversion_value acara, dalam format ISO 4217 3 huruf. * Jika Anda menetapkan conversion_value, currency diperlukan agar metrik pendapatan dapat dihitung secara akurat.
conversion_value	number	Ya*	30.03	Nilai uang dari peristiwa. * conversion_value biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai peristiwa utama, sebaiknya tetapkan conversion_value. * currency diperlukan jika Anda menetapkan conversion_value.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
lead_source	string	Tidak	Pameran dagang	Sumber prospek.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa generate_lead menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "generate_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_source",
          "value": "Trade show"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "generate_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_source": "Trade show"
      }
    }]
  })
});

qualify_lead

Peristiwa ini mengukur saat pengguna ditandai memenuhi kriteria untuk menjadi prospek yang berkualitas.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
currency	string	Ya*	USD	Mata uang conversion_value acara, dalam format ISO 4217 3 huruf. * Jika Anda menetapkan conversion_value, currency diperlukan agar metrik pendapatan dapat dihitung secara akurat.
conversion_value	number	Ya*	30.03	Nilai uang dari peristiwa. * conversion_value biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai peristiwa utama, sebaiknya tetapkan conversion_value. * currency diperlukan jika Anda menetapkan conversion_value.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa qualify_lead menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "qualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "qualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

working_lead

Peristiwa ini mengukur saat pengguna menghubungi atau dihubungi oleh perwakilan.

Kolom peristiwa

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
currency	string	Ya*	USD	Mata uang conversion_value acara, dalam format ISO 4217 3 huruf. * Jika Anda menetapkan conversion_value, currency diperlukan agar metrik pendapatan dapat dihitung secara akurat.
conversion_value	number	Ya*	30.03	Nilai uang dari peristiwa. * conversion_value biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai peristiwa utama, sebaiknya tetapkan conversion_value. * currency diperlukan jika Anda menetapkan conversion_value.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
lead_status	string	Tidak	Percakapan yang dimulai	Status prospek.

Contoh

Contoh berikut menunjukkan cara mengirim peristiwa working_lead menggunakan Data Manager API. Jika Anda melakukan upgrade dari Measurement Protocol, gunakan tab untuk memigrasikan permintaan ke Data Manager API.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "working_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_status",
          "value": "Started conversations"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
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": "working_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_status": "Started conversations"
      }
    }]
  })
});