광고를 위한 잠재 고객용 양식

이 문서에서는 마케팅 API를 사용하여 그래프 API로 잠재 고객 확보를 위한 광고를 만드는 방법을 설명합니다.

잠재 고객용 광고를 만들어서 게시하려면 다음의 단계를 따르세요.

광고 캠페인 만들기
광고와 광고 캠페인을 연결하는 광고 세트 만들기
잠재 고객용 양식 만들기
잠재 고객용 양식으로 광고 크리에이티브 만들기
캠페인과 크리에이티브를 연결하여 광고 만들기
광고 게시하기

시작하기 전에

이 가이드에서는 Messenger 플랫폼 개요를 읽고 메시지와 알림을 주고받는 데 필요한 구성 요소를 구현했다고 가정합니다.

다음 항목을 준비해야 합니다.

ads_management 권한
pages_manage_ads 권한
pages_read_engagement 권한
pages_show_list 권한
페이지에서 ADVERTISE 작업을 수행할 수 있는 사용자의 페이지 액세스 토큰

1단계. 캠페인 만들기

잠재 고객 확보 광고를 위한 광고 캠페인을 만들려면 다음의 매개변수를 포함하여 /act_AD_ACCOUNT_ID/campaigns 엔드포인트로 POST 요청을 보내세요.

자신의 페이지 액세스 토큰으로 설정된 access_token
AUCTION으로 설정된 buying_type
캠페인의 이름으로 설정된 name
LEAD_GENERATION으로 설정된 objective
NONE으로 설정된 special_ad_categories 또는 사용자의 특별 광고 카테고리
PAUSED로 설정된 status

요청 예시

가독성을 높이기 위해 형식을 지정했습니다. AD_ACCOUNT_ID와 같은 굵은 글꼴 값, 기울임꼴 값을 자신의 값으로 바꿉니다.

curl -X POST "https://graph.facebook.com/v19.0/act_AD_ACCOUNT_ID/campaigns" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"Your_page_access_token",
           "buying_type":"AUCTION",
           "name":"Messenger_ad_campaign_name",
           "objective":"LEAD_GENERATION",
           "special_ad_categories":["NONE"],
           "status":"PAUSED"
         }'

요청에 성공하면 앱이 캠페인에 대한 ID를 포함하는 JSON 개체를 받게 됩니다. 이 ID는 다음 단계에서 광고 세트를 만들 때 사용합니다.

{
  "id": "YOUR_CAMPAIGN_ID"
}

자세한 내용은 광고 캠페인 참고 자료 를 참조하세요.

2단계. 광고 세트 만들기

광고 세트를 만들려면 act_ad_account_id/adsets 엔드포인트로 POST 요청을 보냅니다. 여기에서 ad_account_id는 Meta 광고 계정의 ID입니다. 요청에는 다음 항목이 포함되어야 합니다.

자신의 페이지 액세스 토큰으로 설정된 access_token
지불하고자 하는 최대 금액으로 설정된 bid_amount
IMPRESSIONS로 설정된 billing_event
1단계에서 얻은 광고 캠페인의 ID로 설정된 campaign_id
하루에 지출하고자 하는 금액으로 설정된 daily_budget
광고 세트의 이름으로 설정된 name
LEAD_GENERATION 또는 QUALITY_LEAD로 설정된 optimization_goal
promoted_object – 비즈니스 Facebook 페이지의 ID로 설정
PAUSED로 설정된 status

참고: CRM 데이터 소스를 설정하고 QUALITY_LEAD를 최적화 목표로 선택할 경우 품질에 대한 추가 최적화를 위해 pixel_id를 promoted_object에 추가할 수 있습니다. pixel_id와 함께 pixel_rule을 제공할 필요가 없습니다.

요청 예시

가독성을 높이기 위해 형식을 지정했습니다. AD_ACCOUNT_ID와 같은 굵은 글꼴 값, 기울임꼴 값을 자신의 값으로 바꿉니다.

