Halaman ini diterjemahkan oleh Cloud Translation API.

Peristiwa yang direkomendasikan

Peristiwa ini memungkinkan Anda mengukur fitur dan perilaku tambahan serta menghasilkan laporan yang lebih berguna di Google Analytics 4. Karena peristiwa ini memerlukan konteks tambahan agar bermakna, peristiwa tersebut tidak dikirim secara otomatis. Gunakan dokumen ini untuk melihat parameter wajib dan opsional untuk setiap peristiwa.

add_payment_info

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

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`currency`	`string`	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Jika Anda menetapkan `value`, `currency` diperlukan agar metrik pendapatan bisa dihitung secara akurat.
`value`	`number`	Ya*	30,03	Nilai uang dari peristiwa. * Tetapkan `value` ke jumlah `(price * quantity)` untuk semua item di `items`. Jangan sertakan `shipping` atau `tax`. * `value` biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai konversi, sebaiknya tetapkan `value`. * `currency` diperlukan jika Anda menetapkan `value`.
`coupon`	`string`	Tidak	SUMMER_FUN	Nama/kode kupon yang terkait dengan peristiwa. Parameter `coupon` tingkat peristiwa dan tingkat item bersifat independen.
`payment_type`	`string`	Tidak	Credit Card	Metode pembayaran yang dipilih.
`items`	`Array<Item>`	Ya		Item untuk peristiwa.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`item_id`	`string`	Ya*	SKU_12345	ID item. *`item_id` atau `item_name` harus ada.
`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: `afiliasi` 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 ditetapkan, `creative_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_name` tingkat peristiwa akan digunakan, jika ada.
`creative_slot`	`string`	Tidak	featured_app_1	Nama slot materi iklan promosi yang dikaitkan dengan item. Jika ditetapkan, `creative_slot` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_slot` tingkat peristiwa akan digunakan, jika ada.
`discount`	`number`	Tidak	2.22	Nilai diskon uang satuan 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: `ID lokasi` hanya tersedia di cakupan item.
`price`	`number`	Tidak	10,01	Harga satuan uang item, dalam satuan parameter mata uang yang ditentukan. Jika diskon berlaku untuk item tersebut, tetapkan `price` ke harga unit yang didiskon dan tentukan diskon harga unit di parameter `discount`.
`promotion_id`	`string`	Tidak	P_12345	ID promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_id` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_id` tingkat peristiwa akan digunakan, jika ada.
`promotion_name`	`string`	Tidak	Summer Sale	Nama promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_name` tingkat peristiwa akan digunakan, jika ada.
`quantity`	`number`	Tidak	3	Jumlah item. Jika tidak ditetapkan, `quantity` akan ditetapkan ke 1.

Selain parameter yang ditetapkan, Anda dapat menyertakan maksimal 27 parameter kustom dalam array items.

Contoh

Contoh berikut ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: add_payment_info
Variabel Lapisan Data (Nama - Nama Variabel Lapisan Data)

Item E-commerce - ecommerce.items
Nilai E-commerce - ecommerce.value
Mata Uang E-commerce - ecommerce.currency
Kupon E-Commerce - ecommerce.coupon
Jenis Pembayaran E-commerce - ecommerce.payment_type

Parameter Peristiwa (Nama Parameter - Nilai):

items - {{Item E-commerce}}
value - {{Nilai E-commerce}}
currency - {{Mata Uang E-commerce}}
coupon - {{Kupon E-commerce}}
payment_type - {{Jenis Pembayaran E-commerce}}

Pemicu: peristiwa sama dengan add_payment_info

Konfigurasi pemicu:

Jenis Pemicu: Peristiwa Kustom
Nama Peristiwa: add_payment_info
Pemicu ini diaktifkan pada: Semua Peristiwa Kustom

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_payment_info",
  ecommerce: {
    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",
      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,
      quantity: 3
    }
    ]
  }
});

add_shipping_info

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

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`currency`	`string`	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Jika Anda menetapkan `value`, `currency` diperlukan agar metrik pendapatan bisa dihitung secara akurat.
`value`	`number`	Ya*	30,03	Nilai uang dari peristiwa. * Tetapkan `value` ke jumlah `(price * quantity)` untuk semua item di `items`. Jangan sertakan `shipping` atau `tax`. * `value` biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai konversi, sebaiknya tetapkan `value`. * `currency` diperlukan jika Anda menetapkan `value`.
`coupon`	`string`	Tidak	SUMMER_FUN	Nama/kode kupon yang terkait dengan peristiwa. Parameter `coupon` tingkat peristiwa dan tingkat item bersifat independen.
`shipping_tier`	`string`	Tidak	Ground	Jenis pengiriman (misalnya, `Ground`, `Air`, `Next-day`) yang dipilih untuk pengiriman item yang dibeli.
`items`	`Array<Item>`	Ya		Item untuk peristiwa.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`item_id`	`string`	Ya*	SKU_12345	ID item. *`item_id` atau `item_name` harus ada.
`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: `afiliasi` 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 ditetapkan, `creative_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_name` tingkat peristiwa akan digunakan, jika ada.
`creative_slot`	`string`	Tidak	featured_app_1	Nama slot materi iklan promosi yang dikaitkan dengan item. Jika ditetapkan, `creative_slot` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_slot` tingkat peristiwa akan digunakan, jika ada.
`discount`	`number`	Tidak	2.22	Nilai diskon uang satuan 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: `ID lokasi` hanya tersedia di cakupan item.
`price`	`number`	Tidak	10,01	Harga satuan uang item, dalam satuan parameter mata uang yang ditentukan. Jika diskon berlaku untuk item tersebut, tetapkan `price` ke harga unit yang didiskon dan tentukan diskon harga unit di parameter `discount`.
`promotion_id`	`string`	Tidak	P_12345	ID promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_id` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_id` tingkat peristiwa akan digunakan, jika ada.
`promotion_name`	`string`	Tidak	Summer Sale	Nama promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_name` tingkat peristiwa akan digunakan, jika ada.
`quantity`	`number`	Tidak	3	Jumlah item. Jika tidak ditetapkan, `quantity` akan ditetapkan ke 1.

