Marketing API

Opsi Spesifikasi Kabar Aset

Anda dapat menggunakan opsi berikut di asset_feed_spec. Lihat Spesifikasi Kabar Aset Iklan untuk informasi referensi selengkapnya.

Nama Properti Deskripsi

images

jenis: array daftar

Wajib untuk format SINGLE_IMAGE dan CAROUSEL_IMAGE.

Array gambar yang memenuhi syarat. Gambar yang diberikan di array ini harus ada dalam galeri gambar akun iklan.


Lengkapi kolom ini dengan array daftar yang berisi {"url": "{IMAGE_URL}", "hash": "{IMAGE_HASH}", "url_tags": "{TAG}"}. Wajib menggunakan url atau hash.

videos

jenis: array daftar

Wajib untuk format SINGLE_VIDEO.

Array video_id. video_id yang diberikan di array ini harus dimiliki oleh akun iklan.


Lengkapi kolom ini dengan array daftar yang berisi {"video_id": "{VIDEO_ID}", "thumbnail_url": "{THUMBNAIL_URL}", "url_tags": "{TAG}"}

carousels
jenis: array daftar

Opsional.
Array child_attachments bersama dengan nilai Boolean multi_share_end_card dan multi_share_optimized, serta adlabels. child_attachments yang diberikan di array ini harus dimiliki oleh akun iklan.



