市场营销 API

进阶赋能型智能购物广告系列

进阶赋能型智能购物广告系列是一种解决方案，有助于电子商务和零售领域的直销广告主以及品牌广告主提升表现，提高个性化水平，并且变得更加高效。通过这些广告系列，广告主可以更加灵活地控制创意、定位、版位和预算等方法，并有更多机会来优化广告系列，从而促进转化。

通过进阶赋能型智能购物广告系列，您可以将特定市场的所有受众合并到单一的广告架构中，避免针对细分的受众投放多个广告系列。此举旨在简化创建和管理流程，同时减少受众重叠。

手动设置广告系列与进阶赋能型智能购物广告系列比较

手动设置 BAU 广告系列进阶赋能型智能购物广告系列

多个 BAU 广告系列

BAU 组合更换


通过 7 种定位方法进行手动定位


自动化定位，只需输入一个国家/地区即可提高设置效率的自动化功能


在多个广告系列中严格分配预算


在一个广告系列中自动分配预算


最多支持测试 50 种创意组合


允许使用动态广告和静态广告，最多支持 150 种创意组合


本文档简要介绍您设置进阶赋能型智能购物广告系列集成时需要遵循的步骤。您需要执行以下操作：

  1. 定义现有客户
  2. 创建广告系列
  3. 验证广告系列创建情况
  4. 创建广告组
  5. 提供创意和创建广告
  6. 设置最低年龄限制和地理排除条件（参见“广告账户控制选项”参考文档）

详细了解进阶赋能型智能购物广告系列的跨渠道转化优化。

第 1 步：定义您的现有客户

通过进阶赋能型智能购物广告系列，您可以将现有客户定义为一系列自定义受众编号。您的现有客户是指已熟悉您的业务或产品的用户。设置此定义后，您可以将其用于为进阶赋能型智能购物广告系列分配预算，从而限制对现有客户的花费。我们还会提供指标，用于向您报告广告系列在这些不同受众细分中的表现。

您可以向 /act_{ad_account_id} 端点发送 POST 请求，从而定义广告。您需要提供以下参数，才能设置此定义：

参数描述

existing_customers

Array<string>

由广告账户有权访问的自定义受众编号构成的数组。目前，自定义受众的支持来源是网站、应用活动、客户名单、目录和线下活动。


如需了解如何创建自定义受众，请参阅此页面。

示例

curl -X POST \
  -F 'existing_customers=[<CUSTOM_AUDIENCE_ID>, <CUSTOM_AUDIENCE_ID>]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>

如需进一步了解在第三方追踪工具中追踪新用户受众和现有受众的相关信息，请参阅受众类型网址参数。

第 2 步：创建广告系列

您首先要创建广告系列。如要执行此操作，请向 /act_{ad_account_id}/campaigns 发送 POST 请求。

参数


参数描述

name
字符串

必要
进阶赋能型智能购物广告系列的名称

objective
枚举

必要
广告系列的目标。请为此类型的广告指定 OUTCOME_SALES

special_ad_categories

list<Object>

必要
与进阶赋能型智能购物广告系列关联的特殊广告类别

adlabels

list<Object>

可选
与进阶赋能型智能购物广告系列关联的广告标签

buying_type
字符串

可选
进阶赋能型智能购物广告系列仅支持 AUCTION 值

execution_options

list<enum>

可选
默认值：set。其他选项包括：

  • validate_only：如果指定此选项，API 调用不会执行更改，但会按照验证规则对每个字段的值进行验证。
  • include_recommendations：不能单独使用此选项。如果使用此选项，要添加广告目标配置的相关建议。响应中会出现单独的建议部分，前提是存在关于此指定操作的建议。

如果调用通过验证或审核，则响应会是 {"success": true}。如果调用未通过验证或审核，系统则会返回错误及更多详细信息。

smart_promotion_type
枚举

必要
如要将此广告系列指定为进阶赋能型智能购物广告系列，智能促销类型应设为 AUTOMATED_SHOPPING_ADS

status
枚举

可选
有效选项包括：PAUSED 和 ACTIVE。


如果此状态是 PAUSED，则广告系列所有投放中的广告组和广告都将暂停，而且生效状态为 CAMPAIGN_PAUSED

创建广告系列的示例

curl -X POST \
  -F 'name=Advantage+ Shopping Campaign' \
  -F 'objective=OUTCOME_SALES' \
  -F 'status=ACTIVE' \
  -F 'special_ad_categories=[]' \
  -F 'smart_promotion_type=AUTOMATED_SHOPPING_ADS' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

更新

您可以向 /{campaign_id} 发送 POST 请求，从而更新广告系列。

参数


参数描述

name
字符串

进阶赋能型智能购物广告系列的名称

special_ad_categories

list<Object>

与进阶赋能型智能购物广告系列关联的特殊广告类别