Selain parameter yang ditetapkan, Anda dapat menyertakan maksimal 27 parameter kustom dalam array items.

Contoh

Contoh berikut ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: add_shipping_info
Variabel Lapisan Data (Nama - Nama Variabel Lapisan Data)

Item E-commerce - ecommerce.items
Nilai E-commerce - ecommerce.value
Mata Uang E-commerce - ecommerce.currency
Kupon E-Commerce - ecommerce.coupon
Jenis Pengiriman E-commerce - ecommerce.shipping_tier

Parameter Peristiwa (Nama Parameter - Nilai):

items - {{Item E-commerce}}
value - {{Nilai E-commerce}}
currency - {{Mata Uang E-commerce}}
coupon - {{Kupon E-commerce}}
shipping_tier - {{Tingkat Pengiriman E-commerce}}

Pemicu: peristiwa sama dengan add_shipping_info

Konfigurasi pemicu:

Jenis Pemicu: Peristiwa Kustom
Nama Peristiwa: add_shipping_info
Pemicu ini diaktifkan pada: Semua Peristiwa Kustom

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_shipping_info",
  ecommerce: {
    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",
      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,
      quantity: 3
    }
    ]
  }
});

add_to_cart

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

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`currency`	`string`	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Jika Anda menetapkan `value`, `currency` diperlukan agar metrik pendapatan bisa dihitung secara akurat.
`value`	`number`	Ya*	30,03	Nilai uang dari peristiwa. * Tetapkan `value` ke jumlah `(price * quantity)` untuk semua item di `items`. Jangan sertakan `shipping` atau `tax`. * `value` biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai konversi, sebaiknya tetapkan `value`. * `currency` diperlukan jika Anda menetapkan `value`.
`items`	`Array<Item>`	Ya		Item untuk peristiwa.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`item_id`	`string`	Ya*	SKU_12345	ID item. *`item_id` atau `item_name` harus ada.
`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: `afiliasi` 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 ditetapkan, `creative_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_name` tingkat peristiwa akan digunakan, jika ada.
`creative_slot`	`string`	Tidak	featured_app_1	Nama slot materi iklan promosi yang dikaitkan dengan item. Jika ditetapkan, `creative_slot` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_slot` tingkat peristiwa akan digunakan, jika ada.
`discount`	`number`	Tidak	2.22	Nilai diskon uang satuan 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: `ID lokasi` hanya tersedia di cakupan item.
`price`	`number`	Tidak	10,01	Harga satuan uang item, dalam satuan parameter mata uang yang ditentukan. Jika diskon berlaku untuk item tersebut, tetapkan `price` ke harga unit yang didiskon dan tentukan diskon harga unit di parameter `discount`.
`promotion_id`	`string`	Tidak	P_12345	ID promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_id` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_id` tingkat peristiwa akan digunakan, jika ada.
`promotion_name`	`string`	Tidak	Summer Sale	Nama promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_name` tingkat peristiwa akan digunakan, jika ada.
`quantity`	`number`	Tidak	3	Jumlah item. Jika tidak ditetapkan, `quantity` akan ditetapkan ke 1.

Selain parameter yang ditetapkan, Anda dapat menyertakan maksimal 27 parameter kustom dalam array items.

Contoh

Contoh berikut ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: add_to_cart
Variabel Lapisan Data (Nama - Nama Variabel Lapisan Data)

Item E-commerce - ecommerce.items
Nilai E-commerce - ecommerce.value
Mata Uang E-commerce - ecommerce.currency

Parameter Peristiwa (Nama Parameter - Nilai):

items - {{Item E-commerce}}
value - {{Nilai E-commerce}}
currency - {{Mata Uang E-commerce}}

Pemicu: peristiwa sama dengan add_to_cart

Konfigurasi pemicu:

Jenis Pemicu: Peristiwa Kustom
Nama Peristiwa: add_to_cart
Pemicu ini diaktifkan pada: Semua Peristiwa Kustom

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      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,
      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.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`currency`	`string`	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Jika Anda menetapkan `value`, `currency` diperlukan agar metrik pendapatan bisa dihitung secara akurat.
`value`	`number`	Ya*	30,03	Nilai uang dari peristiwa. * Tetapkan `value` ke jumlah `(price * quantity)` untuk semua item di `items`. Jangan sertakan `shipping` atau `tax`. * `value` biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai konversi, sebaiknya tetapkan `value`. * `currency` diperlukan jika Anda menetapkan `value`.
`items`	`Array<Item>`	Ya		Item untuk peristiwa.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`item_id`	`string`	Ya*	SKU_12345	ID item. *`item_id` atau `item_name` harus ada.
`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: `afiliasi` 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 ditetapkan, `creative_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_name` tingkat peristiwa akan digunakan, jika ada.
`creative_slot`	`string`	Tidak	featured_app_1	Nama slot materi iklan promosi yang dikaitkan dengan item. Jika ditetapkan, `creative_slot` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_slot` tingkat peristiwa akan digunakan, jika ada.
`discount`	`number`	Tidak	2.22	Nilai diskon uang satuan 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: `ID lokasi` hanya tersedia di cakupan item.
`price`	`number`	Tidak	10,01	Harga satuan uang item, dalam satuan parameter mata uang yang ditentukan. Jika diskon berlaku untuk item tersebut, tetapkan `price` ke harga unit yang didiskon dan tentukan diskon harga unit di parameter `discount`.
`promotion_id`	`string`	Tidak	P_12345	ID promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_id` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_id` tingkat peristiwa akan digunakan, jika ada.
`promotion_name`	`string`	Tidak	Summer Sale	Nama promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_name` tingkat peristiwa akan digunakan, jika ada.
`quantity`	`number`	Tidak	3	Jumlah item. Jika tidak ditetapkan, `quantity` akan ditetapkan ke 1.

Selain parameter yang ditetapkan, Anda dapat menyertakan maksimal 27 parameter kustom dalam array items.

Contoh

Contoh berikut ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: add_to_wishlist
Variabel Lapisan Data (Nama - Nama Variabel Lapisan Data)

