Tài liệu này đã được cập nhật.
Bản dịch sang Tiếng Việt chưa hoàn tất.
Cập nhật bằng tiếng Anh: 30 tháng 4

File phương tiện động

Với file phương tiện động, nhà quảng cáo có thể phân phối tài sản video thuộc danh mục của họ trong quảng cáo danh mục Advantage+.

Trước khi bạn bắt đầu

Bạn sẽ cần có:

  • Danh mục sản phẩm chứa các sản phẩm hiện có
  • Video cho từng món sản phẩm ở định dạng URL video có thể tải xuống

Hãy xem tài liệu về quảng cáo danh mục Advantage+ để tìm hiểu thêm về cách hoạt động.

Giới hạn

  • Hiện tại, tính năng này có thể hỗ trợ video cho tối đa 30.000 sản phẩm trong mỗi danh mục.
  • Bạn nên sử dụng tối thiểu 20 sản phẩm, nhưng không bắt buộc.
  • Kích thước của mỗi video không được vượt quá 200MB. Không hạn chế độ dài.
  • Video phải ở một trong những định dạng sau đây: 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 hoặc wmv.

Thêm video vào danh mục

Bạn có thể thêm video cho các món sản phẩm trong danh mục của mình theo 3 cách: file nguồn cấp dữ liệu danh mục, API loạt danh mục và tải lên thủ công qua Công cụ quản lý thương mại.

Thêm video bằng file nguồn cấp dữ liệu danh mục

Khi sử dụng file nguồn cấp dữ liệu danh mục, bạn có thể cung cấp tối đa 30.000 sản phẩm có URL video ở cấp độ sản phẩm.

Bước 1. Chuẩn bị file nguồn cấp dữ liệu danh mục

Bạn có thể triển khai file nguồn cấp dữ liệu danh mục của mình theo một trong những quy trình sau đây.

  • Quy trình 1: Thay đổi nguồn cấp dữ liệu chính
    • Thêm cột video[0].url vào file nguồn cấp dữ liệu danh mục hiện có của bạn, chỉ điền URL video cho những sản phẩm đã chọn và để trống đối với các hàng sản phẩm khác.
    • Bạn có thể thêm video khác cho cùng một sản phẩm bằng cột khác: video[1].url, video[2].url, video[3].url, v.v.
  • Quy trình 2: Nguồn cấp dữ liệu bổ sung
    Chuẩn bị file nguồn cấp dữ liệu danh mục bổ sung để thêm vào quá trình tải lên nguồn cấp dữ liệu hiện có. Nguồn cấp dữ liệu bổ sung này chỉ có thể thêm hoặc thay thế video cho các món sản phẩm đã có. Hãy thêm cột video[0].url và cột ID để liên kết video với ID món sản phẩm.

Không bắt buộc:
Thay vì sử dụng cột video[0].url, bạn có thể tạo một cột có tên là video và thêm thẻ cho video đó. Nếu chọn sử dụng cột thẻ cho bộ lọc nhóm sản phẩm, bạn cũng cần thêm cột này vào file nguồn cấp dữ liệu.

Ví dụ về định dạng cột video:
[{"url": "http://www.jaspersmarket.com/video-file.avi", tag: ["Optional Tag1", "Optional Tag2"]}]

Đối với nguồn cấp dữ liệu XML, bạn có thể thêm URL video bằng thẻ <video> như sau:

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

Thêm video bằng API loạt danh mục

Bạn có thể cập nhật món sản phẩm bằng điểm cuối /{product_catalog_id}/items_batch. Bạn có thể thực hiện lệnh gọi API POST có trường video. Trường này là mảng URL.

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"
          }
        ]
      }
    }
  ]
}

Hãy xem ví dụ này trong Trình khám phá API Đồ thị.

Tạo quảng cáo bằng file phương tiện động

Khi tạo quảng cáo, bạn có thể tận dụng video trong danh mục theo 2 cách:

  • Loại file phương tiện động
  • Hiển thị video khi có sẵn (chỉ áp dụng cho định dạng một video)

Lưu ý: Cách chọn loại file phương tiện động bằng API tương tự như cách chọn tùy chọn File phương tiện động trong Trình quản lý quảng cáo.

Quảng cáo loại file phương tiện động (khuyên dùng)

Khi tạo đối tượng nội dung quảng cáo bằng điểm cuối act_<AD_ACCOUNT_ID>/adcreatives

  • đặt khóa media_type_automationOPT_IN.
  • Cách này chỉ áp dụng cho định dạng Thẻ quay vòng và Bộ sưu tập
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

Hoặc khi tạo đối tượng quảng cáo bằng điểm cuối act_<AD_ACCOUNT_ID>/ads, hãy đặt khóa media_type_automationOPT_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

Quảng cáo file phương tiện động (Hiển thị video khi có sẵn)

Trong object_story_spec, hãy thay đổi format_option thành single_video. Cách này chỉ áp dụng cho định dạng một hình ảnh/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