Targetizzazione del posizionamento

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

brand_safety_content_filter_levels

array<string>

Per le inserzioni nei contenuti (in-stream di Facebook e inserzioni su Facebook Reels), consentiamo questi valori:

  • EXPANDED: FACEBOOK_RELAXED
  • MODERATE: FACEBOOK_STANDARD
  • LIMITED: FACEBOOK_STRICT

Per Audience Network, consentiamo questi valori:

  • EXPANDED: AN_RELAXED
  • MODERATE: AN_STANDARD
  • LIMITED: AN_STRICT

Per le inserzioni nel feed (feed di Facebook, feed di Instagram, feed di Facebook Reels e feed di Instagram Reels), consentiamo questi valori:

  • EXPANDED: FEED_RELAXED
  • MODERATE: FEED_STANDARD
  • LIMITED: FEED_STRICT

Esempio: "brand_safety_content_filter_levels":["FACEBOOK_STRICT", "AN_RELAXED"]

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 MODERATE, l'utente potrà selezionare solo MODERATE o LIMITED per una campagna. Non saranno disponibili opzioni meno restrittive (in questo esempio, EXPANDED).

excluded_publisher_categories

array<string>

Include: dating e gambling

excluded_publisher_list_ids

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:
"excluded_publisher_list_ids":["{block_list_id_1}","{block_list_id_2}"]

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

excluded_publisher_categories

array<string>

Include:

  • debated_social_issues
  • mature_audiences
  • tragedy_and_conflict

Esempio:
"excluded_publisher_categories": ["debated_social_issues", "mature_audiences"]

Dispositivo, editore e posizioni

Nome: opzioni Descrizione

device_platforms: mobile, desktop

Facoltativo.
Predefinito: tutti
I tipi di dispositivo posseduti dalla persona che vede la tua inserzione.

publisher_platforms: facebook, instagram, messenger, audience_network

Facoltativo.
Predefinito: tutti
Il canale di pubblicazione per la tua inserzione. Puoi impostare la posizione del canale di pubblicazione in facebook_positions, instagram_positions, audience_network_positions o messenger_positions.

facebook_positions: feed, right_hand_column, marketplace, video_feeds, story, search, instream_video, facebook_reels, facebook_reels_overlay, profile_feed

Facoltativo.
Predefinito: tutti


Note:

  • Se fornito, publisher_platforms deve includere facebook oppure, se non fornito, è "tutti" per impostazione predefinita.
  • feed include il feed del computer e quello mobile.
  • Per le campagne che targetizzano gli Stati Uniti (US), il Regno Unito (GB), la Francia (FR), la Spagna (ES), la Germania (DE), il Messico (MX), l'India (IN) e la Thailandia (TH), puoi utilizzare instream_video senza feed per gli obiettivi VIDEO_VIEWS e POST_ENGAGEMENT. instream_video non è supportato per l'obiettivo CONVERSIONS.
  • Se selezioni story, devi utilizzare feed di Facebook oppure story e device_platforms: mobile di Instagram perché Facebook Stories è solo per i dispositivi mobili.
  • Se selezioni marketplace, search o profile_feed, devi usare feed.
  • A partire dalla v3.0, right_hand_column è disponibile solo per i formati immagine singola, video singolo e carosello per gli obiettivi TRAFFIC, CONVERSIONS e PRODUCT_CATALOG_SALES.

instagram_positions: stream, story, explore, explore_home, reels, profile_feed, ig_search, profile_reels

Facoltativo.
Predefinito: tutti
Puoi targetizzare le inserzioni carosello di Instagram per stream, story o ig_search di Instagram. Se usi creatività carosello non promosse nelle storie, non puoi selezionare entrambe le opzioni per lo stesso gruppo di inserzioni.
Le inserzioni che usano story saranno mostrate sia nei feed per computer sia in quelli su web mobile.

audience_network_positions: classic, rewarded_video

Facoltativo.
Predefinito: tutti
Per impostazione predefinita, non restituiamo effective_audience_network_positions quando leggi le specifiche di targetizzazione per un gruppo di inserzioni. Tale impostazione potrebbe essere diversa dal parametro audience_network_positions configurato. Se specifichi una posizione non supportata per un determinato obiettivo, questa viene visualizzata nella lista delle posizioni configurate, ma non nella lista delle posizioni effettive.

messenger_positions: messenger_home, sponsored_messages, story

Facoltativo.
Predefinito: messenger_home, story


Note:

  • Se selezioni messenger_home, devi selezionare anche publisher_platform e feed di Facebook per facebook_positions.
  • messenger_home è disponibile per immagine singola e carosello negli obiettivi LINK_CLICKS, CONVERSIONS, MESSAGES, APP_INSTALLS e PRODUCT_CATALOG_SALES per le inserzioni che aumentano il traffico verso siti web, app e Messenger.
  • Se selezioni story, devi utilizzare feed di Facebook oppure story e device_platforms: mobile di Instagram perché Messenger Stories è solo per i dispositivi mobili. Puoi utilizzare story per i formati immagine singola e video nelle campagne pubblicitarie con gli obiettivi CONVERSIONS, TRAFFIC, REACH, BRAND_AWARENESS e APP_INSTALLS per le inserzioni che aumentano il traffico verso siti web e app.
  • Non puoi utilizzare sponsored_messages con gli altri posizionamenti, tra cui messenger_home o i posizionamenti di Facebook.

Logica

  • La logica per le opzioni nello stesso parametro è OR.
    Ad esempio, publisher_platforms=['facebook','instagram'] significa pubblicare inserzioni su Facebook e Instagram.
  • La logica tra i parametri è AND.
    Ad esempio, publisher_platforms=['facebook']&device_platforms=['mobile'] significa pubblicare le inserzioni solo su Facebook mobile.
  • Se la logica si traduce nella targetizzazione di nessuno, come publisher_platforms=['instagram']& device_platforms=['desktop'], vedrai un errore.

Limitazioni

  • Non puoi utilizzare Audience Network da solo, quindi publisher_platforms: audience_network non può essere selezionato da solo.
  • Il posizionamento audience_network con l'obiettivo VIDEO_VIEWS deve essere utilizzato con l'obiettivo di ottimizzazione THRUPLAYS.
  • Non puoi selezionare story per facebook_positions da solo. Se selezioni story per facebook_positions, devi selezionare anche feed di Facebook oppure story di Instagram.
  • Non puoi selezionare story per messenger_positions da solo. Se selezioni story per messenger_positions, devi selezionare anche feed di Facebook oppure story di Instagram.
  • Le inserzioni nei feed web di Instagram utilizzano il posizionamento 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.

Esempi

Storie

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

Video in-stream

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

Audience Network

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>"
}

Reel

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

Home di Esplora di Instagram

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

Risultati della ricerca di Instagram

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

Posizionamento efficace con targetizzazione

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'accesso
  • billing_event, come IMPRESSIONS
  • Tipo di acquisto, come AUCTION
  • Obiettivo, come POST_ENGAGEMENT
  • Obiettivo di ottimizzazione, facoltativo, come POST_ENGAGEMENT
  • Oggetto promosso, come 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.