Item E-commerce - ecommerce.items
Nilai E-commerce - ecommerce.value
Mata Uang E-commerce - ecommerce.currency

Parameter Peristiwa (Nama Parameter - Nilai):

items - {{Item E-commerce}}
value - {{Nilai E-commerce}}
currency - {{Mata Uang E-commerce}}

Pemicu: peristiwa sama dengan add_to_wishlist

Konfigurasi pemicu:

Jenis Pemicu: Peristiwa Kustom
Nama Peristiwa: add_to_wishlist
Pemicu ini diaktifkan pada: Semua Peristiwa Kustom

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_wishlist",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      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,
      quantity: 3
    }
    ]
  }
});

begin_checkout

Peristiwa ini menandakan bahwa pengguna telah memulai proses checkout.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`currency`	`string`	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Jika Anda menetapkan `value`, `currency` diperlukan agar metrik pendapatan bisa dihitung secara akurat.
`value`	`number`	Ya*	30,03	Nilai uang dari peristiwa. * Tetapkan `value` ke jumlah `(price * quantity)` untuk semua item di `items`. Jangan sertakan `shipping` atau `tax`. * `value` biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai konversi, sebaiknya tetapkan `value`. * `currency` diperlukan jika Anda menetapkan `value`.
`coupon`	`string`	Tidak	SUMMER_FUN	Nama/kode kupon yang terkait dengan peristiwa. Parameter `coupon` tingkat peristiwa dan tingkat item bersifat independen.
`items`	`Array<Item>`	Ya		Item untuk peristiwa.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`item_id`	`string`	Ya*	SKU_12345	ID item. *`item_id` atau `item_name` harus ada.
`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: `afiliasi` 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 ditetapkan, `creative_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_name` tingkat peristiwa akan digunakan, jika ada.
`creative_slot`	`string`	Tidak	featured_app_1	Nama slot materi iklan promosi yang dikaitkan dengan item. Jika ditetapkan, `creative_slot` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_slot` tingkat peristiwa akan digunakan, jika ada.
`discount`	`number`	Tidak	2.22	Nilai diskon uang satuan 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: `ID lokasi` hanya tersedia di cakupan item.
`price`	`number`	Tidak	10,01	Harga satuan uang item, dalam satuan parameter mata uang yang ditentukan. Jika diskon berlaku untuk item tersebut, tetapkan `price` ke harga unit yang didiskon dan tentukan diskon harga unit di parameter `discount`.
`promotion_id`	`string`	Tidak	P_12345	ID promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_id` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_id` tingkat peristiwa akan digunakan, jika ada.
`promotion_name`	`string`	Tidak	Summer Sale	Nama promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_name` tingkat peristiwa akan digunakan, jika ada.
`quantity`	`number`	Tidak	3	Jumlah item. Jika tidak ditetapkan, `quantity` akan ditetapkan ke 1.

Selain parameter yang ditetapkan, Anda dapat menyertakan maksimal 27 parameter kustom dalam array items.

Contoh

Contoh berikut ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: begin_checkout
Variabel Lapisan Data (Nama - Nama Variabel Lapisan Data)

Item E-commerce - ecommerce.items
Nilai E-commerce - ecommerce.value
Mata Uang E-commerce - ecommerce.currency
Kupon E-Commerce - ecommerce.coupon

Parameter Peristiwa (Nama Parameter - Nilai):

items - {{Item E-commerce}}
value - {{Nilai E-commerce}}
currency - {{Mata Uang E-commerce}}
coupon - {{Kupon E-commerce}}

Pemicu: peristiwa sama dengan begin_checkout

Konfigurasi pemicu:

Jenis Pemicu: Peristiwa Kustom
Nama Peristiwa: begin_checkout
Pemicu ini diaktifkan pada: Semua Peristiwa Kustom

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "begin_checkout",
  ecommerce: {
    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",
      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,
      quantity: 3
    }
    ]
  }
});

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.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`virtual_currency_name`	`string`	Tidak	Gems	Nama mata uang virtual.
`value`	`number`	Tidak	5	Nilai mata uang virtual.

Contoh

Contoh berikut ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: earn_virtual_currency
Parameter Peristiwa (Nama Parameter - Nilai):

virtual_currency_name - Berlian
value–5

Memicu peristiwa saat seseorang diberi mata uang virtual

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.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`currency`	`string`	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Jika Anda menetapkan `value`, `currency` diperlukan agar metrik pendapatan bisa dihitung secara akurat.
`value`	`number`	Ya*	30,03	Nilai uang dari peristiwa. * Tetapkan `value` ke jumlah `(price * quantity)` untuk semua item di `items`. Jangan sertakan `shipping` atau `tax`. * `value` biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai konversi, sebaiknya tetapkan `value`. * `currency` diperlukan jika Anda menetapkan `value`.

Contoh

Contoh berikut ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: generate_lead
Parameter Peristiwa (Nama Parameter - Nilai):

currency - USD
value - 99,99

Memicu peristiwa saat prospek dihasilkan

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 ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: join_group
Parameter Peristiwa (Nama Parameter - Nilai):

group_id - G_12345

Memicu peristiwa saat pengguna bergabung dengan grup

level_end

Peristiwa ini menandakan bahwa pemain telah mencapai akhir level dalam game.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`level_name`	`string`	Tidak	The journey begins...	Nama level.
`success`	`boolean`	Tidak	true	Tetapkan ke `true` jika level berhasil diselesaikan.

Contoh

Contoh berikut ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: level_end
Parameter Peristiwa (Nama Parameter - Nilai):

level_name - Perjalanan dimulai...
success - true

Dipicu saat pemain telah mencapai akhir level (mis. halaman konfirmasi level)

level_start

Peristiwa ini menandakan bahwa pemain telah memulai level dalam game.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`level_name`	`string`	Tidak	The journey begins...	Nama level.

Contoh

Contoh berikut ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: level_start
Parameter Peristiwa (Nama Parameter - Nilai):

level_name - Perjalanan dimulai...

Dipicu saat seseorang memulai level baru (mis., halaman awal level)

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 ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: level_up
Parameter Peristiwa (Nama Parameter - Nilai):

level–5
character - Pemain 1

Dipicu saat pemain naik level

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

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 ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: post_score
Parameter Peristiwa (Nama Parameter - Nilai):

score - 10.000
level–5
character - Pemain 1

Dipicu saat pengguna memposting skor

purchase

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

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`currency`	`string`	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Jika Anda menetapkan `value`, `currency` diperlukan agar metrik pendapatan bisa dihitung secara akurat.
`value`	`number`	Ya*	30,03	Nilai uang dari peristiwa. * Tetapkan `value` ke jumlah `(price * quantity)` untuk semua item di `items`. Jangan sertakan `shipping` atau `tax`. * `value` biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai konversi, sebaiknya tetapkan `value`. * `currency` diperlukan jika Anda menetapkan `value`.
`transaction_id`	`string`	Ya	T_12345	ID unik transaksi. Parameter `transaction_id` membantu Anda agar tidak ada peristiwa duplikat untuk satu pembelian.
`coupon`	`string`	Tidak	SUMMER_FUN	Nama/kode kupon yang terkait dengan peristiwa. Parameter `coupon` tingkat peristiwa dan tingkat item bersifat independen.
`shipping`	`number`	Tidak	3.33	Biaya pengiriman yang terkait dengan transaksi.
`tax`	`number`	Tidak	1.11	Biaya pajak yang terkait dengan transaksi.
`items`	`Array<Item>`	Ya		Item untuk peristiwa.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`item_id`	`string`	Ya*	SKU_12345	ID item. *`item_id` atau `item_name` harus ada.
`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: `afiliasi` 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 ditetapkan, `creative_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_name` tingkat peristiwa akan digunakan, jika ada.
`creative_slot`	`string`	Tidak	featured_app_1	Nama slot materi iklan promosi yang dikaitkan dengan item. Jika ditetapkan, `creative_slot` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_slot` tingkat peristiwa akan digunakan, jika ada.
`discount`	`number`	Tidak	2.22	Nilai diskon uang satuan 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: `ID lokasi` hanya tersedia di cakupan item.
`price`	`number`	Tidak	10,01	Harga satuan uang item, dalam satuan parameter mata uang yang ditentukan. Jika diskon berlaku untuk item tersebut, tetapkan `price` ke harga unit yang didiskon dan tentukan diskon harga unit di parameter `discount`.
`promotion_id`	`string`	Tidak	P_12345	ID promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_id` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_id` tingkat peristiwa akan digunakan, jika ada.
`promotion_name`	`string`	Tidak	Summer Sale	Nama promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_name` tingkat peristiwa akan digunakan, jika ada.
`quantity`	`number`	Tidak	3	Jumlah item. Jika tidak ditetapkan, `quantity` akan ditetapkan ke 1.

