Media Dinamis

Media dinamis memungkinkan pengiklan menayangkan aset video dari katalog mereka di iklan katalog Advantage+ mereka.

Sebelum Memulai

Anda akan memerlukan:

• Katalog produk dengan produk yang sudah ada
• Sebuah video untuk setiap item produk dalam format URL video yang bisa diunduh

Lihat Dokumentasi iklan katalog Advantage+ untuk mempelajari selengkapnya tentang cara kerjanya.

Batasan

• Kami merekomendasikan minimal 20 produk, tetapi tidak ada persyaratan minimum.
• Setiap ukuran video tidak boleh melebihi 200MB. Tidak ada batasan panjang.
• Video harus dalam salah satu format berikut: 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, atau wmv.
• video_fetch_status bisa ditampilkan sebagai NO_STATUS hingga video digunakan dalam iklan atau peristiwa lain yang mengharuskan video dipicu.

Menambahkan Video ke Katalog Anda

Ada 3 cara untuk menambahkan video ke item produk di katalog Anda: file kabar katalog, API batch katalog, dan unggah manual melalui Commerce Manager Anda.

Menambahkan video dengan file kabar katalog

Langkah 1. Menyiapkan File Kabar Katalog Anda

Anda bisa menggunakan salah satu proses berikut untuk mengimplementasikan file kabar katalog Anda.

• Proses 1: Ubah kabar utama

  • Tambahkan kolom video[0].url ke file kabar katalog yang ada, isi URL video hanya untuk produk yang dipilih, dan biarkan baris produk lainnya kosong.
  • Video tambahan untuk produk yang sama bisa ditambahkan dengan kolom tambahan: video[1].url, video[2].url, video[3].url, dll.
  • Tanda bisa ditambahkan ke video dengan memasukkan tanda di kolom terpisah. Contoh: video[0].tag[0], video[0].tag[1], video[1].tag[0], dan seterusnya.
• Proses 2: Kabar tambahan
  Siapkan file kabar katalog tambahan untuk melengkapi unggahan kabar yang sudah ada. Kabar tambahan ini hanya bisa menambah atau mengganti video pada item produk yang sudah ada. Tambahkan kolom video[0].url dan kolom ID untuk mengaitkan video dengan ID item produk.

Opsional:
Daripada menggunakan kolom video[0].url, Anda bisa membuat kolom bernama video dan menambahkan tanda ke video. Kolom video bisa berisi beberapa URL video per produk dan beberapa tanda per URL yang dikodekan dalam format JSON. Jika Anda memilih untuk menggunakan kolom tanda untuk filter set produk, Anda juga perlu menambahkan kolom ini ke file kabar.

Untuk kabar XML, URL video bisa ditambahkan menggunakan tanda <video> seperti:

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

Data video kueri dari produk item API

Kolom videos, videos_metadata, dan video_fetch_status tersedia di API katalog untuk mengambil detail video produk katalog.

curl -i GET \ "http://graph.facebook.com/v25.0/<PRODUCT_ITEM_ID>?fields=videos,videos_metadata,video_fetch_status"

Untuk informasi selengkapnya tentang video, lihat detail Item Produk.

Tambahkan video dengan API batch katalog

Pembaruan pada item produk didukung menggunakan /{product_catalog_id}/items_batch endpoint. Anda bisa melakukan panggilan API POST dengan kolom video, yang merupakan array 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": "http://www.jaspersmarket-example1.com/video-file.avi", "tag": ["Optional Tag1", "Optional Tag2"]}, 
          {"url": "http://www.jaspersmarket-example2.com/video-file.avi", "tag": ["Optional Tag1", "Optional Tag2"]}
        ]
      }
    },
    {
      "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"
          }
        ]
      }
    }
  ]
}

Lihat contoh ini di Graph API Explorer.

Membuat Iklan dengan Media Dinamis

Saat membuat iklan, ada tiga jenis opsi yang memanfaatkan video dari katalog:

• Media dinamis carousel/koleksi (direkomendasikan)
• Tampilkan video bila tersedia (hanya tersedia untuk format video tunggal)
• Gambar tunggal dipilih ke dalam media dinamis

Catatan: Memilih jenis media dinamis dengan API mirip dengan memilih opsi Media Dinamis di Pengelola Iklan. Dengan perubahan yang dimulai pada September 2025, iklan katalog Advantage+ akan dipilih menggunakan media dinamis secara default.

Iklan jenis media dinamis

Saat membuat objek materi iklan dengan endpoint act_<AD_ACCOUNT_ID>/adcreatives

