Mulai 1 Juli 2023, properti Universal Analytics (UA) standar berhenti memproses data (1 Juli 2024 untuk properti UA 360). Bermigrasi ke Google Analytics 4.

Enhanced E-commerce

Halaman ini menjelaskan cara menggunakan gtag.js untuk mengumpulkan data Enhanced E-commerce. Jika Anda telah mengonfigurasi Google Analytics di gtag.js dan mengaktifkan Enhanced E-commerce di Google Analytics, Anda dapat menggunakan gtag.js untuk mengirim data tayangan, data produk, data promosi, dan data tindakan ke Google Analytics.

Tindakan dan Jenis Data Enhanced E-commerce

Ada beberapa jenis data e-commerce yang dapat Anda kirim:

data tayangan
data produk
data tindakan
jenis tindakan

Data Tayangan

Menampilkan informasi tentang produk yang telah dilihat. Ini disebut sebagai impressionFieldObject dan berisi nilai-nilai berikut:

Kunci	Jenis Nilai	Wajib	Deskripsi
`id`	teks	*Ya	ID produk atau SKU (misalnya, P67890). * Salah satu dari `id` atau `name` harus ditetapkan.
`name`	teks	*Ya	Nama produk (misalnya, Kaus Android). * Salah satu dari `id` atau `name` harus ditetapkan.
`list`	teks	Tidak	Daftar atau koleksi yang berisi produk (misalnya, Hasil Penelusuran)
`list_name`	teks	Tidak	Daftar atau koleksi yang berisi produk (misalnya, Hasil Penelusuran)
`brand`	teks	Tidak	Merek yang terkait dengan produk (misalnya, Google).
`category`	teks	Tidak	Kategori produk (misalnya, Pakaian). Gunakan `/` sebagai pemisah untuk menentukan hierarki hingga 5 tingkat (misalnya Pakaian/Pria/Kaus).
`variant`	teks	Tidak	Varian produk (misalnya, Hitam).
`position`	bilangan bulat	Tidak	Posisi produk dalam daftar atau koleksi (misalnya, 2).
`list_position`	bilangan bulat	Tidak	Posisi produk dalam daftar atau koleksi (misalnya, 2).
`price`	angka	Tidak	Harga produk (misalnya, 29,20).

Data Produk

Data produk menampilkan setiap produk yang dilihat, yang ditambahkan ke keranjang belanja, dll. Data ini disebut sebagai productFieldObject dan berisi nilai berikut:

Kunci	Jenis Nilai	Wajib	Deskripsi
`id`	teks	*Ya	ID produk atau SKU (misalnya, P67890). * Salah satu dari ID atau `name` harus ditetapkan.
`name`	teks	*Ya	Nama produk (misalnya, Kaus Android). * Salah satu dari ID atau `name` harus ditetapkan.
`brand`	teks	Tidak	Merek yang terkait dengan produk (misalnya, Google).
`category`	teks	Tidak	Kategori produk (misalnya, Pakaian). Gunakan / sebagai pemisah untuk menentukan hierarki hingga 5 tingkat (misalnya, Pakaian/Pria/Kaus).
`variant`	teks	Tidak	Varian produk (misalnya, Hitam).
`price`	angka	Tidak	Harga produk (misalnya, 29,20).
`quantity`	bilangan bulat	Tidak	Kuantitas produk (misalnya, 2).
`coupon`	teks	Tidak	Kode kupon yang terkait dengan produk (misalnya, SUMMER_SALE13).
`position`	bilangan bulat	Tidak	Posisi produk dalam daftar atau koleksi (misalnya, 2).
`list_position`	bilangan bulat	Tidak	Posisi produk dalam daftar atau koleksi (misalnya, 2).

Data Promosi

Menampilkan informasi tentang promosi yang telah dilihat. Ini disebut promoFieldObject dan berisi nilai-nilai berikut:

