Penerapan End-to-end Conversions API

Conversions API mendukung upaya pengiklan dalam memberi pelanggan transparansi dan kontrol data yang memadai sekaligus tetap membantu mereka untuk terus memberikan pengalaman pribadi. Dengan API, Anda bisa membagikan data langsung dari server Anda, bukan melalui browser.

Manfaat Integrasi

• Visibilitas Corong yang Lebih Mendalam: Dengan Conversions API, Anda bisa membagikan array data yang lebih luas jika dibandingkan Meta Pixel. Dengan API, Anda bisa membuat keputusan dengan mempertimbangkan lebih banyak informasi, seperti data CRM, peristiwa corong bawah (termasuk prospek yang memenuhi syarat), dan konversi multisitus di seluruh situs web dan lokasi fisik.

• Kontrol Data: Jika digunakan melalui penerapan Server Saja (contoh: tanpa Meta Pixel), Conversions API memberi Anda kontrol tambahan terhadap data yang Anda bagikan. Anda bisa memilih untuk menambahkan insight ke peristiwa Anda, dengan memberikan data seperti margin produk atau informasi historis, seperti skor nilai pelanggan.

• Keandalan dan Ketangguhan Sinyal: Pembagian data melalui Conversions API bisa lebih diandalkan dibandingkan metode berbasis browser saja, seperti Meta Pixel. API dirancang untuk lebih tahan terhadap berbagai masalah seperti crash browser atau masalah konektivitas. Batasan transmisi data industri yang baru mungkin membatasi efisiensi cookie dan pelacakan Pixel, sehingga Conversions API membantu Anda memiliki kontrol atas pembagian sinyal yang mungkin sudah tidak ditangkap oleh Pixel.

Ringkasan

Anda bisa mempertimbangkan integrasi Conversions API dalam dua tahap utama:

• Persiapan—Pilih jenis integrasi yang sesuai untuk Anda, tentukan peristiwa yang akan dikirimkan, dan tinjau opsi pengoptimalan yang tersedia.

• Eksekusi — Pelajari cara menerapkan API. Untuk tahap ini, Anda juga bisa menggunakan integrasi partner.

Berikut ini adalah snapshot dari proses integrasi lengkap:

Pengguna Pixel yang Ada

Jika Anda sudah memiliki integrasi Meta Pixel, integrasi Conversions API harus dijadikan ekstensi integrasi Pixel, bukan koneksi yang benar-benar terpisah.

Persetujuan Umum

Jika Anda memiliki logika untuk mengontrol persetujuan terkait hal membagikan data Pixel, gunakan logika yang sama terkait dengan hal membagikan data melalui Conversions API.

Alternatif

• Jika Anda ingin mengoptimalkan iklan untuk peristiwa aplikasi, gunakan App Events API.

Persiapan

Pilih Jenis Integrasi Anda

Untuk memulainya, pilih opsi integrasi yang ingin Anda terapkan:

Menentukan Peristiwa yang Akan Dikirim

Setelah memilih pendekatan integrasi, Anda bisa menentukan peristiwa yang akan dikirimkan. Sinyal akan paling berguna jika dicocokkan dengan ID pengguna Meta. Jadi, penting untuk memikirkan parameter yang akan Anda kirimkan kepada kami dengan peristiwanya dan seberapa sering Anda akan mengirimkannya.

Opsi Peristiwa

Kirim peristiwa yang paling relevan dengan bisnis Anda. Lihat daftar lengkap peristiwa Meta standar dan khusus yang didukung.

Parameter Peristiwa

Anda dapat mengirim beberapa parameter dalam setiap peristiwa. Lihat parameter yang digunakan oleh Conversions API untuk mempelajari selengkapnya tentang kolom-kolom tersebut.

Anda bisa menambahkan beberapa jenis ID ke peristiwa Anda, termasuk event_id, external_id, dan order_id. Penting untuk memahami perbedaan berbagai parameter ini:

Kebaruan Data

Kami merekomendasikan untuk mengirimkan peristiwa secara realtime atau dalam batch berdasarkan linimasa spesifik melalui Conversions API. Mengirimkan peristiwa Anda secara realtime atau dalam 1 jam akan membantu memastikan bahwa peristiwa tersebut dapat digunakan untuk atribusi dan dioptimalkan untuk penayangan iklan.

Mengirimkan peristiwa Anda lebih dari 2 jam setelah terjadi dapat menyebabkan penurunan kinerja yang signifikan untuk iklan yang dioptimalkan untuk peristiwa tersebut. Peristiwa yang dikirimkan setelah tertunda 24 jam atau lebih bisa mengalami masalah serius atribusi dan pengoptimalan penayangan iklan.

Jika Anda mengirim peristiwa dengan periode konversi yang panjang, kirimkan peristiwa se-realtime mungkin sejak titik konversi lengkap diselesaikan.

Lanjutkan ke langkah berikutnya setelah Anda memiliki:

• Daftar peristiwa yang akan dikirimkan.
• Kolom khusus yang ingin Anda kirimkan dengan tiap peristiwa.
• Frekuensi seberapa sering Anda akan mengirimkan peristiwa.

