Inserzioni video e carosello

Puoi facilmente creare, misurare e ottimizzare inserzioni video e carosello su Facebook attraverso l'API. Consulta Facebook for Business, Inserzioni carosello. Per i formati video suppportati per le inserzioni, vedi Centro assistenza per gli inserzionisti, Video.

Inserzioni video

Per creare un'inserzione video in un obiettivo VIDEO_VIEWS e ottimizzare l'offerta per la copertura, procedi nel modo seguente:

• Passaggio 1: fornire le creatività dell'inserzione
• Passaggio 2: creare una campagna pubblicitaria
• Passaggio 3: creare un gruppo di inserzioni
• Passaggio 4: creare un'inserzione

Passaggio 1: fornire le creatività dell'inserzione

Crea un'inserzione video utilizzando un ID video esistente e un video caricato su Facebook.

Ecco cosa ti servirà:

• Autorizzazioni pages_read_engagement e ads_management
• Un video caricato sull'endpoint act_{ad-account-id}/advideos

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

Slideshow

Per estendere o lanciare campagne del brand su telefoni con funzioni di base nei mercati emergenti o per creare un semplice video, prova gli slideshow di immagini (sono necessarie almeno 3 immagini). Carica immagini in una risorsa video. Ad esempio:

curl \
  -F 'slideshow_spec={ 
  "images_urls": [ 
  "<IMAGE_URL_1>", 
  "<IMAGE_URL_2>", 
  "<IMAGE_URL_3>" 
  ], 
  "duration_ms": 2000, 
  "transition_ms": 200 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph-video.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/advideos
 
  Open In Graph API Explorer

Consulta le best practice per le creatività video e il riferimento sui video delle inserzioni.

Passaggio 2: creare una campagna pubblicitaria

Imposta l'obiettivo su VIDEO_VIEWS:

curl -X POST \
  -F 'name="Video Views campaign"' \
  -F 'objective="OUTCOME_ENGAGEMENT"' \
  -F 'status="PAUSED"' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns
  
Open In Graph API Explorer

Consulta il riferimento sulle campagne, AdObjectives in PHP e AdObjectives in Python

Passaggio 3: creare un gruppo di inserzioni

Se il tuo obiettivo è ridurre il più possibile il costo per visualizzazione, associa l'obiettivo della campagna di visualizzazione del video al parametro optimization_goal=THRUPLAY del gruppo di inserzioni. Puoi impostare bidding_event su IMPRESSIONS o THRUPLAY per pagare per impression o per visualizzazione del video. Scopri di più sull'offerta CPV.

curl \
  -F 'name=A CPV Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2024-05-06T04:45:29+0000' \
  -F 'end_time=2024-06-06T04:45:29+0000' \
  -F 'billing_event=THRUPLAY' \
  -F 'optimization_goal=THRUPLAY' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
  "device_platforms": ["mobile"], 
  "geo_locations": {"countries":["US"]}, 
  "publisher_platforms": ["facebook"] 
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets


  Open In Graph API Explorer

Le tariffe dei costi per visualizzazione sono inferiori per i gruppi di inserzioni con optimization_goal=THRUPLAY rispetto ai CPV di acquisti basati su copertura e frequenza ottimizzati per le visualizzazioni del video. La data di fine deve essere nel futuro. Consulta il riferimento sui gruppi di inserzioni.

Passaggio 4: creare un'inserzione

Usa il gruppo di inserzioni e la creatività dell'inserzione esistenti:

curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="<AD_SET_ID>"' \
  -F 'creative={
  "creative_id": "<CREATIVE_ID>"
  }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

Quando l'obiettivo della campagna è VIDEO_VIEWS, l'inserzione acquisisce per impostazione predefinita le specifiche di monitoraggio corrette, che definiscono le azioni monitorate per un'inserzione. Ad esempio, le visualizzazioni del video:

{'action.type':'video_view','post':'POST_ID','post.wall':'PAGE_ID'}
    

Consulta Gestione inserzioni: le mie campagne e il riferimento sulle inserzioni.

Notorietà del brand di esempio

