市场营销 API

多目标位置直达广告

本指南介绍如何使用市场营销 API 创建和发布多目标位置直达广告。

多目标位置直达广告可将点击广告的用户直接引导至消息应用或他们最有可能回复的应用（Messenger、Instagram 或 WhatsApp）中与您的商家开展对话。商家可以使用这些广告大规模触达用户，并提供出色的个性化服务。

多目标位置广告意味着广告可以前往以下目标位置的任意组合：Messenger 聊天、Instagram 聊天、WhatsApp 聊天。

如要创建仅前往一个目标位置的广告，请参阅：

广告创建流程概览

本文档概述了您设置多目标位置直达广告集成需要遵循的步骤。您需要执行以下操作：

  1. 创建广告系列
  2. 创建广告组，将广告与广告系列关联
  3. 为您希望投放的多目标位置广告类型创建广告创意
  4. 将广告创意与广告组关联，以创建广告

前期准备

本指南假设您已具备以下条件：

第 1 步：创建广告系列

首先创建广告系列。请向 /act_<AD_ACCOUNT_ID>/campaigns 端点发送 POST 请求，其中 <AD_ACCOUNT_ID> 是您 Meta 广告账户的编号。请求中必须包含：

参数

名称描述

name

字符串

必要。
多目标位置直达广告系列的名称。

objective

枚举

必要。
广告系列的目标。
支持的目标是 OUTCOME_ENGAGEMENT、OUTCOME_SALES 和 OUTCOME_TRAFFIC。

special_ad_categories

list<Object>

必要。
与多目标位置直达广告系列关联的特殊广告类别。目前，我们不支持多目标位置直达广告使用特殊广告类别，因此此参数需要为 NONE 或空数组。请参阅广告系列参考文档，了解详情。

status

枚举

非必要。
有效选项是 PAUSED 和 ACTIVE。
如果广告系列的状态是 PAUSED，该广告系列所有投放中的广告组和广告都将暂停，生效状态为 CAMPAIGN_PAUSED。

请求

curl -X POST \
  -F 'name=Click to Multi Destination Campaign' \
  -F 'objective=OUTCOME_ENGAGEMENT' \
  -F 'status=ACTIVE' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns

响应

若请求成功，应用收到的 JSON 响应中将包含您新建广告系列的编号。

{
  "id": "<AD_CAMPAIGN_ID>"
}

更新

您可以通过向 /<AD_CAMPAIGN_ID> 发送 POST 请求来更新广告系列。

读取

要验证您是否已成功创建多目标位置直达广告系列，请向 /<AD_CAMPAIGN_ID> 发送 GET 请求。请参阅广告系列参考文档，获取可用参数的完整清单。

请求

curl -X GET -G \
  -d 'fields=name,status,objective' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_CAMPAIGN_ID>

响应

{
  "name": "Click to Multi Destination Campaign",
  "status": "ACTIVE",
  "objective": "OUTCOME_ENGAGEMENT",
  "id": "<AD_CAMPAIGN_ID>"
}

第 2 步：创建广告组

广告系列创建完成之后，要创建广告组。创建方法是：向 /act_<AD_ACCOUNT_ID>/adsets 端点发送 POST 请求，其中 <AD_ACCOUNT_ID> 是您 Meta 广告账户的编号。请求中必须包含：

参数

名称描述

bid_amount

未签名的 int32

在 bid_strategy 设为 LOWEST_COST_WITH_BID_CAP 或 COST_CAP 时，此参数是必要项。
您根据自己的 optimization_goal 希望为某个成效支付的最高金额。

bid_strategy

枚举

非必要。
此广告系列的与您特定业务目标相符的竞价策略。请参阅广告系列参考文档，了解详情。
值：LOWEST_COST_WITHOUT_CAP、LOWEST_COST_WITH_BID_CAP、COST_CAP

billing_event

枚举

