市场营销 API

素材定制规则

使用此解决方案来定义您想要在广告中显示的创意素材。创建广告时，您可以根据素材定制规则选择要显示的素材组合。创意素材的示例有图像、视频、文本和广告正文。

我们提供了以下 3 种使用素材定制规则的 API：

  • 版位素材定制：定制在不同广告版位显示的创意素材。
  • 多语言广告：定制广告创意的不同部分（如图像、视频、文本和广告正文等），以便覆盖使用不同语言的受众。
  • 受众细分素材定制：根据定位类型定制广告素材。

所有使用 asset_feed_spec 的广告都必须至少包含 2 条定位定制规则。如果您在创意中使用了 asset_feed_spec，但是其中包含的规则数少于 2 条，那么您将无法创建广告。

入门指南

第 1 步：创建广告系列和广告组

您可以为素材定制规则创建标准广告系列，但有以下限制：

API 支持的广告目标

受众细分素材定制

APP_INSTALLS、BRAND_AWARENESS、CONVERSIONS、LINK_CLICKS、REACH、VIDEO_VIEWS。

版位素材定制

APP_INSTALLS、BRAND_AWARENESS、CONVERSIONS、LEAD_GENERATION、LINK_CLICKS、REACH、VIDEO_VIEWS。

多语言广告

APP_INSTALLS、BRAND_AWARENESS、CONVERSIONS、LINK_CLICKS、REACH、VIDEO_VIEWS。

对于广告组，请使用标准广告组端点，然后将 is_dynamic_creative 设置为 false。

如要在广告系列中创建广告组，并将 optimization_goal 设置为 conversions，请使用以下代码：

curl \
  -F 'status=PAUSED'
  -F 'name=Sample Ad Set'
  -F 'campaign_id=<CAMPAIGN_ID>'
  -F 'optimization_goal=OFFSITE_CONVERSIONS'
  -F 'is_dynamic_creative=false'
  -F 'lifetime_budget=1000'
  -F 'promoted_object={"pixel_id": "<PIXEL_ID>", "custom_event_type": "PURCHASE"}'
  -F 'billing_event=IMPRESSIONS'
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP'
  -F 'targeting={"geo_locations": {"countries": ["US"]}}'
  -F 'start_time=2019-04-02'
  -F 'end_time=2019-04-09'
  -F access_token=<ACCESS_TOKEN>
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets

如要将 asset_feed_spec 和针对 APP_INSTALLS 优化的广告组配合使用，您应该指定 link_url，例如 http://www.abc.com。link_url应与 promoted_object 中的 object_store_url 保持一致。在 asset_feed_spec 中，您应该仅提供 1 个 link_url。

asset_feed_spec 可以为动态素材、版位素材定制、多语言广告和受众细分素材定制提供广告创意。参数格式因解决方案而异。

第 2 步：提供广告创意

通过 asset_feed_spec 提供广告创意。素材信息库由一系列不同的创意元素组成，例如图像、标题和正文等。您可以为每种素材类型指定多个创意素材。

在 /adcreative 中创建 asset_feed_spec。如要应用定制选项，请在 asset_feed_spec 中设置 asset_customization_rules。

设置完成后，验证 asset_feed_spec：

curl -G 
-d "access_token=<ACCESS_TOKEN>"
-d "fields=asset_feed_spec" 
https://graph.facebook.com/<API_VERSION>/<AD_CREATIVE_ID>

创建广告时，请提供对广告创意编号的引用。您可以为每个广告组创建多个广告。

curl 
  -F 'name=Asset Custom Rule Ad' 
  -F 'adset_id=<ADSET_ID>' 
  -F 'access_token=<ACCESS_TOKEN>' 
  -F 'creative={
      "creative_id": <CREATIVE_ID>,
   }' 
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ads

创建后：