Per creare un'inserzione video per promuovere la notorietà del brand, consulta il post del blog sulla notorietà del brand.

Copertura e frequenza di esempio

Per estendere la copertura di un video a più persone, usa l'obiettivo della campagna di visualizzazione del video con copertura e frequenza. Dovrai creare una previsione, prenotarla e assegnarla al tuo gruppo di inserzioni.

Segui le indicazioni relative alla creazione per le visualizzazioni del video, ma applica copertura e frequenza al tuo gruppo di inserzioni. Specifica questi parametri aggiuntivi:

-F "rf_prediction_id=<RESERVATION_ID>" \

Video per la risposta diretta

Per incoraggiare le persone a passare dalla notorietà all'azione, consulta Video Creative in the Carousel Format (Creatività video nel formato carosello).

• Raggiungi le persone che hanno guardato un video. Dalla notorietà all'affinità e alla considerazione. Vedi Remarketing.
• Interagisci con il brand e i prodotti. Aggiungi una call to action per visitare una pagina specifica del tuo sito web. Vedi Call to action.

Remarketing

Il remarketing delle inserzioni video aiuta gli inserzionisti a targetizzare un pubblico personalizzato a partire da video organici o a pagamento sia su Facebook che su Instagram. Usa questa funzione per fare in modo che le persone passino dalla notorietà a obiettivi di funnel più significativi, come affinità e considerazione. Consulta Ricerca: combinazioni di creatività che funzionano.

Per creare un pubblico per un video su una pagina, hai bisogno dell'autorizzazione dell'inserzionista di quella pagina.

Per il pubblico, imposta subtype=ENGAGEMENT. Quindi scrivi le regole per il pubblico che desideri creare. Ogni regola ha un valore object_id, come ID video, e un valore event_name. Il valore event_name è uno dei seguenti:

• video_watched: il numero di volte in cui il tuo video è stato visualizzato per un totale di almeno 3 secondi o per la quasi totalità della durata, qualunque azione si sia verificata per prima.
• video_completed: il numero di volte in cui il tuo video è stato visualizzato fino al 95% della sua durata, incluse le visualizzazioni che sono saltate direttamente a quel punto.
• video_view_10s: il numero di volte in cui il tuo video è stato visualizzato per un totale di almeno 10 secondi o per la quasi totalità della durata, qualunque azione si sia verificata per prima.
• video_view_15s: il numero di volte in cui il tuo video è stato visualizzato per un totale di almeno 15 secondi o per la quasi totalità della durata, qualunque azione si sia verificata per prima.
• video_view_25_percent: il numero di volte in cui il tuo video è stato visualizzato fino al 25% della sua durata, incluse le visualizzazioni che sono saltate direttamente a quel punto.
• video_view_50_percent: il numero di volte in cui il tuo video è stato visualizzato fino al 50% della sua durata, incluse le visualizzazioni che sono saltate direttamente a quel punto.
• video_view_75_percent: il numero di volte in cui il tuo video è stato visualizzato fino al 75% della sua durata, incluse le visualizzazioni che sono saltate direttamente a quel punto.

Puoi combinare diversi video per creare un pubblico basato su più video e azioni. Ad esempio, un pubblico può contenere visualizzazioni da 3 secondi del video A e visualizzazioni complete dei video B e C.

Questo crea un pubblico sulla base degli spettatori che hanno visualizzato almeno 3 secondi del video 1 e di quelli che hanno visualizzato interamente il video 2 negli ultimi 14 giorni. Inoltre, il pubblico prevede l'inserimento automatico delle persone che hanno visualizzato il video prima della creazione del pubblico con prefill=true.

curl \
  -F 'name=Video Ads Engagement Audience' \
  -F 'subtype=ENGAGEMENT' \
  -F 'description=Users who watched my video' \
  -F 'prefill=1' \
  -F 'rule=[ 
  {"object_id":"%video_id_1","event_name":"video_watched"}, 
  {"object_id":"%video_id_2","event_name":"video_completed"} 
  ]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences
  
Open In Graph API Explorer

Il backfill per le visualizzazioni del video è supportato a partire dal 16 ottobre 2015.

Call to action

