Webhooks 또는 대량 읽기로 잠재 고객을 읽을 수 있습니다.
ad_id
, campaign_id
와 같은 광고별 필드를 읽으려면 다음 항목이 필요합니다.
pages_manage_metadata
권한(Webhooks를 사용할 경우) 모든 잠재 고객 데이터 및 광고 수준 데이터를 읽으려면 다음 항목이 필요합니다.
참고: 이 페이지 관리자가 잠재 고객을 직접 지정하거나 잠재 고객 액세스 관리자에 액세스 권한을 부여한 적이 없는 경우 모든 페이지 관리자에게 잠재 고객 액세스 권한이 있습니다. 비즈니스 운영자가 잠재 고객 액세스 권한을 직접 설정하는 경우, 이는 페이지의 기본 관리자에게 잠재 고객 액세스 권한이 있는지 여부와 관계없이 비즈니스 운영자의 구성에 좌우됩니다.
사용 제한은 Facebook 페이지에 대해 지난 90일 동안 발생한 잠재 고객 수의 24x200배입니다. 24시간 이내에 이보다 더 많은 수의 호출을 보낼 경우 해당 요청은 오류를 반환합니다.
GET
요청을 /ads/lead_gen/export_csv/
엔드포인트로 보내세요. 이 경우 데이터 형식은 POSIX
또는 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
가 설정되지 않았거나 양식 생성 시간보다 작은 경우 양식 생성 시간이 사용됩니다.to_date
가 설정되지 않았거나 현재 시간보다 미래인 경우 현재 시간이 사용됩니다.
TSV에 광고 ID 또는 광고 그룹 ID가 없는 항목이 있는 경우 다음과 같은 이유 때문일 수 있습니다.
is_organic
이 1
로 표시됩니다. 그렇지 않은 경우 이 값은 0
입니다.잠재 고객용 광고의 실시간 업데이트를 받습니다.
Webhooks 시작하기 가이드를 참조하여 엔드포인트를 설정하고 Webhooks를 구성합니다.
만료 걱정 없이 데이터를 지속적으로 가져오려면 단일 장기 실행 페이지 토큰을 생성합니다.
페이지용 Webhooks 가이드를 참조하여 페이지에 앱을 설치하는 방법을 알아봅니다.
잠재 고객 확보를 생성하면 앱에서 다음과 같은 Webhooks 응답을 받습니다.
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 ) ) ) ) ) )
leadgen_id
를 사용하여 잠재 고객과 관련된 데이터를 검색할 수 있습니다.
curl -X GET \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/{lead-id}/
성공할 경우 앱은 다음과 같은 응답을 받습니다.
{ "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" ] }], ... }
Github 저장소에서 이 구현의 예시를 확인할 수 있습니다.
2018년 7월 2일 이후에 만든 앱은 잠재 고객을 읽을 때 leads_retrieval
권한을 사용하도록 강제 적용됩니다.
leads
는 광고 그룹과 양식 노드에 모두 존재합니다. 이는 각 개체와 관련된 모든 데이터를 반환합니다. 양식은 여러 광고에서 다시 사용할 수 있으므로 양식에는 양식을 사용하는 광고보다 훨씬 더 많은 잠재 고객이 포함될 수 있습니다.
광고 기준 일괄 읽기:
curl -X GET \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/{adgroup-id}/leads
양식 기준 읽기:
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
응답:
{ "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" } } }
매장 찾기 질문은 다른 질문과 아무런 차이가 없습니다. 매장 찾기 질문에는 양식 생성 시 매장 찾기 질문에 대해 매핑되는 필드 ID도 있습니다. 또한 전송 방법도 다른 질문과 유사합니다. 전달되는 값은 선택한 위치의 매장 번호에서 생성됩니다.
예를 들어 필드 ID가 selected_dealer
인 매장 찾기 질문이 있다고 가정해보겠습니다. 잠재 고객을 대량으로 가져오려면 다음과 같이 호출할 수 있습니다.
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
응답:
{ "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" } } }
field_data
에는 사용자가 작성하는 맞춤 고지 사항 확인란(선택 사항)에 대한 응답이 포함되지 않습니다. 응답을 검색하려면 custom_disclaimer_responses
필드를 사용합니다.
curl -X GET \ "https://graph.facebook.com/<API_VERSION>/<LEADGEN_ID>? fields=custom_disclaimer_responses"
응답:
{ "custom_disclaimer_responses": [ { "checkbox_key": "optional_1", "is_checked": "1" }, { "checkbox_key": "optional_2", "is_checked": "" } ], "id": "1231231231" }
이 예에서는 타임스탬프에 따라 잠재 고객을 필터링합니다. 타임스탬프는 Unix 타임스탬프여야 합니다.
curl -X GET \
-d 'filtering=[
{
"field": "time_created",
"operator": "GREATER_THAN",
"value": 1731610171
}
]' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/{adgroup-id}/leads
operator
는 다음 값 중 하나를 갖습니다.
연산자 | 의미 |
---|---|
| 타임스탬프보다 작은 값을 필터링합니다. |
| 타임스탬프보다 큰 값을 필터링합니다. |
| 타임스탬프보다 크거나 같은 값을 필터링합니다. |
양식에 맞춤 설정 필드 ID가 있을 경우 반환된 필드와 값은 지정된 필드와 값이 됩니다.