Selain parameter yang ditetapkan, Anda dapat menyertakan maksimal 27 parameter kustom dalam array items.

Contoh

Contoh berikut ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: purchase

Item E-commerce - ecommerce.items
ID Transaksi E-commerce - ecommerce.transaction_id
Nilai E-commerce - ecommerce.value
Pajak E-commerce - ecommerce.tax
Pengiriman E-commerce - ecommerce.shipping
Mata Uang E-commerce - ecommerce.currency
Kupon E-Commerce - ecommerce.coupon

Parameter Peristiwa (Nama Parameter - Nilai):

items - {{Item E-commerce}}
transaction_id - {{ID Transaksi E-commerce}}
value - {{Nilai E-commerce}}
tax - {{Pajak E-commerce}}
shipping - {{Pengiriman E-commerce}}
currency - {{Mata Uang E-commerce}}
coupon - {{Kupon E-commerce}}

Pemicu: peristiwa sama dengan purchase

Konfigurasi pemicu:

Jenis Pemicu: Peristiwa Kustom
Nama Peristiwa: purchase
Pemicu ini diaktifkan pada: Semua Peristiwa Kustom

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "purchase",
  ecommerce: {
    transaction_id: "T_12345",
    // Sum of (price * quantity) for all items.
    value: 72.05,
    tax: 3.60,
    shipping: 5.99,
    currency: "USD",
    coupon: "SUMMER_SALE",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      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,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      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: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

refund

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

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`currency`	`string`	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Jika Anda menetapkan `value`, `currency` diperlukan agar metrik pendapatan bisa dihitung secara akurat.
`transaction_id`	`string`	Ya	T_12345	ID unik transaksi.
`value`	`number`	Ya*	30,03	Nilai uang dari peristiwa. * Tetapkan `value` ke jumlah `(price * quantity)` untuk semua item di `items`. Jangan sertakan `shipping` atau `tax`. * `value` biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai konversi, sebaiknya tetapkan `value`. * `currency` diperlukan jika Anda menetapkan `value`.
`coupon`	`string`	Tidak	SUMMER_FUN	Nama/kode kupon yang terkait dengan peristiwa. Parameter `coupon` tingkat peristiwa dan tingkat item bersifat independen.
`shipping`	`number`	Tidak	3.33	Biaya pengiriman yang terkait dengan transaksi.
`tax`	`number`	Tidak	1.11	Biaya pajak yang terkait dengan transaksi.
`items`	`Array<Item>`	Tidak*		Item untuk peristiwa.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`item_id`	`string`	Ya*	SKU_12345	ID item. *`item_id` atau `item_name` harus ada.
`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: `afiliasi` 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 ditetapkan, `creative_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_name` tingkat peristiwa akan digunakan, jika ada.
`creative_slot`	`string`	Tidak	featured_app_1	Nama slot materi iklan promosi yang dikaitkan dengan item. Jika ditetapkan, `creative_slot` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_slot` tingkat peristiwa akan digunakan, jika ada.
`discount`	`number`	Tidak	2.22	Nilai diskon uang satuan 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: `ID lokasi` hanya tersedia di cakupan item.
`price`	`number`	Tidak	10,01	Harga satuan uang item, dalam satuan parameter mata uang yang ditentukan. Jika diskon berlaku untuk item tersebut, tetapkan `price` ke harga unit yang didiskon dan tentukan diskon harga unit di parameter `discount`.
`promotion_id`	`string`	Tidak	P_12345	ID promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_id` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_id` tingkat peristiwa akan digunakan, jika ada.
`promotion_name`	`string`	Tidak	Summer Sale	Nama promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_name` tingkat peristiwa akan digunakan, jika ada.
`quantity`	`number`	Tidak	3	Jumlah item. Jika tidak ditetapkan, `quantity` akan ditetapkan ke 1.

Selain parameter yang ditetapkan, Anda dapat menyertakan maksimal 27 parameter kustom dalam array items.

Contoh

Contoh berikut ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: refund
Variabel Lapisan Data (Nama - Nama Variabel Lapisan Data)

Item E-commerce - ecommerce.items
ID Transaksi E-commerce - ecommerce.transaction_id
Nilai E-commerce - ecommerce.value
Pajak E-commerce - ecommerce.tax
Pengiriman E-commerce - ecommerce.shipping
Mata Uang E-commerce - ecommerce.currency
Kupon E-Commerce - ecommerce.coupon

Parameter Peristiwa (Nama Parameter - Nilai):

items - {{Item E-commerce}}
transaction_id - {{ID Transaksi E-commerce}}
value - {{Nilai E-commerce}}
tax - {{Pajak E-commerce}}
shipping - {{Pengiriman E-commerce}}
currency - {{Mata Uang E-commerce}}
coupon - {{Kupon E-commerce}}

Pemicu: peristiwa sama dengan refund

Konfigurasi pemicu:

Jenis Pemicu: Peristiwa Kustom
Nama Peristiwa: refund
Pemicu ini diaktifkan pada: Semua Peristiwa Kustom

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "refund",
  ecommerce: {
    currency: "USD",
    transaction_id: "T_12345", // Transaction ID. Required for purchases and refunds.
    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",
      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,
      quantity: 3
    }
    ]
  }
});

remove_from_cart

Peristiwa ini menandakan bahwa item telah dihapus dari keranjang.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`currency`	`string`	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Jika Anda menetapkan `value`, `currency` diperlukan agar metrik pendapatan bisa dihitung secara akurat.
`value`	`number`	Ya*	30,03	Nilai uang dari peristiwa. * Tetapkan `value` ke jumlah `(price * quantity)` untuk semua item di `items`. Jangan sertakan `shipping` atau `tax`. * `value` biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai konversi, sebaiknya tetapkan `value`. * `currency` diperlukan jika Anda menetapkan `value`.
`items`	`Array<Item>`	Ya		Item untuk peristiwa.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`item_id`	`string`	Ya*	SKU_12345	ID item. *`item_id` atau `item_name` harus ada.
`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: `afiliasi` 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 ditetapkan, `creative_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_name` tingkat peristiwa akan digunakan, jika ada.
`creative_slot`	`string`	Tidak	featured_app_1	Nama slot materi iklan promosi yang dikaitkan dengan item. Jika ditetapkan, `creative_slot` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_slot` tingkat peristiwa akan digunakan, jika ada.
`discount`	`number`	Tidak	2.22	Nilai diskon uang satuan 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: `ID lokasi` hanya tersedia di cakupan item.
`price`	`number`	Tidak	10,01	Harga satuan uang item, dalam satuan parameter mata uang yang ditentukan. Jika diskon berlaku untuk item tersebut, tetapkan `price` ke harga unit yang didiskon dan tentukan diskon harga unit di parameter `discount`.
`promotion_id`	`string`	Tidak	P_12345	ID promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_id` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_id` tingkat peristiwa akan digunakan, jika ada.
`promotion_name`	`string`	Tidak	Summer Sale	Nama promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_name` tingkat peristiwa akan digunakan, jika ada.
`quantity`	`number`	Tidak	3	Jumlah item. Jika tidak ditetapkan, `quantity` akan ditetapkan ke 1.

Selain parameter yang ditetapkan, Anda dapat menyertakan maksimal 27 parameter kustom dalam array items.

Contoh

Contoh berikut ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: remove_from_cart
Variabel Lapisan Data (Nama - Nama Variabel Lapisan Data)

Item E-commerce - ecommerce.items
Nilai E-commerce - ecommerce.value
Mata Uang E-commerce - ecommerce.currency

Parameter Peristiwa (Nama Parameter - Nilai):

items - {{Item E-commerce}}
value - {{Nilai E-commerce}}
currency - {{Mata Uang E-commerce}}

Pemicu: peristiwa sama dengan remove_from_cart

Konfigurasi pemicu:

Jenis Pemicu: Peristiwa Kustom
Nama Peristiwa: remove_from_cart
Pemicu ini diaktifkan pada: Semua Peristiwa Kustom

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "remove_from_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      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,
      quantity: 3
    }
    ]
  }
});

