마케팅 API

전화 유도 광고

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

시작하기 전에

이 가이드에서는 다음 항목을 보유하고 있는 상태라고 가정합니다.

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

  • 페이지에서 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/v21.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/v21.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/v21.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/v21.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