精品栏广告

精品栏广告格式包括即时体验，用户能够借助由视觉手段打造的沉浸式体验，更轻松地通过移动设备发现、浏览和购买商品及服务。您动态中的广告会在主图或主视频下方展示三款商品，在用户与其互动时开启全屏即时体验。精品栏广告分为两类：图片广告和视频广告。

凡提及“全屏广告”处皆可视为代表即时体验，因为“全屏广告”是这一格式的旧称。

您可以通过构建即时体验来创建采用精品栏格式的广告。开始创建时，可选用模板或选择自定义布局。详情请参阅广告帮助中心 > 即时体验。

您也可以使用 JavaScript SDK 创建精品栏广告对话框，将 Facebook 精品栏格式的广告创建用户界面添加到您的网站中。

有关使用精品栏广告的一般信息，请参阅：

如需创建店铺中使用的精品栏广告，或向商品系列添加元数据，请参阅电子商务平台 > 商品系列精品栏 API。

For API calls, your AD_ACCOUNT_ID should be formatted as act_XXXXXXXXXXXXXXX.

支持的目标和版位

您可以结合以下目标使用精品栏广告：

流量
转化量
目录商品销量（在您将精品栏广告和商品系列结合使用时受支持。）
店铺访问量（在您将精品栏广告和商品系列结合使用时受支持。）
品牌知名度
覆盖人数

对于流量和转化量目标，您还可以使用幻灯片视频。如需获取更多信息，请参阅 Business 帮助中心：选择合适的广告目标。

支持以下版位：

Facebook 动态
Facebook Reels
Instagram 动态（请参阅即时体验：即时体验与 Instagram 广告。）
Instagram 快拍（请参阅即时体验：即时体验与 Instagram 广告。）

如需获取更多版位信息，请参阅 Business 帮助中心：版位简介和 Business 帮助中心：各个营销目标可用的广告版位。

根据商品系列创建精品栏广告

创建精品栏广告前，您需要提供广告创意和即时体验。您必须至少提供四个用以轮流显示的元素，这些元素可以代表照片，也可以代表附有商品标记的商品。轮播广告元素中的子照片元素也有效。

根据目录创建精品栏广告。精品栏广告在主图片/主视频下方展示三款商品，并会在移动端动态中显示。此功能支持使用幻灯片视频。

广告会显示在动态中，用户可轻触广告进入全屏体验并查看更多内容。

如要使用商品系列，您应熟悉进阶赋能型目录广告并提前设置商品目录。详情请参阅进阶赋能型目录广告和进阶赋能型目录广告 > 商品目录。

创建广告

根据商品系列创建精品栏广告时，您还必须明确创建一个包含正确元素的即时体验。当您将此即时体验用于精品栏广告时，Facebook 会自动生成精品栏广告。您的即时体验应包含：

图像，即全屏广告照片、全屏广告视频或全屏广告模板视频。
show_in_feed 设置为 true 的商品系列。（请参阅参考文档 > 全屏广告商品系列。）
页脚（请参阅参考文档 > 全屏广告页脚。）

即时体验图像

使用图片创建即时体验：

curl \
  -F 'canvas_photo={ 
    "photo_id": "PHOTO_ID", 
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements

或使用视频创建即时体验：

curl \
  -F 'canvas_video={ 
    "video_id": "VIDEO_ID", 
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements

或使用模板视频创建即时体验：

curl -X POST \
  -F canvas_template_video={
      "name": "Cover Image or Video",
	"bottom_padding": "0",
	"top_padding": "0",
	"product_set_id": <Product_Set_ID>,
	"template_video_spec": {
	    "customization": {
	        "text_color": "FFFFFF",
	        "text_background_color": "000000",
		  "name_template": "{{product.name}}",
		  "body_template": "{{product.current_price strip_zeros}}"
	    },
	}
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<PAGE_ID>/canvas_elements

即时体验商品系列

然后创建 canvas_product_set，其中包含商品目录中的 product_set_id。您必须将 show_in_feed 设置为 true，才能创建精品栏广告。

curl \
  -F 'canvas_product_set={ 
    "max_items": 50,
    "product_set_id": "<PRODUCT_SET_ID>",
    "item_headline": "{{product.name}}",
    "item_description": "{{product.current_price}}"
    "image_overlay_spec": {
      "overlay_template": "pill_with_text",
      "text_type": "price",
      "text_font": "dynads_hybrid_bold",
      "position": "top_left",
      "theme_color": "background_e50900_text_ffffff",
      "float_with_margin": true,
    },
    "storefront_setting": {
        "enable_sections": true,
        "customized_section_titles": [
            { "title_id": "popular", "customized_title": "My Populars" },
            { "title_id": "favorites", "customized_title": "My Favorites" }
        ],
        "product_set_layout": {
            "layout_type": "GRID_3COL"
        }
    },
    "retailer_item_ids": [0, 0, 0],
    "show_in_feed": true
  }' \
  https://graph.facebook.com/v19.0/<PAGE_ID>/canvas_elements