adlabels

list<Object>

与进阶赋能型智能购物广告系列关联的广告标签

execution_options

list<enum>

默认值：set。其他选项包括：

  • validate_only：如果指定此选项，API 调用不会执行更改，但会按照验证规则对每个字段的值进行验证。
  • include_recommendations：不能单独使用此选项。如果使用此选项，要添加广告目标配置的相关建议。响应中会出现单独的建议部分，前提是存在关于此指定操作的建议。

如果调用通过验证或审核，则响应会是 {"success": true}。如果调用未通过验证或审核，系统则会返回错误及更多详细信息。

topline_id
数字字符串或整数

顶行编号

status
枚举

可对更新 API 调用使用以下状态：

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

如果广告系列状态设为 PAUSED，则该广告系列正在使用的子目标会暂停，而且有效状态为 CAMPAIGN_PAUSED。

更新广告系列的示例

curl -X POST \
  -F 'name=Advantage+ Shopping Update Sample Campaign' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<CAMPAIGN_ID>

第 3 步：验证广告系列创建情况

如要验证您是否已成功创建进阶赋能型智能购物广告系列，请向 /<AD_CAMPAIGN_ID> 发送 GET 请求，请求中应包含 smart_promotion_type 字段。

如果进阶赋能型智能购物广告系列有效，系统会返回字段值 AUTOMATED_SHOPPING_ADS。

示例

curl -X GET -G \
  -d 'fields=smart_promotion_type' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_CAMPAIGN_ID>

响应

{
  "smart_promotion_type": "AUTOMATED_SHOPPING_ADS",
  "id": <AD_CAMPAIGN_ID>
}

第 4 步：创建广告组

广告系列创建完成之后，请创建您的广告组。一个进阶赋能型智能购物广告系列只能关联一个广告组。

如要创建广告组，请向 /act_{ad_account_id}/adsets 发送 POST 请求。

参数


参数描述

campaign_id
数字字符串或整数

必要
一个有效的进阶赋能型智能购物广告系列，您希望将此广告组添加到该广告系列。

name
字符串

必要
进阶赋能型智能购物广告系列的名称

promoted_object
对象

必要
广告组要通过组内所有广告推广的对象。对于进阶赋能型智能购物广告系列，请提供以下内容：

  • pixel_id 和
  • custom_event_type：进阶赋能型智能购物广告组支持以下事件：PURCHASE、ADD_TO_CART、INITIATED_CHECKOUT、ADD_PAYMENT_INFO、ADD_TO_WISHLIST、CONTENT_VIEW、COMPLETE_REGISTRATION、DONATE、START_TRIAL、SUBSCRIBE、SEARCH、OTHER。不支持客户转化事件。

详细了解进阶赋能型智能购物广告系列的跨渠道转化优化。

targeting
定位目标

必要
进阶赋能型智能购物广告组的定位结构。只允许指定 geo_locations。

geo_locations
数组

必要
用作广告组分享对象细分条件

  • countries — 定位的国家/地区。需要提供由 2 位数 ISO 3166 格式代码组成的数组。
    示例：
    {
  "geo_locations": {
    "countries": [“US”]
  },
}
  • regions — 州、省或地区。如需了解可用的值，请参阅定位搜索 > 地区。字符数上限：200。
    示例：
    {
  "geo_locations": {
    "regions": [{"key":"3847"}]
  },
}

daily_budget
int64

可选
用您的账户货币指定的单日预算，仅针对时长（end_time 与 start_time 之差）长于 24 小时的广告组。


daily_budget 或 lifetime_budget，值必须大于 0。

lifetime_budget
int64

可选
用您的账户货币指定的总预算。如果指定此参数，则还须指定 end_time。


daily_budget 或 lifetime_budget，值必须大于 0。

end_time
日期/时间

如果指定 lifetime_budget，此参数为必要项。
如果创建的广告组包含 daily_budget，请指定 end_time=0，以便将此广告组设置为没有结束日期的长期广告组。UTC UNIX 时间戳


示例：2015-03-12 23:59:59-07:00 或 2015-03-12 23:59:59 PDT。

optimization_goal
枚举

可选
选择 OFFSITE_CONVERSIONS 作为优化目标，以便最大限度提高转化量。如果您想最大限度提高转化价值，请选择 VALUE 作为优化目标。在广告管理工具中，您的竞价策略会显示为“最高价值”。

bid_strategy
枚举

可选

  • LOWEST_COST_WITHOUT_CAP：Facebook 会自动代您竞价，并为您获取费用最低的结果。我们会根据需要自动提高您的有效竞价，以便根据您给定的 optimization_goal 获取期望的成效。如果 optimization_goal 为 OFFSITE_CONVERSION 或 VALUE，这是 bid_strategy 的默认值。
  • LOWEST_COST_WITH_MIN_ROAS：针对价值优化的特定竞价选项。您必须指定 roas_average_floor，此为您想从广告花费中获得的最低回报。请参阅最低广告花费回报竞价。
  • COST_CAP：我们会努力保持在您设置的单次操作费用范围内，同时尽量实现最大成效。您必须在 bid_amount 字段中设置一个上限数值。注意：无法保证完全遵从费用上限的限制。请参阅费用上限。