I video con call to action (CTA) invitano le persone a scoprire di più e visitare una pagina specifica su un sito web. Migliora le prestazioni quando il tuo obiettivo principale sono le visualizzazioni del video o la notorietà del brand e l'obiettivo secondario è l'aumento dei clic fuori dal sito. Per quest'ultimo, devi usare un'inserzione video con link. Ecco come vengono visualizzate le CTA:

• Su mobile e computer: vengono mostrate come parte del post. Quando il video viene messo in pausa, vengono visualizzate accanto all'opzione Riprendi.
• Su mobile: quando qualcuno clicca su un video per guardarlo a schermo intero, viene visualizzata una call to action mobile come overlay video.
• Post con link a video esterni: le CTA non vengono mostrate.

Puoi usare i video con CTA solo con i seguenti obiettivi della campagna:

• PAGE_LIKES
• LEAD_GENERATION
• LOCAL_AWARENESS
• LINK_CLICKS
• CONVERSIONS
• APP_INSTALLS
• VIDEO_VIEWS
• BRAND_AWARENESS
• Interazione con app mobili

Consulta Espansione dei video per obiettivi aggiuntivi. Questo esempio crea un'inserzione video con la call to action GET_DIRECTIONS:

curl \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": { 
  "call_to_action": { 
  "type": "GET_DIRECTIONS", 
  "value": { 
  "link": "fbgeo:\/\/37.48327, -122.15033, \"1601 Willow Rd Menlo Park CA\"" 
  } 
  }, 
  "image_url": "<THUMBNAIL_URL>", 
  "link_description": "Come check out our new store in Menlo Park!", 
  "video_id": "<VIDEO_ID>" 
  } 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
   https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Metriche dei video

Dati statistici sui post con video, organici

Scopri di più sulle prestazioni dei tuoi video su Facebook e prendi decisioni più informate in merito ai contenuti video. Attualmente, forniamo metriche solo quando qualcuno inizia a guardare i video. Questo include le visualizzazioni del video, le visualizzazioni uniche del video, la durata media della visualizzazione del video e il mantenimento del pubblico. Scopri i punti del video in cui le persone interrompono la visualizzazione e le parti che le persone potrebbero trovare più interessanti.

Dati statistici sui post con video, a pagamento

Usa l'API Ad Insights. La risposta contiene diverse metriche relative al video.

Tipo di video

Recupera le statistiche delle inserzioni video raggruppate per tipo di video, come riproduzione automatica o riproduzione tramite clic. Includi action_video_type in action_breakdowns. I valori attesi per action_video_type sono total, click_to_play e auto_play.

Attualmente, siamo in fase di test limitata per l'opzione action_video_type. Per identificare i client con i dettagli, verifica il parametro CAN_USE_VIDEO_METRICS_BREAKDOWN per l'account pubblicitario.

curl -G \
  -d 'action_breakdowns=action_video_type' \
  -d 'date_preset=last_30_days' \
  -d 'fields=actions,video_avg_pct_watched_actions,video_complete_watched_actions' \
  -d 'access_token= <ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
   
Open In Graph API Explorer

La risposta include oggetti con action_typevideo_view e contiene action_video_type:

{
  "data": [
    {
      "actions": [
        ...
        {
          "action_type": "video_play", 
          "value": 9898
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 921129
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 915971
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 5158
        }
      ], 
      "video_avg_pct_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 60.59
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 60.47
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 80.63
        }
      ], 
      "video_complete_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 156372
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 154015
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 2357
        }
      ], 
      "date_start": "2014-12-26", 
      "date_stop": "2015-03-25"
    }
  ], 
  "paging": {
    "cursors": {
      "before": "MA==", 
      "after": "MA=="
    }
  }
}

Vedi API Ad Insights

Inserzioni carosello

Ottieni più spazio per le creatività nel feed e rimanda le persone al tuo sito web o alla tua app mobile dove possono effettuare conversioni. Puoi creare un'inserzione carosello in due modi:

• Crea un'inserzione e un post della Pagina non pubblicato con una sola chiamata: API per le creatività dell'inserzione.
• Crea un post della Pagina non pubblicato, quindi crea le creatività dell'inserzione usando il post (non disponibile per il carosello video).