注意：在上述示例中，item_headline、item_description、image_overlay_spec、storefront_setting 和 retailer_item_ids 均为可选字段。以前，您可以在同一次调用中提供这些字段，以创建精品栏广告和基本的即时体验素材。现在您可以在此调用中提供这些字段。

在 image_overlay_spec 参数里提供所有必要字段。详情请参阅市场营销 API > 参考文档 > 广告创意链接数据图片叠加参数。

storefront_setting 参数支持 product_set_layout、enable_sections 和 customized_section_titles 字段。

`product_set_layout` 字段

名称	描述
`layout_type` 字符串	必要。商品系列的显示方式。值：`GRID_2COL`、`GRID_3COL`、`CAROUSEL`、`HSCROLL_LIST`

如要使用 customized_section_titles，必须将 enable_sections 设置为 true。customized_section_titles 字段要求提供一个对象数组，每个对象都应包含 title_id 和 customized_title 参数。

`customized_section_titles` 字段

名称	描述
`title_id` 字符串	必要。枚举字符串，表示您想替换掉的默认版块标题字符串。值：`keep_shopping`、`take_another_look`、`you_may_also_like`、`related_products`、`trending`、`popular`、`top_items`、`favorites`、`most_viewed`、`top_picks_for_you`、`suggested_for_you`、`featured_favorites`、`just_for_you`、`explore_more`、`shop_by_category`
`customized_title` 字符串	必要。备选自定义字符串，观众看到的应该是版块标题。

即时体验页脚

创建附有链接的即时体验页脚。

curl \
  -F 'canvas_button={ 
    "rich_text": {
      "plain_text": "See more at www.abc.com."
    },
    "open_url_action": {
      "url": "https://www.abc.com"
    }
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements

如有需要，您也可以创建一个按钮，并在之后将其用于页脚中。

curl \
  -F 'canvas_footer={ 
    "child_elements": [BUTTON_ELEMENT_ID]
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements

为页脚提供的文本相对灵活，以前您需要提供 See more....，但是现在可以使用按钮 URL 提供自定义文本。

完整的即时体验

curl \
  -F 'body_element_ids=[
    PHOTO/VIDEO_ELEMENT_ID,
    PRODUCT_SET_ELEMENT_ID,
    FOOTER_ELEMENT_ID
  ]' \
  -F 'is_published=true' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvases

如要使用您设置的模板视频、商品系列、按钮、店铺位置和可选页脚创建即时体验，您需要加入 source_template_id 参数：

curl \
  -F 'body_element_ids=[
    TEMPLATE_VIDEO_ELEMENT_ID,
    PRODUCT_SET_ELEMENT_ID,
    FOOTER_ELEMENT_ID
  ]' \
  -F 'name="Dynamic Video Instant Experience"', \
  -F 'source_template_id="1932289657009030"', \
  -F 'is_published=true' \
  https://graph.facebook.com/v19.0/<PAGE_ID\/canvases

对于店面模板，您需要指定 source_template_id = 1932289657009030（详见即时体验 > 使用模板中的定义）。虽然每个模板的布局都是固定的，但您可以将默认内容替换为自己的动态视频、商品、文本和链接。详情请参阅即时体验 > 使用模板。

使用即时体验创建精品栏广告

最后，您需要创建一条精品栏广告。这样一来，用户便可点击精品栏广告的图片或视频元素。

如果即时体验的第一个元素是照片，则您必须将 object_type 设置为 SHARE。

curl \
  -F 'name=Collection Sample Image Creative' \
  -F 'object_story_spec={ 
    "link_data": { 
      "link": "https://fb.com/canvas_doc/CANVAS_ID", 
      "message": "AD_MESSAGE",
      "name": "AD_HEADLINE", 
    }, 
    "page_id": "PAGE_ID" 
  }' \
  -F 'object_type=SHARE' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

如果即时体验的第一个元素是视频，则需发出如下请求：

curl \
  -F 'name=Collection Sample Video Creative' \
  -F 'object_story_spec={ 
    "video_data": {
      "call_to_action": {
        "type":"LEARN_MORE",
        "value":{
          "link":"https://fb.com/canvas_doc/CANVAS_ID",
        }
      },
      "image_url": "THUMBNAIL_IMAGE_URL",
      "message": "AD_MESSAGE",
      "title": "AD_HEADLINE", 
    }, 
    "page_id": "PAGE_ID" 
  }' \
  -F 'object_type=VIDEO' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

