Ringkasan

API Pinterest untuk Konversi memungkinkan pengiklan mengirim konversi langsung ke Pinterest melalui metode koneksi server ke server. Konversi yang ditangkap dengan API Pinterest kemudian dapat digunakan untuk penargetan ulang dalam kampanye dan dapat ditinjau dalam pelaporan konversi guna meningkatkan visibilitas konversi.

Melalui API Pinterest untuk Konversi, pengiklan dapat mengirim:

  • Konversi web
  • Konversi Dalam Aplikasi
  • Konversi Offline
  • Peristiwa dapat diterima secara realtime atau dalam waktu satu jam setelah peristiwa terjadi dan ditangkap. Peristiwa yang diterima di luar periode ini atau sebagai bagian dari peristiwa batch yang tertunda akan dihitung sebagai konversi offline. 

    Penggunaan API Pinterest untuk Konversi bersama dengan Tag Pinterest dapat membantu memaksimalkan visibilitas tentang konversi yang ditangkap. Praktik terbaik kami adalah menggunakan solusi penangkapan konversi untuk memastikan Anda memperoleh gambaran komprehensif tentang kinerja kampanye konversi Anda.

    API Pinterest

    API Pinterest untuk Konversi adalah salah satu dari beberapa produk yang berada dalam ekosistem API Pinterest. Siapa pun yang memiliki akun Pinterest Business dapat menggunakan API Pinterest untuk Konversi, tetapi penggunaan ini tidak secara otomatis memberikan akses ke API Pinterest yang lebih luas. 

    Platform Pengembang Pinterest memuat informasi tentang semua produk API Pinterest. 

    Memulai

    Siapa pun yang memiliki akun Pinterest Business memiliki akses ke API Pinterest untuk Konversi.

    Untuk memulai, Anda harus terlebih dahulu membuat token akses. Token akses adalah serangkaian karakter yang memverifikasi permintaan yang dibuat dan dikirim kembali ke akun pengguna yang benar. 

    Untuk membuat token akses: 

  • Masuk ke Akun Pinterest BusinessAnda
  • Klik Iklan di menu atas dan pilih Konversi
  • Pilih halaman Token akses konversi dari navigasi sebelah kiri
  • Klik tombol Buat token baru
  • Salin token akses baru dan kembali ke proses penyiapan.
  • Jika mencoba mengakses akun yang bukan milik Anda, Anda harus menyiapkan Akses Bisnis terlebih dahulu. 

    Implementasi

    Peristiwa Konversi: Semua jenis peristiwa yang tersedia untuk ditangkap di Tag Pinterest juga tersedia melalui API Pinterest untuk Konversi. Anda dapat menemukan daftar lengkap peristiwa dan informasi lebih lanjut mengenai kepentingannya dalam Dokumentasi Pengembang API Pinterest.

    Menyiapkan integrasi API server-ke-server memerlukan sumber daya rekayasa dan pengembang dari pemilik situs web. Tingkat upaya teknis pengembang akan bervariasi tergantung pada:

  • Seberapa jauh pengembang Anda mengenal integrasi API. Jika belum pernah melakukan integrasi API sebelumnya, tindakan ini mungkin memerlukan upaya tambahan.  Jika Anda telah menerapkan API konversi lainnya, pengembang Anda hanya perlu melakukan beberapa perubahan tambahan.
  • Data jumlah peristiwa yang sudah dilacak dan sudah pada tahap apa proses konversi akan dikirimkan kepada kami.
  • Jika pengiklan menginginkan atau perlu menggunakan pihak ketiga untuk melakukan integrasi (mis. Shopify, GTM, Tealium).
  • Jika Anda sudah menggunakan Tag Pinterest

    Kami sangat menyarankan penggunaan API Pinterest untuk Konversi bersama Tag Pinterest untuk memastikan bahwa Anda memaksimalkan konversi. 

    Jika Anda telah menyiapkan Tag Pinterest, Anda harus memastikan konversi tidak dihitung dua kali (sekali melalui Tag Pinterest, dan sekali melalui API). 

    Untuk memastikan hal ini, Anda harus memastikan parameternya, event_id dikembalikan dengan konversi yang ditangkap oleh Tag Pinterest dan API Pinterest untuk Konversi. 

    Sistem kami kemudian akan mengenali event_ids sebagai duplikat dan hanya menyimpan konversi pertama yang ditangkap. Untuk memastikan deduplikasi ini berhasil, event_ids harus:

  • event_ids harus identik untuk konversi yang sama - Seseorang membuka halaman web dan Konversi kunjungan halaman diaktifkan oleh Tag Pinterest dan API Pinterest. Kedua konversi tersebut harus memiliki event_ids yang sama yang dikirim kembali agar sistem kami mengenali bahwa konversi tersebut sama. 
  • event_ids harus unik untuk konversi yang berbeda - Seseorang membuka halaman web dan Konversi kunjungan halaman diaktifkan oleh Tag Pinterest dan API Pinterest. Orang tersebut kemudian menambahkan sebuah kaus ke tasnya, yang memicu aktivasi peristiwa AddToCart baik pada Tag Pinterest maupun API Pinterest. Meskipun event_ids yang diaktifkan untuk peristiwa yang sama harus sama, event_ids yang dikirim untuk peristiwa Kunjungan halaman dan peristiwa AddToCart harus unik. Dengan begini, sistem kami mengenali kedua peristiwa itu sebagai peristiwa terpisah.
  • Berdasarkan pengenal peristiwa dan event_name, Pinterest akan menghapus semua peristiwa duplikat dari catatan, asalkan (a) peristiwa tidak berlangsung offline (action_source bukan offline), dan (b) Pinterest menerima peristiwa duplikat dalam waktu 48 jam sejak peristiwa aslinya.

    Memverifikasi penyiapan Anda

    Setelah selesai menyiapkan API, Anda dapat memverifikasi peristiwa konversi yang diterima dengan memeriksa:

  • Kode Respons: Pengembang yang menyiapkan integrasi API Anda dapat meninjau kode respons yang dihasilkan untuk setiap permintaan yang dikirim kembali setelah konversi diaktifkan. 
  • Halaman Deduplikasi di Manajer Iklan: Konversi setelah deduplikasi akan muncul di Halaman Deduplikasi di Manajer Iklan. Untuk mengakses halaman deduplikasi:
    • Masuk ke Akun Pinterest BusinessAnda
    • Klik Iklan di menu atas dan pilih Konversi
    • Pilih Deduplikasi dari navigasi sebelah kiri.
  • Kualitas dan ketahanan

    Ketahanan adalah status penyiapan API untuk Konversi yang memungkinkan pencocokan dan atribusi tingkat sinyal tertinggi. Data tambahan ini akan membantu kami menyediakan pelaporan yang lebih akurat seiring perubahan dan perkembangan kebijakan industri iklan.

    Status Ketahanan

    Ada dua kategori  status ketahanan: Bagus dan Buruk. Status ketahanan Anda terlihat di bagian Kesehatan Konversi di Manajer Iklan.

    Ketahanan yang bagus

    Opsi 1: Cakupan Pengenal Spesifik

  • Cakupan pengenal
    • Harus ada IP/UA pada 90% atau lebih peristiwa, 
    • ada Email yang di-hash atau MAID pada 10% atau lebih peristiwa corong bawah, 
    • dan ada id eksternal pada 10% peristiwa atau lebih.
  • Tumpang tindih dengan data Tag (jika berlaku)
    • 90%* atau lebih peristiwa Tag harus diterima melalui CAPI 
  • Atau:

    Opsi 2: Mencapai Tingkat Kecocokan Dasar

  • Tingkat Kecocokan Pengguna CAPI 60% atau lebih
  • Tumpang tindih dengan data Tag (jika berlaku)
  • 90%* atau lebih peristiwa Tag harus diterima melalui CAPI 


  • Ketahanan yang buruk

    Penyiapan apa pun yang tidak Bagus.

    ID dan Sinyal Ketahanan

    Kirim sinyal berikut untuk mencapai status pengiklan yang tangguh.

    ID API/Sinyal Bobot/Peringkat
    client_ip_address + client_user_agent Tinggi
    em Tinggi
    external_id Tinggi
    hashed_maid Tinggi
    click_id Tinggi
    fn + ln Rendah
    ph Rendah
    ge, bd, ct, st, zp, country Rendah

    *Bobot/peringkat berdasarkan probabilitas kenaikan tingkat kecocokan

    Implementasi Pihak Ketiga

    Pinterest memiliki beberapa Integrasi Pihak Ketiga untuk membantu mendukung proses adopsi API Anda. 

    Google Tag Manager - Sisi Server

    Hubungkan akun Google Tag Manager Anda dengan API Pinterest untuk Konversi untuk mengetahui seberapa besar Pinterest memengaruhi lalu lintas ke toko dan penjualan produk Anda.

    Integrasi ini mengharuskan Anda menerapkan penampung server menggunakan penyedia cloud pilihan Anda dan pengetahuan tentang pemberian tag sisi server. Untuk info lebih lanjut tentang prasyarat, kunjungi situs web pengembang

    Shopify

    Integrasi API untuk Konversi ini melengkapi Tag Pinterest demi memastikan cakupan dan kualitas data yang tinggi. Asalkan aplikasi Shopify telah terinstal, tidak ada tindakan yang perlu dilakukan untuk memanfaatkan peningkatan ini. Perubahan akan diterapkan secara otomatis ke toko merchant.

    Tealium

    Pengiklan yang tertarik dengan Tealium dapat menyiapkan API untuk Konversi bersama pihak ketiga secara langsung. Tealium membuat template dan akan membantu memfasilitasi integrasi dengan pengiklan. 

    Proses implementasi diuraikan di Pusat Pembelajaran Tealium. Semua pertanyaan tentang dukungan implementasi dapat dikirimkan ke support [at] tealium.com (support[at]tealium[dot]com)

    Jika Anda tertarik dengan integrasi pihak ketiga tambahan, hubungi perwakilan penjualan Anda untuk informasi lebih lanjut. 

    Memahami Pemrosesan Data Terbatas

    Mulai 1 Januari 2023, pengiklan dapat menggunakan bendera Pemrosesan Data Terbatas untuk membantu mereka mematuhi Undang-Undang Privasi Konsumen California, sebagaimana diamendemen oleh Undang-Undang Hak Privasi California (bersama-sama disebut CCPA). Dengan bendera ini, Pinterest akan membatasi cara kami menggunakan data tertentu untuk membantu pengiklan mematuhi pengaturan privasi pengguna. Misalnya, pengiklan dapat menerapkan bendera Pemrosesan Data Terbatas untuk pengguna California yang telah menolak penjualan atau pembagian data mereka berdasarkan CCPA. Jika bendera Pemrosesan Data Terbatas digunakan, Pinterest akan bertindak sebagai penyedia layanan berdasarkan CCPA sehubungan dengan data yang ditandai dari pengguna di California.

    Pengiklan bertanggung jawab untuk mematuhi pilihan pengguna, serta mengidentifikasi status residensi pengguna saat menerapkan bendera Pemrosesan Data Terbatas.

    End of Other articles Links
    Still need help? Contact us
    User feedback
    Apakah artikel ini membantu?

    collection_fields

    Bagaimana kami dapat menjadikan artikel ini lebih baik?