Le inserzioni carosello non sono supportate per Facebook Stories.

Creazione in linea

Crea un post della Pagina per l'inserzione carosello mentre sviluppi le creatività dell'inserzione. Specifica i contenuti del post della Pagina in object_story_spec, creando così un post della Pagina non pubblicato da adcreatives. Consulta Creatività dell'inserzione. Ad esempio:

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "link_data": { 
      "child_attachments": [ 
        { 
          "description": "$8.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product1", 
          "name": "Product 1", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$9.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product2", 
          "name": "Product 2", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$10.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product3", 
          "name": "Product 3" 
        } 
      ], 
      "link": "<URL>" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

La risposta è un ID della creatività:

{"id":"<CREATIVE_ID>"}

Creazione del post e successivamente dell'inserzione

Crea un post della Pagina non pubblicato. child_attachments è un array di oggetti del link. Su ogni oggetto del link, picture, name e description sono opzionali. Puoi pubblicarli a nome della Pagina solo con un token d'accesso della Pagina.

curl -X GET \
  -d 'message="Browse our latest products"' \
  -d 'published=0' \
  -d 'child_attachments=[
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 1",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 2",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 3",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 4",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       }
     ]' \
  -d 'caption="WWW.EXAMPLE.COM"' \
  -d 'link="http://www.example.com/products"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/posts
  
Open In Graph API Explorer

Fornisci quindi le creatività dell'inserzione con il post della Pagina non pubblicato. Usa l'id per il campo object_story_id nelle tue creatività dell'inserzione.

curl -X POST \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Creazione dell'inserzione video carosello

Le inserzioni carosello video possono includere l'elemento "caption" negli allegati secondari per personalizzare l'URL di visualizzazione nella schermata finale:

"child_attachments": [
 {
   "link": "https://www.facebookmarketingdevelopers.com/",
   "name": "Facebook Marketing Developers",
   "description": "Facebook Marketing Developers",
   "call_to_action": {
     "type": "APPLY_NOW",
     "value": {
      "link_title": "Facebook Marketing Developers"
     }
   },
   "video_id": "123",
   "caption": "mycustomlinkcaption.com"
  },
]

Per ottenere i dettagli degli allegati secondari, usa l'ID ed effettua una chiamata all'API Graph, riferimento sui video.

Creazione di un'inserzione per le app mobile

Limitazioni:

• Le inserzioni carosello per le app mobile supportano una sola app.
• È richiesto un minimo di tre immagini, rispetto alle due immagini delle inserzioni carosello che non promuovono un'app.
• Le inserzioni carosello per le app mobile devono avere una call to action.
• L'unità finale che di solito mostra l'immagine del profilo della pagina non verrà visualizzata per le inserzioni carosello su un'app mobile. Tieni presente che devi specificare lo stesso link allo store delle app in ciascun child_attachment. Non devi specificare di nuovo il link in call_to_action:{'value':{'link':... }}}.

Ad esempio, per creare un'inserzione carosello per le installazioni dell'app mobile:

\

curl -X POST \
  -F 'name="Carousel app ad"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "message": "My message",
         "link": "http://www.example.com/appstoreurl",
         "caption": "WWW.ITUNES.COM",
         "name": "The link name",
         "description": "The link description",
         "child_attachments": [
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           }
         ],
         "multi_share_optimized": true
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Puoi pubblicare il tuo post solo come la Pagina Facebook associata all'app mobile. Inoltre, devi usare un token d'accesso della Pagina.

curl \
  -F 'message=My description' \
  -F 'link=<APP_STORE_URL>' \
  -F 'caption=WWW.ITUNES.COM' \
  -F 'child_attachments=[ 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    } 
  ]' \
  -F 'multi_share_optimized=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/feed

Usa l'id della risposta per la creazione di AdCreative:

curl -X POST \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Specifica del campo

Questa è un'inserzione carosello su iOS, in cui puoi vedere come vengono usati i campi descritti.

Statistiche sulle inserzioni in base al prodotto

