Kode peristiwa

Setelah menambahkan kode dasar, Anda dapat menambahkan kode peristiwa untuk melacak peristiwa konversi tertentu pada situs web Anda.

Tabel di bawah menunjukkan peristiwa yang dapat Anda Lacak dengan tag Pinterest, dan apakah pin tersebut berisi laporan penciptaan audiens dan konversi audiens. 

Peristiwa

Tujuan

Pembuatan audiens

Pelaporan konversi

Checkout

Melacak orang yang menyelesaikan transaksi

AddToCart

Melacak orang yang menambahkan item ke keranjang belanja

PageVisit

Melacak orang yang melihat halaman utama, seperti halaman produk dan halaman artikel

Signup

Melacak orang yang mendaftar ke produk atau layanan Anda

WatchVideo

Melacak orang yang menonton video

Lead

Melacak orang yang tertarik pada produk atau layanan Anda

Search

Melacak orang yang melakukan pencarian di situs web Anda untuk mencari produk tertentu atau lokasi toko

ViewCategory

Melacak orang yang melihat halaman kategori

Custom

Melacak peristiwa khusus. Gunakan nama peristiwa ini untuk melacak peristiwa khusus yang ingin Anda sertakan dalam pelaporan konversi Anda

[User-defined event]

Menambahkan peristiwa lain yang telah Anda tentukan untuk tujuan penargetan audiens. Peristiwa unik tidak tersedia untuk pelaporan konversi. Harap diingat bahwa spasi kosong akan dihapus dari nama peristiwa awal yang melewati tag

 

Penempatan

Baik kode dasar dan kode peristiwa harus ditambahkan ke halaman apa pun yang konversinya ingin Anda lacak. Kode dasar harus diletakkan pada setiap halaman situs web Anda, sementara kode peristiwa hanya perlu diletakkan pada halaman yang konversinya ingin Anda lacak. Kode dasar harus berjalan sebelum kode peristiwa, jadi pastikan untuk menempatkannya lebih awal.

Misalnya, jika ingin melacak checkout yang berhasil, Anda harus meletakkan kode dasar lalu kode peristiwa checkout di antara tag <head> dan </head> di halaman konfirmasi checkout Anda. Penempatan ini akan memastikan bahwa kode segera berjalan begitu halaman dimuat.

Di sisi lain, jika sebuah peristiwa dipicu hanya setelah pengguna melakukan tindakan tertentu di halaman tersebut, seperti mengklik tombol atau mengirimkan formulir, Anda perlu memastikan bahwa kode peristiwa berjalan hanya sebagai hasil dari tindakan tersebut. Hal ini membutuhkan pemahaman penanganan peristiwa pada kode JavaScript halaman Anda.

Data Peristiwa

Anda dapat menyediakan informasi tambahan tentang sebuah peristiwa dengan menambahkan objek yang berisi data peristiwa.

Harap diingat bahwa saat ini kami hanya menawarkan pelaporan data peristiwa value dan order_quantity. Data peristiwa tambahan lainnya tersedia untuk penargetan audiens, tetapi tidak tersedia untuk pelaporan konversi.

Nilai harus dikirim kembali bersama-sama dengan kode mata uang yang tepat. Kami akan melakukan konversi di Manajer iklan ke mata uang akun Anda dengan menggunakan nilai tukar antara kode mata uang yang dikirim kembali di Tag konversi dan mata uang akun Anda.

Data peristiwa

Contoh nilai

Jenis

Pembuatan audiens

Pelaporan konversi

value

100,00

Angka (bilangan bulat atau titik mengambang)

order_quantity

1

Bilangan bulat

currency

USD

Salah satu dari yang berikut: USD, GBP, CAD, EUR, AUD, atau NZD

 

product_name

Parker Boots

array line_items

 

product_id

1414

array line_items

 

product_category

Sepatu

array line_items

 

product_variant_id

1414-Red

array line_items

 

product_variant

Merah

array line_items

 

product_price

99,99

Angka (bilangan bulat atau titik mengambang), array line_item

 

product_quantity

1

Bilangan bulat, array line_items

 

product_brand

Parker

array line_items

 

promo_code

WINTER10

String

 

property

Athleta

String

 

search_query

boot

String

 

video_title

Cara bergaya dengan Parker Boot Anda

String

 

lead_type

Newsletter

String

 

 

