Iklan Koleksi

Format iklan koleksi menyertakan Instant Experience dan memudahkan orang untuk menemukan, menjelajahi, dan membeli produk serta layanan dari perangkat selulernya melalui cara yang visual dan mendalam. Iklan Anda di beranda akan menampilkan tiga produk dengan gambar atau video utama yang membuka Instant Experience layar penuh saat seseorang berinteraksi dengan iklan Anda. Ada dua jenis iklan koleksi: berbasis gambar dan berbasis video.

Pertimbangkan semua referensi "Canvas" untuk mewakili Instant Experience karena Canvas adalah nama sebelumnya untuk format ini.

Anda dapat membuat iklan dengan format koleksi dengan membuat Instant Experience. Mulailah dengan template atau pilih tata letak khusus Anda sendiri. Untuk informasi selengkapnya, lihat Pusat Bantuan Iklan, Instant Experience.

Anda juga dapat menyertakan antarmuka pengguna pembuatan iklan Facebook untuk format koleksi di situs web Anda dengan menggunakan JavaScript SDK untuk membuat Dialog Iklan Koleksi.

Untuk informasi umum tentang menggunakan koleksi, lihat:

Untuk membuat koleksi yang digunakan di Toko dan menambahkan metadata ke set produk, lihat Platform Jual Beli, API Koleksi Set Produk.

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

Tujuan dan Penempatan yang Didukung

Anda dapat menggunakan iklan koleksi dengan tujuan berikut:

Traffic
Konversi
Penjualan Katalog Produk — (Didukung ketika Anda menggunakan koleksi dengan satu set produk.)
Kunjungan Toko — (Didukung ketika Anda menggunakan koleksi dengan satu set produk.)
Brand Awareness
Jangkauan

Untuk tujuan Traffic dan Konversi, Anda juga dapat menggunakan video tayangan slide. Untuk informasi selengkapnya, lihat Pusat Bantuan Bisnis: Memilih Tujuan Iklan yang Tepat.

Penempatan berikut didukung:

Kabar Facebook
Reels Facebook
Kabar Instagram (Lihat Instant Experience: Instant Experience dan Iklan Instagram.)
Instagram Stories (Lihat Instant Experience: Instant Experience dan Iklan Instagram.)

Untuk informasi selengkapnya, lihat Pusat Bantuan Bisnis: Tentang penempatan dan Pusat Bantuan Bisnis: Penempatan iklan yang tersedia untuk tujuan pemasaran.

Iklan Koleksi dari Set Produk

Sebelum Anda membuat iklan koleksi, Anda harus menyediakan materi iklan dan Instant Experience. Anda harus menyediakan setidaknya empat elemen yang mewakili foto atau empat elemen yang mewakili produk dengan tanda produk untuk ditampilkan secara bergiliran. Elemen foto anak dalam elemen carousel juga valid.

Buat iklan koleksi dari katalog Anda. Iklan koleksi memiliki empat produk di bawah gambar atau video utama dan ditampilkan di Kabar seluler. Anda dapat menggunakan video tayangan slide dengan fitur ini.

Iklan tersebut muncul di Kabar, dan orang-orang dapat melihat lebih banyak dalam pengalaman layar penuh yang terbuka saat mereka mengetuk iklan.

Untuk menggunakan set produk, Anda harus memahami iklan katalog Advantage+ dan sudah menyiapkan katalog produk. Lihat Iklan Katalog Advantage+ dan Iklan Katalog Advantage+, Katalog Produk untuk informasi selengkapnya.

Membuat Iklan

Saat Anda membuat iklan koleksi dari set produk, Anda juga harus secara eksplisit membuat Instant Experience dengan elemen yang benar. Saat Anda menggunakan Instant Experience dalam iklan koleksi, Facebook secara otomatis membuat iklan koleksi. Instant Experience Anda harus berisi:

Gambar, baik sebagai Foto Canvas, Video Canvas, atau Video Template Canvas.
Set produk dengan show_in_feed diatur ke true. (Lihat Set Produk Canvas, Referensi.)
Footer (Lihat Footer Canvas, Referensi.)

Gambar Instant Experience

Membuat Instant Experience dengan gambar:

curl \
  -F 'canvas_photo={ 
    "photo_id": "PHOTO_ID", 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/PAGE_ID/canvas_elements