bid_amount

如果 bid_strategy 为 COST_CAP，此参数为必要项。

bid_constraints
JSON 对象

可选

  • optimization_goal 必须为 VALUE。
  • bid_strategy 必须为 LOWEST_COST_WITH_MIN_ROAS。
  • “广告花费回报 (ROAS) 保底”型竞价竞价使用 bid_constraints 来传递“广告花费回报 (ROAS) 保底值”，但您不能将该值与 bid_constraints 一起使用，而应该使用 roas_average_floor。请参阅最低广告花费回报竞价。
  • roas_average_floor 的有效范围是 [100, 10000000]（包含端值）。这意味着“广告花费回报保底”的有效范围是 [0.01, 1000.0] 或 [1%, 100000.0%]（包含端值）。

billing_event
枚举

必要
广告组的付费事件。进阶赋能型智能购物广告系列仅支持 IMPRESSIONS。

existing_customer_budget_percentage
数字

可选
针对与此广告账户关联的现有客户，指定可为他们花费的成本在预算中所占的百分比上限。值越低，单次转化成本可能越高。有效值在 0 到 100 之间。

adlabels

list<Object>

可选

指定一个由要关联此对象的标签组成的清单。

start_time
日期/时间

可选
广告组的开始时间。UTC UNIX 时间戳


示例：2015-03-12 23:59:59-07:00 或 2015-03-12 23:59:59 PDT。

time_start
日期/时间

可选

开始时间

time_stop
日期/时间

可选

结束时间

attribution_spec

list<JSON Object>

可选
一个转化归因参数，用于归因转化操作，以便进行优化。

创建广告组的示例