search

Catat peristiwa ini untuk mendeteksi saat 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 ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: search
Parameter Peristiwa (Nama Parameter - Nilai):

search_term - kaus

Dipicu saat pengguna melakukan penelusuran di situs Anda

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.

Contoh

Contoh berikut ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: select_content
Parameter Peristiwa (Nama Parameter - Nilai):

content_type - produk
content_id - C_12345

Pemicu: peristiwa sama dengan select_content

select_item

Peristiwa ini menandakan bahwa item dipilih dari daftar.

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.
`items`	`Array<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.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`item_id`	`string`	Ya*	SKU_12345	ID item. *`item_id` atau `item_name` harus ada.
`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: `afiliasi` 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 ditetapkan, `creative_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_name` tingkat peristiwa akan digunakan, jika ada.
`creative_slot`	`string`	Tidak	featured_app_1	Nama slot materi iklan promosi yang dikaitkan dengan item. Jika ditetapkan, `creative_slot` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_slot` tingkat peristiwa akan digunakan, jika ada.
`discount`	`number`	Tidak	2.22	Nilai diskon uang satuan 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: `ID lokasi` hanya tersedia di cakupan item.
`price`	`number`	Tidak	10,01	Harga satuan uang item, dalam satuan parameter mata uang yang ditentukan. Jika diskon berlaku untuk item tersebut, tetapkan `price` ke harga unit yang didiskon dan tentukan diskon harga unit di parameter `discount`.
`promotion_id`	`string`	Tidak	P_12345	ID promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_id` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_id` tingkat peristiwa akan digunakan, jika ada.
`promotion_name`	`string`	Tidak	Summer Sale	Nama promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_name` tingkat peristiwa akan digunakan, jika ada.
`quantity`	`number`	Tidak	3	Jumlah item. Jika tidak ditetapkan, `quantity` akan ditetapkan ke 1.