如果即时体验的第一个元素是模板视频，则需发出如下请求：

curl -X POST \
  -F 'name="Dynamic Video Collection Ad"' \
  -F 'adset_id=<ADSET_ID>' \
  -F 'status=PAUSED \
  -F 'creative={
       "object_story_spec": {
         "instagram_actor_id": "<INSTAGRAM_PAGE_ID>",
         "page_id": "<MAIN_PAGE_ID>",
         "template_data":{
           "call_to_action":{
             "type":"LEARN_MORE"
           },
           "format_option":"collection_video",
           "link":"https://fb.com/canvas_doc/CANVAS_ID",   
           "name":"Test Dynamic Ads with dynamic video",
           "retailer_item_ids":[
             "0",
             "0",
             "0",
             "0"
           ]
         }
       },
       "object_type": "SHARE",
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/ads

广告预览

如果您拥有广告预览功能，可提供 ad_format 和用户访问口令，以便根据您的广告或广告创意生成预览。

curl -X GET \
  -d 'ad_format="MOBILE_FEED_STANDARD"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<CREATIVE_ID>/previews

注意：对于模板视频即时体验广告，支持的格式如下：BIZ_DISCO_FEED_MOBILE、GROUPS_MOBILE、MOBILE_FEED_STANDARD、SUGGESTED_VIDEO_DESKTOP、SUGGESTED_VIDEO_MOBILE、WATCH_FEED_MOBILE。

详情请参阅广告预览。

标准精品栏广告

您可以使用模板针对特定的业务目标快速创建即时体验。虽然每个模板的布局都是固定的，但您可以将默认内容替换为自己的图片、视频、商品、文本和链接。详情请参阅即时体验 > 使用模板。

即时体验精品栏广告分为图片广告和视频广告两个类型，具体取决于您提供的素材。将广告创意准备就绪后，即可创建广告。

创建图片广告

curl 
  -F 'name=Instant Experiences Collection Sample Image Creative' 
  -F 'object_story_spec={ 
    "link_data": {
      "link": "https://fb.com/canvas_doc/ELIGIBLE_CANVAS_ID", 
      "message": "Ad message", 
      "name": "name", 
      "picture": "IMAGE_URL", 
      "collection_thumbnails": [
        {"element_crops": {"100x100": [[0, 0], [100, 100]]},"element_id": "PHOTO_ELEMENT_WITH_PRODUCT_TAGS_ID",},
        {"element_child_index": 0,"element_id": "",},
        {"element_child_index": 1,"element_id": "PRODUCT_LIST_ELEMENT_ID",},
      ],
    }, 
    "page_id": "PAGE_ID" 
  }' 
  -F 'access_token=ACCESS_TOKEN' 
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

创建视频广告

curl 
  -F 'name=Instant Experiences Collection Sample Video Creative' 
  -F 'object_story_spec={ 
    "page_id": "PAGE_ID", 
    "video_data": { 
      "call_to_action": {"type":"LEARN_MORE","value":{"link":"https://fb.com/canvas_doc/ELIGIBLE_CANVAS_ID"}}, 
      "image_url": "IMAGE_URL",
      "collection_thumbnails": [
        {"element_crops": {"100x100": [[0, 0], [100, 100]]},"element_id": "PHOTO_ELEMENT_NO_PRODUCT_TAGS_ID",},
        {"element_child_index": 0,"element_id": "PHOTO_ELEMENT_WITH_PRODUCT_TAGS_ID",},
        {"element_child_index": 1,"element_id": "PRODUCT_LIST_ELEMENT_ID",},
      ],
      "title": "My title", 
      "video_id": "VIDEO_ID" 
    } 
  }' 
  -F 'access_token=ACCESS_TOKEN' 
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

参数

名称	描述
`link` 字符串	必要将观众重定向到即时体验。
`collection_thumbnails` 数组	必要一组缩略图。需要四个缩略图。

`collection_thumbnails` 字段

名称	描述
`element_id` 数字字符串	必要全屏广告照片元素编号，或商品列表元素编号。全屏广告照片需要关联至附加到此精品栏广告的即时体验。用户点击广告后，即时体验会显示与此编号关联的图片。主图片元素编号无效。
`element_child_index` 整数	对于包含商品标记和商品列表元素的照片元素为必要项商品索引，来自一组带有商品标记的照片元素编号，或来自一组包含商品列表元素的 `product_id_list`。注意：必须为正整数。
`element_crops` AdsImageCrops	对于照片元素为必要项定义指定图片裁剪尺寸的 JSON 对象。仅允许使用 `100x100` 裁剪键。