curl -X POST \
  -F 'name=Advantage+ Shopping Sample Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'promoted_object={ "pixel_id": "<PIXEL_ID>", "CUSTOM_EVENT_TYPE": "PURCHASE" }' \
  -F 'daily_budget=<NUM>' \
  -F 'existing_customer_budget_percentage=<NUM>' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'targeting={"geo_locations": {"countries": ["US"]}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

更新

您可以向 /{ad_set_id} 发送 POST 请求，从而更新广告组。

参数


参数描述

adlabels

list<Object>

指定一个由要关联此对象的标签组成的清单。此字段是可选项。

daily_budget
int64

用您的账户货币指定的单日预算，仅针对时长（end_time 与 start_time 之差）长于 24 小时的广告组。


daily_budget 或 lifetime_budget，值必须大于 0。

existing_customer_budget_percentage
数字

针对与此广告账户关联的现有客户，指定可为他们花费的成本在预算中所占的百分比上限。值越低，单次转化成本可能越高。有效值在 0 到 100 之间。

end_time
日期/时间

结束时间；如果指定 lifetime_budget，此为必要参数。


示例：2015-03-12 23:59:59-07:00 或 2015-03-12 23:59:59 PDT


如果创建的广告组有单日预算，请指定 end_time=0，以便将此广告组设置为没有结束日期的长期广告组。


UTC UNIX 时间戳。

execution_options

list<enum>

默认值：set。其他选项包括：

  • validate_only：如果指定此选项，API 调用不会执行更改，但会按照验证规则对每个字段的值进行验证。
  • include_recommendations：不能单独使用此选项。如果使用此选项，要添加广告目标配置的相关建议。响应中会出现单独的建议部分，前提是存在关于此指定操作的建议。

如果调用通过验证或审核，则响应会是 {"success": true}。如果调用未通过验证或审核，系统则会返回错误及更多详细信息。

start_time
日期/时间

广告组的开始时间。必须以 UTC UNIX 时间戳的形式指定。


示例：2015-03-12 23:59:59-07:00 或 2015-03-12 23:59:59 PDT。

status
枚举

可用于更新的选项包括：

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

如果此参数设置为 PAUSED，则广告组所有投放中的广告都将暂停，而且生效状态为 ADSET_PAUSED。

lifetime_budget
int64

用您的账户货币指定的总预算。如果指定此参数，则还须指定 end_time。


daily_budget 或 lifetime_budget，值必须大于 0。

time_start
日期/时间

开始时间

time_stop
日期/时间

结束时间

targeting
定位目标

广告组的定位结构。定位的有效值为 geo_locations。

geo_locations
数组

必要
用作广告组分享对象细分条件

  • countries — 定位的国家/地区。需要提供由 2 位数 ISO 3166 格式代码组成的数组。
    示例：
    {
  "geo_locations": {
    "countries": [“US”]
  },
}
  • regions — 州、省或地区。如需了解可用的值，请参阅定位搜索 > 地区。字符数上限：200。
    示例：
    {
  "geo_locations": {
    "regions": [{"key":"3847"}]
  },
}

attribution_spec

list<JSON Object>

可选
一个转化归因参数，用于归因转化操作，以便进行优化。

更新广告组的示例

curl -X POST \
  -F 'name=Advantage+ Shopping Sample Updated Ad Set' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_SET_ID>

第 5 步：提供创意及创建广告

广告组创建完成后，您可以向 /act_{ad_account_id}/ads 端点发送 POST 请求，从而创建广告。您可以添加以下参数：

参数


参数描述

name
字符串

必要
广告的名称

adset_id
int64

必要
广告组的编号，对于创建流程而言是必要项。

creative
AdCreative

必要项
要用于此广告的广告创意的创意参数或编号。有效字段包括：

  • object_story_spec
  • product_set_id
  • use_page_actor_override
  • creative_id

您可于此页面阅读关于创意的更多内容


按以下格式提供创意：{"creative_id": <CREATIVE_ID>}


或提供创意参数：

{
        "creative": {
          "name": <NAME>, 
          "object_story_spec": <SPEC>,
          "product_set_id": <PRODUCT_SET_ID>
        }
}

status
枚举

可选
在创建流程中，只有 ACTIVE 和 PAUSED 是有效值。在测试过程中，建议将广告状态设置为 PAUSED，以免产生意外花费。

adlabels

list<Object>

可选
与此广告关联的广告标签

execution_options

list<enum>

可选
默认值：set。

  • validate_only：如果指定此选项，API 调用不会执行更改，但会按照验证规则对每个字段的值进行验证。
  • synchronous_ad_review：不得单独使用此选项。如果使用此选项，始终都要指定 validate_only。指定这些选项后，API 调用会执行广告诚信验证，包括消息语言检查、图片的文字内容不能超过 20% 的规则以及验证逻辑等项。
  • include_recommendations：不能单独使用此选项。如果使用此选项，要添加广告目标配置的相关建议。响应中会出现单独的建议部分，前提是存在关于此指定操作的建议。

如果调用通过验证或审核，则响应会是 {"success": true}。如果调用未通过验证或审核，系统则会返回错误及更多详细信息。

创建广告的示例

curl -X POST \
  -F 'name=Advantage+ Shopping campaign Sample Ad' \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={"name": <NAME>, "object_story_spec": <SPEC>}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/ads

创意字段

如要查看广告创意字段的完整列表，请查看此页面。

字段描述

object_story_spec
AdCreativeObjectStorySpec

可选
如果想要新建公共主页隐藏帖，然后将此帖设为广告，可以使用此字段。公共主页编号和内容，用于新建公共主页隐藏帖。

use_page_actor_override
AdCreative

必要
如果此字段为 true，系统会显示与进阶赋能型智能购物广告系列关联的 Facebook 公共主页。

创建创意的示例

curl -X POST \
  -F 'object_story_spec=<SPEC>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

更新

您可以向 /{ad_id} 发送 POST 请求，从而更新广告。

参数


参数描述

name
字符串

广告的名称

adlabels

list<Object>

与此广告关联的广告标签。

execution_options

list<enum>

默认值：set。其他选项包括：

  • validate_only：如果指定此选项，API 调用不会执行更改，但会按照验证规则对每个字段的值进行验证。
  • synchronous_ad_review：不得单独使用此选项。如果使用此选项，始终都要指定 validate_only。指定这些选项后，API 调用会执行广告诚信验证，包括消息语言检查、图片的文字内容不能超过 20% 的规则以及验证逻辑等项。
  • include_recommendations：不能单独使用此选项。如果使用此选项，要添加广告目标配置的相关建议。响应中会出现单独的建议部分，前提是存在关于此指定操作的建议。

如果调用通过验证或审核，则响应会是 {"success": true}。如果调用未通过验证或审核，系统则会返回错误及更多详细信息。

status
枚举

选项包括：

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

在测试过程中，建议将广告状态设置为 PAUSED，以免产生意外花费。

creative
AdCreative

要用于此广告的广告创意的创意参数。有效字段为 object_story_spec、asset_feed_spec 和 use_page_actor_override，您可以在此页面查看这些字段。您可于此页面阅读关于创意的更多内容


按以下格式提供创意：

{
    "creative": {
      "name": <NAME>, 
      "object_story_spec": <SPEC>,
      "product_set_id": <PRODUCT_SET_ID>
    }
}

更新广告的示例

curl -X POST \
  -F 'name=Advantage+ Shopping campaign Sample Update Ad' \
  -F 'creative={"name": <NAME>, "object_story_spec": <SPEC>}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_ID>

详细了解