Kunci	Jenis Nilai	Wajib	Deskripsi
`id`	teks	*Ya	ID promosi (misalnya, PROMO_1234). * Salah satu dari `id` atau `name` harus ditetapkan.
`name`	teks	*Ya	Nama promosi (misalnya, Summer Sale). * Salah satu dari `id` atau `name` harus ditetapkan.
`creative`	teks	Tidak	Materi iklan yang terkait dengan promosi (misalnya, summer_banner2).
`creative_name`	teks	Tidak	Nama materi iklan (misalnya, summer_banner2).
`position`	teks	Tidak	Posisi materi iklan (misalnya, banner_slot_1).
`creative_slot`	teks	Tidak	Nama slot materi iklan (misalnya, banner_slot_1).

Data Tindakan

Menampilkan informasi tentang tindakan terkait e-commerce yang telah terjadi. Ini disebut sebagai actionFieldObject dan berisi nilai-nilai berikut:

Kunci	Jenis Nilai	Wajib	Deskripsi
`id`	teks	*Ya	ID transaksi (misalnya, T1234). * Wajib jika jenis tindakan adalah `purchase` atau `refund`
`affiliation`	teks	Tidak	Toko atau afiliasi tempat transaksi ini terjadi (misalnya, Google Store).
`revenue`	angka	Tidak	Menyatakan total pendapatan atau jumlah total yang terkait dengan transaksi (mis., 11,99). Nilai ini bisa mencakup pengiriman, biaya pajak, atau penyesuaian lainnya pada total pendapatan yang ingin Anda sertakan sebagai bagian dari penghitungan pendapatan Anda. Catatan: Jika pendapatan tidak ditetapkan, nilainya akan secara otomatis dihitung menggunakan kolom kuantitas dan harga produk dari semua produk dalam hit yang sama.
nilai	angka	Tidak	Nilai (yaitu pendapatan) yang terkait dengan peristiwa.
`tax`	angka	Tidak	Total pajak yang terkait dengan transaksi.
`shipping`	angka	Tidak	Biaya pengiriman yang terkait dengan transaksi.
`coupon`	teks	Tidak	Kupon transaksi yang ditukarkan dengan transaksi.
`list`	teks	Tidak	Daftar yang mencakup produk terkait. Opsional.
`items`	array	Tidak	Array yang berisi produk terkait.
`step`	bilangan bulat	Tidak	Angka yang mewakili langkah dalam proses checkout. Opsional pada tindakan `checkout`.
`checkout_step`	bilangan bulat	Tidak	Angka yang mewakili langkah dalam proses checkout.
`option`	teks	Tidak	Kolom tambahan untuk tindakan `checkout` dan `checkout_option` yang dapat menjelaskan informasi opsi di halaman checkout, seperti metode pembayaran yang dipilih.
`checkout_option`	teks	Tidak	Opsi checkout (yaitu metode pembayaran yang dipilih).

Kunci	Jenis Nilai	Wajib	Deskripsi
`coupon`	string	Tidak	Kode kupon untuk item yang dapat dibeli.

Tindakan Produk dan Promosi

Tindakan menentukan cara menafsirkan data produk dan promosi yang Anda kirim ke Google Analytics.

Tindakan	Peristiwa	Deskripsi
`click`	Klik pada produk atau link produk untuk satu atau beberapa produk.
`detail`	Tampilan detail produk.
`add`	Menambahkan satu atau beberapa produk ke keranjang belanja.
`remove`	Menghapus satu atau beberapa produk dari keranjang belanja.
`checkout`	Memulai proses checkout untuk satu atau beberapa produk.
`checkout_option`	Mengirim nilai opsi untuk langkah checkout tertentu.
`purchase`	Penjualan satu atau beberapa produk.
`refund`	Pengembalian dana untuk satu atau beberapa produk.
`promo_click`	Klik pada promosi internal.
`add_to_cart`	Pengguna menambahkan satu atau beberapa produk ke keranjang belanja.
`begin_checkout`	Pengguna memulai proses checkout untuk satu atau beberapa produk.
`checkout_progress`	Pengguna menyelesaikan langkah checkout setelah langkah checkout pertama.
`purchase`	Pengguna menyelesaikan pembelian.
`refund`	Pengguna akan menerima pengembalian dana untuk satu atau beberapa produk.
`remove_from_cart`	Pengguna menghapus satu atau beberapa produk dari keranjang belanja.
`select_content`	Pengguna mengklik link produk atau produk.
`set_checkout_option`	Langkah checkout yang diselesaikan pengguna.
`view_item`	Pengguna melihat detail untuk suatu produk.
`view_item_list`	Pengguna melihat daftar dari satu atau beberapa produk.
`view_promotion`	Pengguna mengklik promosi internal.
`view_refund`	Pengguna melihat pengembalian dana untuk satu atau beberapa produk.

