Business Management APIs

Membagikan Meta Pixel Antar Bisnis

Mungkin ada beberapa kasus penggunaan bagi bisnis untuk mengakses set data pixel dari satu bisnis dengan bisnis lainnya (biasanya suatu agensi), seperti untuk mengelola iklan, menganalisis kinerja, atau mengunggah peristiwa.

Berikut adalah integrasi API yang dibutuhkan untuk menjalin hubungan antara pixel dan bisnis agensi. Jika bisnis penerima (agensi) juga mengelola iklan untuk klien dan perlu menggunakan pixel tersebut untuk akun iklan, lihat langkah 3.

Prasyarat: Persyaratan Aplikasi

Aplikasi harus mempunyai fitur Akses Standar Pengelolaan Iklan (akses lanjutan). Aplikasi juga harus mempunyai izin berikut:

  • business_management
  • ads_management atau ads_read dan manage_pages

Langkah 1: Mulai Berbagi Pixel dengan Bisnis Agensi

Langkah ini memerlukan token akses pengguna dengan izin aplikasi di atas dari admin bisnis yang memiliki pixel tersebut.

POST <ads_pixel>/agencies?business=<agency_business_id>&permitted_tasks=[<permitted_tasks_for_agency_business>]

Opsi dan parameter untuk permintaan ini mencakup:

Nama Deskripsi

business

jenis: numerik

Wajib.

ID bisnis agensi menerima akses ke pixel

permitted_tasks

jenis: list:string

Wajib.

Contoh: ['ANALISIS', 'UNGGAH', 'IKLANKAN']

Tugas yang diizinkan untuk agensi pada pixel

Kemungkinan Nilai: ANALYZE, UPLOAD, ADVERTISE, EDIT

ANALISIS: Lihat, analisis, dan iklankan.

UNGGAH: Unggah data konversi situs web ke set data ini.

IKLAN: Hubungkan akun iklan ke set data Facebook ini. Gunakan set data ini untuk pengiklanan.

EDIT: Kelola set data, edit pengaturan, analisis, dan iklankan. (Akses EDIT saat ini dibatasi, hubungi perwakilan Meta Anda untuk memasukkan aplikasi Anda ke dalam daftar yang diizinkan)

Kami menangani permintaan berdasarkan status hubungan dengan bisnis lainnya:

  • Bisnis yang sudah mempunyai hubungan yang disetujui. Kami berbagi pixel secara langsung dengan mereka.
  • Bisnis yang sudah mempunyai hubungan yang sedang berlangsung. Kami menambahkan pixel ke permintaan sehingga ketika bisnis penerima menyetujui permintaan ini, selanjutnya kami membagikan pixel tersebut.
  • Bisnis yang tidak mempunyai hubungan apa pun. Kami membuat perjanjian berbagi dengan pixel yang terlampir sehingga ketika bisnis penerima menyetujui permintaan ini, pixel akan dibagikan dengan bisnis tersebut.

Jika pixel berhasil dibagikan dengan bisnis, akan diberikan tanggapan balik berikut:

{  
    success: true,
}

Jika permintaan sedang menunggu penerimaan perjanjian berbagi, permintaan API memberikan tanggapan balik berikut dengan pending_request_id. Ketika bisnis penerima menerima permintaan, pixel akan dibagikan secara otomatis dengan bisnis penerima. Lihat langkah 2 untuk menerima/menolak permintaan.


{
  "success": true,
  "pending_request_id": "{request_id}"
}

Ingat bahwa ada batasan pada seberapa banyak bisnis yang dapat dibagikan pixelnya.

Langkah 2: Terima Permintaan yang Tertunda (jika diperlukan)

Setelah memulai permintaan berbagi pixel, bisnis agensi dapat menerima permintaan perjanjian berbagi yang tertunda, jika agensi tersebut belum memiliki hubungan dengan bisnis yang mempunyai pixel tersebut. Admin bisnis penerima dapat melihat dan menerima permintaan ini di Pengelola Bisnis mereka.

Untuk menyetujui atau menolak permintaan hubungan menggunakan API, dapatkan request_id dari tanggapan kesalahan di Langkah 1.

API memerlukan token akses pengguna dari admin bisnis penerima dengan business_mangement atau ads_management permission untuk aplikasi tersebut.

POST <request_id>?request_status="approve"

Jika berhasil, API menanggapi balik tanggapan ini:

{  
    success: bool
}

Opsi dan parameter untuk permintaan ini mencakup:

Nama Deskripsi

request_status

jenis: string

Wajib.

Apakah bisnis yang menerima permintaan berbagi pixel menyetujui atau menolak permintaannya.


Kemungkinan Nilai: APPROVE, DECLINE

Langkah 3: Bagikan Pixel dengan Akun Iklan Bisnis Agensi

Jika agensi mengelola iklan untuk klien dan perlu mengizinkan akun iklan khusus klien untuk menggunakan set data pixel, gunakan API ini.

Setelah pixel dibagikan ke suatu bisnis dengan izin iklankan/analisis, bisnis ini dapat mengizinkan akun iklan dalam bisnis untuk menggunakan set data pixel untuk pengiklanan.

API memerlukan token akses pengguna dengan izin business_management, ads_management atau ads_read dari admin bisnis.

Post <ads_pixel>/shared_accounts?business=<business_id>&ad_account=<ad_account_id>
Nama Deskripsi

business_id

jenis: numerik

Wajib.

Bisnis yang mengelola iklan dan mempunyai akses ke pixel dan akun iklan. Pengguna yang token aksesnya digunakan harus mempunyai izin admin pada bisnis ini.

ad_account_id

jenis: numerik

Wajib.

Akun iklan akan diizinkan pada pixel.

Langkah 4: Hapus Koneksi Berbagi Pixel

Jika koneksi antara pixel dan bisnis agensi tidak lagi diperlukan, gunakan API berikut untuk menghapus koneksi.

Delete <adspixel>/agencies?business=<agency_business_id>

API memerlukan token akses pengguna admin dari bisnis pemilik pixel.

Jika berhasil, API menanggapi balik tanggapan ini:

{  
    success: true
}

Pelajari Selengkapnya