Integrasi Quality API

API ini masih dalam versi beta. Untuk mendapatkan akses, silakan hubungi perwakilan Meta.

Pengiklan yang membagikan peristiwa server menggunakan Conversions API dapat melihat Kualitas Kecocokan Peristiwa di Pengelola Peristiwa. Namun, ini hanya berfungsi secara individual dan sulit untuk diskalakan dalam kasus-kasus di mana mitra penyedia layanan teknologi, mitra agensi, atau pengiklan mengelola ratusan dan ribuan Meta Pixel untuk bisnis mereka. Integrasi Quality API dapat membantu mengatasi masalah ini dengan mengonsolidasikan metrik kualitas integrasi secara terprogram dalam skala besar.

Tentang Kualitas Kecocokan Peristiwa

Kualitas Kecocokan Peristiwa

Kualitas Kecocokan Peristiwa (Event Match Quality atau EMQ) adalah skor (dari 10) yang menunjukkan seberapa efektif informasi pelanggan yang dikirim dari server Anda dalam mencocokkan instance peristiwa ke akun Facebook. Pencocokan acara berkualitas tinggi dapat meningkatkan atribusi dan kinerja iklan. Perhatikan bahwa metrik ini sedang dalam pengembangan.

Cara Menghitungnya

Kualitas Kecocokan Peristiwa dihitung dengan melihat parameter informasi pelanggan mana yang diterima dari server Anda melalui integrasi Conversions API, kualitas informasi yang diterima, dan persentase instance peristiwa yang dicocokkan dengan akun Meta.

Cara Menggunakannya

Kualitas Kecocokan Peristiwa digunakan untuk menilai apakah Anda mengirimkan informasi pelanggan yang tepat untuk mencocokkan peristiwa Anda dengan akun Meta melalui Conversions API, dan apakah Anda telah menyiapkan parameter informasi pelanggan dengan benar. Parameter informasi pelanggan membantu mencocokkan peristiwa Anda dengan akun Meta sehingga Anda dapat menghubungkan konversi dengan iklan Anda dan mengirimkannya kepada orang-orang yang kemungkinan besar akan melakukan konversi.

Kualitas Kecocokan Peristiwa dihitung secara realtime. Pelajari selengkapnya tentang praktik terbaik EMQ di sini.

EMQ saat ini hanya tersedia untuk peristiwa web. Untuk jenis peristiwa lainnya seperti peristiwa offline dan toko fisik, peristiwa aplikasi, prospek konversi, atau integrasi apa pun dalam tahap alfa atau beta, hubungi perwakilan Meta Anda untuk mendapatkan panduan tentang cara meningkatkan kualitas pencocokan.

Kasus Penggunaan Umum

Mitra dan agensi dapat menggunakan Integrasi Quality API untuk menyediakan dasbor dan insight yang berkualitas, sekaligus membantu pengiklan untuk meningkatkan dan mengoptimalkan integrasi mereka. Mitra juga dapat menggunakan integrasi ini untuk memantau stabilitas integrasi Conversions API mereka. Pengiklan dapat menggunakan endpoint ini untuk mengumpulkan data kualitas integrasi untuk dimasukkan ke dalam pemantauan mereka.

Autentikasi

Autentikasi Pengiklan melalui Pengelola Bisnis

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

Autentikasi Platform Mitra

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

Facebook Login for Business (Direkomendasikan)

Facebook Login for Business adalah solusi autentikasi dan otorisasi pilihan bagi penyedia layanan teknologi dan developer aplikasi bisnis yang membutuhkan akses ke aset klien bisnis mereka. Facebook Login for Business memungkinkan Anda untuk menentukan jenis token akses, jenis aset, dan izin yang dibutuhkan aplikasi Anda, dan menyimpannya sebagai satu set (konfigurasi). Kemudian, Anda dapat menyajikan set tersebut kepada klien bisnis Anda untuk menyelesaikan alur dan memberikan aplikasi Anda akses ke aset bisnis mereka.

Meta Business Extension (Direkomendasikan)

Dengan opsi ini, Meta Business Extension (MBE) memberikan semua informasi yang diperlukan untuk mengirim peristiwa atas nama klien. MBE menyediakan endpoint untuk mengambil token akses pengguna sistem yang dibuat di Pengelola Bisnis klien. Proses ini mencakup izin untuk mengirim peristiwa server dan dilakukan secara otomatis dan aman. MBE saat ini masih dalam versi beta, silakan hubungi perwakilan Meta Anda untuk mendapatkan akses.

Endpoint memerlukan token akses pengguna sebagai parameter input. Jika Anda adalah pengguna MBE baru, panggil endpoint ini untuk mengambil token akses pengguna sistem setelah Anda selesai mengatur MBE. Pengguna yang ada harus meminta autentikasi ulang sebelum memanggil endpoint API yang baru.

Klien Berbagi Meta Pixel dengan Pengelola Bisnis Mitra

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

Mengambil Informasi Kualitas Integrasi Pixel

Anda dapat memantau skor Kualitas Kecocokan Peristiwa per peristiwa, bersama dengan kode kecocokan yang dikirim, menggunakan endpoint, parameter, dan kolom API berikut ini:

Endpoint

https://graph.facebook.com/v21.0/<pixel_id>/integration_quality

Parameter

Parameter Deskripsi