Open In Graph API Explorer

Atau membuat Instant Experience dengan video:

curl \
  -F 'canvas_video={ 
    "video_id": "VIDEO_ID", 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/PAGE_ID/canvas_elements
Open In Graph API Explorer

Atau, buat Instant Experience dengan video template:

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/v21.0/<PAGE_ID>/canvas_elements

Set produk Instant Experience

Lalu Anda membuat canvas_product_set dengan product_set_id dari katalog produk Anda. Anda harus mengatur show_in_feed ke true untuk membuat iklan koleksi.

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/v21.0/<PAGE_ID>/canvas_elements

Catatan: Dalam contoh di atas, item_headline, item_description, image_overlay_spec, storefront_setting, dan retailer_item_ids semuanya adalah kolom opsional. Sebelumnya, Anda menyediakan ini dalam panggilan yang sama untuk membuat iklan koleksi dan aset Instant Experience yang mendasarinya. Sekarang Anda menyediakannya dalam panggilan ini.

Sediakan kolom wajib dalam parameter image_overlay_spec. Untuk informasi selengkapnya, lihat Marketing API, Referensi, Data Tautan Materi Iklan, Spesifikasi Overlay Gambar.

Parameter storefront_setting mendukung kolom product_set_layout, enable_sections, dan customized_section_titles.

Kolom `product_set_layout`

Nama	Deskripsi
`layout_type` string	Wajib. Cara set produk akan ditampilkan. Nilai:`GRID_2COL`, `GRID_3COL`, `CAROUSEL`, `HSCROLL_LIST`

Untuk menggunakan customized_section_titles, enable_sections harus diatur ke true. Kolom customized_section_titles mengharapkan array objek, masing-masing dengan parameter title_id dan customized_title.

Kolom `customized_section_titles`

Nama	Deskripsi
`title_id` string	Wajib. String enum string mewakili string judul bagian default yang ingin Anda ganti. Nilai:`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` string	Wajib. String khusus alternatif yang seharusnya dilihat pemirsa sebagai judul bagian.

Footer Instant Experience

Buat footer Instant Experience dengan tautan.

curl \
  -F 'canvas_button={ 
    "rich_text": {
      "plain_text": "See more at www.abc.com."
    },
    "open_url_action": {
      "url": "https://www.abc.com"
    }
  }' \
 -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/PAGE_ID/canvas_elements
Open In Graph API Explorer

Jika dikehendaki, Anda juga dapat membuat tombol yang dapat digunakan di footer.

curl \
  -F 'canvas_footer={ 
    "child_elements": [BUTTON_ELEMENT_ID]
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/PAGE_ID/canvas_elements
Open In Graph API Explorer

Teks yang Anda berikan di footer relatif fleksibel, yang sebelumnya perlu Anda berikan See more.... tetapi sekarang Anda dapat menyediakan teks khusus dengan tombol URL.

Instant Experience lengkap

curl \
  -F 'body_element_ids=[
    PHOTO/VIDEO_ELEMENT_ID,
    PRODUCT_SET_ELEMENT_ID,
    FOOTER_ELEMENT_ID
  ]' \
  -F 'is_published=true' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/PAGE_ID/canvases
Open In Graph API Explorer

Untuk membuat Instant Experience dengan template video, set produk, tombol, lokasi toko, dan footer opsional yang Anda siapkan, Anda harus menyertakan parameter 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' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/canvases
Open In Graph API Explorer

Untuk template Storefront, Anda perlu menentukan source_template_id = 1932289657009030, yang didefinisikan dalam Instance Experiences, Menggunakan template. Tata letak untuk setiap template bersifat tetap, namun Anda dapat mengganti konten default dengan video, produk, teks, dan tautan dinamis Anda sendiri. Untuk informasi selengkapnya, lihat Instant Experience, Menggunakan Template.

Membuat iklan koleksi dengan Instant Experience

Akhirnya, Anda perlu membuat iklan koleksi. Ini memungkinkan orang untuk mengeklik elemen gambar atau video dari iklan koleksi Anda.

Jika elemen pertama dari Instant Experience Anda adalah foto, Anda harus mengatur object_type ke 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/v21.0/AD_ACCOUNT_ID/adcreatives

