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.
Die verfügbaren Plattformen und Positionen sind device_platforms
, publisher_platforms
, facebook_positions
, audience_network_positions
, instagram_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/v21.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_platforms
facebook
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/adsets
Bei Audience Network und In-Stream-Videos kannst du Publisher ebenfalls nach Kategorie ausschließen:
Name | Beschreibung |
---|---|
Array<string> | Dazu gehören:
Beispiel: |
Name: Optionen | Beschreibung |
---|---|
| Optional. |
| Optional. |
| Optional. Hinweise:
|
| 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.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
.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/adsets
So 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/adsets
So 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>/adsets
Gibt 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/adsets
So 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/v21.0
/act_<AD_ACCOUNT_ID>/adsets
So 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",
"ig_search"
],
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.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. 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 IMPRESSIONS
AUCTION
POST_ENGAGEMENT
POST_ENGAGEMENT
PIXEL_ID
Alle 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. 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, 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" } ], } }
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.