市场营销 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
  • 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 步：创建广告

如要创建广告，您需要将广告创意与广告组关联起来。如要创建广告，请向 /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 以及来电专用广告的更多选项。

Business 帮助中心

市场营销 API