Jenis Pengoptimalan yang Tersedia

Conversions API menawarkan jenis pengoptimalan berikut:

Eksekusi

Ada dua cara untuk menerapkan integrasi Anda:

• Integrasi Langsung — Anda sebagai pengiklan, langsung menerapkan Conversions API.
• Integrasi sebagai Platform — Anda sebagai partner marketing, menawarkan Conversions API sebagai layanan bagi klien Anda.

Integrasi Langsung

Langkah 1: Siapkan Persyaratan

Sebelum menggunakan Conversions API, siapkan aset berikut:

Lanjutkan ke Menerapkan API setelah Anda menyiapkan aset. Jangan lupa menyimpan ID untuk aset Anda karena Anda akan menggunakannya di panggilan API.

Langkah 2: Terapkan API

Setelah semua persyaratan selesai, mulailah proses penerapan. Saat membuat Conversions API, selalu periksa dokumen developer.

Panggilan Pengujian (Opsional)

Jika inilah kali pertama Anda menggunakan API, mulailah dengan panggilan pengujian. Untuk melakukannya, Anda perlu payload dan metode untuk membuat panggilan API. Setelah panggilan selesai, periksa Pengelola Peristiwa untuk memverifikasi panggilan berfungsi sebagaimana mestinya.

{
  "data": [
   {
    "event_name": "Purchase",
    "event_time": 1601673450,
    "user_data": {
      "em": "7b17fb0bd173f625b58636fb796407c22b3d16fc78302d79f0fd30c2fc2fc068",
      "ph": null
     },
    "custom_data": {
      "currency": "USD",
      "value": "142.52"
    }
   }
  ]
}

{
  "events_received": 1,
  "messages": [],
  "fbtrace_id": <FB-TRACE-ID>
}

Setelah Anda menyelesaikan panggilan pertama, verifikasikan peristiwa Anda di Pengelola Peristiwa > Pixel Anda > Ringkasan.

Lanjutkan ke Kirim dan Verifikasikan Peristiwa setelah Anda memeriksa uji peristiwa di Pengelola Peristiwa.

Mengirim dan Memverifikasi Peristiwa

Untuk mulai mengirimkan peristiwa, buat permintaan POST ke edge /events API. Lampirkan payload ke panggilan Anda. Jika Anda perlu bantuan membuat payload, kunjungi Bantuan Payload. Lihat sumber informasi berikut untuk mendapatkan informasi selengkapnya dan contoh kode:

• Menggunakan API > Kirim permintaan
• Peristiwa Dibatalkan
• Waktu Pengunggahan versus Waktu Transaksi Peristiwa
• Batch Permintaan
• Hashing

Setelah Anda mulai mengirimkan peristiwa, buka Pengelola Peristiwa dan pastikan kami menerima peristiwa yang Anda kirimkan. Pelajari cara Memverifikasi Peristiwa Anda.

Jika penerapan Anda bersifat pelengkap untuk Pixel browser, lanjutkan ke pengaturan penghapusan duplikasi. Jika tidak, semua sudah beres! Periksa Dukungan jika Anda masih memiliki pertanyaan.

Langkah 3: Tambahkan Parameter untuk Menghapus Duplikasi

Jika Anda mengirim peristiwa identik dari Pixel Anda dan melalui Conversions API, Anda perlu menyiapkan penghapusan duplikasi untuk peristiwa yang Anda kirim melalui kedua saluran. Pertama, baca dokumen developer untuk memahami logika penghapusan duplikasi.

Penghapusan duplikasi berbasis peristiwa

Jika kami menemukan kombinasi kode server yang sama (event_id, event_name) dan kombinasi kode browser (eventID, event) dikirimkan ke ID Pixel yang sama dalam waktu 48 jam, kami membuang peristiwa duplikat kedua yang dikirimkan.

Untuk membantu memastikan peristiwa dihapus duplikasinya:

• Untuk peristiwa terkait, pastikan parameter berikut diatur ke nilai yang sama:

  • event_id dari peristiwa server dan eventID dari peristiwa browser Anda
  • event_name dari peristiwa server dan browser Anda
• Setelah Anda mengirimkan peristiwa duplikat, periksa Pengelola Peristiwa untuk mengetahui apakah peristiwa yang benar dibatalkan.
• Pastikan bahwa setiap peristiwa unik yang dikirim melalui Pixel dan Conversions API memiliki event_id sendiri. ID ini tidak boleh digunakan bersama dengan peristiwa lain.

Alternatif untuk menghapus duplikasi berbasis peristiwa

Meskipun ID Peristiwa akan selalu menjadi cara terbaik untuk menghapus peristiwa duplikat, penerapannya cukup rumit. Anda bisa memanfaatkan berbagai solusi alternatif menggunakan parameter external_id atau fbp. Jika Anda sudah mengonfigurasi parameter external_id atau fbp agar diteruskan melalui browser dan server, kami akan otomatis menghapus peristiwa duplikat jika menemukan peristiwa yang sama dengan parameter external_id atau fbp dalam waktu 48 jam.

Langkah 4, Opsional: Jelajahi Fitur Business SDK