Selain parameter yang ditetapkan, Anda dapat menyertakan maksimal 27 parameter kustom dalam array items.

Contoh

Contoh berikut ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: select_item
Variabel Lapisan Data (Nama - Nama Variabel Lapisan Data)

Item E-commerce - ecommerce.items
ID Daftar Item E-commerce - ecommerce.item_list_id
Nama Daftar Item E-commerce - ecommerce.item_list_name

Parameter Peristiwa (Nama Parameter - Nilai):

items - {{Item E-commerce}}
item_list_id - {{ID Daftar Item E-commerce}}
item_list_name - {{Nama Daftar Item E-commerce}}

Pemicu: peristiwa sama dengan select_item

Konfigurasi pemicu:

Jenis Pemicu: Peristiwa Kustom
Nama Peristiwa: select_item
Pemicu ini diaktifkan pada: Semua Peristiwa Kustom

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_item",
  ecommerce: {
    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",
      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,
      quantity: 3
    }
    ]
  }
});

select_promotion

Peristiwa ini menandakan bahwa promosi dipilih dari daftar.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`creative_name`	`string`	Tidak	summer_banner2	Nama materi iklan promosi. Akan diabaikan jika ditetapkan pada tingkat item.
`creative_slot`	`string`	Tidak	featured_app_1	Nama slot materi iklan promosi yang dikaitkan dengan peristiwa. Akan diabaikan jika ditetapkan pada tingkat item.
`promotion_id`	`string`	Tidak	P_12345	ID promosi yang dikaitkan dengan peristiwa. Akan diabaikan jika ditetapkan pada tingkat item.
`promotion_name`	`string`	Tidak	Summer Sale	Nama promosi yang dikaitkan dengan peristiwa. Akan diabaikan jika ditetapkan pada tingkat item.
`items`	`Array<Item>`	Tidak		Item untuk peristiwa.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`item_id`	`string`	Ya*	SKU_12345	ID item. *`item_id` atau `item_name` harus ada.
`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: `afiliasi` 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 ditetapkan, `creative_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_name` tingkat peristiwa akan digunakan, jika ada.
`creative_slot`	`string`	Tidak	featured_app_1	Nama slot materi iklan promosi yang dikaitkan dengan item. Jika ditetapkan, `creative_slot` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_slot` tingkat peristiwa akan digunakan, jika ada.
`discount`	`number`	Tidak	2.22	Nilai diskon uang satuan 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: `ID lokasi` hanya tersedia di cakupan item.
`price`	`number`	Tidak	10,01	Harga satuan uang item, dalam satuan parameter mata uang yang ditentukan. Jika diskon berlaku untuk item tersebut, tetapkan `price` ke harga unit yang didiskon dan tentukan diskon harga unit di parameter `discount`.
`promotion_id`	`string`	Tidak	P_12345	ID promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_id` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_id` tingkat peristiwa akan digunakan, jika ada.
`promotion_name`	`string`	Tidak	Summer Sale	Nama promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_name` tingkat peristiwa akan digunakan, jika ada.
`quantity`	`number`	Tidak	3	Jumlah item. Jika tidak ditetapkan, `quantity` akan ditetapkan ke 1.

Selain parameter yang ditetapkan, Anda dapat menyertakan maksimal 27 parameter kustom dalam array items.

Contoh

Contoh berikut ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Variabel Lapisan Data (Nama - Nama Variabel Lapisan Data)

Nama Materi Iklan E-commerce - ecommerce.creative_name
Slot Materi Iklan E-commerce - ecommerce.creative_slot
ID Promosi E-commerce - ecommerce.promotion_id
Nama Promosi E-commerce - ecommerce.promotion_name
Item E-commerce - ecommerce.items

Parameter Peristiwa (Nama Parameter - Nilai):

creative_name - {{Nama Materi Iklan E-commerce}}
creative_slot - {{Slot Materi Iklan E-commerce}}
promotion_id - {{ID Promosi E-commerce}}
promotion_name - {{Nama Promosi E-commerce}}
items - {{Item E-commerce}}

Jenis Variabel: Variabel lapisan data - 'ecommerce.items'
Pemicu: peristiwa sama dengan select_promotion

Konfigurasi pemicu:

Jenis Pemicu: Peristiwa Kustom
Nama Peristiwa: select_promotion
Pemicu ini diaktifkan pada: Semua Peristiwa Kustom

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_promotion",
  ecommerce: {
    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",
      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,
      quantity: 3
    }
    ]
  }
});

Gunakan peristiwa ini saat pengguna membagikan konten.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`method`	`string`	Tidak	Twitter	Metode yang digunakan untuk membagikan konten.
`content_type`	`string`	Tidak	gambar	Jenis konten yang dibagikan.
`item_id`	`string`	Tidak	C_12345	ID konten yang dibagikan.

Contoh

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 ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: sign_up
Parameter Peristiwa (Nama Parameter - Nilai):

method - Google

Dipicu saat pengguna telah mendaftar untuk membuat akun

spend_virtual_currency

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

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`value`	`number`	Ya	5	Nilai mata uang virtual.
`virtual_currency_name`	`string`	Ya	Gems	Nama mata uang virtual.
`item_name`	`string`	Tidak	Starter Boost	Nama item yang dibeli dengan mata uang virtual.

Contoh

Contoh berikut ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: spend_virtual_currency
Parameter Peristiwa (Nama Parameter - Nilai):

value–5
virtual_currency_name - Berlian
item_name - Peningkatan Pemula

Dipicu saat seseorang membeli item virtual

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 untuk peristiwa ini.

Contoh

Contoh berikut ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: tutorial_begin
Dipicu saat seseorang memulai proses orientasi

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 ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: tutorial_complete
Dipicu saat seseorang menyelesaikan proses orientasi

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 ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: unlock_achievement
Parameter Peristiwa (Nama Parameter - Nilai):

achievement_id - A_12345

Dipicu saat pengguna memperoleh pencapaian

view_cart

Peristiwa ini menandakan bahwa pengguna telah melihat keranjangnya.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`currency`	`string`	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Jika Anda menetapkan `value`, `currency` diperlukan agar metrik pendapatan bisa dihitung secara akurat.
`value`	`number`	Ya*	30,03	Nilai uang dari peristiwa. * Tetapkan `value` ke jumlah `(price * quantity)` untuk semua item di `items`. Jangan sertakan `shipping` atau `tax`. * `value` biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai konversi, sebaiknya tetapkan `value`. * `currency` diperlukan jika Anda menetapkan `value`.
`items`	`Array<Item>`	Ya		Item untuk peristiwa.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`item_id`	`string`	Ya*	SKU_12345	ID item. *`item_id` atau `item_name` harus ada.
`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: `afiliasi` 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 ditetapkan, `creative_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_name` tingkat peristiwa akan digunakan, jika ada.
`creative_slot`	`string`	Tidak	featured_app_1	Nama slot materi iklan promosi yang dikaitkan dengan item. Jika ditetapkan, `creative_slot` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_slot` tingkat peristiwa akan digunakan, jika ada.
`discount`	`number`	Tidak	2.22	Nilai diskon uang satuan 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: `ID lokasi` hanya tersedia di cakupan item.
`price`	`number`	Tidak	10,01	Harga satuan uang item, dalam satuan parameter mata uang yang ditentukan. Jika diskon berlaku untuk item tersebut, tetapkan `price` ke harga unit yang didiskon dan tentukan diskon harga unit di parameter `discount`.
`promotion_id`	`string`	Tidak	P_12345	ID promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_id` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_id` tingkat peristiwa akan digunakan, jika ada.
`promotion_name`	`string`	Tidak	Summer Sale	Nama promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_name` tingkat peristiwa akan digunakan, jika ada.
`quantity`	`number`	Tidak	3	Jumlah item. Jika tidak ditetapkan, `quantity` akan ditetapkan ke 1.