创建互动受众

您可以将曾与精品栏广告互动的用户自动创建为受众，这与标准即时体验的互动受众类似。详情请参阅即时体验 > 互动受众。

将全屏展示即时体验广告的受众定位为曾点击过精品栏广告的用户，我们将此类受众称为全屏体验互动受众。如要创建此类受众，您需先创建自定义受众，然后将 object_id 设置为 CANVAS_ID，再设置一个用于追踪其中一类事件的规则。

将曾打开过即时体验的用户创建为一组受众

curl \
    -F 'name=Collection Engagement Audience' 
    -F 'description=People who opened this Instant Experience' 
    -F 'rule=[{"object_id":"CANVAS_ID","event_name":"instant_shopping_document_open"}]' 
    -F 'access_token=ACCESS_TOKEN' 
https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/customaudiences

将曾点击过精品栏广告的用户创建为一组受众

curl \
    -F 'name=Collection Engagement Audience' 
    -F 'description=People who clicked any links in this Instant Experience' 
    -F 'rule=[{"object_id":"CANVAS_ID","event_name":"instant_shopping_element_click"}]'
    -F 'access_token=ACCESS_TOKEN' 
https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/customaudiences

精品栏广告对话框

精品栏广告基于包含模板的即时体验而创建。因此，如要使用对话框创建精品栏广告，您需要使用带有额外参数的即时体验对话框。此对话框会在您的网站中提供 Facebook 精品栏广告创建的用户界面流程。如需详细了解用户界面组件，请参阅对话框。

如要设置 Javascript 版 Facebook SDK，请参阅：

JavaScript SDK 要求已登录的用户具备必要权限，才能创建即时体验。如果用户不具备为提供广告的公共主页和公司创建即时体验的必要权限，则对话框会显示错误。用户还必须具备访问商品目录和商品系列的权限。为确保不会出错，用户必须具有访问商务管理平台的权限，且需具备为公共主页创建广告的权限。

然后，您可以触发精品栏广告对话框。

FB.ui({         
  display: 'popup',
  method: 'instant_experiences_builder',
  account_id: 'AD_ACCOUNT_ID'.
  business_id: 'BUSINESS_ID',
  page_id: 'PAGE_ID',
  template_id: 'TEMPLATE_ID'
}, function(response) {
  // callback
});

可为插件提供以下设置：

名称	描述
`display`	必要此为必要参数，且设定值为 `popup`。
`method`	必要此为必要参数，且设定值为 `instant_experiences_builder`。
`account_id`	必要您的广告帐户编号。
`business_id`	必要您的公司编号。
`page_id`	必要您想将即时体验与之关联的公共主页编号。
`template_id`	必要您想使用的模板编号。
`product_catalog_id`	可选要在精品栏中使用的商品目录编号。若已给定 `product_set_id`，则此为必要字段。
`product_set_id`	可选要在精品栏中使用的商品系列编号。

可在即时体验：使用模板中找到所有有效的模板类型和相应的编号。

product_catalog_id 和 product_set_id 参数为可选项，但如果您提供 product_set_id，则还需提供 product_catalog_id。在您提供这些编号后，用户将无法在用户界面中更改精品栏。如果两个参数均未提供，则用户可以在用户界面中选择目录和商品系列。如要预览精品栏广告，建议您使用即时体验预览对话框。

操作成功后，此插件会作出如下响应：


{
  "success": true,
  "id": "CANVAS_ID"
}

返回的 id 将是未发布的即时体验。发布后，方可将其用于广告系列中。

若无响应或返回 undefined 响应，则表示用户未完成即时体验就已关闭对话框，或者用户可能已保存即时体验，但尚未完成。您可以使用图谱 API 查询属于某个公共主页的所有即时体验，以查看是否有任何未完成的即时体验。

添加目的地目录

您可以在精品栏广告的主图片中显示目的地目录的广告创意，也可以显示包含该目的地酒店图片的轮播广告。为此，您必须提供在主图片上显示的备选图片，以便我们在找不到与轮播广告中的酒店对应的任何目的地时使用。详情请参阅目的地目录。

请注意以下限制：

不支持视频素材。
我们仅支持展示目的地和酒店目录图片的组合。
我们不支持展示其他目录组合。

如要使用这项功能，请在创建 canvas_photo 元素时添加 destination_set_id 参数，然后按照其他标准步骤创建即时体验和精品栏广告。

示例

curl \
  -F 'canvas_photo={ 
    "photo_id": "PHOTO_ID", 
    "destination_set_id": "DESTINATION_SET_ID",
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements