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/v19.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 impostazioni predefinitepublisher_platforms
. 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. Escludi gli editori per categoria oppure crea 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.
Filtro dei contenuti ti aiuta a controllare se le tue inserzioni vengono visualizzate accanto a diversi tipi di contenuto in-stream di Facebook e Audience Network. Per maggiori informazioni su queste categorie di contenuti, consulta Centro assistenza per le aziende, Filtro dei contenuti. Puoi scegliere un valore per in-stream di Facebook e un valore per Audience Network. Le opzioni includono: Full
, Standard
e Limited
. Per i dettagli, vedi brand_safety_content_filter_levels
di seguito:
Nome | Descrizione |
---|---|
array<string> | Per in-stream di Facebook, consentiamo questi valori:
Per Audience Network, 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 moderato, l'utente potrà selezionare solo moderato o limitato per una campagna. Non saranno disponibili opzioni meno restrittive (in questo esempio, esteso).
|
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/v19.0
/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",
"ig_search"
],
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.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.