Selain parameter yang ditetapkan, Anda dapat menyertakan maksimal 27 parameter kustom dalam array items.

Contoh

Contoh berikut ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: view_cart
Variabel Lapisan Data (Nama - Nama Variabel Lapisan Data)

Item E-commerce - ecommerce.items
Nilai E-commerce - ecommerce.value
Mata Uang E-commerce - ecommerce.currency

Parameter Peristiwa (Nama Parameter - Nilai):

items - {{Item E-commerce}}
value - {{Nilai E-commerce}}
currency - {{Mata Uang E-commerce}}

Pemicu: peristiwa sama dengan view_cart

Konfigurasi pemicu:

Jenis Pemicu: Peristiwa Kustom
Nama Peristiwa: view_cart
Pemicu ini diaktifkan pada: Semua Peristiwa Kustom

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      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,
      quantity: 3
    }
    ]
  }
});

view_item

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

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`currency`	`string`	Ya*	USD	Mata uang item yang terkait dengan peristiwa, dalam format ISO 4217 3 huruf. * Jika Anda menetapkan `value`, `currency` diperlukan agar metrik pendapatan bisa dihitung secara akurat.
`value`	`number`	Ya*	30,03	Nilai uang dari peristiwa. * Tetapkan `value` ke jumlah `(price * quantity)` untuk semua item di `items`. Jangan sertakan `shipping` atau `tax`. * `value` biasanya diperlukan agar pelaporan relevan. Jika Anda menandai peristiwa sebagai konversi, sebaiknya tetapkan `value`. * `currency` diperlukan jika Anda menetapkan `value`.
`items`	`Array<Item>`	Ya		Item untuk peristiwa.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`item_id`	`string`	Ya*	SKU_12345	ID item. *`item_id` atau `item_name` harus ada.
`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: `afiliasi` 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 ditetapkan, `creative_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_name` tingkat peristiwa akan digunakan, jika ada.
`creative_slot`	`string`	Tidak	featured_app_1	Nama slot materi iklan promosi yang dikaitkan dengan item. Jika ditetapkan, `creative_slot` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_slot` tingkat peristiwa akan digunakan, jika ada.
`discount`	`number`	Tidak	2.22	Nilai diskon uang satuan 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: `ID lokasi` hanya tersedia di cakupan item.
`price`	`number`	Tidak	10,01	Harga satuan uang item, dalam satuan parameter mata uang yang ditentukan. Jika diskon berlaku untuk item tersebut, tetapkan `price` ke harga unit yang didiskon dan tentukan diskon harga unit di parameter `discount`.
`promotion_id`	`string`	Tidak	P_12345	ID promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_id` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_id` tingkat peristiwa akan digunakan, jika ada.
`promotion_name`	`string`	Tidak	Summer Sale	Nama promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_name` tingkat peristiwa akan digunakan, jika ada.
`quantity`	`number`	Tidak	3	Jumlah item. Jika tidak ditetapkan, `quantity` akan ditetapkan ke 1.

Selain parameter yang ditetapkan, Anda dapat menyertakan maksimal 27 parameter kustom dalam array items.

Contoh

Contoh berikut ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: view_item
Variabel Lapisan Data (Nama - Nama Variabel Lapisan Data)

Item E-commerce - ecommerce.items
Nilai E-commerce - ecommerce.value
Mata Uang E-commerce - ecommerce.currency

Parameter Peristiwa (Nama Parameter - Nilai):

items - {{Item E-commerce}}
value - {{Nilai E-commerce}}
currency - {{Mata Uang E-commerce}}

Pemicu: peristiwa sama dengan view_item

Konfigurasi pemicu:

Jenis Pemicu: Peristiwa Kustom
Nama Peristiwa: view_item
Pemicu ini diaktifkan pada: Semua Peristiwa Kustom

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      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,
      quantity: 3
    }
    ]
  }
});

view_item_list

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

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.
`items`	`Array<Item>`	Ya		Item untuk peristiwa.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`item_id`	`string`	Ya*	SKU_12345	ID item. *`item_id` atau `item_name` harus ada.
`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: `afiliasi` 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 ditetapkan, `creative_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_name` tingkat peristiwa akan digunakan, jika ada.
`creative_slot`	`string`	Tidak	featured_app_1	Nama slot materi iklan promosi yang dikaitkan dengan item. Jika ditetapkan, `creative_slot` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_slot` tingkat peristiwa akan digunakan, jika ada.
`discount`	`number`	Tidak	2.22	Nilai diskon uang satuan 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: `ID lokasi` hanya tersedia di cakupan item.
`price`	`number`	Tidak	10,01	Harga satuan uang item, dalam satuan parameter mata uang yang ditentukan. Jika diskon berlaku untuk item tersebut, tetapkan `price` ke harga unit yang didiskon dan tentukan diskon harga unit di parameter `discount`.
`promotion_id`	`string`	Tidak	P_12345	ID promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_id` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_id` tingkat peristiwa akan digunakan, jika ada.
`promotion_name`	`string`	Tidak	Summer Sale	Nama promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_name` tingkat peristiwa akan digunakan, jika ada.
`quantity`	`number`	Tidak	3	Jumlah item. Jika tidak ditetapkan, `quantity` akan ditetapkan ke 1.

