Pubblica inserzioni su posizionamenti specifici, ad esempio solo il feed dei computer oppure il feed mobile e il video con premio di Audience Network. Puoi utilizzare solo determinate opzioni di posizionamento a seconda dell'obiettivo della campagna. Consulta Campagna, obiettivo e posizionamenti per ulteriori informazioni.
Le piattaforme e le posizioni disponibili sono device_platforms
, publisher_platforms
, facebook_positions
, audience_network_positions
, instagram_positions
e messenger_positions
. Consulta la sezione Dispositivo, editore e posizioni per ulteriori informazioni.
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
Se non specifichi nulla per un particolare campo del posizionamento, Facebook prende in considerazione tutte le posizioni predefinite possibili per tale campo. Ad esempio, se imposti publisher_platforms
su facebook
, ma non selezioni nulla per facebook_positions
, Facebook prende in considerazione tutte le posizioni predefinite di Facebook come feed
, right_hand_column
, ecc. In alternativa, se non selezioni publisher_platforms
, Facebook considera tutte le publisher_platforms
predefinite. Inoltre, Facebook può considerare automaticamente nuove posizioni o piattaforme non appena diventano disponibili.
In Audience Network, puoi limitare quali editori possono visualizzare le tue inserzioni. Puoi escludere gli editori per categoria oppure creare una lista personalizzata di URL degli app store o degli URL dei domini da escludere.
Non puoi utilizzare esclusivamente right_hand_column
da solo come un posizionamento per inserzioni video, con raccolta o canvas.
Il filtro dei contenuti ti aiuta a controllare se le tue inserzioni vengono mostrate accanto a diversi tipi di contenuti per le inserzioni nei contenuti (video in-stream di Facebook, inserzioni su Facebook Reels e inserzioni su Instagram Reels), inserzioni di Audience Network e inserzioni nel feed (feed di Facebook, feed di Instagram, feed di Facebook Reels e feed di Instagram Reels). Per maggiori informazioni su queste categorie di contenuti, consulta Centro assistenza per le aziende, Filtro dei contenuti. Puoi scegliere valori separati per contenuti, Audience Network e inserzioni nel feed. Le opzioni includono: Expanded
, Moderate
e Limited
. Per i dettagli, vedi brand_safety_content_filter_levels
di seguito:
Nome | Descrizione |
---|---|
array<string> | Per le inserzioni nei contenuti (in-stream di Facebook e inserzioni su Facebook Reels), consentiamo questi valori:
Per Audience Network, consentiamo questi valori:
Per le inserzioni nel feed (feed di Facebook, feed di Instagram, feed di Facebook Reels e feed di Instagram Reels), consentiamo questi valori:
Esempio: Nota: quando viene applicato un filtro a livello di account pubblicitario, a livello della campagna saranno disponibili solo opzioni più restrittive. Ad esempio, se l'account è impostato su |
array<string> | Include: |
array<numeric strings> | Ogni stringa è un ID della lista per le esclusioni. Crea liste personalizzate in Gestione inserzioni o API Marketing, Lista di editori bloccati. Esempio: |
Ad esempio, per utilizzare 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
Per Audience Network e video in-stream, puoi anche escludere gli editori per categoria:
Nome | Descrizione |
---|---|
array<string> | Include:
Esempio: |
Nome: opzioni | Descrizione |
---|---|
| Facoltativo. |
| Facoltativo. |
| Facoltativo. Note:
|
| Facoltativo. |
| Facoltativo. |
| Facoltativo. Note:
|
OR
.publisher_platforms=['facebook','instagram']
significa pubblicare inserzioni su Facebook e Instagram. AND
.publisher_platforms=['facebook']&device_platforms=['mobile']
significa pubblicare le inserzioni solo su Facebook mobile. publisher_platforms=['instagram']& device_platforms=['desktop']
, vedrai un errore.publisher_platforms: audience_network
non può essere selezionato da solo. audience_network
con l'obiettivo VIDEO_VIEWS
deve essere utilizzato con l'obiettivo di ottimizzazione THRUPLAYS
.story
per facebook_positions
da solo. Se selezioni story
per facebook_positions
, devi selezionare anche feed
di Facebook oppure story
di Instagram.story
per messenger_positions
da solo. Se selezioni story
per messenger_positions
, devi selezionare anche feed
di Facebook oppure story
di Instagram.stream
e vengono controllate per l'idoneità web per essere pubblicate sia nei feed per computer sia in quelli su web mobile. Gli obiettivi compatibili sono BRAND_AWARENESS
, REACH
, LINK_CLICKS
, POST_ENGAGEMENT
, VIDEO_VIEWS
e CONVERSIONS
.Per utilizzare Facebook Stories come posizionamento:
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
Per creare un gruppo di inserzioni solo con il posizionamento instream_video
che targetizza un Paese supportato elencato in precedenza:
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
Per targetizzare il posizionamento video con premio di 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
Questo restituisce:
{ "targeting": { "audience_network_positions": [ "classic", "rewarded_video" ], "effective_audience_network_positions": [ "classic", "rewarded_video" ] }, "id": "<AD_SET_ID>" }
Per utilizzare Facebook Reels come posizionamento:
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
Per creare un gruppo di inserzioni solo con il posizionamento explore_home
che targetizza un Paese supportato (ad es. "US"):
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
Per creare un gruppo di inserzioni solo con il posizionamento ig_search
che targetizza un Paese supportato (ad es. "US"):
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
Crei gruppi di inserzioni con posizionamenti nelle specifiche di targetizzazione; tuttavia non sempre sai se Facebook ha pubblicato la tua inserzione nei posizionamenti specificati, perché il posizionamento selezionato potrebbe non essere applicabile all'obiettivo pubblicitario scelto. Grazie all'API effective placements per la targetizzazione, ora puoi determinare in quali posizionamenti verrà pubblicata la tua inserzione, date le tue opzioni di targetizzazione, e ricevere messaggi di convalida per comprendere il motivo per cui alcuni posizionamenti vengono filtrati. Se non fornisci la targetizzazione, puoi comunque determinare il posizionamento efficace in base al gruppo di inserzioni e alle impostazioni della campagna pubblicitaria.
Per leggere un posizionamento efficace in base alla tua targetizzazione, posiziona semplicemente effective_
prima del nome del campo di posizionamento. Ad esempio:
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>
Per vedere il motivo per cui alcuni posizionamenti sono stati filtrati, usa il campo recommendation
:
curl -G \ -d "fields=recommendations" \ -d "access_token=<access_token>" \ https://graph.facebook.com/<VERSION>/23842573364570019
Con i posizionamenti efficaci, ora puoi determinare quali posizionamenti verranno pubblicati dalla tua inserzione in base a billing_event
, optimization_goal
e promoted_object
del gruppo di inserzioni, nonché in base a buying_type
e objective
della campagna pubblicitaria. Tutti i parametri per /ad_campaign_placement
includono:
account_id
dell'inserzione e token d'accessobilling_event
, come IMPRESSIONS
AUCTION
POST_ENGAGEMENT
POST_ENGAGEMENT
PIXEL_ID
Tutti i parametri, tranne promoted_object
e optimization_goal
, sono obbligatori. Se fornisci la targetizzazione, puoi usare l'API Marketing per determinare il posizionamento efficace in base a quelli consentiti per le tue impostazioni; vedi Posizionamento efficace con la targetizzazione. Ad esempio:
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>
La chiamata restituisce:
{ "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" } ], } }
Puoi usare il campo code
da questo risultato in una chiamata ad /ad-recommendation
per vedere una motivazione dettagliata. Ad esempio, puoi ottenere queste informazioni:
[{“code”: 1815610, “summary”: “Device Platform Not Supported By Objective”},]
Per maggiori informazioni, consulta il riferimento sui consigli per le inserzioni e Posizionamento efficace con la targetizzazione.