Parameter	Deskripsi
`agent_name` string	Opsional. Nilai yang dinormalisasi dari kolom partner_agent digunakan untuk memfilter hanya peristiwa yang dikirim dengan param partner_agent di /{pixel_id}/events permintaan POST (lihat menghubungkan peristiwa Anda dengan praktik terbaik di sini dan di sini). Sebagai contoh, jika nilai partner_agent Anda adalah `[partner_name]_[majorversion]_[minorVersion]`, nilai string agen yang dinormalisasi adalah `partner_name` dalam huruf kecil. `agent_name` memungkinkan Anda untuk mengatur pengidentifikasi platform Anda sendiri saat mengirim peristiwa atas nama klien. Jika Anda adalah mitra/agensi terkelola, bekerja samalah dengan perwakilan Meta Anda untuk menyepakati pengidentifikasi platform Anda. Jika Anda seorang pengiklan, biasanya Anda tidak perlu khawatir tentang atribusi `agent_name`. Jika Anda tidak menyediakan `agent_name`, semua peristiwa terlepas dari apakah peristiwa tersebut dikirim oleh agen atau tidak, akan dimasukkan dalam perhitungan EMQ.

agent_name

string

Opsional.
Nilai yang dinormalisasi dari kolom partner_agent digunakan untuk memfilter hanya peristiwa yang dikirim dengan param partner_agent di /{pixel_id}/events permintaan POST (lihat menghubungkan peristiwa Anda dengan praktik terbaik di sini dan di sini).

Sebagai contoh, jika nilai partner_agent Anda adalah [partner_name]_[majorversion]_[minorVersion], nilai string agen yang dinormalisasi adalah partner_name dalam huruf kecil.

agent_name memungkinkan Anda untuk mengatur pengidentifikasi platform Anda sendiri saat mengirim peristiwa atas nama klien. Jika Anda adalah mitra/agensi terkelola, bekerja samalah dengan perwakilan Meta Anda untuk menyepakati pengidentifikasi platform Anda.

Jika Anda seorang pengiklan, biasanya Anda tidak perlu khawatir tentang atribusi agent_name.

Jika Anda tidak menyediakan agent_name, semua peristiwa terlepas dari apakah peristiwa tersebut dikirim oleh agen atau tidak, akan dimasukkan dalam perhitungan EMQ.

Kolom

Kolom	Deskripsi
`event_name` string	Sebuah peristiwa standar atau nama peristiwa khusus.
`event_match_quality` AdsPixelCAPIEMQ	Kualitas Kecocokan Peristiwa menunjukkan seberapa efektif informasi pelanggan yang dikirim dari server Anda dalam mencocokkan instance peristiwa ke akun Facebook.

Contoh

Graph API Explorer

GET/v21.0/<PIXEL_ID>/integration_quality?fields=event_match_quality,event_name&agent_name=<AGENT_NAME>&access_token=<ACCESS_TOKEN>

cURL

curl -X GET -G \
  -d 'fields="event_match_quality,event_name"' \
  -d 'agent_name="&lt;AGENT_NAME&gt;"' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<LATEST_VERSION>/<PIXEL_ID>/integration_quality

Tanggapan API

{
  "data": [
    {
      "event_match_quality": {
        "composite_score": 5.1,
        "match_key_feedback": [
          {
            "identifier": "email",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "user_agent",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "external_id",
            "coverage": {
              "percentage": 100
            }
          }
        ]      
      },
      "event_name": "pLTVPurchase"
    },
    {
      "event_match_quality": {
        "composite_score": 7.2,
        "match_key_feedback": [
          {
            "identifier": "email",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "user_agent",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "phone",
            "coverage": {
              "percentage": 69.1
            }
          },
          {
            "identifier": "fbp",
            "coverage": {
              "percentage": 96.7
            }
          },
          {
            "identifier": "external_id",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "fbc",
            "coverage": {
              "percentage": 3.2
            }
          }
        ]
      },
      "event_name": "CompleteRegistration"
    }
  ]
}

Pertanyaan Umum

What is the access token used for?

The access token is used when partners send signal events or access the Setup Quality API on behalf of advertisers. The client system user access token onboarding method is not compatible with the EMQ API at the moment.

Tautan Permanen

How should the partner_agent field be formatted?

The partner_agent value in your API GET request should be a normalized lowercase format. This field is now optional.

Tautan Permanen

Pelajari Selengkapnya

Praktik Terbaik Conversions API.
Mendorong kinerja dengan penyiapan Conversions API yang dioptimalkan.
Praktik terbaik untuk menggunakan Conversions API bagi mitra
Panduan kualitas penyiapan Conversions API dari Pusat Bantuan Bisnis Meta:

Praktik terbaik untuk Conversions API dalam membantu meningkatkan kinerja iklan. Praktik terbaik Conversions API ini dapat membantu bisnis meningkatkan kinerja iklan mereka dengan menurunkan biaya per tindakan. Kami menyarankan untuk mengikuti praktik terbaik ini pada saat penyiapan awal, tetapi praktik ini juga dapat digunakan untuk memperbarui penyiapan yang sudah ada.

Melihat detail peristiwa server di Pengelola Peristiwa Meta. Setelah pelaku bisnis menyiapkan Conversions API, mereka dapat menggunakan artikel ini untuk mempelajari cara memantau peristiwa dan parameter untuk memastikan penyiapan mereka bekerja secara efektif dan mengidentifikasi peluang untuk peningkatan. Mereka juga dapat menggunakan artikel ini untuk mempelajari cara menggunakan detail peristiwa server (Kecocokan Peristiwa [Kualitas Kecocokan Peristiwa/EMQ]), Kebaruan Data, Ikhtisar Peristiwa, dan Deduplikasi Peristiwa) di Pengelola Peristiwa untuk meningkatkan penyiapan Conversions API mereka.