Kode peristiwa contoh berikut melacak peristiwa checkout dengan data peristiwa yang menjelaskan pembelian dua produk. Harap diingat bahwa contoh ini adalah bagian JavaScript dari kode peristiwa. Pada contoh ini, order_quantity dan Value bersifat statis, tapi mungkin Anda ingin meneruskan kembali nilai tersebut secara dinamis.

Lihat bagian data peristiwa nilai dan jumlah untuk contoh nilai dan jumlah dinamis.
 

<script>
 pintrk('track', 'checkout', {
   value: 10.00,
   order_quantity: 2,
   currency: 'USD',
   line_items: [
     {
       product_name: 'Parker Boots',
       product_id: '1414',
       product_price: 5.00,
       product_quantity: 1
     },
     {
       product_name: 'Parker Sandals',
       product_id: 'ABC',
       product_price: 5.00,
       product_quantity: 1
     }
   ]
 });
</script>

Nilai dan jumlah data peristiwa

Nilai dan jumlah pesanan adalah dua data peristiwa yang saat ini tersedia di pelaporan konversi. Jika ingin menambahkan nilai dan jumlah, Anda dapat menggunakan nilai statis atau meneruskannya kembali secara dinamis. Jika Anda ingin meneruskan kembali nilai dan jumlah secara dinamis seperti yang disarankan, tindakan ini akan unik bagi situs web Anda dan cara Anda melakukan pencatatan penjualan. Biasanya, nilai dan jumlah produk pada setiap pesanan di situs web Anda berbeda. Untuk melacak nilai keseluruhan penjualan Anda secara akurat, kami menyarankan variabel dinamis untuk melacak jumlah dan nilai pada tag konversi Anda.

Contoh nilai dan jumlah yang ditulis permanen:

<script>
 pintrk('track', 'checkout', {
   value: 10.00, // Read this value (must be a number)
   order_quantity: 5 // Read this quantity (must be an integer)
 });
</script>
<noscript>
 <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=checkout&ed[value]=10.00&ed[order_quantity]=5&noscript=1"/>
</noscript>

Nilai yang dilaporkan: 10,00

Jumlah yang dilaporkan: 5

Contoh nilai dan jumlah dinamis:

<script>
 pintrk('track', 'checkout', {
   value: {{Enhanced Transaction Revenue}},
   order_quantity: {{item.quantity}}
 });
</script>
<noscript>
 <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=checkout&ed[value]={{Enhanced Transaction Revenue}}&ed[order_quantity]={{item.quantity}}&noscript=1" />
</noscript>

Nilai yang dilaporkan: Jumlah dinamis yang dibeli dengan checkout yang terkait

Jumlah yang dilaporkan: Jumlah dinamis yang dibeli dengan checkout yang terkait

Harap dicatat bahwa penyiapan jumlah dan nilai pesanan dinamis bersifat unik bagi situs web Anda.

Panggilan Balik

Selain data peristiwa, Anda dapat meneruskan fungsi panggil balik JavaScript sebagai argumen opsional ke fungsi pintrk(). Fungsi panggil balik ini berjalan setiap saat ketika panggilan pelacakan peristiwa, yaitu fungsi pintrk(), terpicu.

Fungsi panggil balik menggunakan dua argumen berikut:

function(didInit, error) {}
  • didInit: Argumen pertama ini menerima nilai boolean, yang ditetapkan ke true jika panggilan pelacakan peristiwa berhasil dibuat, dan ditetapkan ke false jika kesalahan terdeteksi saat membuat panggilan pelacakan peristiwa.

  • error: Argumen kedua ini menerima string, yang menjelaskan kesalahan saat didInit menghasilkan false; jika didInit true, string ini akan menjadi 'undefined'.

Contoh

<script>
 pintrk('track', 'checkout', {
   value: 10.00,
   order_quantity: 2,
   currency: 'USD',
   line_items: [
     {
       product_name: 'Parker Boots',
       product_id: '1414',
       product_price: 5.00,
       product_quantity: 1
     },
     {
       product_name: 'Parker Sandals'
       product_id: 'ABC',
       product_price: 5.00,
       product_quantity: 1
     }
   ]
 }, function(didInit, error) { if (!didInit) { console.log(error); }
 });
</script>

Langkah selanjutnya

Anda dapat melihat beberapa contoh lain di sini. Setelah menambahkan kode dasar dan kode peristiwa, Anda dapat menggunakan bantuan tag pinterest untuk mengonfirmasi bahwa Anda telah menerapkan tag dengan benar.

Masih butuh bantuan?
Hubungi Kami