Selain parameter yang ditetapkan, Anda dapat menyertakan maksimal 27 parameter kustom dalam array items.

Contoh

Contoh berikut ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: view_item_list
Variabel Lapisan Data (Nama - Nama Variabel Lapisan Data)

Item E-commerce - ecommerce.items
ID Daftar Item E-commerce - ecommerce.item_list_id
Nama Daftar Item E-commerce - ecommerce.item_list_name

Parameter Peristiwa (Nama Parameter - Nilai):

items - {{Item E-commerce}}
item_list_id - {{ID Daftar Item E-commerce}}
item_list_name - {{Nama Daftar Item E-commerce}}

Pemicu: peristiwa sama dengan view_item_list

Konfigurasi pemicu:

Jenis Pemicu: Peristiwa Kustom
Nama Peristiwa: view_item_list
Pemicu ini diaktifkan pada: Semua Peristiwa Kustom

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item_list",
  ecommerce: {
    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",
      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.03,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      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: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

view_promotion

Peristiwa ini menandakan bahwa promosi dilihat dari daftar.

Parameter

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`creative_name`	`string`	Tidak	summer_banner2	Nama materi iklan promosi. Akan diabaikan jika ditetapkan pada tingkat item.
`creative_slot`	`string`	Tidak	featured_app_1	Nama slot materi iklan promosi yang dikaitkan dengan peristiwa. Akan diabaikan jika ditetapkan pada tingkat item.
`promotion_id`	`string`	Tidak	P_12345	ID promosi yang dikaitkan dengan peristiwa. Akan diabaikan jika ditetapkan pada tingkat item.
`promotion_name`	`string`	Tidak	Summer Sale	Nama promosi yang dikaitkan dengan peristiwa. Akan diabaikan jika ditetapkan pada tingkat item.
`items`	`Array<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.

Parameter item

Nama	Jenis	Wajib	Nilai contoh	Deskripsi
`item_id`	`string`	Ya*	SKU_12345	ID item. *`item_id` atau `item_name` harus ada.
`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: `afiliasi` 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 ditetapkan, `creative_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_name` tingkat peristiwa akan digunakan, jika ada.
`creative_slot`	`string`	Tidak	featured_app_1	Nama slot materi iklan promosi yang dikaitkan dengan item. Jika ditetapkan, `creative_slot` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `creative_slot` tingkat peristiwa akan digunakan, jika ada.
`discount`	`number`	Tidak	2.22	Nilai diskon uang satuan 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: `ID lokasi` hanya tersedia di cakupan item.
`price`	`number`	Tidak	10,01	Harga satuan uang item, dalam satuan parameter mata uang yang ditentukan. Jika diskon berlaku untuk item tersebut, tetapkan `price` ke harga unit yang didiskon dan tentukan diskon harga unit di parameter `discount`.
`promotion_id`	`string`	Tidak	P_12345	ID promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_id` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_id` tingkat peristiwa akan digunakan, jika ada.
`promotion_name`	`string`	Tidak	Summer Sale	Nama promosi yang dikaitkan dengan item. Jika ditetapkan, `promotion_name` tingkat peristiwa akan diabaikan. Jika tidak ditetapkan, `promotion_name` tingkat peristiwa akan digunakan, jika ada.
`quantity`	`number`	Tidak	3	Jumlah item. Jika tidak ditetapkan, `quantity` akan ditetapkan ke 1.

Selain parameter yang ditetapkan, Anda dapat menyertakan maksimal 27 parameter kustom dalam array items.

Contoh

Contoh berikut ditujukan untuk penerapan Tag Manager:

Tampilkan konfigurasi tag

Konfigurasi tag:

Jenis tag: Peristiwa GA4
Nama Peristiwa: view_promotion
Variabel Lapisan Data (Nama - Nama Variabel Lapisan Data)

Nama Materi Iklan E-commerce - ecommerce.creative_name
Slot Materi Iklan E-commerce - ecommerce.creative_slot
ID Promosi E-commerce - ecommerce.promotion_id
Nama Promosi E-commerce - ecommerce.promotion_name
Item E-commerce - ecommerce.items

Parameter Peristiwa (Nama Parameter - Nilai):

creative_name - {{Nama Materi Iklan E-commerce}}
creative_slot - {{Slot Materi Iklan E-commerce}}
promotion_id - {{ID Promosi E-commerce}}
promotion_name - {{Nama Promosi E-commerce}}
items - {{Item E-commerce}}

Pemicu: peristiwa sama dengan view_promotion

Konfigurasi pemicu:

Jenis Pemicu: Peristiwa Kustom
Nama Peristiwa: view_promotion
Pemicu ini diaktifkan pada: Semua Peristiwa Kustom

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_promotion",
  ecommerce: {
    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",
      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,
      quantity: 3
    }
    ]
  }
});