推廣 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 廣告帳戶編號。您的要求必須包括以下內容：

  • 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 步：建立廣告組合

如要建立廣告組合，您需向 act_ad_account_id/adsets 端點傳送 POST 要求，其中 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 步：建立廣告創意

透過建立廣告創意，您可以在廣告中加入各種資產。支援輪播廣告、圖像廣告、純文字廣告和影片廣告。

如要建立廣告創意，您需向 /act_ad_account_id/adcreatives 端點傳送 POST 要求，其中 ad_account_id 即您的 Meta 廣告帳戶編號。您的要求必須包括以下內容：

  • name
  • object_story_spec
  • 包含 link_data 物件的 object_story_spec，該物件可定義 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 步：建立廣告

在建立廣告時，您需將廣告創意與廣告組合連結。如要建立廣告，請向 /act_ad_account_id/ads 端點傳送 POST 要求，其中 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