curl -X POST "https://graph.facebook.com/v19.0/act_AD_ACCOUNT_ID/adsets"
     -H "Content-Type: application/json" 
     -d '{
           "access_token":"Your_page_access_token",
           "bid_amount":"Your_bid_amount",
           "billing_event":"IMPRESSIONS",
           "campaign_id":"Your_campaign_id",
           "daily_budget":"Your_daily_budget",
           "name:"YOUR_LEADADS_ADSET",
           "optimization_goal:LEAD_GENERATION",
           "promoted_object":"YOUR_PAGE_ID",
           "status:PAUSED"
         }'

요청에 성공하면 앱이 광고 세트의 ID가 포함된 다음과 같은 JSON 응답을 받게 됩니다.

{
  "id": "YOUR_ADSET_ID"
}

자세한 내용은 광고 세트 참고 자료 를 참조하세요.

3단계. 잠재 고객용 양식 만들기

양식을 만들려면 다음의 매개변수를 포함하여 /PAGE_ID/leadgen_forms 엔드포인트로 POST 요청을 보내세요.

자신의 페이지 액세스 토큰으로 설정된 access_token
자신의 양식 이름으로 설정된 name
key 매개변수를 사용하여 질문의 유형과 양식에 표시될 순서를 정의하는 개체의 배열로 설정된 questions
- label 매개변수를 사용하는 맞춤 질문
- 답변으로 구성된 드롭다운 메뉴를 포함한 options 매개변수를 사용하는 맞춤 질문

요청 예시

가독성을 높이기 위해 형식을 지정했습니다. 굵은 글꼴 값, 기울임꼴 값을 자신의 값으로 바꿉니다.

curl -X POST "https://graph.facebook.com/v19.0/PAGE_ID/leadgen_forms" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token": "YOUR_PAGE_ACCESS_TOKEN",
           "name": "YOUR_LEADADS_FORM_NAME",
           "questions": "[
               {"type":"FULL_NAME", "key": "question1"},
               {"type":"EMAIL", "key": "question2"},
               {"type":"PHONE", "key": "question3"},
               {"type":"CUSTOM", "key": "question4" "label": "Do you like rainbows?"}
               {"type":"CUSTOM", "key": "question5" "label": "What is your favorite color?", 
                   "options": [
                       {value: "Red", key: "key1"},
                       {value: "Green", key: "key2"},
                       {value: "Blue", key: "key2"},
                   ]}
           ]"
         }'

Messenger 대화 양식

Messenger 대화상의 광고 에서 사용하고자 하는 양식에는 다음 내용을 포함해야 합니다.

questions.type 매개변수는 다음 값 중 하나로만 설정할 수 있습니다.
CUSTOM
EMAIL
FIRST_NAME
FULL_NAME
LAST_NAME
PHONE
나열된 값 이외의 다른 값으로 설정된 questions.type이 양식에 있는 경우 해당 양식은 적합하지 않습니다.
block_display_for_non_targeted_viewer 매개변수는 false로 설정해야 합니다. 그러면 해당 양식이 오픈 공유로 표시됩니다.

적격 Messenger 잠재 고객용 양식의 요청 예시

가독성을 높이기 위해 형식을 지정했습니다. 굵은 글꼴 값, 기울임꼴 값을 자신의 값으로 바꿉니다.

curl -X POST "https://graph.facebook.com/v19.0/PAGE_ID/leadgen_forms" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token": "page_ACCESS_TOKEN"
           "block_display_for_non_targeted_viewer": "false"
           "name": "LeadAds Form for Messenger Conversation Name"
           "questions": "[
               {"type":"FULL_NAME", "key": "question1"},
               {"type":"EMAIL", "key": "question2"},
               {"type":"PHONE", "key": "question3"},
               {"type":"CUSTOM", "key": "question4" "label": "Do you like rainbows?"}
               {"type":"CUSTOM", "key": "question5" "label": "What is your favorite color?", 
                   "options": [
                       {value: "Red", key: "key1"},
                       {value: "Green", key: "key2"},
                       {value: "Blue", key: "key2"},
                   ]}
           ]"
         }'

추가적 질문 유형