必要。
对于多目标位置直达广告，此参数必须设为 IMPRESSIONS。向用户展示您的广告时，Meta 将向您收取费用。

campaign_id

数字字符串或整数

必要。
您希望在其中添加此广告组的有效多目标位置直达广告。

daily_budget

int64

在未设置 lifetime_budget 时，此参数为必要项。
以您的账户货币定义的单日预算。仅适用于投放期（end_time 与 start_time 之差）超过 24 小时的广告组。
daily_budget 或 lifetime_budget 必须大于 0。

destination_type

字符串

必要。


  • 如要使用所有三个目标位置（Messenger、WhatsApp 和 Instagram），将此参数设为 MESSAGING_INSTAGRAM_DIRECT_MESSENGER_WHATSAPP。
  • 如要使用 Messenger 和 Instagram，将此参数设为 MESSAGING_INSTAGRAM_DIRECT_MESSENGER。
  • 如要使用 Messenger 和 WhatsApp，将此参数设为 MESSAGING_MESSENGER_WHATSAPP。
  • 如要使用 WhatsApp 和 Instagram，将此参数设为 MESSAGING_INSTAGRAM_DIRECT_WHATSAPP。

注意：如果您的目标位置中包含 WhatsApp，请确保 WhatsApp Business 电话号码已与您的公共主页绑定。如果目标位置中包含 Instagram，请确保 Instagram 业务账户已与您的公共主页绑定。

end_time

日期时间

在指定了 lifetime_budget 时，此参数为必要项。
创建包含 daily_budget 的广告组时，应指定 end_time=0；或将此字段留空，以将此广告组设为长期投放，没有结束日期。
示例：2015-03-12 23:59:59-07:00 或 2015-03-12 23:59:59 PDT。UTC UNIX 时间戳。

lifetime_budget

int64

在未设置 daily_budget 时，此参数为必要项。
以您账户货币定义的广告组总预算。在指定了此字段时，您还必须指定 end_time。
daily_budget 或 lifetime_budget 必须大于 0。

name

字符串

必要。
多目标位置直达广告组的名称。

optimization_goal

枚举

必要。
广告组的优化目标。对于多目标位置直达广告，此参数必须设为 CONVERSATIONS。根据广告系列的目标，广告组可能有资格使用不同的优化目标。

promoted_object

必要。
广告组要通过其所有广告进行推广的对象。对于多目标位置直达广告，promoted_object 具有以下条件：

  • page_id：必要。Facebook 公共主页的编号。

请参阅广告组 > 推广对象，了解详情。

start_time

日期时间

非必要。
广告组的开始时间。如果未提供值，此字段将默认使用当前时间。
示例：2015-03-12 23:59:59-07:00 或 2015-03-12 23:59:59 PDT。UTC UNIX 时间戳。

status

枚举

必要。
广告组的状态。此字段可与生效状态不同，具体值取决于上级广告系列。如果未提供值，此字段将默认使用 ACTIVE。
值：ACTIVE、PAUSED、DELETED、ARCHIVED

targeting

定位对象

必要。
Instagram 直达广告的定位结构。请参阅定位，了解详情。

time_start

日期时间

非必要。
可与 start_time 互换。

time_stop

日期时间

在指定了 lifetime_budget 时，此参数为必要项。
可与 end_time 互换。

请访问广告账户的广告组参考文档，获取可用参数的完整清单。

请求

curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=<DAILY_BUDGET>' \
  -F 'destination_type=<DESTINATION_TYPE>' \
  -F 'name=<AD_SET_NAME>' \
  -F 'optimization_goal=CONVERSATIONS' \
  -F 'promoted_object={
      "page_id": "<PAGE_ID>"
    }' \
  -F 'status=ACTIVE' \
  -F 'start_time=<START_TIME>' \
  -F 'targeting={ 
        "geo_locations": { "countries":["US","CA"] },
        "device_platforms": ["mobile", "desktop"]
  }' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets

响应

若请求成功，应用收到的 JSON 响应中将包含您新建广告组的编号。

