Anda bisa membaca prospek dengan Webhooks atau Pembacaan Massal.
Untuk membaca kolom khusus iklan, seperti ad_id
, campaign_id
, Anda memerlukan:
ads_management
pages_manage_metadata
- jika menggunakan Webhooks Untuk membaca semua data dan data level iklan, Anda akan memerlukan:
Catatan: Jika admin halaman ini tidak pernah menyesuaikan prospek atau memberikan izin akses dengan Pengelola Akses Prospek, SEMUA admin halaman harus memiliki izin akses prospek. Jika izin akses prospek telah disesuaikan oleh admin bisnis, maka konfigurasi admin bisnis itu akan menentukan apakah admin halaman biasa memiliki izin akses prospek atau tidak.
Batas laju adalah 200 kali 24 kali jumlah prospek yang dibuat dalam 90 hari terakhir untuk sebuah Halaman Facebook. Jika Anda membuat lebih banyak panggilan daripada jumlah ini dalam periode 24 jam, permintaan Anda mengembalikan kesalahan.
Kirimkan permintaan GET
ke endpoint /ads/lead_gen/export_csv/
tempat format data POSIX
atau cap waktu UNIX
:
curl -i -X GET "https://www.facebook.com/ads/lead_gen/export_csv/ ?id=<FORM_ID> &type=form &from_date=1482698431 &to_date=1482784831"
from_date
tidak diatur atau kurang dari waktu pembuatan formulir, waktu pembuatan formulir akan digunakan.Jika to_date
tidak diatur atau lebih dari waktu saat ini, waktu saat ini akan digunakan.
Jika entri ID Iklan atau ID Grup tidak ditemukan dalam TSV, hal ini mungkin karena alasan berikut:
is_organic
dalam TSV menampilkan 1
. Jika tidak, nilainya adalah 0
.Dapatkan pembaruan realtime untuk iklan prospek.
Kunjungi Panduan Mulai Menggunakan Webhooks kami untuk membuat endpoint dan mengonfigurasi webhook Anda.
Buat token Halaman berdurasi lama untuk terus mengambil data tanpa khawatir tentang waktu kedaluwarsanya.
Kunjungi panduan Webhooks untuk Halaman kami untuk mempelajari cara menginstal aplikasi di Halaman.
Pada pembuatan leadgen, aplikasi Anda akan menerima tanggapan Webhooks berikut:
array( "object" => "page", "entry" => array( "0" => array( "id" => 153125381133, "time" => 1438292065, "changes" => array( "0" => array( "field" => "leadgen", "value" => array( "leadgen_id" => 123123123123, "page_id" => 123123123, "form_id" => 12312312312, "adgroup_id" => 12312312312, "ad_id" => 12312312312, "created_time" => 1440120384 ) ), "1" => array( "field" => "leadgen", "value" => array( "leadgen_id" => 123123123124, "page_id" => 123123123, "form_id" => 12312312312, "adgroup_id" => 12312312312, "ad_id" => 12312312312, "created_time" => 1440120384 ) ) ) ) ) )
Anda dapat menggunakan leadgen_id
untuk mengambil data terkait prospek:
curl -X GET \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/{lead-id}/
Setelah berhasil, aplikasi Anda menerima tanggapan berikut:
{ "created_time": "2015-02-28T08:49:14+0000", "id": "<LEAD_ID>", "ad_id": "<AD_ID>", "form_id": "<FORM_ID>", "field_data": [{ "name": "car_make", "values": [ "Honda" ] }, { "name": "full_name", "values": [ "Joe Example" ] }, { "name": "email", "values": [ "joe@example.com" ] }, { "name": "selected_dealer", "values": [ "99213450" ] }], ... }
Anda dapat melihat contoh penerapan ini di repo Github kami.
Aplikasi yang dibuat setelah 2 Juli 2018 dipaksa menggunakan izin leads_retrieval
untuk membaca prospek.
leads
ada di grup iklan dan node formulir. Prospek ini mengembalikan semua data yang terkait dengan objeknya masing-masing. Oleh karena sebuah formulir dapat digunakan lagi untuk beberapa iklan, formulir Anda dapat berisi prospek yang jauh lebih banyak daripada iklan yang menggunakannya.
Untuk membaca secara massal berdasarkan iklan:
curl -X GET \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/{adgroup-id}/leads
Untuk membaca menurut formulir:
curl -G \ -d 'access_token=<ACCESS_TOKEN>' \ -d 'fields=created_time,id,ad_id,form_id,field_data' \ https://graph.facebook.com/<API_VERSION>/<FORM_ID>/leads
Tanggapan:
{ "data": [ { "created_time": "2018-02-28T08:49:14+0000", "id": "<LEAD_ID>", "ad_id": "<AD_ID>", "form_id": "<FORM_ID>", "field_data": [ { "name": "car_make", "values": [ "Honda" ] }, { "name": "full_name", "values": [ "Joe Example" ] }, { "name": "email", "values": [ "joe@example.com" ] }, ], ... } ], "paging": { "cursors": { "before": "OTc2Nz3M8MTgyMzU1NDMy", "after": "OTcxNjcyOTg8ANTI4NzE4" } } }
Pertanyaan pencari lokasi toko tidak berbeda dengan pertanyaan lain. Pertanyaan pencari lokasi toko juga memiliki ID kolom yang akan dipetakan selama pembuatan formulir. Pertanyaan tersebut juga akan dikirim seperti pertanyaan lain. Nilai yang diteruskan berasal dari Jumlah Toko dari lokasi yang dipilih.
Contoh: katakanlah Anda memiliki pertanyaan mengenai pencari lokasi toko dengan selected_dealer
sebagai ID kolom. Untuk mengambil prospek secara massal, Anda dapat memanggil:
curl -G \ -d 'access_token=<ACCESS_TOKEN>' \ -d 'fields=created_time,id,ad_id,form_id,field_data' \ https://graph.facebook.com/<API_VERSION>/<FORM_ID>/leads
Tanggapan:
{ "data": [ { "created_time": "2018-02-28T08:49:14+0000", "id": "<LEAD_ID>", "ad_id": "<AD_ID>", "form_id": "<FORM_ID>", "field_data": [ { "name": "car_make", "values": [ "Honda" ] }, { "name": "full_name", "values": [ "Joe Example" ] }, { "name": "email", "values": [ "joe@example.com" ] }, { "name": "selected_dealer", "values": [ "99213450" ] } ], ... } ], "paging": { "cursors": { "before": "OTc2Nz3M8MTgyMzU1NDMy", "after": "OTcxNjcyOTg8ANTI4NzE4" } } }
Kolom field_data
tidak berisi tanggapan untuk kotak centang penafian khusus opsional yang harus diisi oleh pengguna. Untuk mengambil tanggapan, gunakan kolom custom_disclaimer_responses
.
curl -X GET \ "https://graph.facebook.com/<API_VERSION>/<LEADGEN_ID>? fields=custom_disclaimer_responses"
Tanggapan:
{ "custom_disclaimer_responses": [ { "checkbox_key": "optional_1", "is_checked": "1" }, { "checkbox_key": "optional_2", "is_checked": "" } ], "id": "1231231231" }
Contoh ini memfilter prospek berdasarkan cap waktu. Cap waktu haruslah cap waktu Unix.
curl -X GET \
-d 'filtering=[
{
"field": "time_created",
"operator": "GREATER_THAN",
"value": 1731610193
}
]' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/{adgroup-id}/leads
operator
memiliki salah satu nilai berikut.
Operator | Artinya |
---|---|
| Memfilter nilai yang lebih kecil daripada cap waktu tersebut. |
| Memfilter nilai yang lebih besar daripada cap waktu tersebut. |
| Memfilter nilai yang lebih besar daripada atau sama dengan cap waktu tersebut. |
Jika formulir tersebut memiliki ID kolom, maka kolom dan nilai yang dikembalikan akan berupa kolom dan nilai tertentu.