Azioni di gruppo per le inserzioni carosello in base a ciascun prodotto con actions_breakdown=['action_carousel_card_id', 'action_carousel_card_name']. Ogni child_attachment ha un ID unità diverso. Gli elementi action_carousel_card_id e action_carousel_card_name possono essere specificati solo per le inserzioni carosello.

Ottieni le seguenti statistiche per le unità:

• website_ctr: disponibile quando si specifica fields=['website_ctr'].
• app_install, app_use, apps.uses, credit_spent, mobile_app_install, tab_view, link_click, mobile_app_install, app_custom_event.*, offsite_conversion.*: disponibili quando si specifica fields=['actions']. Non sono disponibili altre azioni con i dettagli di un'unità.

curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_id"]' \
  -d 'level=ad' \
  -d 'date_preset=last_30_days' \
  -d 'time_increment=all_days' \
  -d 'breakdowns=placement' \
  --data-urlencode 'filtering=[ 
    { 
      "field": "action_type", 
      "operator": "IN", 
      "value": ["link_click"] 
    } 
  ]' \
  -d 'fields=impressions,inline_link_clicks,actions,website_ctr' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

Risposta:

{
...
   "website_ctr": [
      {
         "action_carousel_card_id": "1",
         "action_type": "link_click",
         "value": 51.401869158878
      },
      {
         "action_carousel_card_id": "2",
         "action_type": "link_click",
         "value": 50.980392156863
      }
   ],
   "placement": "mobile_feed",
   "date_start": "2015-05-25",
   "date_stop": "2015-05-28"
}

Puoi anche richiedere cost_per_action_type per i dettagli dei costi in base al tipo di azione:

curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_name"]' \
  -d 'level=ad' \
  -d 'breakdowns=placement' \
  -d 'fields=impressions,campaign_name,cost_per_action_type' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

Esempio di risposta:

{
   "data": [
      {
         "impressions": "1862555",
         "campaign_name": "My Campaign",
         "cost_per_action_type": [
            {
               "action_carousel_card_name": "My Carousel Card 1",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.093347346315861
            },
            {
               "action_carousel_card_name": "My Carousel Card 2",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.38324089579301
            },
            ...
         ],
      }
   ]
}

Posizionamenti

Se selezioni solo right_hand_column come posizionamento, puoi usare solo un formato carosello o un video singolo nel tuo gruppo di inserzioni. Non supportiamo il formato video quando è selezionato solo il posizionamento right_hand_column. Consulta Targetizzazione e posizionamento avanzati.

Ad esempio, crea un gruppo di inserzioni con right_hand_column come unico posizionamento:

curl \
  -F 'name=RHS only Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2017-11-21T15:41:36+0000' \
  -F 'end_time=2017-11-28T15:41:36+0000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
    "device_platforms": ["mobile"], 
    "geo_locations": {"countries":["US"]}, 
    "publisher_platforms": ["facebook"] ,
    "facebook_positions": ["right_hand_column"] ,  
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets
  
Open In Graph API Explorer

Fornisci una creatività dell'inserzione con il video:

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

In alternativa, fornisci un formato pubblicitario canvas per le creatività dell'inserzione:

curl \
  -F 'image_hash=<IMAGE_HASH>' \
  -F 'object_story_spec={ 
    "link_data": { 
      "call_to_action": {"type":"LEARN_MORE"}, 
      "image_hash": "<IMAGE_HASH>", 
      "link": "CANVAS_LINK", 
      "name": "Creative message" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

Se provi a creare un'inserzione con il gruppo di inserzioni e la creatività dell'inserzione:

curl \
  -F 'name=My Ad' \
  -F 'adset_id=<AD_SET_ID>' \
  -F 'creative={"creative_id":"<CREATIVE_ID>"}' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

Qualora ricevessi un codice di errore, dovrai fornire una creatività supportata o modificare la targetizzazione.

Altri contenuti da consultare

• Guida al caricamento dei video su Facebook
• Carosello per le inserzioni per app mobile
• Riferimento sull'API Graph sul feed della Pagina
• Post della Pagina non pubblicati
• Creatività dell'inserzione
• Inserzioni carosello di Instagram