Open In Graph API Explorer

Jika elemen pertama Instant Experience Anda adalah video, buatlah permintaan ini:

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/v21.0/AD_ACCOUNT_ID/adcreatives

Jika elemen pertama Instant Experience Anda adalah video template, buatlah permintaan ini:

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/v21.0/act_<AD_ACCOUNT_ID>/ads

Pratinjau Iklan

Jika Anda memiliki kemampuan Pratinjau Iklan, Anda dapat menyediakan ad_format dan token akses Pengguna untuk membuat pratinjau berdasarkan iklan atau materi iklan Anda.

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

Open In Graph API Explorer

Contoh: Untuk iklan Instant Experience video template, format yang didukung adalah BIZ_DISCO_FEED_MOBILE, GROUPS_MOBILE, MOBILE_FEED_STANDARD, SUGGESTED_VIDEO_DESKTOP, SUGGESTED_VIDEO_MOBILE, WATCH_FEED_MOBILE.

Lihat Pratinjau Iklan untuk informasi selengkapnya.

Iklan Koleksi Standar

Anda dapat menggunakan template sebagai cara cepat untuk membuat Instant Experience untuk tujuan bisnis tertentu. Tata letak untuk setiap template bersifat tetap, namun Anda dapat mengganti konten default dengan gambar, video, produk, teks, dan tautan Anda sendiri. Untuk informasi selengkapnya, lihat Instant Experience, Menggunakan Template.

Ada dua jenis iklan koleksi dengan Instant Experience: berbasis gambar dan berbasis video, bergantung pada aset yang Anda sediakan. Setelah Anda memiliki materi iklan, Anda dapat membuat iklan.

Membuat Iklan Berbasis Gambar

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/v21.0/AD_ACCOUNT_ID/adcreatives

Membuat Iklan Berbasis Video

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/v21.0/AD_ACCOUNT_ID/adcreatives

Parameter

Nama	Deskripsi
`link` string	Wajib Mengarahkan penonton ke Instant Experience.
`collection_thumbnails` array	Wajib Array gambar mini. Empat gambar mini diperlukan.

Kolom `collection_thumbnails`

Nama	Deskripsi
`element_id` string numerik	Wajib ID elemen foto Canvas atau ID elemen daftar produk. Foto Canvas harus dikaitkan dengan Instant Experience yang dilampirkan pada iklan koleksi ini. Gambar yang terkait dengan ID ini muncul di Instant Experience setelah seseorang mengeklik iklan. ID elemen gambar utama tidak valid.
`element_child_index` bilangan bulat	Wajib untuk elemen foto dengan tanda produk dan elemen daftar produk Indeks produk dari array ID elemen foto dengan tanda produk. Atau indeks produk dari array `product_id_list`, yang berisi elemen daftar produk. Catatan: Harus berupa bilangan bulat positif.
`element_crops` AdsImageCrops	Wajib untuk elemen foto Objek JSON yang menentukan dimensi pemotongan untuk gambar yang ditentukan. Hanya kunci pangkas `100x100` yang diizinkan.

Membuat Pemirsa Interaksi

Anda dapat secara otomatis membuat pemirsa untuk orang-orang yang berinteraksi dengan iklan koleksi Anda. Ini serupa dengan pemirsa interaksi untuk Instant Experience standar. Untuk informasi selengkapnya, lihat Instant Experience, Pemirsa Interaksi.

Anda dapat menargetkan iklan Instant Experience Anda dengan tampilan layar penuh kepada orang-orang yang mengetuk iklan koleksi Anda. Kami menyebut jenis pemirsa ini pemirsa interaksi Pengalaman Layar Penuh. Buat pemirsa ini dengan membuat Pemirsa Khusus, lalu tetapkan object_id ke CANVAS_ID, dan buat aturan untuk melacak salah satu peristiwanya.

Membuat pemirsa yang membuka Instant Experience

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/v21.0/AD_ACCOUNT_ID/customaudiences

Open In Graph API Explorer

Membuat pemirsa yang mengeklik iklan koleksi

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/v21.0/AD_ACCOUNT_ID/customaudiences
    
Open In Graph API Explorer

Dialog Iklan Koleksi