Contoh

Mengukur tayangan produk

Untuk mengukur tayangan produk, kirim view_item_list dengan informasi produk:

gtag('event', 'view_item_list', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": 3
    }
  ]
});

Mengukur klik produk

Untuk mengukur klik produk, kirim peristiwa select_content, tentukan product sebagai content_type, dan berikan informasi produk:

gtag('event', 'select_content', {
  "content_type": "product",
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    }
  ]
});

Mengukur tampilan detail produk

Setelah mengklik listingan produk, pengguna mungkin melihat halaman detail produk. Untuk mengukur tampilan detail produk, kirim peristiwa view_item dengan detail produk:

gtag('event', 'view_item', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

Mengukur penambahan ke dan penghapusan dari keranjang belanja

Untuk mengukur penambahan produk ke keranjang belanja, kirim peristiwa add_to_cart dengan informasi produk:

gtag('event', 'add_to_cart', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

Untuk mengukur penghapusan produk dari keranjang belanja, kirim peristiwa remove_from_cart dengan informasi produk:

gtag('event', 'remove_from_cart', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

Mengukur checkout

Untuk mengukur setiap langkah dalam proses checkout:

Tambahkan kode pengukuran untuk mengukur setiap langkah dalam proses checkout.
Jika relevan, tambahkan kode pengukuran untuk mencatat opsi checkout.

1. Mengukur langkah checkout

Untuk mengukur langkah checkout pertama, kirim peristiwa begin_checkout dengan item checkout:

gtag('event', 'begin_checkout', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ],
  "coupon": ""
});

Untuk mengukur setiap langkah checkout berikutnya, kirim peristiwa checkout_progress dengan item checkout:

gtag('event', 'checkout_progress', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ],
  "coupon": "SUMMER_DISCOUNT"
});

2. Mengukur opsi checkout

Untuk mengukur opsi checkout, kirim peristiwa set_checkout_option dengan opsi checkout:

gtag('event', 'set_checkout_option', {
  "checkout_step": 1,
  "checkout_option": "shipping method",
  "value": 3
});

Mengukur tayangan promosi

Untuk mengukur tayangan promosi, kirim peristiwa view_promotion dengan informasi promosi:

gtag('event', 'view_promotion', {
  "promotions": [
    {
      "id": "abc123",
      "name": "summer_promo"
    },
    {
      "id": "xyz987",
      "name": "spring savings"
    }
  ]
});

Mengukur klik promosi

Untuk mengukur klik promosi, kirim peristiwa select_content dan berikan promosi:

gtag('event', 'select_content', {
  "promotions": [
    {
      "id": "abc123",
      "name": "summer_promo"
    }
  ]
});

Mengukur pembelian

Untuk mengukur transaksi, kirim peristiwa purchase dengan item dalam transaksi:

gtag('event', 'purchase', {
  "transaction_id": "24.031608523954162",
  "affiliation": "Google online store",
  "value": 23.07,
  "currency": "USD",
  "tax": 1.24,
  "shipping": 0,
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": '3.0'
    }
  ]
});

Mengukur pengembalian dana

Untuk mengukur pengembalian dana penuh dari transaksi, kirim peristiwa refund dengan ID transaksi:

gtag('event', 'refund', { "transaction_id": "T12345" })

Untuk mengukur pengembalian dana sebagian, kirim peristiwa refund dengan ID transaksi dan item yang akan dikembalikan dananya:

gtag('event', 'refund', {
  "transaction_id": "79.18502354114992",
  "affiliation": "Google online store",
  "value": 23.07,
  "currency": "USD",
  "tax": 1.24,
  "shipping": 0,
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": '3.0'
    }
  ]
});