Meta 行銷 API 通話廣告

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

廣告建立流程總覽

若要建立和發佈廣告，您需要執行以下步驟：

建立廣告行銷活動
建立將廣告連結至廣告行銷活動的廣告組合
建立通話廣告的廣告創意
將廣告創意連結至廣告組合，以建立廣告
將廣告發佈至 Facebook 和 Instagram

準備工作

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

使用有效付款方式的 Meta 廣告帳號
將圖像或影片等任何要用於廣告的素材上傳至 Meta 伺服器

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

可在粉絲專頁上執行 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/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"],
         }'

成功後，您的應用程式會收到包含行銷活動編號的 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/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"] 
           } 
         }'

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

{
  "id": "adset_id"
}

步驟 3：建立廣告創意

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

若要建立廣告創意，請傳送 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/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" }
               }   
             }
           }
         }'

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

{
  "id": "ad_creative_id"
}

步驟 4：建立廣告

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

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"
         }'

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

{
  "id": "ad_id"
}

後續步驟

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

瞭解詳情

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

企業商家使用說明

在廣告管理員查看通話廣告的衡量指標