{
  "id": "<AD_SET_ID>"
}

更新

您可以通过向 /<AD_SET_ID> 发送 POST 请求来更新广告组。

读取

要验证您是否已成功创建多目标位置直达广告组，请向 /<AD_SET_ID> 发送 GET 请求。请参阅广告组参考文档，获取可用参数的完整清单。

请求

curl -X GET -G \
  -d 'fields=name,destination_type,optimization_goal,bid_strategy' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_SET_ID>

响应

{
  "name": "<AD_SET_NAME>",
  "destination_type": "<DESTINATION_TYPE>",
  "optimization_goal": "CONVERSATIONS",
  "bid_strategy": "LOWEST_COST_WITHOUT_CAP'"
  "id": "<AD_SET_ID>"
}

第 3 步：创建广告创意

通过广告创意，您可以为广告添加素材。如要创建广告创意，请向 /act_<AD_ACCOUNT_ID>/adcreatives 端点发送 POST 请求，其中 <AD_ACCOUNT_ID> 是您 Meta 广告账户的编号。请求中必须包含：

参数

名称描述

asset_feed_spec

必要。
指定多目标位置直达广告的目标位置

必要项：

  • optimization_type：对于多目标位置直达广告，此参数必须设为 DOF_MESSAGING_DESTINATION。
  • call_to_actions：多目标位置直达广告所选择的目标位置数组。需要与广告组中指定的 destination_type 一致。

Messenger

{
  "type": "MESSAGE_PAGE",
    "value": {
       "app_destination": "MESSENGER",
       "link": "https://fb.com/messenger_doc/"
    }
}

WhatsApp

{
  "type": "WHATSAPP_MESSAGE",
    "value": {
       "app_destination": "WHATSAPP",
       "link": "https://api.whatsapp.com/send"
    }
}

Instagram

{
  "type": "INSTAGRAM_MESSAGE",
    "value": {
       "app_destination": "INSTAGRAM_DIRECT",
       "link": "https://www.instagram.com"
    }
}

name

字符串

必要。
广告创意的名称。

object_story_spec

必要。
包含某条消息相关信息的一个对象。请参阅广告创意对象快拍规格，了解详情。


必要项：

  • page_id：Facebook 公共主页的编号
  • instagram_actor_id：Instagram 账户编号。有三种方法可以获取 Instagram 账户编号（Instagram 账户包括：商务管理平台拥有的 Instagram 账户、公共主页关联的 Instagram 账户和公共主页绑定的 Instagram 账户）。

非必要项：

  • link_data：链接公共主页帖子或轮播广告的规格
  • photo_data：照片公共主页帖子的规格
  • text_data：文本公共主页帖子的规格
  • video_data：视频公共主页帖子的规格

degrees_of_freedom_spec

非必要。
请参阅适用于进阶赋能型素材的标准美化，了解详情。

请访问广告创意参考文档，获取可用参数的完整清单。

填写公共主页的欢迎消息

客户看到的默认消息是“您好！我能获得与这个公共主页相关的更多信息吗？”。通过在 object_story_spec 下的 page_welcome_message 字段中定制广告的问候消息、开场白和自动填写消息，您可以为多目标位置直达广告创建更细化的专属用户体验。

有关开场白的详情，请参阅 ice_breakers 参考文档。

限制

  • 开场白的标题不能超过 80 个字符。
  • 对开场白的回复不能超过 300 个字符。
  • 消息文本不能超过 300 个字符。

示例

创建 page_welcome_message 对象，以添加带问候消息的开场白。

"page_welcome_message": {
  "type":"VISUAL_EDITOR",
  "version":2,
  "landing_screen_type":"welcome_message",
  "media_type":"text",
  "text_format":{
    "customer_action_type":"ice_breakers",
    "message":{
      "ice_breakers":[
        {"title":"Can I make a purchase?","response":"This is a response 1"},
        {"title":"Can I see a menu?", "response":"This is a response 2"},
        {"title":"Where are you located?", "response":"This is a response 3"}],
      "quick_replies":[],
      "text":"Hi {{user_first_name}}! Please let us know how we can help you."}
  },
  "user_edit":false,
  "surface":"visual_editor_new"
}

广告创意创建示例

将 page_welcome_message 字段添加到创意中，如下所示。

请求

curl -X POST \
-F 'name=<CREATIVE_NAME>' \
-F 'object_story_spec={
     "page_id": "438346666550309",
     "link_data": {
       "name": "<AD_HEADLINE>",
       "message": "<AD_PRIMARY_TEXT>",
       "image_hash": "<IMAGE_HASH>"
       "link": "https://fb.com/messenger_doc/",
       "page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
       "call_to_action": {
         "type": "MESSAGE_PAGE",
         "value": {
           "app_destination": "MESSENGER"
         }
       }
     }
   }' \
-F 'asset_feed_spec={
     "optimization_type": "DOF_MESSAGING_DESTINATION",
     "call_to_actions": [
       {
         "type": "MESSAGE_PAGE",
         "value": {
           "app_destination": "MESSENGER",
           "link": "https://fb.com/messenger_doc/"
         }
       },
       {
         "type": "WHATSAPP_MESSAGE",
         "value": {
           "app_destination": "WHATSAPP",
           "link": "https://api.whatsapp.com/send"
         }
       },
       {
         "type": "INSTAGRAM_MESSAGE",
         "value": {
           "app_destination": "INSTAGRAM_DIRECT",
           "link": "https://www.instagram.com"
         }
       }
     ]
   }' \
-F 'degrees_of_freedom_spec={
     "creative_features_spec": {
       "standard_enhancements": {
         "enroll_status": "OPT_IN"
       }
     }
   }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

响应

若请求成功，应用收到的 JSON 响应中将包含您新建广告创意的编号。

{
  "id": "<AD_CREATIVE_ID>"
}

使用 Instagram 内容创建广告创意

Instagram 帖子

请参考将帖子用作 Instagram 广告，了解详情。

curl -X POST \
  -F 'name=Sample ad creative from Instagram post' \
  -F 'object_id=<PAGE_ID>' \
  -F 'instagram_user_id=<INSTAGRAM_USER_ID>' \
  -F 'source_instagram_media_id=<INSTAGRAM_POST_ID>' \
  -F 'call_to_action={
       "type": "INSTAGRAM_MESSAGE",
       "value": {
         "link": "https://www.instagram.com"
       }
     }' \ 
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Instagram 图片

curl -X POST \
  -F 'name=Sample ad creative from Instagram image' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
       "link_data": {
         "message": "<AD_PRIMARY_TEXT>",
         "picture": "<IMAGE_URL>"
         "page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
         "call_to_action": {
           "type": "INSTAGRAM_MESSAGE",
           "value": {
             "app_destination": "INSTAGRAM_DIRECT"
           }
         }
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

使用 Facebook 内容创建广告创意

请参阅将帖子用作 Instagram 广告：Facebook 帖子，了解详情。

curl -i -X POST \
  "https://graph.facebook.com/v21.0/act_<AD_ACCOUNT>/adcreatives
  ?object_story_id=<postOwnerID_postID>
  &instagram_actor_id=<IG_USER_ID>
  &call_to_action="{'type':MESSAGE_PAGE,'value':{'app_destination':'MESSENGER'}}"
  &access_token=<ACCESS_TOKEN>"

在上方调用中，object_story_id 是帖子编号，采用了 postOwnerID_postID 格式；instagram_actor_id 是绑定了公共主页的 Instagram 账户编号或由公共主页提供支持的 Instagram 账户编号。详情请参阅使用公共主页设置 Instagram 账户。

更新

您可以通过向 /<AD_CREATIVE_ID> 发送 POST 请求来更新广告创意。

读取

要验证您是否已成功创建点击多目标位置直达广告创意，请向 /<AD_CREATIVE_ID> 发送 GET 请求。请参阅广告创意，获取可用参数的完整清单。

请求

curl -X GET -G \
  -d 'fields=name,object_story_spec{page_welcome_message},asset_feed_spec' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_CREATIVE_ID>

响应

{
  "name": "<CREATIVE_NAME>",
  "object_story_spec": {
    "page_welcome_message": {
      "type": "VISUAL_EDITOR",
      "version": 2,
      "landing_screen_type": "welcome_message",
      "media_type": "text",
      "text_format": {
        "customer_action_type": "ice_breakers",
        "message": {
          "text": "Sample greeting message",
          "ice_breakers": [
            {
              "title": "Sample icebreaker"
            },
            {
              "title": "Sample icebreaker"
            },
            {
              "title": "Sample icebreaker"
            }
          ]
        }
      }
    }
  },
  "asset_feed_spec": {
    "optimization_type": "DOF_MESSAGING_DESTINATION",
    "call_to_actions": [
      {
        "type": "MESSAGE_PAGE",
        "value": {
          "app_destination": "MESSENGER",
          "link": "https://fb.com/messenger_doc/"
        }
      },
      {
        "type": "WHATSAPP_MESSAGE",
        "value": {
          "app_destination": "WHATSAPP",
          "link": "https://api.whatsapp.com/send"
        }
      },
      {
        "type": "INSTAGRAM_MESSAGE",
        "value": {
          "app_destination": "INSTAGRAM_DIRECT",
          "link": "https://www.instagram.com"
        }
      }
    ]
  },
  "id": "<AD_CREATIVE_ID>"
}

第 4 步：创建广告

您可以通过广告将广告创意信息与广告组关联。如要创建广告，请向 /act_<AD_ACCOUNT_ID>/ads 端点发送 POST 请求，其中 <AD_ACCOUNT_ID> 是您 Meta 广告账户的编号。请求中必须包含：

参数

名称描述

name

字符串

必要。
广告创意的名称。

adset_id

数字字符串或整数

必要。
广告组的编号。

creative

必要。
要用于此广告的广告创意。您可以提供现有广告创意的 creative_id，或通过在请求中加入所有必要字段来新建一个广告创意。请参阅广告创意，了解详情。

status

枚举

必要。
广告的配置状态。
值：ACTIVE、PAUSED、DELETED、ARCHIVED

请求

curl -X POST \
  -F 'name=<AD_NAME>' \
  -F 'adset_id=<AD_SET_ID> \
  -F 'creative={
       "creative_id": "<AD_CREATIVE_ID>"
     }' \
  -F 'status=ACTIVE \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads

响应

若请求成功，应用收到的 JSON 响应中将包含您新建广告的编号。

{
  "id": "<AD_ID>"
}

行动号召

创建广告时，您还可以设置行动号召。

"asset_feed_spec": {
  "optimization_type": "DOF_MESSAGING_DESTINATION",
  "call_to_actions": [
    {
      "type": "MESSAGE_PAGE",
      "value": {
        "app_destination": "MESSENGER",
        "link": "https://fb.com/messenger_doc/"
      }
    },
    {
      "type": "INSTAGRAM_MESSAGE",
      "value": {
        "app_destination": "INSTAGRAM_DIRECT",
        "link": "https://www.instagram.com"
      }
    }
  ]
}

详情请参阅“素材信息库参数”文档。

更新

您可以通过向 /<AD_ID> 发送 POST 请求来更新广告。

读取

要验证您是否已成功创建多目标位置直达广告，请向 /<AD_ID> 发送 GET 请求。请参阅广告参考文档，获取可用参数的完整清单。

请求

curl -X GET -G \
  -d 'fields=status,adset_id \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_ID>

响应

{
  "status": "ACTIVE",
  "adset_id": "<AD_SET_ID>",
  "id": "<AD_ID>"
}