Berikan child_attachments sebagai array daftar yang berisi {"image_label": {"name": "{IMAGE_LABEL}"}, "video_label": {"name": "{VIDEO_LABEL}"}, "title_label": {"name": "{TITLE_LABEL}"}, "description_label": {"name": "{DESC_LABEL}", "link_url_label": {"name": "{LINK_URL}"}}. Wajib menggunakan image_label atau video_label.

bodies

jenis: array daftar

Opsional.

Array isi. Pesan utama atau salinan iklan.


Lengkapi kolom ini dengan array daftar {"text": "{BODY_TEXT}", "url_tags": "{TAG}"}.

call_to_action_types

jenis: array daftar

Wajib untuk semua tujuan, kecuali OUTCOME_AWARENESS.

Array nilai jenis ajakan bertindak.


Lengkapi kolom ini dengan array daftar {"{CALL_TO_ACTION}"}. Anda dapat memberikan maksimum lima nilai.

titles

jenis: array daftar

Opsional.

Array judul. Judul singkat pada iklan, biasanya ditampilkan di samping tautan, gambar, atau video.


Lengkapi kolom ini dengan array daftar {"text": "{TITLE}", "url_tags": "{TAG}"}.

descriptions

jenis: array daftar

Opsional.

Array teks deskripsi sekunder, ditampilkan kurang menonjol dibandingkan isi atau judul. Biasanya muncul di samping tautan, gambar, atau video. Jika tidak ditentukan, Facebook akan melakukan scraping tautan yang Anda berikan untuk membuatnya. Gunakan string kosong dengan spasi tunggal untuk deskripsi kosong, jika Anda tidak ingin menggunakan teks hasil scraping.


Lengkapi kolom ini dengan array daftar {"text": "{DESCRIPTION}", "url_tags": "{TAG}"}.

link_urls

jenis: array daftar

Wajib.

Array URL tautan.


Lengkapi kolom ini dengan array daftar {"website_url": "{URL}"}.

ad_formats

jenis: array string

Wajib.

Array format iklan Facebook yang harus kita gunakan untuk membuat iklan. Format yang didukung: SINGLE_IMAGE, CAROUSEL, SINGLE_VIDEO, AUTOMATIC_FORMAT.


Lengkapi kolom ini dengan array string ["{AD_FORMAT}"].

optimization_type

jenis: string

Opsional.

Jenis pengoptimalan yang digunakan dalam kabar aset. Nilai yang mungkin adalah ASSET_CUSTOMIZATION, LANGUAGE, PLACEMENT, dan REGULAR.

message_extensions

jenis: array string

Opsional.
Jenis ekstensi pesan yang digunakan dalam kabar aset.


Nilai yang mungkin: whatsapp

onsite_destinations
jenis: array daftar

Wajib untuk Iklan Shops. Valid untuk Iklan Statis; format SINGLE_IMAGE, SINGLE_VIDEO, atau CAROUSEL.
Lengkapi kolom ini dengan array daftar yang berisi salah satu dari nilai-nilai berikut guna menentukan destinasi untuk toko di situs Anda.

{"storefront_shop_id": "<SHOP_STOREFRONT_ID>"}
or 
{"shop_collection_product_set_id": "<PRODUCT_SET_ID>" 
or 
{"details_page_product_id": "<PRODUCT_ID>"}

shops_bundle
jenis: boolean

Wajib untuk Iklan Shops. Valid untuk Iklan Katalog Advantage+.
Lengkapi kolom ini untuk pengoptimalan toko. Termasuk tipe pengoptimalan toko reasons_to_shop dan automated_product_tags.
Nilai yang mungkin: true, false

reasons_to_shop
jenis: boolean

Wajib untuk Iklan Shops. Valid untuk Iklan Katalog Advantage+.
Lengkapi kolom ini untuk pengoptimalan toko. Menyoroti informasi produk secara otomatis dari toko Anda, seperti "Pengiriman gratis", "Tren", atau "Stok menipis".
Nilai yang mungkin: true, false

Batasan Spesifikasi Kabar Aset

Format Iklan

  • Format yang didukung ad_formats: SINGLE_IMAGE, CAROUSEL, SINGLE_VIDEO, dan AUTOMATIC_FORMAT.
  • Hanya satu ad_format yang diizinkan per kabar aset.
  • ad_format dihitung sebagai satu aset dalam kabar aset.

Jumlah Aset:

  • Maksimum total 30 aset. Misalnya, Anda memiliki 28 aset dengan 10 images, 5 bodies, 5 titles, 5 description, 1 ad_format, 1 link_url, dan 1 call_to_action_types.
  • Total jumlah gambar: <= 10.
  • Total jumlah video: <= 10. Jika menggunakan Instagram sebagai penempatan Anda, hanya video persegi atau video lanskap yang diizinkan.
  • Total jumlah isi: <= 5.
  • Total jumlah ajakan bertindak: <= 5.
  • Total jumlah judul: <= 5.
  • Total jumlah tautan: <= 5.
  • Total jumlah deskripsi: <= 5.

Persyaratan gambar:

  • Spesifikasi gambar yang direkomendasikan: 1,9:1.
  • Ukuran gambar yang direkomendasikan: 1.200 x 628 piksel.
  • Untuk format CAROUSEL_IMAGE, Anda harus memberikan setidaknya 2 gambar.
  • Jika menggunakan Instagram sebagai penempatan Anda, gunakan gambar persegi untuk mendapatkan kinerja yang lebih baik.

Persyaratan teks:

  • Judul dan teks deskripsi: panjang maksimum 255 karakter.
  • Teks isi: panjang maksimum 1.024 karakter.
  • Jika Anda tidak menentukan deskripsi apa pun, kami akan melakukan scraping tautan yang Anda berikan untuk mengambil deskripsi.
  • Untuk CAROUSEL_IMAGE, judul bersifat opsional.

url_tags bersifat opsional dan hanya tersedia untuk images, videos, bodies, descriptions, dan titles. Facebook menambahkan url_tags ke tautan URL sebagai parameter untuk setiap aset dalam iklan.

Misalnya, pengaturan kombinasi kabar aset yang valid untuk format SINGLE_IMAGE adalah:

  • 5 images
  • 3 bodies
  • 3 titles
  • 3 descriptions
  • 1 format: SINGLE_IMAGE
  • 2 link_urls
"link_urls=[{'website_url':'<WEBSITE_URL>'}, {'website_url':'<WEBSITE_URL>'}]"

Gunakan Tautan Dalam

Anda dapat menggunakan tautan-dalam di spesifikasi kabar aset untuk kampanye dengan tujuan berikut:

  • APP_INSTALLS
  • CONVERSIONS
  • LINK_CLICKS

Tambahkan deeplink_url dalam link_urls saat membuat asset_feed_spec Anda.

curl \
-F 'object_story_spec={
       "page_id": "<PAGE_ID>"
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>",
    }' \
-F "asset_feed_spec={'images': [{'hash':'image_hash'}], 'bodies': [{'text':'Body 1'}, {'text':'Body 2'}], 'titles': [{'text':'Title 1'}, {'text':'Title 2'}], 'descriptions': [{'text':' '}], 'ad_formats': ['SINGLE_IMAGE'], 'link_urls': [{'website_url':'App's object store URL','deeplink_url':'deeplink URL'}]}" \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Situs Web untuk Iklan WhatsApp

Anda dapat membuat iklan yang mengarahkan orang ke situs web Anda dengan tombol WhatsApp yang muncul di bagian bawah layar, agar mereka bisa langsung menghubungi Anda. Ini akan membantu orang terhubung dengan Anda di WhatsApp saat mengunjungi situs web Anda.

Tambahkan message_extensions saat membuat asset_feed_spec Anda.

curl \
-F 'object_story_spec={
       "page_id": "<PAGE_ID>"
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>",
    }' \
-F 'asset_feed_spec={"images": [{"hash":"image_hash"}], "bodies": [{"text":"Body 1"}, {"text":"Body 2"}],"titles": [{"text":"Title 1"}, {"text":"Title 2"}], "descriptions": [{"text":" "}], "ad_formats": ["SINGLE_IMAGE"], "link_urls": [{"website_url":"business URL"}], "message_extensions": [{"type": "whatsapp"}]}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives