市场营销 API

动态素材

通过动态素材，您可以自动向不同的用户投放广告创意的不同组合。动态素材有助您根据展示次数找到最佳创意组合，并了解素材在各类受众中的表现。

此解决方案还可提升您探索各种创意素材组合和受众的能力，以便您能向用户展示最适合的图片、标题、描述和其他素材。

您应将动态素材用于以下目的：

  • 让用于测试创意的工作流程实现自动化
  • 使用不同的受众来了解如何选择效果最佳的创意素材组合

请在新建的广告系列、长期广告系列以及投放期超过 5 天的广告系列中使用此 API。您应对现有广告系列执行拆分对比测试，以找到可以满足您需求的最佳方法。

入门指南

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

您可以为动态素材创建标准广告系列，但有以下 2 条限制：

  • 您的 objective 必须是以下其中一项：OUTCOME_SALES、OUTCOME_ENGAGEMENT、OUTCOME_LEADS、OUTCOME_AWARENESS、OUTCOME_TRAFFIC 或 OUTCOME_APP_PROMOTION。
  • buying_type 必须为默认值（即 AUCTION）或留空。

例如，如要创建 objective 为 CONVERSIONS 的广告系列，请使用以下代码：

curl \
  -F 'name=Dynamic Creative Sample Campaign'
  -F 'objective=OUTCOME_SALES'
  -F 'status=PAUSED'
  -F 'special_ad_categories=<SPECIAL_AD_CATEGORY>'
  -F access_token=<ACCESS_TOKEN>
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns

创建广告系列后，使用标准广告组端点创建广告组。

  • 您可以使用 billing_event、targeting 和 promoted_object 这三个参数，但前提是这些参数与父级广告系列的 objective 兼容。
  • 对于 OUTCOME_SALES、OUTCOME_ENGAGEMENT、OUTCOME_LEADS 和 OUTCOME_TRAFFIC 目标，您必须将 optimization_goal 设为 OFFSITE_CONVERSIONS，
  • 然后将 is_dynamic_creative 设置为 true。

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

curl \
  -F 'status=PAUSED'
  -F 'name=Dynamic Creative Ad Set'
  -F 'campaign_id=<CAMPAIGN_ID>'
  -F 'optimization_goal=OFFSITE_CONVERSIONS'
  -F 'is_dynamic_creative=true'
  -F 'lifetime_budget=5000'
  -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=2024-04-09'
  -F 'end_time=2024-04-20'
  -F access_token=<ACCESS_TOKEN>
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets

系统将返回新的广告组编号：

{"id":"23842500259260001"}

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

curl 
-F "name=Dynamic Creative AdSet"
-F "campaign_id=CAMPAIGN_ID"
-F "optimization_goal=APP_INSTALLS"
-F 'is_dynamic_creative=true'
-F "billing_event=IMPRESSIONS"
-F "is_autobid=true"
-F "promoted_object={'object_store_url':'https://itunes.apple.com/us/app/facebook/id284882215','application_id':ADVERTISED_APP_ID}"  // object_store_url must match what is provided in asset feed's link_urls 
-F "lifetime_budget=20000"
-F "end_time=1461974400"
-F "targeting={
     'geo_locations':{'countries':['US']},
     'age_min':18,
     'age_max':24,
     'publisher_platforms':['facebook', 'audience_network'],
     'user_os':['ios']
   }"
-F "access_token=ACCESS_TOKEN" 
https://graph.facebook.com/<API_VERSION>/act_AD_ACCOUNT_ID/adsets

第 2 步：通过 asset_feed_spec 提供广告创意

通过 asset_feed_spec 字段（也称为“素材信息库”）提供创意。在此字段中，您可以为每种素材类型指定多个创意素材。部分素材类型示例包括图片、视频、标题和链接描述。请参阅下方内容：

请注意，您可能还需要设置 page_id 和 instagram_actor_id。

只有市场营销 API v3.1 和更早版本支持 asset_feed_id。您应该改为使用 asset_feed_spec。

图片裁剪

动态素材支持图片裁剪。请在图片参数中指定图片裁剪参数。您只能为每张图片提供一个裁剪参数。我们会将您的裁剪参数应用到图片的所有版位。请参阅市场营销 API > 图片裁剪。

此时，您的广告组必须为空。创建广告时，请提供对创意编号的引用。您只能为每个广告组创建一则广告。但您可以新建其他广告组，然后在其中创建更多动态素材广告。

curl 
  -F 'name=Dynamic Creative 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

创建广告后：

为动态素材创建广告后，您不能将该广告删除或归档。如要执行这些操作，您应该改为删除或归档父级广告组。

动态素材支持除 Messenger 上的 sponsored_messages 外的所有其他版位。

轮播广告

动态素材可以采用轮播广告格式，投放最佳的素材组合。如果您信息库中图片的数量不超过 10 张，则轮播图卡数量将与图片数量相同。如果您使用的图片超过 10 张，我们会显示包含 10 张图卡的轮播广告。我们建议采用方形图片。

如果使用包含动态素材的轮播广告，您不能使用以下轮播广告功能：

  • BODY_LABEL
  • CALL_TO_ACTION_TYPE_LABEL
  • LINK_URL_LABEL
  • CAPTION_LABEL
  • AD_FORMAT_LABEL

在素材成效分析细分数据中，我们会将所有图卡卡内素材的基于展示次数指标汇总到第一张图卡的素材中。卡内素材包括图片、标题和描述

如需背景信息，请参阅轮播广告。

（可选）第 4 步：检查审核状态

创建广告系列、广告组和广告后，请检查广告审核状态：

curl -G 
-d "access_token=<ACCESS_TOKEN>" 
-d 'fields=review_feedback' 
https://graph.facebook.com/<API_VERSION>/<ADSET_ID>

审核结果会包括广告审核反馈。如果数组为空，则表示您的广告已通过审核：

{
  "review_feedback":"[]",
  "id":"<ADSET_ID>"
}

如果广告未通过审核，您会看到以下代码：

{
  "review_feedback": {
    {"id":23842500258220001,"text":"Body 1","reason":["ALCOHOL"]},
    {"id":23842500258160001,"text":"Title 1","reason":["ALCOHOL"]},
    {"id":23842500258170001,"text":"Title 2","reason":["ALCOHOL"]}
  }",
  "id": "<AD_ID>"  
}