动态素材

动态素材允许广告主在进阶赋能型目录广告中投放目录中的视频素材。

前期准备

您需要提供：

现有商品的商品目录
每个商品以可下载的视频网址格式提供的视频

要详细了解它们如何运作，请查看进阶赋能型目录广告文档。

限制

目前，这项功能可以支持每个目录多达 30,000 件商品的视频。
我们建议至少 20 种产品，但没有最低数据要求。
每个视频大小不得超过 200MB。没有时间限制。
视频必须以下列格式之一提供：3g2、3gp、3gpp、asf、avi、dat、divx、dv、f4v、flv、gif、m2ts、m4v、mkv、mod、mov、mp4、mpe、mpeg、mpeg4、mpg、mts、nsv、ogm、ogv、qt、tod、ts、vob 或 wmv。

向目录添加视频

有 3 种方法可以将视频添加到目录中的商品：目录信息库文件、目录批处理 API、以及通过电商管理工具手动上传。

通过目录信息库文件添加视频

使用目录信息库文件，您可以提供不超过 30,000 件商品和商品层级视频网址。

第 1 步：准备目录信息库文件

您可以使用以下其中一种方法来生成目录信息库文件。

方法 1：更改主信息库
- 添加 video[0].url 列到现有目录信息库文件，将视频网址填充到选中的商品，然后为其他产品行留空。
- 同一产品的额外视频可以添加附加列：video[1].url、video[2].url、video[3].url 等，依此类推
方法 2：补充信息库
准备一个补充目录信息库文件来补充现有的信息库上传。这个补充信息库只能添加或替换现有商品的视频。添加一个 video[0].url 列和一个 ID 列，将视频与商品编号关联。

可选：
您可以创建一个名为 video 的列并向视频添加标记，而不添加 video[0].url。如果选择为商品系列筛选器使用标记列，您还需要把这个列添加到信息库文件中。

示例视频列格式：
[{"url": "http://www.jaspersmarket.com/video-file.avi", tag: ["Optional Tag1", "Optional Tag2"]}]

对于 XML 信息库，视频网址可以使用 <video> 标签添加，如：

<video><url>https://{URL1}</url><tag>video_product_set1</tag></video><video><url>https://{URL2}</url><tag>video_product_set1</tag></video>

使用目录批处理 API 添加视频

支持使用/{product_catalog_id}/items_batch端点来更新商品。您可以使用video 字段进行 POST API 调用，该字段是网址构成的数组。

curl \
  -d @body.json \
  -H "Content-Type: application/json"

> cat body.json
{
  "access_token": "<ACCESS_TOKEN>",
  "item_type": "PRODUCT_ITEM",
  "requests": [
    {
      "method": "CREATE",
      "data": {
        "id": "retailer-2",
        "availability": "in stock",
        "brand": "BrandName",
        "google_product_category": "t-shirts",
        "description": "product description",
        "image_link": "http://www.images.example.com/t-shirts/1.png",
        "title": "product name",
        "price": "10.00 USD",
        "shipping": [
          {
            "shipping_country": "US",
            "shipping_region": "CA",
            "shipping_service": "service",
            "shipping_price_value": "10",
            "shipping_price_currency": "USD"
          }
        ],
        "condition": "new",
        "link": "http://www.images.example.com/t-shirts/1.png",
        "item_group_id": "product-group-1",
        "video": [
          {
            "url": "https://yourvideo.com/demo.mp4?q=1411"
          },
          {
            "url": "https://yourvideo.com/demo.mp4?q=1421"
          }
        ]
      }
    },
    {
      "method": "UPDATE",
      "data": {
        "availability": "out of stock",
        "id": "retailer-3",
        "video": [
          {
            "url": "https://yourvideo.com/demo.mp4?q=1411"
          },
          {
            "url": "https://yourvideo.com/demo.mp4?q=1421"
          }
        ]
      }
    }
  ]
}

在图谱 API 探索工具中查看示例。

使用动态素材创建广告

创建广告时，有两种类型的选项来利用目录中的视频：

动态素材类型（轮播/精品栏）（推荐）
可用时显示视频（仅适用于单一视频格式）

注意：用 API 选择动态素材类型类似于在广告管理工具中选择动态素材选项。

动态素材类型广告

使用 act_<AD_ACCOUNT_ID>/adcreatives 端点创建广告创意对象时

将 media_type_automation 键设为 OPT_IN。
这个键适用于轮播和精品栏格式。

curl \
-F 'name=Dynamic Media Ad Creative' \
-F 'object_story_spec={
    ...
  }' \
-F 'degrees_of_freedom_spec={
    "creative_features_spec": {
      "media_type_automation": {
        "enroll_status": "OPT_IN"
      }
    }
  }' \
-F 'product_set_id=<PRODUCT_SET_ID>' \
https://graph.facebook.com/v18.0/act_<AD_ACCOUNT_ID>/adcreatives

或者使用 act_<AD_ACCOUNT_ID>/ads 端点创建广告目标时，将 media_type_automation 键设为 OPT_IN。

curl \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={
    "name": "Dynamic Media Ad Creative",
    "object_story_spec": {
      ...
    },
    "degrees_of_freedom_spec": {
      "creative_features_spec": {
        "media_type_automation": {
          "enroll_status": "OPT_IN"
        }
      }
    },
    "product_set_id": "<PRODUCT_SET_ID>"
  }' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/ads

动态素材广告（精品栏格式）

动态素材只取代主素材。点击前体验和即时体验中的产品缩略图将始终是图片。
如果选择使用动态素材，并且如果产品视频可用，我们将用产品视频取代动态视频主素材。
只有在选择使用动态素材时，此类素材才会取代动态视频主素材。目前，静态主图像和视频不会被产品视频取代，即图像幻灯片体验将被产品视频取代。

示例：含动态素材的精品栏的创意

curl \
-F 'name=Dynamic Media Ad Creative' \
-F 'object_story_spec={
      "template_data": {
          ...
          "format_option": "collection_video",
          "link": "https://fb.com/canvas_doc/<CANVAS_ID>",
          "message": "Your Collection Ad",
          ...
    }
  }' \
-F 'degrees_of_freedom_spec={
    "creative_features_spec": {
      "media_type_automation": {
        "enroll_status": "OPT_IN"
      }
    }
  }' \
-F 'product_set_id=<PRODUCT_SET_ID>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

动态素材广告（可用时显示视频）

在 object_story_spec 中，将 format_option 更改为 single_video。这只适用于单一图片/视频格式。

curl \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={
    "name": "Dynamic Media Ad Creative",
    "object_story_spec": {
      "page_id": "<PAGE_ID>",
      "template_data": {
        ...
        "format_option": "single_video",
        ...
      }
    },
    "product_set_id": "<PRODUCT_SET_ID>"
    }' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/ads