多目标位置直达广告
本指南介绍如何使用市场营销 API 创建和发布多目标位置直达广告。
多目标位置直达广告可将点击广告的用户直接引导至消息应用或他们最有可能回复的应用（Messenger、Instagram 或 WhatsApp）中与您的商家开展对话。商家可以使用这些广告大规模触达用户，并提供出色的个性化服务。
多目标位置广告意味着广告可以前往以下目标位置的任意组合：Messenger 聊天、Instagram 聊天、WhatsApp 聊天。
如要创建仅前往一个目标位置的广告，请参阅：
广告创建流程概览
本文档概述了您设置多目标位置直达广告集成需要遵循的步骤。您需要执行以下操作：
第 1 步：创建广告系列
首先创建广告系列。请向 /act_<AD_ACCOUNT_ID>/campaigns 端点发送 POST 请求，其中 <AD_ACCOUNT_ID> 是您 Meta 广告帐户的编号。请求中必须包含：
参数
| 名称 | 描述 |
|---|---|
字符串 | 必要项。 |
枚举 | 必要项。 |
list<Object> | 必要项。 |
枚举 | 可选项。 |
请求
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/v19.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/v19.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 广告帐户的编号。请求中必须包含：
参数
| 名称 | 描述 |
|---|---|
未签名的 int32 | 在 bid_strategy 设为 |
枚举 | 可选项。 |
枚举 | 必要项。 |
数字字符串或整数 | 必要项。 |
int64 | 在未设置 |
字符串 | 必要项。
注意：如果您的目标位置中包含 WhatsApp，请确保 WhatsApp Business 电话号码已与您的公共主页绑定。如果目标位置中包含 Instagram，请确保 Instagram 业务帐户已与您的公共主页绑定。 |
日期时间 | 在指定了 |
int64 | 在未设置 |
字符串 | 必要项。 |
枚举 | 必要项。 |
| 必要项。
请参阅广告组 > 推广对象，了解详情。 |
日期时间 | 可选项。 |
枚举 | 必要项。 |
定位对象 | 必要项。 |
日期时间 | 可选项。 |
日期时间 | 在指定了 |
请访问广告帐户的广告组参考文档，获取可用参数的完整清单。
请求
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/v19.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/v19.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 广告帐户的编号。请求中必须包含：
参数
| 名称 | 描述 |
|---|---|
| 必要项。 必要项：
Messenger
{
"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"
}
}
|
字符串 | 必要项。 |
| 必要项。 必要项：
可选项：
|
| 可选项。 |
请访问广告创意参考文档，获取可用参数的完整清单。
填写公共主页的欢迎消息
客户看到的默认消息是“您好！我能获得与这个公共主页相关的更多信息吗？”。通过在 object_story_spec 下的 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": {
"text": "<GREETING_MESSAGE>",
"ice_breakers": [
{
"title": "<ICEBREAKER>"
},
{
"title": "<ICEBREAKER>"
},
{
"title": "<ICEBREAKER>"
}
]
}
}
}
广告创意创建示例
请求
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/v19.0/act_<AD_ACCOUNT_ID>/adcreatives
响应
若请求成功，应用收到的 JSON 响应中将包含您新建广告创意的编号。
{
"id": "<AD_CREATIVE_ID>"
}
更新
您可以通过向 /<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/v19.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 广告帐户的编号。请求中必须包含：
参数
| 名称 | 描述 |
|---|---|
字符串 | 必要项。 |
数字字符串或整数 | 必要项。 |
| 必要项。 |
枚举 | 必要项。 |
请求
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/v19.0/act_<AD_ACCOUNT_ID>/ads
响应
若请求成功，应用收到的 JSON 响应中将包含您新建广告的编号。
{
"id": "<AD_ID>"
}
更新
您可以通过向 /<AD_ID> 发送 POST 请求来更新广告。
读取
要验证您是否已成功创建多目标位置直达广告，请向 /<AD_ID> 发送 GET 请求。请参阅广告参考文档，获取可用参数的完整清单。
请求
curl -X GET -G \
-d 'fields=status,adset_id \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/<AD_ID>响应
{
"status": "ACTIVE",
"adset_id": "<AD_SET_ID>",
"id": "<AD_ID>"
}