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 |
---|---|
array<string> | Untuk iklan dalam konten (in-stream Facebook dan iklan di Facebook Reels), nilai berikut ini diizinkan:
Untuk Audience Network, nilai berikut ini diizinkan:
Untuk iklan Kabar (Kabar Facebook, Kabar Instagram, Kabar Facebook Reels, dan Kabar Instagram Reels), nilai berikut ini diizinkan:
Contoh: Catatan: Saat filter diterapkan pada tingkat akun iklan, hanya opsi yang lebih ketat yang akan tersedia pada tingkat kampanye. Contohnya, jika aku diatur ke |
array<string> | Termasuk: |
array <numeric strings> | Setiap string adalah ID daftar untuk pengecualian. Buat daftar khusus di Pengelola Iklan atau Marketing API, Daftar Blokir Penerbit. Contoh: |
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 |
---|---|
array<string> | Termasuk:
Contoh: |
Nama: Opsi | Deskripsi |
---|---|
| Opsional. |
| Opsional. |
| Opsional. Catatan:
|
| Opsional. |
| Opsional. |
| Opsional. Catatan:
|
OR
.publisher_platforms=['facebook','instagram']
berarti menayangkan iklan di Facebook dan Instagram. AND
.publisher_platforms=['facebook']&device_platforms=['mobile']
berarti hanya menayangkan iklan ini di Facebook Seluler. publisher_platforms=['instagram']& device_platforms=['desktop']
, Anda akan melihat kesalahan.publisher_platforms: audience_network
tidak bisa dipilih sendirian. 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.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
.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
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
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>" }
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
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
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
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:
account_id
dan token aksesbilling_event
, seperti IMPRESSIONS
AUCTION
POST_ENGAGEMENT
POST_ENGAGEMENT
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.