마케팅 API

Meta 마케팅 API의 전화 유도 광고

이 가이드에서는 Meta 마케팅 API를 사용하여 전화 유도 광고를 만들고 게시하는 방법을 설명합니다.

광고 만들기 개요

광고를 만들고 게시하려면 다음과 같은 단계를 거쳐야 합니다.

  1. 광고 캠페인 만들기
  2. 광고와 광고 캠페인을 연결하는 광고 세트 만들기
  3. 전화 유도 광고를 위한 광고 크리에이티브 만들기
  4. 광고 크리에이티브를 광고 세트와 연결하여 광고 만들기
  5. 광고를 Facebook과 Instagram에 게시하기

시작하기 전에

이 가이드에서는 다음 조건이 충족된 상태라고 가정합니다.

이 가이드에서 모든 엔드포인트를 성공적으로 호출하려면 다음 항목이 필요합니다.

  • 페이지에서 ADVERTIZE 작업을 수행할 수 있는 사용자가 요청한 페이지 액세스 토큰
  • 앱 사용자에게 다음과 같은 권한을 부여해야 합니다.
    • ads_management
    • pages_manage_ads
    • pages_read_engagement
    • pages_show_list

권장 사항

Facebook 페이지 설정 에서 비즈니스 운영 시간을 설정하세요.

API 호출을 테스트할 때 액세스 토큰으로 설정된 access_token 매개변수를 포함할 수 있습니다. 그러나 앱에서 보안 호출을 수행할 때는 액세스 토큰 클래스를 사용합니다.

제한 사항

  • 타겟 대상은 만 18세 이상이어야 합니다.
  • 행동 유도에 포함된 전화번호는 타겟 대상과 동일한 국가여야 합니다.

1단계. 캠페인 만들기

광고 캠페인을 만들려면 act_ad_account_id/campaigns 엔드포인트로 POST 요청을 보냅니다. 여기에서 ad_account_id는 Meta 광고 계정의 ID입니다. 요청에는 다음과 같은 항목을 포함해야 합니다.

  • name
  • objective – 다음의 지원되는 목표 중 하나로 설정합니다.
    • OUTCOME_AWARENESS
    • OUTCOME_ENGAGEMENT
    • OUTCOME_LEADS
    • OUTCOME_SALES
    • OUTCOME_TRAFFIC
  • special_ad_categories

요청 예시

가독성을 높이기 위해 형식을 지정했습니다. ad_account_id와 같은 굵은 글꼴 값, 기울임꼴 값을 자신의 값으로 바꾸세요.
curl -X POST "https://graph.facebook.com/v19.0/act_ad_account_id/campaigns" \
     -H "Content-Type: application/json" \
     -d '{
           "name":"Call_ad_campaign_name",
           "objective":"OUTCOME_TRAFFIC",
           "special_ad_categories":["NONE"],
         }'

요청에 성공하면 앱이 캠페인의 ID가 포함된 JSON 응답을 받게 됩니다.

{
  "id": "campaign_id"
}

2단계. 광고 세트 만들기

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

  • bid_amount
  • IMPRESSIONS로 설정된 billing_event
  • campaign_id
  • daily_budget
  • PHONE_CALL로 설정된 destination_type
  • name
  • 전화 유도 광고에 대해 QUALITY_CALL로 설정된 optimization_goal
  • targeting

요청 예시

가독성을 높이기 위해 형식을 지정했습니다. ad_account_id와 같은 굵은 글꼴 값, 기울임꼴 값을 자신의 값으로 바꾸세요.
curl -X POST "https://graph.facebook.com/v19.0/act_ad_account_id/adsets"
     -H "Content-Type: application/json" 
     -d '{
           "bid_amount":"Your_bid_amount",
           "billing_event":"IMPRESSIONS",
           "campaign_id":"Your_campaign_id",
           "daily_budget":"Your_daily_budget",
           "destination_type":"PHONE_CALL",
           "name:"Your_call_adset_name",
           "optimization_goal":"QUALITY_CALL",
           "targeting":{ 
             "geo_locations": { "countries":["US","CA"] },
             "device_platforms": ["mobile"],
             "publisher_platforms": ["facebook"] 
           } 
         }'

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

{
  "id": "adset_id"
}

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

광고 크리에이티브를 사용하면 광고에 자산을 추가할 수 있습니다. 슬라이드, 이미지, 텍스트 전용, 동영상 광고가 지원됩니다.

광고 크리에이티브를 만들려면 /act_ad_account_id/adcreatives 엔드포인트로 POST 요청을 보냅니다. 여기에서 ad_account_id는 Meta 광고 계정의 ID입니다. 요청에는 다음과 같은 항목을 포함해야 합니다.

  • name
  • object_story_spec
  • call_to_action을 정의하는 link_data 개체를 포함하는 object_story_spec이 필요합니다. 이때 type은 CALL_NOW로 설정하고 value는 비즈니스의 전화번호로 설정합니다.

이미지 광고 요청 예시

가독성을 높이기 위해 형식을 지정했습니다. page_access_token과 같은 굵은 글꼴 값, 기울임꼴 값을 자신의 값으로 바꾸세요.
curl -X POST "https://graph.facebook.com/v19.0/act_ad_account_id/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "name":"Your_call_image_ad_name",
           "object_story_spec":{
             "page_id": "your_page_id",
             "link_data": {
               "picture": "Your_image_URL", 
               "link": "Your_business_page_URL", 
               "call_to_action": {
                 "type":"CALL_NOW",
                 "value":{ "link":"tel:+Your_business_phone_number_with_country_code" }
               }   
             }
           }
         }'

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

{
  "id": "ad_creative_id"
}

4단계. 광고 만들기

광고를 만들려면 광고 크리에이티브와 광고 세트를 연결해야 합니다. 광고를 만들려면 /act_ad_account_id/ads 엔드포인트로 POST 요청을 보냅니다. 여기에서 ad_account_id는 Meta 광고 계정의 ID입니다. 요청에는 다음과 같은 항목을 포함해야 합니다.

  • adset_id(2단계에서 얻음)
  • creative_id(3단계에서 얻음)
  • 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 '{

           "adset_id": "Your_ad_set_id",
           "creative": { "creative_id": "Your_ad_creative_id" },
           "status": "PAUSED"
         }'

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

{
  "id": "ad_id"
}

다음 단계

검토를 위해 광고를 제출하는 방법을 알아보려면 시작하기 가이드를 참조하세요.

더 알아보기

마케팅 API와 전화 유도 광고를 위한 추가 옵션에 대해 자세히 알아보세요.

비즈니스 지원 센터

마케팅 API