行銷 API

通話廣告

本指南說明如何使用 Meta 的行銷 API 來建立和發佈通話廣告。

準備工作

本指南假設您已經具備下列條件：

為了成功呼叫本指南中的端點，您需要：

  • 可在粉絲專頁上執行 ADVERTIZE 任務之用戶所要求的粉絲專頁存取權杖
  • 您的應用程式用戶必須授予下列權限：
    • ads_management
    • pages_manage_ads
    • pages_read_engagement
    • pages_show_list

建議

請務必在 Facebook 粉絲專頁設定 中設定商家的營業時間。

測試 API 呼叫時，可以將 access_token 參數組合包含在存取權杖中。不過，從應用程式進行安全呼叫時，請使用存取權杖類別。

限制

  • 目標廣告受眾必須年滿 18 歲
  • 行動呼籲中包含的電話號碼必須與目標廣告受眾所在的國家／地區相同

步驟 1：建立行銷活動

若要建立廣告行銷活動，請傳送 POST 要求至 act_ad_account_id/campaigns 端點，其中 ad_account_id 是 Meta 廣告帳號的編號。您的要求必須包含：

  • 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"],
         }'

成功後，您的應用程式會收到包含行銷活動編號的 JSON 回應。

{
  "id": "campaign_id"
}

步驟 2：建立廣告組合

若要建立廣告組合，請傳送 POST 要求至 act_ad_account_id/adsets 端點，其中 ad_account_id 是 Meta 廣告帳號的編號。您的要求必須包含：

  • bid_amount
  • billing_event 設為 IMPRESSIONS
  • campaign_id
  • daily_budget
  • destination_type 設為 PHONE_CALL
  • name
  • optimization_goal 設為通話廣告的 QUALITY_CALL
  • 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"] 
           } 
         }'

成功後，您的應用程式會收到包含廣告組合編號的下列 JSON 回應。

{
  "id": "adset_id"
}

步驟 3：建立廣告創意

廣告創意可讓您新增素材至廣告。支援輪播、圖像、純文字和影片廣告。

若要建立廣告創意，請傳送 POST 要求至 /act_ad_account_id/adcreatives 端點，其中 ad_account_id 是 Meta 廣告帳號的編號。您的要求必須包含：

  • name
  • object_story_spec
  • object_story_spec 包含 link_data 物件，該物件定義 call_to_action，並將 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" }
               }   
             }
           }
         }'

成功後，您的應用程式會收到包含廣告創意編號的下列 JSON 回應。

{
  "id": "ad_creative_id"
}

步驟 4：建立廣告

若要建立廣告，您需要為廣告創意和廣告組合建立關聯。若要建立廣告，請傳送 POST 要求至 /act_ad_account_id/ads 端點，其中 ad_account_id 是 Meta 廣告帳號的編號。您的要求必須包含：

廣告創意廣告要求範例

採用方便閱讀的格式。將粗體、斜體值（例如 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"
         }'

成功後，您的應用程式會收到包含廣告編號的下列 JSON 回應。

{
  "id": "ad_id"
}

後續步驟

請瀏覽開始使用指南，瞭解如何提交廣告進行審查。

瞭解詳情

深入瞭解行銷 API 和通話廣告的其他選項。

企業商家使用說明

行銷 API