[잠재 고객용 양식 만들기 섹션]{#create-a-lead-form}에 표시된 일반적인 질문 유형 외에도 다음의 사용 사례에 더욱 전문화된 질문 유형을 추가할 수 있습니다.

일정 예약 – 일정 예약 질문은 제한된 시간 선택 항목이 포함된 날짜 및 시간 선택 도구와 확인 메시지를 질문 아래에 렌더링합니다.
국가 또는 정부 ID – 국가 ID 질문은 사용자의 국가에 따라 질문을 렌더링하고, 입력한 ID의 형식을 검증합니다.
매장 찾기 – 매장 찾기 질문은 사용자의 우편번호나 그 입력값에 따라 매장 찾기 선택 도구를 렌더링합니다.

일정 예약

일정 예약 질문은 제한된 시간 선택 항목이 포함된 날짜 및 시간 선택 도구와 확인 메시지를 질문 아래에 렌더링합니다.

일정 예약 질문을 추가하려면 type 매개변수를 DATE_TIME을 설정한 질문 개체를 추가합니다. 또는 질문 필드 바로 아래에 렌더링되는 inline_context 매개변수에 확인 메시지를 추가하여 필요한 경우에 추가적 컨텍스트를 얻을 수도 있습니다.

...
           "questions": "[
               ...
               {"type": "DATE_TIME", 
                "label": "Appointment time", 
                "inline_context": "We will verify and call you to confirm your appointment."
               },
...

국가 ID

국가 ID 질문은 사용자의 국가에 따라 질문을 렌더링하고 입력한 ID의 형식을 검증합니다. 이 질문은 다음의 국가에 대해 렌더링할 수 있습니다.

아르헨티나 – {"type": "ID_AR_DNI"}
브라질 – ID_CPF
칠레 – ID_CL_RUT
콜롬비아 – ID_CO_CC
에콰도르 – ID_EC_CI
페루 – ID_PE_DNI

국가 ID 질문을 추가하려면 type 매개변수를 사용자의 국가 유형으로 설정한 질문 개체를 추가합니다.

제한 사항

특정 양식에서는 하나의 국가 ID만 요청할 수 있으며, 해당 국가의 국민만 타게팅할 수 있습니다. 예를 들어 페루에서 DNI를 요청하면 타겟 대상은 페루로 제한됩니다. 이 기준과 일치하는 광고만 승인됩니다.
유효한 형식에 대한 검증 확인입니다. 실제로 해당 ID가 실제 인물의 것인지는 확인하지 않습니다.

...
           "questions": "[
               ...
               {"type": "ID_AR_DNI"
               },
...

매장 찾기

매장 찾기 질문은 사용자의 우편번호나 그 입력값에 따라 매장 찾기 선택 도구를 렌더링합니다.

이 질문을 사용하려면 매장 페이지 구조를 설정해야 합니다. 자세한 방법은 Facebook에 매장 페이지 구조 설정 – Meta 비즈니스 지원 센터 를 참조하세요.

매장 찾기 질문을 추가하려면 type 매개변수가 STORE_LOOKUP으로 설정되고 context_provider_type 매개변수가 LOCATION_MANAGER로 설정된 질문 개체를 추가합니다.

...
           "questions": "[
               ...
               {"type": "STORE_LOOKUP", 
                "label": "Which store do you want to visit?", 
                "context_provider_type": "LOCATION_MANAGER"
               },
...

고급 양식 설정

다음의 양식 설정을 하나 이상 추가하여 보다 좋은 품질의 잠재 고객을 확보하세요.

잠재 고객의 소스를 추적하기 위한 양식 성과 추적
양식 플로에 검토 및 확인 단계를 추가하기 위한 더 확실한 의향을 가진 잠재 고객 양식
유기적 잠재 고객을 필터링하기 위한 유기적 잠재 고객 필터링

성과 추적 추가

잠재 고객의 소스를 추적하는 데 도움이 되도록 추적하고자 하는 매개변수의 키-값 쌍의 리스트로 설정한 tracking_parameters 필드를 양식에 추가합니다. 이러한 매개변수는 광고에 표시되지는 않지만 Meta가 양식에서 확보한 잠재 고객에 대한 메타데이터를 제공할 수 있게 해 줍니다.

요청 예시

가독성을 높이기 위해 형식을 지정했습니다. 굵은 글꼴 값, 기울임꼴 값을 자신의 값으로 바꿉니다.

...
           "name": "YOUR_LEADADS_FORM_NAME",
           "tracking_parameters": {"your_tracking_parameter_name":"your_tracking_parameter_value"},
           "questions": "[
...

더 확실한 의향 설정 추가

기본적으로 잠재 고객용 광고는 잠재 고객의 수에 대해 최적화되지만, 더 확실한 의향을 가진 잠재 고객을 확보하는 양식을 만들 수 있습니다. 이런 유형의 잠재 고객은 특정 제품이나 서비스(예: 대리점에서 시승 예약)에 관심이 있을 수 있는 사람들에게 해당될 수 있습니다. 이 양식 설정은 어떤 사람이 양식을 제출하기 전에 자신의 답변을 검토하고 확인하는 단계를 양식 제출 플로에 추가합니다.

이 확인 플로를 양식에 추가하려면 양식을 만들 때 true로 설정된 is_optimized_for_quality 매개변수를 추가하세요.

요청 예시

가독성을 높이기 위해 형식을 지정했습니다. 굵은 글꼴 값, 기울임꼴 값을 자신의 값으로 바꿉니다.

...
           "name": "YOUR_LEADADS_FORM_NAME",
           "is_optimized_for_quality": "true",
           "questions": "[
...

유기적 잠재 고객 필터링하기

유기적 잠재 고객을 필터링하려면 양식을 만들 때 true로 설정된 block_display_for_non_targeted_viewer 매개변수를 추가하세요.

요청 예시

가독성을 높이기 위해 형식을 지정했습니다. 굵은 글꼴 값, 기울임꼴 값을 자신의 값으로 바꿉니다.

...
           "name": "YOUR_LEADADS_FORM_NAME",
           "block_display_for_non_targeted_viewer": "true",
           "questions": "[
...

응답 예시

요청에 성공하면 앱이 광고를 만들 때 사용할 양식의 ID가 포함된 JSON 응답을 받게 됩니다.

{
  "id": "leadgen_form_id",
}

4단계. 광고 크리에이티브 만들기

이미지와 양식으로 광고 크리에이티브를 만들려면 다음의 매개변수를 포함하여 /act_AD_ACCOUNT_ID/adcreatives 엔드포인트로 POST 요청을 보내세요.

자신의 페이지 액세스 토큰으로 설정된 access_token
다음의 매개변수와 함께 link_data 개체를 포함하는 object_story_spec
- type과 잠재 고객용 양식 ID로 설정된 value를 포함하는 개체로 설정된 call_to_action
- 크리에이티브에 대한 설명으로 설정된 description
- 광고 크리에이티브의 이미지에 대한 해시로 설정된 image_hash
- URL로 설정된 link_url. Facebook 페이지로 설정할 수 없습니다.
- 광고 크리에이티브의 텍스트로 설정된 message
Facebook 페이지 ID로 설정된 page_id

참고:link_data를 만들 때 link 필드와 연결된 값은 https//fb.me/여야만 합니다.

link_data.call_to_action 매개변수는 다음의 값 중 하나로 설정해야 합니다.

APPLY_NOW
DOWNLOAD
GET_QUOTE
LEARN_MORE
SIGN_UP
SUBSCRIBE

요청 예시

가독성을 높이기 위해 형식을 지정했습니다. AD_ACCOUNT_ID와 같은 굵은 글꼴 값, 기울임꼴 값을 자신의 값으로 바꿉니다.

curl -X POST "https://graph.facebook.com/LATEST-API-VERSION/act_AD_ACCOUNT_ID/adcreatives" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"YOUR_PAGE_ACCESS_TOKEN",
           "object_story_spec":{ 
             "link_data": { 
               "call_to_action": {
                 "type":"SIGN_UP",
                 "value":{
                   "lead_gen_form_id":"YOUR_FORM_ID"
                 }
               }, 
               "description": "YOUR_AD_CREATIVE_DESCRIPTION", 
               "image_hash": "YOUR_IMAGE_HASH", 
               "link": "http:\/\/fb.me\/", 
               "message": "YOUR_AD_CREATIVE_MESSAGE" 
             }, 
           "page_id": "YOUR_PAGE_ID" 
         }'

슬라이드 포함

동일한 object_story_spec을 사용하여 슬라이드 잠재 고객용 광고를 만들 수 있지만, 이 경우 child_attachments 매개변수에 추가적인 lead_gen_form_id 필드를 정의해야 합니다.

모든 하위 첨부 파일에 동일한 <FORM_ID>만 지정할 수 있습니다.

curl \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "link_data": { 
      "message": "My description", 
      "link": "http:\/\/www.google.com", 
      "caption": "WWW.EXAMPLE.COM", 
      "child_attachments": [ 
        { 
          "link": "http:\/\/www.google.com", 
          "image_hash": "<IMAGE_HASH>", 
          "call_to_action": {"type":"SIGN_UP","value":{"lead_gen_form_id":"<FORM_ID>"}} 
        }, 
        { 
          "link": "http:\/\/www.google.com", 
          "image_hash": "<IMAGE_HASH>", 
          "call_to_action": {"type":"SIGN_UP","value":{"lead_gen_form_id":"<FORM_ID>"}} 
        }, 
        { 
          "link": "http:\/\/www.google.com", 
          "image_hash": "<IMAGE_HASH>", 
          "call_to_action": {"type":"SIGN_UP","value":{"lead_gen_form_id":"<FORM_ID>"}} 
        }, 
        { 
          "link": "http:\/\/www.google.com", 
          "image_hash": "<IMAGE_HASH>", 
          "call_to_action": {"type":"SIGN_UP","value":{"lead_gen_form_id":"<FORM_ID>"}} 
        } 
      ], 
      "multi_share_optimized": true, 
      "call_to_action": {"type":"SIGN_UP","value":{"lead_gen_form_id":"<FORM_ID>"}} 
    } 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/LATEST-API-VERSION/act_<AD_ACCOUNT_ID>/adcreatives

동영상 포함

잠재 고객용 광고 크리에이티브에 사진 대신 동영상을 사용할 수도 있습니다. 먼저 동영상을 광고 동영상 라이브러리에 업로드하고 object_story_spec 매개변수에서 사용합니다.

curl -X POST \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "video_data": {
         "link_description": "try it out",
         "image_url": "<IMAGE_URL>",
         "video_id": "<VIDEO_ID>",
         "call_to_action": {
           "type": "SIGN_UP",
           "value": {
             "link": "http://fb.me/",
             "lead_gen_form_id": "<FORM_ID>"
           }
         }
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

광고 크리에이티브 응답 예시

요청에 성공하면 앱이 광고 크리에이티브의 ID가 포함된 다음과 같은 JSON 응답을 받게 됩니다.

{
  "id": "YOUR_AD_CREATIVE_ID"
}

5단계. 광고 만들기

광고를 만들려면 광고 크리에이티브와 광고 세트를 연결해야 합니다. 광고를 만들려면 /act_AD_ACCOUNT_ID/ads 엔드포인트로 POST 요청을 보내세요. 요청에는 다음을 포함해야 합니다.

자신의 페이지 액세스 토큰으로 설정된 access_token
adset_id(2단계에서 얻음)
creative_id(4단계에서 얻음)
name
status

크리에이티브가 포함된 광고 요청 예시

가독성을 높이기 위해 형식을 지정했습니다. AD_ACCOUNT_ID와 같은 굵은 글꼴 값, 기울임꼴 값을 자신의 값으로 바꿉니다.

curl -X POST "https://graph.facebook.com/v19.0/act_AD_ACCOUNT_ID/ads"
     -H "Content-Type: application/json" 
     -d '{
           "access_token"="YOUR_PAGE_ACCESS_TOKEN",
           "adset_id"="YOUR_AD_SET_ID",
           "creative"={ "creative_id": "YOUR_AD_CREATIVE_ID" },
           "status"="PAUSED"
         }'

요청에 성공하면 앱이 광고 ID가 포함된 다음과 같은 JSON 응답을 받게 됩니다.

{
  "id": "YOUR_AD_ID"
}

6단계. 광고 게시하기

광고가 광고 관리자 에 있는지 확인합니다. 오른쪽 상단에 있는 검토 및 게시 버튼을 클릭합니다. 캠페인, 캠페인의 광고 세트, 광고를 선택합니다.

광고 관리자 또는 API를 통해 광고를 게시할 수 있습니다. API를 사용하여 광고를 게시하려면 status 매개변수를 ACTIVE로 설정하여 4단계를 반복합니다.

Meta에서 광고를 검토하고 상태가 PENDING_REVIEW로 변경됩니다. 광고가 승인되면 상태가 ACTIVE가 되고 광고가 게재됩니다.

양식 관리

양식 리스트, 특정한 양식 질문을 가져와서 오래된 양식을 아카이브합니다.

양식 리스트 가져오기

잠개 고객 확보 양식의 리스트를 가져오려면 다음의 매개변수를 포함하여 /page_id/leadgen_forms 엔드포인트로 GET 요청을 보내세요.

자신의 페이지 액세스 토큰으로 설정된 access_token
이름 및 양식 ID 등의 특정 정보를 가져오기 위한 쉼표로 구분된 필드 리스트로 설정한 fields(선택 사항)

요청 예시

가독성을 높이기 위해 형식을 지정했습니다. 굵은 글꼴 값, 기울임꼴 값을 자신의 값으로 바꿉니다.

curl -X GET "https://graph.facebook.com/v19.0/PAGE_ID/leadgen_forms
    ?fields=name,id
    &access_token": "YOUR_PAGE_ACCESS_TOKEN"

요청에 성공하면 앱이 양식의 리스트를 포함하는 JSON 응답을 받게 됩니다. 양식 ID를 사용하여 해당 양식에 대한 질문을 가져오거나 양식을 보관할 수 있습니다.

Messenger의 적격 양식 리스트 가져오기

특정 요구 사항을 포함한 양식만 Messenger 대화에서 전송할 수 있습니다.

적격 잠재 고객용 양식의 리스트를 가져오려면 다음의 매개변수를 포함하여 /page_id/leadgen_forms 엔드포인트로 GET 요청을 보내세요.

자신의 페이지 액세스 토큰으로 설정된 access_token
is_eligible_for_in_thread_forms로 설정된 fields

요청 예시

가독성을 높이기 위해 형식을 지정했습니다. 굵은 글꼴 값, 기울임꼴 값을 자신의 값으로 바꿉니다.

curl -X GET "https://graph.facebook.com/v19.0/PAGE_ID/leadgen_forms
    ?fields=is_eligible_for_in_thread_forms
    &access_token": "YOUR_PAGE_ACCESS_TOKEN"

요청에 성공하면 앱이 적격 양식의 ID 리스트를 포함하는 JSON 응답을 받게 됩니다.

{
  "data": [
    {
      "id": "eligible_form_1_id"
    },
    {
      "id": "eligible_form_2_id"
    }
  ],
...
}

질문 리스트 가져오기

특정 잠재 고객 확보 양식의 질문 리스트를 가져오려면 다음의 매개변수를 포함하여 /page_id/leadgen_form_id 엔드포인트로 GET 요청을 보내세요.

자신의 페이지 액세스 토큰으로 설정된 access_token
questions로 설정된 fields

요청 예시

가독성을 높이기 위해 형식을 지정했습니다. 굵은 글꼴 값, 기울임꼴 값을 자신의 값으로 바꿉니다.

curl -X GET "https://graph.facebook.com/v19.0/page_id/leadgen_form_id
    ?fields=questions
    &access_token=page_access_token"

요청에 성공하면 앱이 질문의 리스트를 포함하는 JSON 응답을 받게 됩니다.

양식 보관

삭제가 지원되지 않으므로 잠재 고객용 양식을 보관할 수만 있습니다. 양식이 보관되고 나면:

양식이 양식 라이브러리에 (기본적으로) 표시되지 않습니다.
광고에서 보관된 양식을 사용할 수 없으며, 이를 시도할 경우 API를 통해 오류가 발생할 수 있습니다.
보관된 양식은 CF 또는 PE용 광고를 만들 때 사용할 수 없습니다.

특정 잠재 고객 확보 양식을 보관하려면 다음의 매개변수를 포함하여 /page_id/leadgen_form_id 엔드포인트로 POST 요청을 보내세요.

자신의 페이지 액세스 토큰으로 설정된 access_token
ARCHIVED로 설정된 status

요청 예시

가독성을 높이기 위해 형식을 지정했습니다. 굵은 글꼴 값, 기울임꼴 값을 자신의 값으로 바꿉니다.

curl -X GET "https://graph.facebook.com/v19.0/page_id/leadgen_form_id
    ?status=ARCHIVED
    &access_token=page_access_token"

요청에 성공하면 앱이 success를 true로 설정한 개체를 포함하는 JSON 응답을 받게 됩니다.

보관된 양식은 status를 ACTIVE로 설정하여 요청을 보내면 다시 활성화할 수 있습니다.

웹사이트에 양식 추가

웹사이트에 양식을 추가하려면 Facebook JavaScript SDK를 사용하여 팝업 대화 상자를 시작합니다. 팝업은 실행되는 즉시 시작되므로 적절한 이벤트와 연결하세요. 광고 크리에이티브에 필수적인 데이터를 제공하는 콜백을 정의할 수 있습니다. Meta는 페이지 수준에서 해당 양식을 저장합니다.

제한 사항

이 대화 상자는 모바일 기기에서 지원되지 않습니다.

act_는 ad_account_id 값에 포함되지 않습니다.

SDK 예시

굵은 글꼴 값, 기울임꼴 값을 자신의 값으로 바꿉니다.


FB.ui({
  method: 'lead_gen',
  page_id: YOUR_PAGE_ID,
  ad_account_id: AD_ACCOUNT_ID, 
}, function(response) {
...
});

수신할 콜백 응답에는 양식에 대한 정보가 포함됩니다.

{
  follow_up_action_text: "YOUR_FOLLOW_UP_ACTION_TEXT",
  follow_up_action_url: "YOUR_FOLLOW_UP_ACTION_URL",
  formID: YOUR_FORM_ID,
  form_url: "YOUR_FORM_URL",
  is_tcpa_compliant: false,
  name: "YOUR_FORM_NAME",
  pageID: YOUR_PAGE_ID,
  privacy_policy_url: "YOUR_PRIVACY_POLICY_URL",
  status: "success"
}

응답 속성

이름	설명
`custom_disclaimer_responses`문자열	맞춤 설정 고지 사항 확인란에 대한 응답
`follow_up_action_text`문자열	양식의 마지막 화면에 나타나는 후속 작업 텍스트의 캡션
`follow_up_action_url`문자열	양식의 마지막 화면에 나타나는 후속 작업 텍스트의 랜딩 페이지
`formID`문자열	필수 항목. 양식의 ID
`form_url`문자열	양식 URL
`name`문자열	양식 이름
`pageID`문자열	이 양식이 속한 페이지의 ID
`privacy_policy_url`문자열	제공된 개인정보처리방침 URL
`status`문자열	양식이 생성되면 `success` 반환

만들기를 취소하면 다음과 같이 표시됩니다.

{
  error_code: 4201,
  error_message: "User canceled the Dialog flow"
}

기타 참고 자료

이 문서의 구성 요소에 대해 자세히 알아보려면 다른 가이드를 참조하세요.

광고를 위한 잠재 고객용 양식

시작하기 전에

1단계. 캠페인 만들기

요청 예시

2단계. 광고 세트 만들기

요청 예시

3단계. 잠재 고객용 양식 만들기

요청 예시

Messenger 대화 양식

적격 Messenger 잠재 고객용 양식의 요청 예시

추가적 질문 유형

일정 예약

국가 ID

제한 사항

매장 찾기

고급 양식 설정

성과 추적 추가

요청 예시

더 확실한 의향 설정 추가

요청 예시

유기적 잠재 고객 필터링하기

요청 예시

응답 예시

4단계. 광고 크리에이티브 만들기

요청 예시

슬라이드 포함

동영상 포함

광고 크리에이티브 응답 예시

5단계. 광고 만들기

크리에이티브가 포함된 광고 요청 예시

6단계. 광고 게시하기

양식 관리

양식 리스트 가져오기

요청 예시

Messenger의 적격 양식 리스트 가져오기

요청 예시

질문 리스트 가져오기

요청 예시

양식 보관

요청 예시

웹사이트에 양식 추가

제한 사항

SDK 예시

응답 속성

기타 참고 자료

마케팅 API 개발자 문서

Meta 비즈니스 지원 센터