Penargetan Penempatan

Tayangkan iklan di penempatan tertentu, seperti hanya Kabar desktop atau Kabar seluler plus Video Berhadiah Audience Network. Anda hanya dapat menggunakan opsi penempatan tertentu, bergantung pada tujuan kampanye. Lihat Kampanye, Tujuan, dan Penempatan untuk informasi selengkapnya.

Platform dan posisi yang tersedia adalah device_platforms, publisher_platforms, facebook_positions, audience_network_positions, instagram_positions, dan messenger_positions. Lihat bagian Perangkat, Penerbit, dan Posisi untuk informasi selengkapnya.

curl -X POST \
  -F 'name="My AdSet"' \
  -F 'optimization_goal="REACH"' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'targeting={
       "geo_locations": {
         "countries": [
           "US"
         ]
       },
       "publisher_platforms": [
         "facebook"
       ],
       "facebook_positions": [
         "feed"
       ]
     }' \
  -F 'promoted_object={
       "page_id": "<PAGE_ID>"
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets


Jika Anda tidak menentukan apa pun untuk kolom penempatan tertentu, Facebook akan mempertimbangkan semua posisi default yang mungkin untuk kolom itu. Contoh: jika Anda mengatur publisher_platforms ke facebook, tetapi tidak memilih apa pun untuk facebook_positions, Facebook mempertimbangkan semua posisi default Facebook, seperti feed, right_hand_column, dsb. Atau, jika Anda tidak memilih publisher_platforms apa pun, Facebook mempertimbangkan semua defaultpublisher_platforms. Facebook juga dapat secara otomatis mempertimbangkan posisi atau platform baru saat tersedia.

Di Audience Network, Anda dapat membatasi penerbit mana yang menampilkan iklan Anda. Kecualikan penerbit menurut kategori, atau buat daftar khusus URL toko aplikasi atau URL domain untuk dikecualikan.

Anda tidak dapat menggunakan right_hand_column saja sebagai penempatan untuk iklan video, koleksi, atau canvas.

Filter Inventaris membantu Anda mengontrol apakah iklan Anda ditampilkan di samping berbagai jenis konten untuk iklan dalam konten (video in-stream Facebook, iklan di Facebook Reels dan iklan di Instagram Reels), iklan Audience Network dan iklan kabar (Kabar Facebook, Kabar Instagram, Kabar Facebook Reels, dan Kabar Instagram Reels). Untuk mempelajari selengkapnya tentang kategori konten ini, lihat Pusat Bantuan Iklan, Filter Inventaris. Anda dapat memilih nilai terpisah untuk iklan dalam konten, Audience Network, dan kabar. Opsi mencakup: Expanded, Moderate, dan Limited. Untuk detailnya, lihat brand_safety_content_filter_levels di bawah:

Nama Deskripsi

brand_safety_content_filter_levels

array<string>

Untuk iklan dalam konten (in-stream Facebook dan iklan di Facebook Reels), nilai berikut ini diizinkan:

  • EXPANDED: FACEBOOK_RELAXED
  • MODERATE: FACEBOOK_STANDARD
  • LIMITED: FACEBOOK_STRICT

Untuk Audience Network, nilai berikut ini diizinkan:

  • EXPANDED: AN_RELAXED
  • MODERATE: AN_STANDARD
  • LIMITED: AN_STRICT

Untuk iklan Kabar (Kabar Facebook, Kabar Instagram, Kabar Facebook Reels, dan Kabar Instagram Reels), nilai berikut ini diizinkan:

  • EXPANDED: FEED_RELAXED
  • MODERATE: FEED_STANDARD
  • LIMITED: FEED_STRICT

Contoh: "brand_safety_content_filter_levels":["FACEBOOK_STRICT", "AN_RELAXED"]

Catatan: Saat filter diterapkan pada tingkat akun iklan, hanya opsi yang lebih ketat yang akan tersedia pada tingkat kampanye. Contohnya, jika aku diatur ke MODERATE, pengguna hanya dapat memilih MODERATE atau LIMITED untuk kampanye. Opsi yang lebih longgar (dalam contoh ini, EXPANDED) tidak akan tersedia.

excluded_publisher_categories

array<string>

Termasuk: dating dan gambling

excluded_publisher_list_ids

array <numeric strings>

Setiap string adalah ID daftar untuk pengecualian. Buat daftar khusus di Pengelola Iklan atau Marketing API, Daftar Blokir Penerbit.


Contoh:
"excluded_publisher_list_ids":["{block_list_id_1}","{block_list_id_2}"]

Contoh, untuk menggunakan brand_safety_content_filter_levels:

curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=CAMPAIGN_ID' \
  -F 'targeting= { "geo_locations":{"countries":["US"]}, "brand_safety_content_filter_levels":["FACEBOOK_STRICT","AN_STANDARD"]}' \
  -F 'status=ACTIVE' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/VERSION/AD_ACCOUNT_ID/adsets

Untuk Audience Network dan video In-Stream, Anda juga dapat mengecualikan penerbit berdasarkan kategori:

Nama Deskripsi

excluded_publisher_categories

array<string>

Termasuk:

  • debated_social_issues
  • mature_audiences
  • tragedy_and_conflict

Contoh:
"excluded_publisher_categories": ["debated_social_issues", "mature_audiences"]

Perangkat, Penerbit, dan Posisi

Nama: Opsi Deskripsi

device_platforms: mobile, desktop

Opsional.
Default: Semua
Jenis perangkat milik seseorang yang melihat iklan Anda.

publisher_platforms: facebook, instagram, messenger, audience_network

Opsional.
Default: Semua
Saluran penerbitan untuk iklan Anda. Anda dapat mengatur posisi saluran penerbitan dengan mengaturnya di dalam facebook_positions, instagram_positions, audience_network_positions, atau messenger_positions.

facebook_positions: feed, right_hand_column, marketplace, video_feeds, story, search, instream_video, facebook_reels, facebook_reels_overlay, profile_feed

Opsional.
Default: Semua


Catatan:

  • Jika disediakan, publisher_platforms harus mencakup facebook atau jangan sediakan agar default-nya adalah semua.
  • feed mencakup Kabar untuk Desktop dan Seluler.
  • Untuk kampanye yang menargetkan Amerika Serikat (AS), Inggris Raya (GB), Prancis (FR), Spanyol (ES), Jerman (DE), Meksiko (MX), India (IN), dan Thailand (TH), Anda dapat menggunakan instream_video tanpa feed untuk tujuan VIDEO_VIEWS dan POST_ENGAGEMENT. instream_video tidak didukung untuk tujuan CONVERSIONS.
  • Jika memilih story, Anda harus menggunakan feed Facebook atau story Instagram dan device_platforms: mobile karena Facebook Stories hanya untuk seluler.
  • Jika memilih marketplace, search, atau profile_feed, Anda harus menggunakan feed.
  • Mulai v3.0, right_hand_column hanya tersedia untuk format gambar tunggal, video tunggal, dan carousel untuk tujuan TRAFFIC, CONVERSIONS, dan PRODUCT_CATALOG_SALES.

instagram_positions: stream, story, explore, explore_home, reels, profile_feed, ig_search, profile_reels

Opsional.
Default: Semua
Anda dapat menargetkan iklan carousel Instagram untuk stream, story atau ig_search di Instagram. Jika Anda menggunakan materi iklan carousel yang tidak dirancang dalam cerita, Anda tidak dapat memilih kedua opsi untuk set iklan yang sama.
Iklan yang menggunakan story akan ditampilkan di kabar Instagram Desktop dan Web seluler.

audience_network_positions: classic, rewarded_video

Opsional.
Default: Semua
Secara default, kami tidak menampilkan effective_audience_network_positions saat Anda membaca spesifikasi penargetan untuk set iklan. Ini mungkin berbeda dari audience_network_positions konfigurasi Anda. Jika Anda menentukan posisi yang tidak didukung untuk tujuan tertentu, posisi tersebut akan muncul dalam daftar posisi yang dikonfigurasi, tetapi tidak dalam daftar posisi efektif.

messenger_positions: messenger_home, sponsored_messages, story

Opsional.
Default: messenger_home, story


Catatan:

  • Jika memilih messenger_home, Anda juga harus memilih publisher_platform dan feed Facebook untuk facebook_positions.
  • messenger_home tersedia untuk gambar tunggal dan carousel di tujuan LINK_CLICKS, CONVERSIONS, MESSAGES, APP_INSTALLS, dan PRODUCT_CATALOG_SALES untuk iklan yang mengarahkan traffic ke situs web, aplikasi, dan Messenger.
  • Jika memilih story, Anda harus menggunakan feed Facebook atau story Instagram dan device_platforms: mobile karena Messenger Stories hanya untuk seluler. Anda dapat menggunakan story untuk format gambar dan video tunggal dalam kampanye iklan dengan tujuan CONVERSIONS, TRAFFIC, REACH, BRAND_AWARENESS, dan APP_INSTALLS yang mengarahkan traffic ke situs web dan aplikasi.
  • sponsored_messages tidak bisa digunakan dengan penempatan lain, termasuk messenger_home atau penempatan Facebook.

Logika

  • Logika untuk opsi dalam parameter yang sama adalah OR.
    Contoh: publisher_platforms=['facebook','instagram'] berarti menayangkan iklan di Facebook dan Instagram.
  • Logika di antara parameter adalah AND.
    Contoh: publisher_platforms=['facebook']&device_platforms=['mobile'] berarti hanya menayangkan iklan ini di Facebook Seluler.
  • Jika logikanya tidak menargetkan apa pun, seperti publisher_platforms=['instagram']& device_platforms=['desktop'], Anda akan melihat kesalahan.

Batasan

  • Anda tidak bisa menggunakan hanya Audience Network, publisher_platforms: audience_network tidak bisa dipilih sendirian.
  • Penempatan audience_network dengan tujuan VIDEO_VIEWS harus digunakan dengan tujuan pengoptimalan THRUPLAYS.
  • story untuk facebook_positions tidak bisa dipilih sendirian. Jika memilih story untuk facebook_positions, Anda harus memilih feed Facebook atau story Instagram.
  • story untuk messenger_positions tidak bisa dipilih sendirian. Jika memilih story untuk messenger_positions, Anda juga harus memilih feed Facebook atau story Instagram.
  • Iklan Kabar Web Instagram menggunakan penempatan stream dan diperiksa untuk kelayakan web yang akan dikirim ke kabar web desktop dan seluler. Tujuan yang kompatibel adalah BRAND_AWARENESS, REACH, LINK_CLICKS, POST_ENGAGEMENT, VIDEO_VIEWS, dan CONVERSIONS.

Contoh

Cerita

Untuk menggunakan Facebook Stories sebagai penempatan:

curl \
  -F 'name=My Ad Set' 
  -F 'optimization_goal=CONVERSIONS' 
  -F 'billing_event=IMPRESSIONS' 
  -F 'bid_amount=2' 
  -F 'daily_budget=1000' 
  -F 'campaign_id=<AD_CAMPAIGN_ID>' 
  -F 'targeting={"geo_locations":{"countries":["US"]}, "publisher_platforms":["messenger", "facebook"], "facebook_positions":["story"], "messenger_positions":["story"]}' 
  -F 'status=ACTIVE'
  -F 'access_token=<ACCESS_TOKEN>' 
  https://graph.facebook.com/API_VERSION/act_AD_ACCOUNT_ID/adsets

Video In-stream

Untuk membuat set iklan dengan penempatan hanya instream_video yang menargetkan negara yang didukung dalam daftar di atas:

curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=CAMPAIGN_ID' \
  -F 'targeting={"geo_locations":{"countries":["US"]},"publisher_platforms":["facebook"], "facebook_positions":["instream_video"]}' \
  -F 'status=ACTIVE' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/API_VERSION/act_AD_ACCOUNT_ID/adsets

Audience Network

Untuk menarget penempatan Video Berhadiah Audience Network:

curl \
  -F 'name=My Ad Set' \
  -F 'optimization_goal=OFFSITE_CONVERSIONS' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'is_autobid=true' \
  -F 'daily_budget=40000' \
  -F 'campaign_id=<AD_CAMPAIGN_ID>' \
  -F 'targeting={"app_install_state": "not_installed","geo_locations":{"countries":["US"]},"facebook_positions":["feed"],"device_platforms": ["mobile"],"audience_network_positions": ["classic","rewarded_video"],"user_device": ["Android_Smartphone","Android_Tablet"],"user_os": ["Android_ver_4.4_and_above"]}' \
  -F 'promoted_object={"application_id": "<APPLICATION_ID>","custom_event_type": "PURCHASE","object_store_url": "<OBJECT_STORE_URL>"}' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<APIVERSION>/<AD_ACCOUNT_ID>/adsets

Ini memberikan:

{
  "targeting": {
    "audience_network_positions": [
      "classic",
      "rewarded_video"
    ],
    "effective_audience_network_positions": [
      "classic",
      "rewarded_video"
    ]
  },
  "id": "<AD_SET_ID>"
}

Reels

Untuk menggunakan Facebook Reels sebagai penempatan:

curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=CAMPAIGN_ID' \
  -F 'targeting={"geo_locations":{"countries":["US"]},"publisher_platforms":["facebook"], "facebook_positions":["facebook_reels"]}' \
  -F 'status=ACTIVE' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/API_VERSION/act_AD_ACCOUNT_ID/adsets

Beranda Jelajahi Instagram

Untuk membuat set iklan dengan penempatan explore_home yang menargetkan negara yang didukung (misalnya: "AS"):

curl -X POST \
  -F 'name="My AdSet"' \
  -F 'optimization_goal="LINK_CLICKS"' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'targeting={
       "geo_locations": {
         "countries": [
           "US"
         ]
       },
       "publisher_platforms": [
         "instagram"
       ],
       "instagram_positions": [
         "stream",
         "explore",
         "explore_home"
       ],
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets

Hasil pencarian di Instagram

Untuk membuat set iklan dengan penempatan ig_search yang menargetkan negara yang didukung (misalnya: "AS"):

curl -X POST \
  -F 'name="My AdSet"' \
  -F 'optimization_goal="LINK_CLICKS"' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'targeting={
       "geo_locations": {
         "countries": [
           "US"
         ]
       },
       "publisher_platforms": [
         "instagram"
       ],
       "instagram_positions": [
         "stream",
         "ig_search"
       ],
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets

Penempatan Efektif dengan Penargetan

Anda membuat set iklan dengan penempatan dalam spesifikasi penargetan, namun Anda tidak selalu tahu apakah Facebook mengirimkan iklan Anda ke penempatan yang ditentukan. Ini karena penempatan yang Anda pilih mungkin tidak berlaku untuk tujuan iklan yang dipilih. Dengan API penempatan yang efektif untuk penargetan, kini Anda dapat menentukan penempatan yang akan dituju oleh iklan, dengan opsi penargetan, dan menerima pesan validasi untuk memahami mengapa beberapa penempatan difilter. Jika Anda tidak memberikan penargetan, Anda tetap dapat menentukan penempatan yang efektif berdasarkan pengaturan set iklan dan kampanye iklan.

Untuk membaca penempatan efektif berdasarkan penargetan Anda, tambahkan effective_ di depan nama kolom penempatan. Contoh:

curl -G \
  -d "fields=targeting{effective_publisher_platforms,effective_facebook_positions,effective_device_platforms,effective_audience_network_positions,effective_instagram_positions}" \
  -d "access_token=<access_token>" \
  https://graph.facebook.com/<VERSION>/<AD_SET_ID>

Untuk melihat mengapa beberapa penempatan difilter, gunakan kolom recommendation:

curl -G \
  -d "fields=recommendations" \
  -d "access_token=<access_token>" \
  https://graph.facebook.com/<VERSION>/23842573364570019

Dengan penempatan yang efektif, sekarang Anda dapat menentukan penempatan yang akan menjadi tujuan penayangan iklan Anda berdasarkan billing_event, optimization_goal, dan promoted_object set iklan Anda serta buying_type dan objective kampanye iklan Anda. Semua parameter untuk /ad_campaign_placement mencakup:

  • Iklan account_id dan token akses
  • billing_event, seperti IMPRESSIONS
  • Jenis Pembelian, seperti AUCTION
  • Tujuan, seperti POST_ENGAGEMENT
  • Tujuan Pengoptimalan, yang bersifat opsional, seperti POST_ENGAGEMENT
  • Objek Promosi, seperti PIXEL_ID

Semua parameter kecuali promoted_object dan optimization_goal diperlukan. Jika memberikan penargetan, Anda dapat menggunakan Marketing API untuk mengetahui penempatan yang efektif menurut penempatan yang diizinkan untuk pengaturan Anda. Silakan lihat Penempatan Efektif dengan Penargetan. Contoh:

curl -G \
-d 'account_id=<ACCOUNT_ID>' \
-d 'billing_event=IMPRESSIONS' \
-d 'buying_type=AUCTION' \
-d 'objective=PAGE_LIKES' \
-d 'optimization_goal=IMPRESSIONS' \
https://graph.facebook.com/<VERSION>/ad_campaign_placement?access_token=<TOKEN>

Panggilan memberikan:

{
   "effective_device_platforms": [
      "mobile",
      "desktop"
   ],
   "effective_facebook_positions": [
      "feed",
      "right_hand_column"
   ],
   "effective_publisher_platforms": [
      "facebook"
   ],
   "recommendations": [
      {
         "title": "Placement Not Supported By Objective",
         "message": "Ads with PAGE_LIKES objective do not support facebook.instream_video, facebook.suggested_video, facebook.marketplace, audience_network.classic, audience_network.instream_video, audience_network.rewarded_video, instagram.stream, instagram.story, messenger.messenger_home.",
         "code": 1815609,
         "importance": "LOW",
         "confidence": "HIGH",
         "blame_field": "targeting"
      },
      {
         "title": "Device Platform Not Supported By Objective",
         "message": "Ads with PAGE_LIKES objective do not support connected_tv.",
         "code": 1815610,
         "importance": "LOW",
         "confidence": "HIGH",
         "blame_field": "targeting"
      }
   ],     
   }
}

Anda dapat menggunakan kolom code dari hasil ini dalam panggilan untuk /ad-recommendation untuk melihat alasan mendetail. Sebagai contoh, Anda bisa mendapatkan informasi berikut:

[{“code”: 1815610, “summary”: “Device Platform Not Supported By Objective”},]

Untuk informasi selengkapnya, lihat Rekomendasi Iklan, Referensi dan Penempatan Efektif dengan Penargetan.