Kode peristiwa memungkinkan Anda mengukur dampak iklan Pinterest Anda terhadap tindakan tertentu di situs. Kode ini diperlukan untuk meluncurkan kampanye yang secara otomatis akan mengoptimalkan peristiwa tertentu seperti kampanye konversi atau iklan penargetan ulang dinamis. Anda juga akan memerlukan kode peristiwa untuk
Setelah menambahkan
Tabel di bawah ini menunjukkan peristiwa yang dapat Anda lacak dengan tag Pinterest. Anda dapat menggunakannya untuk
Peristiwa | Tujuan |
---|---|
Checkout | Melacak orang yang menyelesaikan transaksi. |
AddToCart | Melacak orang yang menambahkan item ke tas 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 menunjukkan minat pada produk atau layanan Anda. |
Pencarian | Melacak orang yang menelusuri situs web Anda untuk produk atau lokasi toko tertentu. |
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. |
[User-defined event] | Tambahkan peristiwa tambahan yang Anda tentukan untuk tujuan penargetan audiens. Peristiwa unik tidak tersedia untuk pelaporan konversi. Perlu diingat bahwa setiap spasi dalam nama peristiwa khusus yang melewati tag akan dihapus. |
Ada peristiwa yang diwajibkan dan direkomendasikan, bergantung pada kampanye iklan yang Anda putuskan untuk Anda jalankan.
Jenis kampanye | Peristiwa yang diwajibkan | Peristiwa yang direkomendasikan | Data peristiwa yang diwajibkan | Data peristiwa yang direkomendasikan |
---|---|---|---|---|
Kesadaran atas merek | Tidak ada |
|
Tidak ada | Pencocokan yang Ditingkatkan |
Penjualan katalog |
|
|
|
|
Pertimbangan | Tidak ada |
|
Tidak ada | Pencocokan yang Ditingkatkan |
Konversi |
Setidaknya salah satu dari yang berikut:
|
|
Tidak ada |
|
Jumlah penayangan video | Tidak ada | Tidak ada | Tidak ada | Pencocokan yang Ditingkatkan |
Ada peristiwa yang diwajibkan dan direkomendasikan, bergantung pada fitur yang ingin Anda gunakan.
Fitur | Peristiwa yang diwajibkan | Peristiwa yang direkomendasikan | Data peristiwa yang diwajibkan | Data peristiwa yang direkomendasikan |
---|---|---|---|---|
Wawasan Konversi |
|
Tidak ada | currency | Tidak ada |
Program Merchant Terverifikasi (Verified Merchant Program, VMP) |
|
Tidak ada | currency | Tidak ada |
Penargetan ulang dinamis |
|
Tidak ada |
|
Tidak ada |
Jika Anda memutuskan untuk menggunakan penyiapan manual, Anda harus menambahkan sendiri kode peristiwa ke situs web Anda. Langkah-langkah di bawah ini ditujukan untuk orang-orang yang menggunakan opsi penyiapan manual.
- Masuk ke akun bisnis Pinterest melalui desktop.
- Klik
ikon hamburger di kiri atas halaman - Di bagian Bisnis, klik Konversi.
- Klik Mulai.
- Pilih Tag Pinterest saja, lalu klik Lanjutkan.
- Klik Lewati di kanan bawah layar Anda.
- Klik Lewati ke penyiapan manual.
- Salin kode dasar, lalu klik Lanjutkan.
- Pilih apakah pencocokan persis otomatis akan diaktifkan, lalu klik Lanjutkan.
- Klik Salin kode di bawah kotak abu-abu, di sebelah kode peristiwa yang ingin Anda tambahkan.
- Buka kode untuk halaman di situs web yang peristiwanya ingin Anda lacak.
- Tempelkan kode peristiwa di halaman tempat peristiwa seharusnya terjadi, pastikan untuk mengganti semua nilai contoh dengan nilai yang sesuai untuk situs web Anda. Artinya, peristiwa akan aktif setiap kali halaman dimuat.
- Klik Selesai.
Catatan: Jika sebuah peristiwa dipicu hanya setelah seseorang melakukan tindakan tertentu di halaman, seperti mengklik tombol atau mengirimkan formulir, pastikan bahwa kode peristiwa hanya berjalan sebagai hasil dari tindakan itu. Agar dapat memastikannya, dibutuhkan pemahaman terkait penanganan peristiwa yang terjadi pada kode JavaScript halaman Anda.
Anda dapat menyediakan informasi tambahan tentang sebuah peristiwa dengan melampirkan objek yang berisi data peristiwa. Semua data peristiwa tersedia untuk penargetan audiens tetapi hanya data peristiwa value dan order_quantity yang tersedia untuk pelaporan konversi berbayar dan organik.
Data peristiwa | Contoh nilai | Jenis |
---|---|---|
value | 100,00 | Angka (bilangan bulat atau titik mengambang) |
event_id | eventId0001 |
String (id string yang mengidentifikasi peristiwa secara unik) Catatan: Id ini dapat dikirimkan dengan nama-nama kolom berikut ini, semuanya peka huruf besar/kecil: |
order_quantity | 1 | Bilangan bulat |
order_id | 1234OrderID | String (order_id diperlukan untuk pelaporan analisis konversi) |
product_name | Parker Boots | himpunan line_items, string |
product_id | 1414 | himpunan line_items, string |
product_category | Sepatu | himpunan line_items, string |
product_variant_id | 1414-Red | himpunan line_items, string |
product_variant | Merah | himpunan line_items, string |
product_price | 99,99 | Angka (bilangan bulat atau titik mengambang), himpunan line_items, string |
product_quantity | 1 | Bilangan bulat, himpunan line_items, string |
product_brand | Parker | himpunan line_items, string |
promo_code | WINTER10 | String |
property | Athleta | String |
search_query | boot | String |
video_title | Cara bergaya dengan Parker Boot Anda | String |
lead_type | Newsletter | String |
currency | USD |
Salah satu dari berikut ini: AED, AMD, ARS, AUD, AZN, BAM, BGN, BHD, BMD, BND, BOB, BRL, BSD, CAD, CHF, CLP, CNY, COP, CRC, CZK, DKK, DOP, EGP , EUR, FJD, GBP, GEL, GIP, HKD, HNL, HRK, HUF, IDR, ILS, INR, ISK, JMD, JPY, KGS, KRW, KWD, KZT, MAD, MDL, MOP, MXN, MYR, NOK , NZD, OMR, PAB, PEN, PHP, PKR, PLN, QAR, RON, RSD, RUB, SAR, SEK, SGD, THB, TRY, TWD, UAH, USD, UYU, VND atau ZAR. Catatan: jika Anda memberikan mata uang dengan peristiwa tag Anda, kami akan menghitung nilai tukarnya agar sesuai dengan mata uang akun pengiklan Anda. |
Tag IMG adalah kode di tag Pinterest yang berfungsi sebagai cadangan jika seseorang yang menonaktifkan JavaScript di browsernya. Sebaiknya Anda juga menyertakan data peristiwa di tag IMG karena tindakan ini memungkinkan penargetan pengguna yang lebih baik. Anda dapat memilih untuk hanya menggunakan tag IMG tanpa tag JavaScript, tetapi Anda harus
Di bawah ini terdapat contoh dari setiap jenis peristiwa. Anda dapat menyalin dan menempelkannya langsung di situs web. Perhatikan bahwa Anda harus mengganti nilai contoh dengan variabel dinamis untuk situs web Anda.
Checkout
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=checkout&ed[event_id]=YOUR_EVENT_ID&ed[value]=10.00&ed[order_quantity]=2&noscript=1" />
Data peristiwa: event_id, value, order_quantity, dan currency
Pastikan Anda memasukkan kode mata uang yang benar untuk situs web.
AddToCart
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=AddToCart&ed[value]=10.00&ed[order_quantity]=2&noscript=1" />
Data peristiwa: value, order_quantity, dan currency.
Pastikan Anda memasukkan kode mata uang yang benar untuk situs web.
Pagevisit
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=pagevisit&noscript=1" />
Data peristiwa: tidak ada
Signup
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=signup&noscript=1" />
Data peristiwa: tidak ada
WatchVideo
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=watchvideo&ed[video_title]=My+Product+Video+01&noscript=1" />
Data peristiwa: video_title
Lead
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=lead&ed[lead_type]=Newsletter&noscript=1" />
Data peristiwa:lead_type
Pencarian
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=search&ed[search_query]=horse&noscript=1" />
Data peristiwa:search_query (tipe prospek)
ViewCategory
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=viewcategory&noscript=1" />
Data peristiwa: tidak ada
Custom
Jenis peristiwa harus disebut sebagai custom—jika tidak, konversi yang dilacak oleh tag tidak akan dilaporkan dalam Manajer Iklan.
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=custom&noscript=1" />
Data peristiwa: tidak ada
Value dan order_quantity adalah dua bagian dari data peristiwa yang tersedia di pelaporan konversi berbayar dan organik. Jika Anda ingin menambah nilai dan kuantitas, Anda dapat meneruskannya kembali secara dinamis. Nilai dinamis dapat berubah bergantung pada tindakan yang dilakukan di situs Anda. Jika Anda memilih untuk mengembalikan value dan order_quantity, hal ini akan bersifat unik untuk situs web Anda dan cara Anda mencatat penjualan. Nilai dan kuantitas produk di setiap pesanan yang dilakukan di situs web Anda biasanya bervariasi.
<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
Catatan: Penyiapan jumlah dan nilai pesanan dinamis bersifat unik untuk situs web Anda.
Selain data peristiwa, Anda bisa meneruskan fungsi panggil balik JavaScript sebagai argumen opsional ke fungsi pintrk(). Tindakan ini memberikan informasi tambahan jika ada yang salah dengan tag Anda yang dapat Anda periksa di alat pengembang. Fungsi panggil balik ini berjalan setiap kali panggilan pelacakan peristiwa, fungsi pintrk(), dipicu.
Fungsi panggil balik menggunakan dua argumen berikut:
function(didInit, error) {}
didInit: Argumen pertama ini menerima nilai boolean, yang diatur menjadi true jika panggilan pelacakan peristiwa berhasil dibuat dan 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'.
<script>
pintrk('track', 'checkout', {
value: 10.00,
order_quantity: 2,
currency: 'USD',
event_id: 'eventId0001',
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>
Untuk pelacakan konversi dan pelaporan, Anda harus menentukan satu dari sembilan jenis peristiwa pada kode peristiwa. Anda juga harus mengganti YOUR_TAG_ID dengan ID tag konversi Pinterest Anda. Ingatlah bahwa Anda dapat menyertakan kombinasi data peristiwa apa pun per peristiwa selain yang ditampilkan pada contoh di bawah ini.
Bagian ini berisi contoh setiap jenis peristiwa dalam format lengkap dan dapat disalin, yang dapat Anda tempatkan pada situs Anda secara langsung. Setiap contoh dilengkapi dengan data peristiwa yang dibutuhkan untuk mulai melacak aktivitas di situs web Anda. Perhatikan bahwa Anda harus mengganti nilai contoh dengan nilai statis atau variabel dinamis yang sesuai untuk situs web Anda. Misalnya, Anda mungkin ingin melacak nilai pesanan secara dinamis karena nilai setiap pesanan yang dilakukan di situs web Anda akan bervariasi, bergantung pada item yang dibeli pengguna. Namun, Anda dapat menetapkan nilai statis ke data peristiwa lead_type jika hanya ditempatkan di satu halaman tertentu.
Checkout
<script>
pintrk('track', 'checkout', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Data peristiwa: value, order_quantity, currency, and event_id.
Pastikan untuk memasukkan kode mata uang yang benar untuk situs web Anda.
AddToCart
<script>
pintrk('track', 'addtocart', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Data peristiwa: value, order_quantity, dan currency.
Pastikan untuk memasukkan kode mata uang yang benar untuk situs web Anda.
Pagevisit
<script>
pintrk('track', 'pagevisit', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Signup
<script>
pintrk('track', 'signup', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
WatchVideo
<script>
pintrk('track', 'watchvideo', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Data peristiwa:Video_title
Lead
<script>
pintrk('track', 'lead', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Data peristiwa:lead_type
Pencarian
<script>
pintrk('track', 'search', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Data peristiwa:search_query (tipe prospek)
ViewCategory
<script>
pintrk('track', 'viewcategory', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Peristiwa yang ditentukan pengguna
<script>
pintrk('track', 'user_defined_event_name', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Custom
Jenis peristiwa harus disebut kustom. Jika tidak, konversi yang dilacak oleh tag tidak akan dilaporkan di Manajer Iklan.
<script>
pintrk('track', 'custom', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Berikut adalah beberapa contoh kode dasar yang dikombinasikan dengan kode peristiwa. Ingatlah untuk memastikan bahwa kode peristiwa ditempatkan setelah kode dasar di situs web Anda.
Contoh ID tag konversi: 123456789 (ganti dengan ID tag konversi Pinterest Anda)
Contoh kode peristiwa: PageVisit
<head>
<script type="text/javascript">
!function(e){{if(!window.pintrk){{window.pintrk=function(){{window.pintrk.queue.push(
Array.prototype.slice.call(arguments))}};var
n=window.pintrk;n.queue=[],n.version="3.0";var
t=document.createElement("script");t.async=!0,t.src=e;var
r=document.getElementsByTagName("script")[0];r.parentNode.insertBefore(t,r)}}}}
("https://s.pinimg.com/ct/core.js");
pintrk('load', '123456789'); pintrk('page');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&noscript=1" />
</noscript>
<script>
pintrk('track', 'pagevisit');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=pagevisit&noscript=1" />
</noscript>
</head>
Contoh ID tag konversi: 123456789 (ganti dengan ID tag konversi Pinterest Anda)
Contoh kode peristiwa: PageVisit dan AddToCart
<head>
<script type="text/javascript">
!function(e){{if(!window.pintrk){{window.pintrk=function(){{window.pintrk.queue.push(
Array.prototype.slice.call(arguments))}};var
n=window.pintrk;n.queue=[],n.version="3.0";var
t=document.createElement("script");t.async=!0,t.src=e;var
r=document.getElementsByTagName("script")[0];r.parentNode.insertBefore(t,r)}}}}
("https://s.pinimg.com/ct/core.js");
pintrk('load', '123456789'); pintrk('page');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&noscript=1" />
</noscript>
<script>
pintrk('track', 'pagevisit');
pintrk('track', 'addtocart');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=pagevisit&noscript=1" />
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=addtocart&noscript=1" />
</noscript>
</head>