Iklan koleksi didasarkan pada Instant Experience dengan template. Oleh karena itu, untuk membuat Iklan Koleksi menggunakan dialog, Anda akan menggunakan dialog Instant Experience dengan parameter tambahan. Ini akan memberikan alur UI pembuatan iklan koleksi Facebook di situs web Anda. Untuk detail tentang komponen UI, lihat Dialog.

Untuk menyiapkan Facebook SDK for Javascript, lihat:

JavaScript SDK mengandalkan izin pengguna yang login untuk membuat Instant Experiences. Jika pengguna tidak memiliki izin yang diperlukan untuk membuat Instant Experiences untuk halaman dan bisnis yang ditentukan, dialog akan menampilkan kesalahan. Pengguna juga harus memiliki akses ke katalog dan set produk. Untuk memastikan tidak ada kesalahan, pengguna harus memiliki akses ke Pengelola Bisnis dan memiliki izin untuk membuat iklan untuk halaman tersebut.

Lalu Anda dapat memicu dialog iklan koleksi.

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
});

Anda dapat menyediakan pengaturan ini untuk plugin:

Nama	Deskripsi
`display`	Wajib Atur parameter yang diperlukan ke nilai `popup`.
`method`	Wajib Atur parameter yang diperlukan ke nilai `instant_experiences_builder`.
`account_id`	Wajib ID akun iklan Anda.
`business_id`	Wajib ID bisnis Anda.
`page_id`	Wajib ID Halaman yang ingin Anda hubungkan dengan Instant Experience.
`template_id`	Wajib ID template yang ingin Anda gunakan.
`product_catalog_id`	Opsional ID katalog produk untuk digunakan dalam koleksi. Ini diperlukan jika `product_set_id` disediakan.
`product_set_id`	Opsional ID set produk untuk digunakan dalam koleksi.

Semua jenis template yang valid dan ID yang sesuai dapat ditemukan di Instant Experience: Menggunakan Template.

Parameter product_catalog_id dan product_set_id bersifat opsional. Namun, jika Anda menyediakan product_set_id, Anda perlu menyediakan product_catalog_id. Setelah Anda menyediakan ID ini, pengguna tidak akan dapat mengubah koleksi di UI. Jika tidak ada parameter yang disediakan, pengguna dapat memilih katalog dan set produk di UI. Untuk melihat pratinjau iklan koleksi, kami merekomendasikan penggunaan Dialog Cuplikan Instant Experience.

Plugin memberikan tanggapan ini jika berhasil:


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

id yang ditampilkan akan berupa Instant Experience yang belum diterbitkan. Ini perlu diterbitkan sebelum dapat digunakan di kampanye iklan.

Jika tidak ada tanggapan atau tanggapan undefined ditampilkan, artinya pengguna menutup dialog sebelum menyelesaikan Instant Experience, atau pengguna menyimpan Instant Experience, tetapi tidak menyelesaikannya. Anda dapat meminta Graph API untuk melihat semua Instant Experience yang dimiliki oleh suatu halaman; ini akan memungkinkan Anda untuk melihat apakah ada Instant Experience yang belum selesai.

Menyertakan Katalog Destinasi

Anda dapat menampilkan materi iklan dari katalog destinasi dalam gambar utama iklan koleksi. Anda juga dapat menampilkan carousel gambar hotel di destinasi itu. Untuk melakukan ini, Anda harus memberikan gambar cadangan yang ditampilkan di gambar utama seandainya kami tidak menemukan destinasi yang sesuai untuk hotel di carousel. Untuk informasi selengkapnya, lihat Katalog Destinasi.

Perhatikan batasan ini:

Materi iklan video tidak didukung.
Kami hanya mendukung tampilan gabungan gambar destinasi dan katalog hotel.
Kami tidak mendukung tampilan kombinasi katalog lain.

Untuk menggunakan fitur ini, tambahkan parameter destination_set_id saat membuat elemen canvas_photo Anda, lalu ikuti langkah standar lainnya untuk membuat Instant Experience dan iklan koleksi Anda.

Contoh

curl \
  -F 'canvas_photo={ 
    "photo_id": "PHOTO_ID", 
    "destination_set_id": "DESTINATION_SET_ID",
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/PAGE_ID/canvas_elements
Open In Graph API Explorer