Liefere Anzeigen an bestimmten Platzierungen aus, zum Beispiel nur im Desktop-Feed oder mobilen Feed plus Audience Network Rewarded Video. Du kannst abhängig von deinem Kampagnenziel nur bestimmte Platzierungsoptionen verwenden. Weitere Informationen findest du unter Kampagne, Ziele und Platzierungen.
Folgende Plattformen und Positionen sind verfügbar: device_platforms, publisher_platforms, facebook_positions, audience_network_positions, instagram_positions, threads_positions und messenger_positions. Weitere Informationen findest du im Abschnitt Gerät, Publisher und Positionen.
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/v24.0/act_<AD_ACCOUNT_ID>/adsets
Wenn du für ein Platzierungsfeld keinen Wert festlegst, berücksichtigt Facebook alle möglichen Standardpositionen für dieses Feld. Wenn du zum Beispiel für publisher_platformsfacebook festlegst, jedoch keine Auswahl für facebook_positions triffst, berücksichtigt Facebook alle Standardpositionen in Facebook wie beispielsweise feed, right_hand_column usw. Oder wenn du keine publisher_platforms auswählst, berücksichtigt Facebook alle standardmäßigenpublisher_platforms. Facebook zieht möglicherweise auch neue Positionen oder Plattformen in Erwägung, sobald diese verfügbar sind.
Im Audience Network kannst du einschränken, welche Publisher deine Werbung anzeigen sollen. Schließe Publisher nach Kategorie aus oder erstelle eine eigene Liste mit auszuschließenden App-Store- oder Domänen-URLs.
Du kannst nicht right_hand_column allein als Platzierung für Video, Collection oder Canvas Ads verwenden.
Mit dem Content-Filter kannst du steuern, ob deine Anzeigen neben verschiedenen Arten von Content für In-Content-Anzeigen (In-Stream-Videos von Facebook, Anzeigen auf Facebook Reels und Anzeigen auf Instagram Reels), Audience Network-Anzeigen und Feed-Anzeigen (Facebook Feed, Instagram Feed, Facebook Reels Feed und Instagram Reels Feed) angezeigt werden. Weitere Informationen zu diesen Inhaltskategorien findest du unter Hilfebereich für Unternehmen, Content-Filter. Du kannst für In-Content-, Audience Network- und Feed-Ads unterschiedliche Werte verwenden. Die Optionen umfassen Expanded, Moderate und Limited. Weitere Details findest du nachstehend unter brand_safety_content_filter_levels:
| Name | Beschreibung |
|---|---|
Array<string> | Für In-Content-Ads (Facebook In-Stream und Anzeigen auf Facebook Reels) sind diese Werte zulässig:
Für Audience Network sind diese Werte zulässig:
Für Feed-Anzeigen (Facebook Feed, Instagram Feed, Facebook Reels Feed und Instagram Reels Feed) sind diese Werte zulässig:
Beispiel: Hinweis: Wenn ein Filter auf Werbekonto-Ebene angewendet wird, sind auf Kampagnenebene nur stärker einschränkende Optionen verfügbar. Wenn das Konto z. B. auf |
Array<string> | Beinhaltet |
Array<numeric strings> | Jeder String stellt eine Listen-ID für Ausschlüsse dar. Erstelle eigene Listen unter Werbeanzeigenmanager oder Marketing API, Publisher-Blockierliste. Beispiel: |
So verwendest du beispielsweise 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/adsetsBei Audience Network und In-Stream-Videos kannst du Publisher ebenfalls nach Kategorie ausschließen:
| Name | Beschreibung |
|---|---|
Array<string> | Enthalten:
Beispiel: |
| Name: Optionen | Beschreibung |
|---|---|
| Optional. |
| Optional. Hinweise:
|
| Optional. Hinweise:
|
| Optional. |
| Optional. |
| Optional. |
| Optional. Hinweise:
|
OR.publisher_platforms=['facebook','instagram'], dass Anzeigen auf Facebook und Instagram ausgeliefert werden. AND.publisher_platforms=['facebook']&device_platforms=['mobile'], dass diese Anzeigen nur auf Facebook für Mobilgeräte ausgeliefert werden. publisher_platforms=['instagram']& device_platforms=['desktop'], wird ein Fehler angezeigt.publisher_platforms: audience_network nicht selbst wählen. audience_network mit dem Ziel VIDEO_VIEWS zusammen mit dem Optimierungsziel THRUPLAYS verwenden.story kannst du nicht für facebook_positions selbst auswählen. Wenn du story für facebook_positions auswählst, musst du außerdem Facebook feed oder Instagram story wählen.story kannst du nicht für messenger_positions selbst auswählen. Wenn du story für messenger_positions auswählst, musst du außerdem entweder Facebook feed oder Instagram story wählen.notification kannst du nicht für facebook_positions selbst auswählen. Wenn du notification für facebook_positions auswählst, musst du außerdem Facebook feed wählen.stream und werden auf ihre Web-Berechtigung überprüft, um sowohl über Desktop als auch mobile Web-Feeds ausgeliefert zu werden. Die kompatiblen Ziele sind BRAND_AWARENESS, REACH, LINK_CLICKS, POST_ENGAGEMENT, VIDEO_VIEWS und CONVERSIONS.threads_stream kannst du nicht für threads_positions alleine auswählen. Wenn du threads_stream für threads_positions auswählst, musst du außerdem Instagram stream wählen.Wenn du mithilfe von Platzierungseinschränkungen bestimmte Platzierungen für deine Anzeigengruppen ausschließt, kannst du zulassen, dass bis zu 5 % deiner Ausgaben für jede ausgeschlossene Platzierung ausgegeben werden, wenn dies die Performance verbessern könnte.
Um eine Platzierung mit eingeschränktem Budget zu deaktivieren, übergib die gewünschten Platzierungspositionen mit dem Feld placement_soft_opt_out, wenn du eine Anzeigengruppe erstellst oder aktualisierst.
Folgende Positionen sind verfügbar: facebook_positions, audience_network_positions, instagram_positions, threads_positions und messenger_positions.
"placement_soft_opt_out": { "facebook_positions": [ "marketplace", "profile_feed" ], "audience_network_positions": [ "classic", "rewarded_video" ] }
Um zu sehen, für welche Platzierungen ein begrenztes Ausgabenlimit festgelegt wurde, frage das Feld placement_soft_opt_out einer Anzeigengruppe ab.
curl -G \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/v24.0<AD_SET_ID>?fields=placement_soft_opt_out"
So verwendest du Facebook Stories als Platzierung:
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/adsetsSo erstellst du eine Anzeigengruppe nur mit der Platzierung instream_video, die sich an eines der oben aufgeführten unterstützten Länder richtet:
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/adsetsSo erstellst du dein Targeting für eine Network Rewarded Video-Platzierung:
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>/adsetsGibt Folgendes zurück:
{
"targeting": {
"audience_network_positions": [
"classic",
"rewarded_video"
],
"effective_audience_network_positions": [
"classic",
"rewarded_video"
]
},
"id": "<AD_SET_ID>"
}So verwendest du Facebook Reels als Platzierung:
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/adsetsSo erstellst du eine Anzeigengruppe mit der Platzierung explore_home, die sich an ein unterstütztes Land richtet (z. B. „USA“):
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/v24.0/act_<AD_ACCOUNT_ID>/adsets
So erstellst du eine Anzeigengruppe mit der Platzierung ig_search, die auf ein unterstütztes Land ausgerichtet ist (z. B. „USA“):
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/v24.0/act_<AD_ACCOUNT_ID>/adsets
curl \ -F 'name=Threads Adset' \ -F 'optimization_goal=LINK_CLICKS' \ -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": ["instagram", "threads"], "instagram_positions": ["stream"], "threads_positions": ["threads_stream"], "user_os": ["iOS"] }' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/act_<AD_ACCOUNT_ID>/adsets
Du hast Anzeigengruppen mit Platzierungen in den Target-Spezifikationen erstellt, doch du warst nicht immer sicher, ob Facebook deine Anzeigen an den festgelegten Platzierungen ausgeliefert hat. Das liegt daran, dass deine ausgewählte Platzierung möglicherweise nicht für das festgelegte Werbeziel zur Verfügung steht. Mit der Effective Placements API für Targeting kannst du herausfinden, an welchen Platzierungen deine Anzeige anhand deiner Targetig-Optionen ausgeliefert wird. Außerdem erhältst du Validierungsnachrichten, dank derer du nachvollziehen kannst, warum bestimmte Platzierungen herausgefiltert werden. Wenn du kein Targeting angibst, kannst die die effektive Platzierung dennoch auf Basis der Anzeigengruppen- und Anzeigenkampagneneinstellungen ermitteln.
Setze effective_ vor den Platzierungsfeldnamen, um eine wirksame Platzierung basierend auf deinem Targeting zu lesen. Zum Beispiel:
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>Verwende das recommendation-Feld, um zu sehen, warum manche Platzierungen herausgefiltert wurden:
curl -G \ -d "fields=recommendations" \ -d "access_token=<access_token>" \ https://graph.facebook.com/<VERSION>/23842573364570019
Mit den wirksamen Platzierungen kannst du festlegen, welche Platzierungen deine Anzeige bereitstellt anhand von billing_event, optimization_goal und promoted_object deiner Anzeigengruppe sowie von buying_type und objective deiner Anzeigenkampagne. Alle Parameter für /ad_campaign_placement beinhalten:
account_id und Zugriffsschlüsselbilling_event, wie zum Beispiel IMPRESSIONSAUCTIONPOST_ENGAGEMENTPOST_ENGAGEMENTPIXEL_IDAlle Parameter mit Ausnahme von promoted_object und optimization_goal sind obligatorisch. Durch Targeting-Angabe kannst du mit der Marketing API die wirksame Platzierung basierend auf den für deine Einstellungen zulässigen Platzierungen ermitteln, siehe Wirksame Platzierung mit Targeting. Zum Beispiel:
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>
Der Aufruf gibt Folgendes zurück:
{
"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",
"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"
}
],
}
}Mit dem Feld code aus diesem Ergebnis in einem /ad-recommendation-Anruf kannst du einen detaillierten Grund anzeigen lassen. Du kannst beispielsweise diese Informationen abrufen:
[{“code”: 1815610, “summary”: “Device Platform Not Supported By Objective”},]Weitere Informationen findest du unter Werbeanzeigenempfehlung, Referenz und Effektive Platzierung mit Targeting.