Conversions API

Menyiapkan Conversions API sebagai Platform

Jika Anda menawarkan penyiapan Meta Pixel sebagai bagian dari layanan pengelolaan tag, Anda sebaiknya mempertimbangkan untuk menambahkan fungsi Conversions API. Integrasi dengan Conversions API memungkinkan pelanggan Anda mengirim peristiwa web ke Meta secara langsung, tanpa harus bergantung pada peristiwa pixel browser.

Peristiwa Server vs Peristiwa Browser

Sebelum memulai, penting untuk memahami hubungan antara peristiwa server dan Meta Pixel. Peristiwa server dikirim melalui Conversions API dan digunakan dalam pengukuran, pelaporan, dan pengoptimalan dengan cara yang sama seperti peristiwa piksel browser.

Jika mengirimkan peristiwa piksel browser seperti mengirim email melalui pos udara, maka mengirim peristiwa server seperti mengirim email melalui pengiriman barang. Keduanya merupakan mekanisme untuk mengangkut paket (data tentang suatu peristiwa) ke alamat tujuan (ID pixel). Jadi, kami sangat menyarankan Anda membuat integrasi Conversions API di platform Anda sebagai perpanjangan dari penawaran Meta Pixel Anda saat ini (bukan plugin atau layanan terpisah) untuk alasan berikut:

  • Peristiwa server menggunakan ID pixel sebagai tujuan
  • Peristiwa server diproses dengan cara yang sama seperti peristiwa pixel browser setelah dikirim ke Facebook
  • Deduplikasi akan lebih mudah diterapkan
  • Mudah digunakan bagi klien. Misalnya, peristiwa server dapat dikirim bersama peristiwa browser, secara default.

Setelah platform Anda terintegrasi dengan Conversions API, kami sarankan untuk mengirimkan peristiwa web yang sama melalui browser dan server. Redundansi ini membantu memastikan keandalan sinyal. Peristiwa yang sebelumnya bisa hilang di sisi browser, karena berbagai alasan jaringan, kini ditangkap melalui Conversions API.

Untuk mengirim peristiwa melalui browser dan server, Anda harus mengatur event_id yang sama dengan benar untuk peristiwa terkait. Ini memungkinkan Facebook untuk melakukan deduplikasi peristiwa Anda dengan benar.

Prasyarat

  1. Platform web yang dapat berbagi peristiwa ke Facebook. Misalnya, pembuat situs web, pengelola tag, atau platform AdTech.
  2. Pemberitahuan kepada dan persetujuan dari pengguna Anda untuk berbagi data peristiwa dengan Facebook, sebagaimana diwajibkan oleh Ketentuan Fitur Bisnis Facebook.
  3. Perwakilan Facebook
  4. Prasyarat integrasi Conversions API standar:

Untuk mulai menawarkan Conversions API sebagai platform, aplikasi Anda perlu menjalani Tinjauan Aplikasi. Selama proses itu, Anda harus meminta level akses, fitur, dan izin berikut:

Memulai

Jika ini pertama kalinya Anda menggunakan Conversions API, ikuti langkah ini untuk membuat Bisnis, aplikasi Meta, Meta Pixel, dan pengguna sistem. Lalu Anda dapat menggunakan token akses pengguna sistem Anda untuk mengirim peristiwa server melalui Conversions API.

Langkah 1: Buat sebuah bisnis.

Langkah 2: Buat aplikasi Meta di bawah bisnis yang baru dibuat itu.

Langkah 3: Buat Meta Pixel di bawah bisnis yang baru dibuat itu:

Langkah 4: Buat token akses pengguna sistem.

Langkah 5: Kirimkan peristiwa server ke Meta Pixel Anda.

Mengirim Peristiwa Atas Nama Klien

Setelah Anda berhasil mengirim peristiwa server ke Meta Pixel Anda sendiri, Anda memiliki opsi mengenai cara mengirim peristiwa atas nama klien.

Untuk Meta Pixel yang dimiliki atau dikelola oleh Pengelola Bisnis mitra

  1. Di Pengelola Bisnis, buka bagian Pengguna dan pilih tab Pengguna Sistem. Klik pengguna sistem tertentu yang Anda gunakan untuk Conversions API.
  2. Buka dialog Tetapkan Aset dan pilih Pixel. Kemudian, pilih piksel yang ingin Anda kirimi peristiwa.
  3. Untuk setiap pixel, pilih izin Kelola Pixel, dan klik Simpan Perubahan.
  4. Kembali ke halaman detail pengguna sistem Anda. Verifikasi bahwa pixel yang dipilih terlihat di sana.

Untuk Meta Pixel yang tidak dikelola oleh mitra

Anda harus terlebih dulu meminta otorisasi untuk mengirim peristiwa atas nama klien Anda. Anda memiliki opsi autentikasi berikut:

Facebook Business Extension (Disarankan)

Dengan opsi ini, Facebook Business Extension (FBE) memberikan semua informasi yang diperlukan untuk mengirim peristiwa atas nama klien melalui proses berikut. FBE 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 FBE baru, panggil endpoint ini untuk mengambil token akses pengguna sistem setelah Anda selesai menyiapkan FBE. Pengguna yang ada harus meminta autentikasi ulang sebelum memanggil endpoint API yang baru.

Token Akses Pengguna Sistem Klien

Dengan opsi ini, Anda harus meminta klien membuat token akses pengguna sistem secara manual melalui Conversions API di dalam Pengaturan Pixel. Anda kemudian dapat mengirim 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 atau pengguna sistem admin ini.

Ikuti dokumentasi Memulai kami dan minta token pengguna sistem dari pengiklan Anda. Jangan lupa menggunakan Meta Pixel dan token akses Anda sendiri untuk pengujian.

Klien Berbagi Meta Pixel dengan Pengelola Bisnis Mitra

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

Mengatribusikan Peristiwa ke Platform Anda Menggunakan Kolom partner_agent

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. Bekerjalah bersama Perwakilan Facebook untuk menyepakati pengidentifikasi untuk platform Anda. Kemudian, kirimkan ini dengan setiap peristiwa server.

Contoh payload peristiwa

Jika pengidentifikasi platform Anda adalah datapartner, ini contoh payload peristiwa pembelian yang dikirim atas nama klien Anda:

    
{
  "data": [
    {
      "user_data": {
        "em": "8159ea0e33c51a774b83104ee562784f9b1836c852102046e4bd8385706fe7ca"
      },
      "event_name": "PageView",
      "event_time": 1579645238
    },
    {
      "user_data": {
        "em": "8159ea0e33c51a774b83104ee562784f9b1836c852102046e4bd8385706fe7ca"
      },
      "custom_data": {
        "currency": "USD",
        "value": "50"
      },
      "event_name": "Purchase",
      "event_time": 1579645238
    }
  ],
  "partner_agent": "datapartner"
}

Pertanyaan Umum

Sending events sent via the Conversions API is just like sending events via the Meta Pixel. The only difference is that the event is sent via the server, instead of the browser. So, why make an effort to integrate with the Conversions API? Here are some important use cases:

Capture offline and down-funnel events

If someone uses an advertisers’ website to sign up for a credit card, they can send events such as ViewContent, Application Start, and Application Submit via the browser to the Meta Pixel. However, the end user still needs to be approved for this credit card. The Approval event happens offline and cannot be sent via browser. To register this final step, the advertiser can send the Approval via the Conversions API.

Signal resiliency

Browser side events can be lost for many reasons:

  • The user might navigate away before the page has finished loading.
  • Ad blockers could prevent the event from firing.
  • The changing internet landscape might change the way inter-domain messages are sent.

These examples can all be mitigated by sending events via the Conversions API.

Sensitive data

Many advertisers have expressed concerns about sharing data via the browser when that data could be seen or inspected. This can be mitigated by sending data via the Conversions API.

For example, advertisers may want to send data like profit margin or lifetime value (LTV) along with a purchase event. This way, ads can be optimized towards a specific type of customer.

Tautan Permanen

Since browser events are always vulnerable to obstacles, we recommend that you only send events collected from the Conversions API sources. For example, if:

  • One of the ways your customer ingests data into your platform is via a browser JavaScript tag, or
  • You send that data to Meta via the Conversions API

the data is open to the browser-side risks.

To take full advantage of the Conversions API, no part of the data flow should be reliant on the browser.

Tautan Permanen

We recommend that you provide advertisers with a way to test this connection on your own platform.

  1. Send a test event via the Conversions API to the advertiser’s pixel. Look for a 200 return code.
  2. Update the status of the connection appropriately.
Tautan Permanen

Meta tries to deduplicate identical events sent through the Meta Pixel and the Conversions API. We determine if events are identical based on their event_id and event_name. For more information, see Handling Duplicate Pixel and Conversions API Events.

Tautan Permanen

The external_id parameter is a string that represents a user on an advertiser's system. These IDs help improve ads attribution and create audiences.

You can send external_ids via browser or the Conversions API, but you must be consistent across channels. For example, if you send a browser pixel event with external_id set to 123, your server event for that same user should also have external_id set to 123.

Tautan Permanen