Meta Business SDK dilengkapi berbagai fitur canggih yang dirancang khusus bagi pengguna Conversions API:

• Permintaan Asinkron— Gunakan fitur ini jika Anda tidak mau memblokir eksekusi program Anda untuk menunggu hingga permintaan diselesaikan. Dengan pendekatan ini, Anda membuat permintaan Anda dan mendapatkan sinyal kembali dari server setelah ini diselesaikan. Saat Anda menunggu tanggapan ini, program masih bisa terus dieksekusi.
• Batching Serentak—Manfaatkan permintaan asinkron untuk meningkatkan throughput menggunakan lebih banyak sumber daya secara lebih efisien. Buat permintaan dalam batch untuk mendukung kasus penggunaan, seperti pekerja permintaan peristiwa, cron job, dan sebagainya.
• Antarmuka Layanan HTTP—Batalkan layanan HTTP default Business SDK dan terapkan layanan khusus Anda sendiri dengan metode atau galeri yang Anda pilih.

Integrasi sebagai Platform

Petunjuk berikut ini adalah untuk partner yang menawarkan Conversions API sebagai layanan bagi pengiklan.

Langkah 1: Siapkan Persyaratan

Aplikasi Anda harus mendapatkan fitur dan izin berikut:

• Level Akses: Akses Lanjutan
• Fitur: Akses Standar Pengelolaan Iklan
• Izin: ads_management, pages_read_engagement, dan ads_read.

Langkah 2: Kirim Peristiwa Atas Nama Klien

Pertama, ikuti langkah-langkah integrasi langsung dan uji integrasi Anda. Kemudian, Anda dapat meminta otorisasi untuk mengirim peristiwa atas nama klien Anda. Anda memiliki opsi autentikasi berikut:

Pendekatan Meta Business Extension (Direkomendasikan)

Meta Business Extension memberikan semua informasi penting yang dibutuhkan untuk mengirimkan peristiwa atas nama klien melalui proses berikut. Meta Business Extension menyediakan endpoint untuk mengambil token akses pengguna sistem di Pengelola Bisnis klien. Proses ini mencakup izin untuk mengirimkan peristiwa server dan dilakukan secara otomatis dan aman.

Endpoint memerlukan token akses pengguna sebagai parameter input. Bagi pengguna Meta Business Extension baru, panggil endpoint ini untuk mengambil token akses pengguna sistem setelah Anda selesai menyiapkan Meta Business Extension. Pengguna yang ada harus meminta autentikasi ulang sebelum memanggil endpoint API yang baru.

Token akses pengguna sistem klien

Minta klien Anda membuat Token Akses Pengguna Sistem secara manual melalui Conversions API di dalam Pengaturan Pixel. Kemudian, kirim peristiwa ke Pixel pengiklan dengan token tersebut.

Pengguna sistem atau pengguna sistem admin harus menginstal aplikasi yang akan digunakan untuk membuat token akses. Dengan pengaturan ini, aplikasi Anda diizinkan untuk memanggil API atas nama pengguna sistem ini atau pengguna sistem admin.

Klien membagikan Pixel ke Pengelola Bisnis partner

Dengan opsi ini, klien membagikan Pixel mereka kepada partner melalui pengaturan Pengelola Bisnis atau melalui API, lalu Anda dapat menetapkan pengguna sistem partner ke Pixel klien dan Anda dapat membuat token akses untuk mengirim peristiwa server.

Langkah 3: Atribusikan Peristiwa ke Platform Anda

Untuk mengatribusikan peristiwa Conversions API ke platform Anda, gunakan kolom partner_agent. Dengan begitu, Anda bisa mengatur pengidentifikasi platform Anda sendiri saat mengirimkan peristiwa atas nama klien. Jika Anda adalah partner terkelola, bekerja samalah dengan Perwakilan Meta Anda untuk menyepakati pengidentifikasi platform Anda. Nilai ini harus dalam format yang kurang dari 23 karakter dan mencakup minimal dua karakter alfabet. Kemudian, kirimkan ini dengan setiap peristiwa server.

Dukungan

Untuk Semua Partner

Lihat informasi tentang artikel debugging dan Pusat Bantuan Bisnis.

Untuk Partner Terkelola

Berikan informasi berikut kepada Perwakilan Meta Anda sehingga mereka bisa membantu menguji integrasi dan mengatasi masalah: ID Pengelola Bisnis, ID Aplikasi, ID Pixel.

Dokumentasi API

• Memulai - Uji API dari Pengelola Bisnis Anda
• Menggunakan API
• Praktik Terbaik - Conversions API
• Menyiapkan Conversions API sebagai Platform
• Peristiwa Meta Standar
• Peristiwa Meta Khusus
• Parameter
• Bantuan Payload
• Opsi Pemrosesan Data untuk Conversions API dan Offline Conversions API
• Jika Anda ingin mengoptimalkan peristiwa aplikasi, gunakan App Events API
• Jika peristiwa itu adalah penjualan toko, gunakan Offline Conversions API - Peristiwa offline yang bukan merupakan penjualan toko tidak memenuhi syarat untuk Conversions API