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

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

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

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

시작하기 전에

다음 항목이 필요합니다.

• 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
• OUTCOME_LEADS로 설정된 objective
• NONE으로 설정된 special_ad_categories 또는 사용자의 특별 광고 카테고리
• PAUSED로 설정된 status

요청 예시

curl -X POST "https://graph.facebook.com/v21.0/act_AD_ACCOUNT_ID/campaigns" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"YOUR_PAGE_ACCESS_TOKEN",
           "buying_type":"AUCTION",
           "name":"YOUR_LEADADS_CAMPAIGN_NAME",
           "objective":"OUTCOME_LEADS",
           "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
• ON_AD로 설정된 destination_type
• promoted_object – 비즈니스 Facebook 페이지의 ID로 설정
• PAUSED로 설정된 status

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

요청 예시

curl -X POST "https://graph.facebook.com/v21.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_NAME",
           "optimization_goal":"LEAD_GENERATION",
           "destination_type":"ON_AD",
           "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/v21.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/v21.0/PAGE_ID/leadgen_forms" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token": "YOUR_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
  • 광고 크리에이티브의 텍스트로 설정된 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

요청 예시

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 필드를 정의해야 합니다.

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/v21.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

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

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

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

{
  "id": "YOUR_AD_ID"
}

6단계. 광고 게시하기

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

광고 관리자 또는 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/v21.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/v21.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/v21.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/v21.0/page_id/leadgen_form_id
    ?status=ARCHIVED
    &access_token=page_access_token"

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

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

기타 참고 자료

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

마케팅 API 개발자 문서

• 잠재 고객 확보 UI 대화 상자 SDK 구성 요소
• 페이지 참고 자료, 잠재 고객 확보 양식
• 추적 및 전환 사양, 맞춤 추적 사양

Meta 비즈니스 지원 센터

• 유기적 잠재 고객 지원 센터 아티클
• 공유 버튼 지원 센터 아티클
• 잠재 고객 양식 유형 지원 센터 아티클
• 캔버스 광고의 잠재 고객 양식 지원 센터 아티클