• Mulai September 2025, iklan katalog Advantage+ akan mulai menayangkan video produk katalog secara default. Anda bisa mengatur media_type_automation ke OPT_out untuk menonaktifkan video produk katalog agar tidak muncul di iklan.
• Kunci media_type_automation berfungsi dengan format Carousel, Koleksi, dan Gambar Tunggal.

curl -X POST \ -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/v25.0/act_<AD_ACCOUNT_ID>/adcreatives

Demikian pula, jika membuat objek iklan katalog Advantage+ dengan endpoint act_<AD_ACCOUNT_ID>/ads, iklan akan mulai menayangkan video produk katalog yang tersedia secara default. Anda bisa mengatur kunci media_type_automation ke OPT_out untuk menonaktifkan video produk katalog agar tidak muncul di iklan.

curl -X POST \ -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/v25.0/act_<AD_ACCOUNT_ID>/ads

Iklan media dinamis (dengan format Koleksi)

• Media dinamis hanya menggantikan hero media. Gambar mini produk dalam pengalaman praklik dan Instant Experience akan selalu berupa gambar.
• Jika ikut serta dalam media dinamis dan jika video produk tersedia, kami akan mengganti hero media video dinamis dengan video produk. Iklan katalog Advantage+ dalam format Koleksi akan disetujui dalam media dinamis secara default dan mulai menayangkan video produk katalog mulai September 2025. Anda bisa terus mengatur media_type_automation ke OPT_OUT untuk menonaktifkan video produk katalog agar tidak muncul di iklan.
• Media dinamis hanya menggantikan hero media video dinamis jika diikutsertakan. Saat ini gambar dan video hero statis tidak akan digantikan oleh video produk, mis., Pengalaman tayangan slide gambar diganti dengan video produk.

Contoh Spesifikasi Materi Iklan untuk Koleksi dengan Media Dinamis

curl -X POST \ -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/v25.0/act_<AD_ACCOUNT_ID>/adcreatives

Iklan media dinamis (Tunjukkan video saat tersedia)

Di object_story_spec, ubah format_option menjadi single_video. Ini hanya tersedia untuk format gambar/video tunggal.

curl -X POST \ -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/v25.0/act_<AD_ACCOUNT_ID>/ads

Iklan media dinamis (Gambar tunggal dipilih ke dalam media dinamis)

Dalam object_story_spec, format_option dari single_image akan menampilkan media dinamis saat memilih media_type_automation.

Mulai September 2025, iklan katalog Advantage+ yang menggunakan format_option dari single_image akan disertakan dalam media dinamis secara default dan akan menampilkan video produk katalog yang tersedia dalam iklan. Anda bisa mengatur media_type_automation ke OPT_OUT untuk menonaktifkan video produk katalog agar tidak muncul di iklan.

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

Opsional: Setujui untuk mengaktifkan atau menonaktifkan pemotongan video otomatis

Gunakan kolom video_crop_style untuk mengontrol pemotongan video otomatis. Nilai yang tersedia adalah AUTO atau NONE.

Untuk menolak pemotongan video otomatis, atur video_crop_style ke NONE, atau hapus penyesuaian dari pengaturan media_type_automation.

curl -X POST \ -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": { "customizations": { "video_crop_style": "NONE" }, "enroll_status": "OPT_IN" } } }, "product_set_id": "<PRODUCT_SET_ID>" }' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads

Pemotongan otomatis hanya berlaku untuk video yang tidak memenuhi persyaratan ukuran penempatan, dan pemotongan otomatis saat ini dirancang terutama untuk menyesuaikan video ke dalam viewport pemutar.

Jika ada video yang cocok dengan rasio aspek untuk penempatan iklan, video tersebut akan ditampilkan. Jika semua rasio aspek video produk tertentu disediakan, pemotongan otomatis tidak akan diterapkan. Jika tidak, iklan akan memilih video item tersebut dan memeriksa pengaturan pemotongan otomatis: AUTO menampilkan video yang dipotong otomatis dan NONE menampilkan video asli.

Insight Media Dinamis

Metrik Interaksi Video dari Pengelola Iklan juga bisa dikueri pada API. Gunakan bagan berikut untuk perbandingan.

Permintaan Contoh

curl GET \ -d 'access_token=<ACCESS_TOKEN>' \ -d 'fields=impressions,video_continuous_2_sec_watched_actions,actions,video_thruplay_watched_actions' \ https://graph.facebook.com/v25.0/<AD_ID>/insights

Untuk informasi selengkapnya, lihat dokumentasi Insights API.