Prenotazione

La prenotazione ti consente di pianificare e acquistare le tue campagne a un costo fisso, offrendo una copertura ottimizzata e una frequenza pubblicitaria controllata, aiutandoti a prevedere le prestazioni della tua campagna. La procedura è simile a quella impiegata per l'acquisto degli spot televisivi. Si tratta di un'opzione avanzata e specializzata che verrà usata dalla maggior parte degli inserzionisti solo quando vogliono essere certi che le inserzioni raggiungano un certo numero di account del Centro gestione account.

La prenotazione funziona per tutti i tipi di inserzione e i dispositivi. Dal momento che Meta targetizza in base a persone reali e non a cookie, possiamo predire in modo più preciso la copertura e controllare la frequenza in tutti i dispositivi.

Restrizioni

• Disponibile per determinati account pubblicitari. Consulta il parametro CAN_USE_REACH_AND_FREQUENCY di un account pubblicitario.
• Lo stop_time del gruppo di inserzioni deve ricadere entro i 180 giorni di una previsione.
• Gli account presentano anche limitazioni in base al Paese; effettua il controllo con una chiamata API GET a https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>?fields=rf_spec.
• Imposta un solo Paese per volta in target_spec.
• Nessuna versione di iOS minima per user_os, ad esempio iOS_ver_2.0_and_above.
• Durante la creazione o l'aggiornamento di una campagna di prenotazione, non puoi impostare il budget giornaliero o totale, il limite di impression giornaliere o totali, il limite di frequenza o l'offerta esterna né il campo PacingType.

Cerca rf_spec per i limiti applicabili:

I risultati si presentano così:

{
  "rf_spec": {
    "min_reach_limits": {
      "US": 1000000,
      "CA": 1000000,
    },
    "countries": [
      "US",
      "CA",
    ],
    "min_campaign_duration": {
      "US": 3,
      "CA": 3,
    },
    "max_campaign_duration": {
      "US": 30,
      "CA": 30,
    },
    "max_days_to_finish": {
      "US": 56,
      "CA": 56,
    }
  }
}

Creazione di previsioni

Le previsioni contengono il numero di account del Centro gestione account che la tua inserzione può raggiungere in un intervallo di date in base a copertura, frequenza, pubblico e budget determinati. Le stime della prenotazione possono aiutarti a simulare i risultati complessivi della tua campagna e si modificano in base a obiettivo, budget, pubblico, formati e posizionamenti, brand safety, obiettivo di prestazioni e impostazioni di controllo della frequenza.

Le modifiche a una campagna di prenotazione sono possibili fino a prima del lancio, successivamente non potrai modificarla o sospenderla tranne che per cambiare le creatività dell'inserzione. Se modifichi solamente le creatività di un'inserzione, la previsione non cambierà. Per annullare e interrompere la campagna puoi eliminarla, ma poi dovrai prenotarla di nuovo; in questa occasione potresti ricevere un nuovo CPM e una previsione sugli esiti della campagna. Prenota solo campagne che intendi lanciare.** Per i test, limita le prenotazioni alla dimensione e alla durata minime; in seguito assicurati di annullarle poiché si tratta di un inventario di inserzioni reali che, se non annullate, verranno prenotate.

Limiti

Esistono limiti predefiniti per le previsioni:

• I gruppi di pubblico targetizzato devono essere composti da almeno 300 000 account del Centro gestione account
• Si deve ottenere una copertura minima di 200 000 account del Centro gestione account
• La pubblicazione dei gruppi di inserzioni deve avvenire per almeno 1 giorno e per non più di 90 giorni (il numero di giorni viene calcolato come il numero dei giorni per cui viene pubblicata la campagna. Ad esempio, se la campagna inizia alle 12:00 del primo giorno e termina alle 10:00 del secondo giorno, viene considerata come pubblicata per 2 giorni, sebbene la durata effettiva in ore sia inferiore a 24 ore).
• L'ora di fine del gruppo di inserzioni deve ricadere entro i 180 giorni di una previsione.
• La campagna deve terminare dopo le 6:00 dell'ultimo giorno, nel fuso orario dell'account pubblicitario.

Lettura delle previsioni

Per i dettagli, specifica i campi. Per vedere tutti gli elementi reachfrequencyprediction di un account, effettua una richiesta HTTP GET a https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/reachfrequencypredictions?fields={COMMA_SEPERATED_FIELD_LIST}.

Per raggiungere tutti gli elementi reachfrequencyprediction in base a un ID reachfrequencyprediction, effettua una richiesta HTTP GET con i campi desiderati: https://graph.facebook.com/{API_VERSION}/{RF_PREDICTION_ID}?fields={COMMA_SEPERATED_FIELD_LIST}.

Per impostazione predefinita, Meta restituisce l'ID. Per i dettagli sui campi, consulta Previsione sulla prenotazione, Lettura.

Codici di stato delle risposte

Indica i possibili risultati di status in reachfrequencyprediction. Laddove applicabile, saranno presenti limitazioni iniziali. Tuttavia, in futuro, queste potrebbero variare in base all'account pubblicitario o al Paese:

Uso delle previsioni

Fornisci l'ID previsione e i relativi dati come input per la creazione di un nuovo ID che agirà come ID prenotazione. Quindi, allega l'ID prenotazione al gruppo di inserzioni. Creando una prenotazione, l'inventario non sarà disponibile ad altri, pertanto devi allegarlo prima della scadenza.

Se la prenotazione avviene correttamente, prenotiamo temporaneamente l'inventario per tuo conto. Hai circa un'ora dalla prenotazione per assegnare un'inserzione a un gruppo di inserzioni.

Prenotazione

Prenota le previsioni per il tuo gruppo di inserzioni per fissare il prezzo e ottenere una copertura prevedibile. Prenota un pubblico identificato da reachfrequencyprediction per un'ora specifica con reserve per action. Puoi usare un singolo ID previsione per generare più prenotazioni. Ad esempio:

curl \
-F 'action=reserve' \
-F 'rf_prediction_id=<RF_PREDICTION_ID>' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'
 
// Response 
{"id":9876543210"}

Per prenotare l'inventario in base a una previsione, effettua una chiamata API POST a https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/reachfrequencypredictions.

Per reach, budget e impression, puoi prenotare una previsione in un punto specifico su curve_budget_reach, anziché nella tupla originale di copertura/budget di previsione. Usa questi campi:

Meta prenota le previsioni in modo asincrono. Devi effettuare il polling e verificare lo stato della previsione. Inizialmente, lo stato della previsione è 2 (IN SOSPESO). Al completamento, lo stato è 1, SUCCESS o 15, FAIL, ovvero non disponiamo dell'inventario per completare la prenotazione.

Dal momento che il sistema di prenotazione è dinamico, potresti notare lievi variazioni nella disponibilità dell'inventario tra il momento della previsione e quello della prenotazione. Tuttavia, Meta rispetta i valori che ottieni al momento della previsione, finché le modifiche ricadono entro una soglia ragionevole.

Assegnazione ai gruppi di inserzioni

Dopo aver prenotato correttamente una previsione, usala per creare un gruppo di inserzioni:

curl \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"

Per assegnare una previsione in modo corretto, il gruppo di inserzioni deve soddisfare questi criteri:

• Non specificare:
• start_time: elemento derivato dalla previsione.
• end_time: elemento derivato dalla previsione.
• targeting: elemento derivato dalla previsione.
• bid_amount
• optimization_goal
• lifetime_budget o daily_budget
• Puoi assegnare le prenotazioni ai gruppi di inserzioni senza inserzioni attive. Tuttavia, devi avere almeno un'inserzione attiva prima dell'avvio del gruppo di inserzioni.
• Devi includere rf_prediction_id, che allega la previsione al nuovo gruppo di inserzioni.
• L'attributo della campagna pubblicitaria di buying_type è RESERVED.

Puoi anche allegare reachfrequencyprediction ai gruppi di inserzioni per modificarne la previsione. Per farlo, effettua una richiesta POST a https://graph.facebook.com/{ad_set_id} con rf_prediction_id per l'elemento reachfrequencyprediction da usare.

Questi sono i limiti nel gruppo di inserzioni:

• Opzioni relative alla piattaforma dell'editore: facebook, instagram.
• Opzioni relative al posizionamento su Facebook: feed e rightcolumn.
• Opzioni relative al posizionamento su Instagram: stream, story, explore, explore_home e reels. Se il posizionamento include instagram, devi usare destination_ids e non destination_id. Il campo destination_ids deve contenere l'ID Pagina Facebook usato come destination_id, oltre all'ID account Instagram.
• Pubblico personalizzato o categorie di partner, ma non entrambi.
• Non è ammessa la targetizzazione con esclusione in base al coinvolgimento dei fan, alle interazioni con i video o del pubblico personalizzato dal sito web.
• L'elemento promoted_object del gruppo di inserzioni deve corrispondere all'elemento destination_id della previsione. Per i post della pagina, deve trattarsi dell'ID della pagina specificato per le inserzioni sulle app e deve corrispondere all'ID app specificato.
• È supportata la distribuzione delle inserzioni in modo programmato o standard, ma non la pubblicazione accelerata.

Gli addebiti per le campagne con prenotazione avvengono sulle impression attuali. Se l'ora di inizio della campagna viene superata e nel gruppo di inserzioni non sono presenti inserzioni attive, la pubblicazione della campagna non avviene e non vengono effettuati addebiti. Meta libera l'inventario residuo, tuttavia potremmo sottoporre l'account pubblicitario a penalizzazione nel caso in cui questa situazione si verifichi di frequente.

Quando crei una campagna usando il tipo di acquisto basato sulla prenotazione di Meta, accetti di pagare i costi proposti per l'inventario pubblicitario che prenoti. Se desideri modificare le dimensioni del pubblico o la frequenza dell'inserzione, anche i costi varieranno. Puoi apportare queste modifiche in qualsiasi momento prima dell'inizio della campagna. Puoi modificare le creatività delle inserzioni fino all'inizio della campagna.

Gestione delle inserzioni

I gruppi di inserzioni con prenotazione possono contenere più inserzioni e puoi aggiungere altre inserzioni in qualsiasi punto. Se il gruppo di inserzioni viene attivato e non sono presenti inserzioni attive, devi creare la tua prima inserzione entro 24 ore per i gruppi di inserzioni della durata di 3-30 giorni o entro 6 ore per quelli della durata di 1-2 giorni. In caso contrario, elimineremo la prenotazione.

Dissociazione delle previsioni, modifica dei gruppi di inserzioni

Puoi modificare o mettere in pausa una campagna con prenotazione prima che inizi. Una volta avviata la campagna, puoi solo modificare le creatività dell'inserzione e il budget o estenderne la data di fine. Se modifichi solamente le creatività di un'inserzione, la previsione non cambierà.

Se modifichi il budget o la data di fine, è possibile che venga generata una nuova previsione per la campagna, che visualizzerai nelle stime di prenotazione.

Non puoi mettere in pausa una campagna con prenotazione dopo il suo inizio, ma puoi eliminarla in qualsiasi momento per annullarla.

Per mettere in pausa o modificare un gruppo dopo il suo avvio, consulta Pausa e riavvio dei gruppi di inserzioni attivi e Modifica dei gruppi di inserzioni attivi. Per eliminare un gruppo attivo, consulta il riferimento per il gruppo di inserzioni. Ti verranno addebitate tutte le impression attuali.

Nota: per evitare potenziali errori, è fortemente sconsigliato eliminare tutte le inserzioni quando un gruppo di inserzioni con prenotazione è pubblicato.

Se assegni una prenotazione a un gruppo di inserzioni prima che tale gruppo diventi attivo, non potrai modificare la maggior parte degli attributi, a meno che non dissoci la prenotazione. Effettua una richiesta HTTP POST all'inserzione e imposta rf_prediction_id su 0. Nell'oggetto del gruppo di inserzioni puoi modificare solo l'attributo name.

Per dissociare una prenotazione:

curl \
-F "rf_prediction_id=0" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"

Una volta che il gruppo di inserzioni è attivo, non sarà possibile dissociare la prenotazione e gli attributi del gruppo non saranno modificabili, fatta eccezione per alcuni attributi dell'inserzione aggiunti alla lista di elementi consentiti:

• name
• creative_id
• creative_spec
• conversion_specs
• tracking_specs
• view_tags

Pausa e riavvio dei gruppi di inserzioni

Puoi mettere in pausa un gruppo attivo, consulta il riferimento per il gruppo di inserzioni. Se metti in pausa un gruppo di inserzioni per oltre 30 minuti, non potremo più garantire la previsione per tale gruppo.

Per riattivare un gruppo messo in pausa per più di 30 minuti, ti serve una nuova previsione. Effettua una richiesta POST a reachfrequencypredictions. Consulta Creazione di una previsione e Prenotazione della previsione. Devi passare un existing_campaign_id affinché il gruppo attivo venga riattivato nella richiesta. Dopo aver creato e prenotato una nuova previsione, allega reachfrequencyprediction al gruppo di inserzioni con HTTP POST impostato su https://graph.facebook.com/{ad_set_id}, specificando rf_prediction_id per la previsione da usare.

Modifica dei gruppi di inserzioni attivi

Puoi effettuare questi aggiornamenti dopo l'avvio di un gruppo.

• Puoi aumentare o diminuire il budget e la copertura del gruppo di inserzioni. Il budget o la copertura deve essere maggiore della spesa o della copertura corrente.
• Puoi estendere la programmazione del gruppo di inserzioni a 90 giorni.

Non puoi modificare o mettere in pausa un gruppo attivo se questo soddisfa uno dei criteri seguenti:

• Pubblicazione gravemente insufficiente. Pubblicazione di meno del 10% della previsione. Gruppi troppo costosi, con spesa oltre il budget.
• Gruppi di inserzioni in pubblicazione per un solo giorno.
• Gruppi di inserzioni che terminano entro le 24 ore successive.

Per modificare i gruppi di inserzioni attivi, ottieni una nuova previsione. Consulta Creazione di una previsione e Prenotazione della previsione. Devi passare un existing_campaign_id per il gruppo attivo affinché venga riattivato nella richiesta.

Dopo aver creato e prenotato una nuova previsione, puoi allegare reachfrequencyprediction al gruppo di inserzioni attraverso una richiesta HTTP POST a https://graph.facebook.com/{ad_set_id}, specificando rf_prediction_id come l'ID della previsione di frequenza e copertura da usare.

Riutilizzo del pubblico prenotato

Se annulli una prenotazione, l'inventario prenotato viene liberato per altri inserzionisti. Tuttavia, puoi riutilizzare il pubblico di una previsione prenotata in precedenza se non è già in uso. In questo modo, possiamo prendere in considerazione un inventario aggiuntivo per creare le previsioni, senza dover annullare le prenotazioni già esistenti.

Quando crei una prenotazione, includi rf_prediction_id_to_share. Si tratta dell'ID di una previsione precedente. In questo modo, la prenotazione precedente viene invalidata e tu puoi usare l'inventario per la prenotazione appena creata.

Per prenotare la nuova previsione, devi anche passare il parametro aggiuntivo rf_prediction_id_to_release, ovvero l'ID della prenotazione precedente.

Rotazione e pubblicazione in sequenza delle inserzioni

Puoi mettere le inserzioni in rotazione nel gruppo di inserzioni che stai usando. Per farlo, non devi dissociare la prenotazione dal gruppo di inserzioni. Aggiungi una o più inserzioni al gruppo di inserzioni e attendi che diventino attive. Quindi, potrai modificare lo stato dall'inserzione iniziale per metterla in pausa. Devi avere almeno un'inserzione attiva nel gruppo di inserzioni.

Puoi configurare una sequenza di inserzioni da pubblicare in ordine. In primo luogo, crea il gruppo di inserzioni e le inserzioni. Quindi, specifica la sequenza al livello del gruppo di inserzioni in creative_sequence. La visualizzazione di ogni singola inserzione del gruppo potrebbe avvenire una volta, più volte in sequenza o potrebbe non verificarsi affatto.

Se la lunghezza dell'array creative_sequence è pari a zero, non stai usando alcuna sequenza. Se la lunghezza è diversa da zero, ti consigliamo di renderla uguale al valore di frequency_cap in rf_prediction_id. Se la lunghezza è maggiore rispetto a frequency_cap, taglieremo diverse delle ultime inserzioni dall'array. Se la lunghezza è minore rispetto a frequency_cap, riempiremo automaticamente l'array in modo ricorrente, ripetendo la sequenza dall'inizio. Per rendere chiari i risultati, imposta la lunghezza di creative_sequence sullo stesso valore di frequency_cap.

Ogni inserzione della sequenza presenta lo stato ACTIVE, PENDING_REVIEW o CREDIT_CARD_NEEDED. Una data inserzione nella sequenza viene pubblicata per un utente solo se tutte le inserzioni precedenti della sequenza risultano pubblicate. Le inserzioni escluse da creative_sequence non verranno pubblicate.

Non potrai mettere in pausa, archiviare o eliminare le inserzioni del gruppo che usano la pubblicazione in sequenza, che siano inserite o meno nella sequenza stessa.

Questa funzione è disponibile solo per i gruppi di inserzioni con prenotazione, ad esempio l'elemento buying_type della campagna pubblicitaria principale è RESERVED, mentre nel gruppo di inserzioni è stato impostato rf_prediction_id.

Per maggiori dettagli, consulta la documentazione relativa ai gruppi di inserzioni.

Prenotazione di Instagram

Per la copertura prevista su Instagram, puoi creare una campagna con prenotazione con buying_type impostato su RESERVED.

La prenotazione ti aiuta a pianificare e prenotare campagne di notorietà e interazione, ottimizzando copertura, aumento del ricordo dell'inserzione e ThruPlay.

Le stime di copertura in Gestione inserzioni e l'API possono fornire indicazioni ai partner su cosa aspettarsi. La community di Instagram ha la precedenza e stiamo iniziando da un approccio conservativo, prevediamo di evolverci man mano che sviluppiamo conoscenze più approfondite. Tutte le normative applicabili all'uso delle stime delle prenotazioni per Facebook si applicano anche su Instagram.

Codici di errore

Esempi

Creazione di una reachfrequencyprediction per un destination_id dell'app:

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook"], "facebook_positions":["feed"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_id=<APP_ID>' \
-F 'prediction_mode=1' \
-F "objective=MOBILE_APP_INSTALLS" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

Creazione di una reachfrequencyprediction per un destination_id della Pagina:

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook"], "facebook_positions":["feed"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_id=<PAGE_ID>' \
-F 'prediction_mode=1' \
-F "objective=POST_ENGAGEMENT" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

Creazione di una reachfrequencyprediction per un destination_id dell'app con posizionamento Instagram:

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook","instagram"], "device_platforms":["mobile"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_ids=[<APP_ID>,<INSTAGRAM_ACCOUNT_ID>]' \
-F 'prediction_mode=1' \
-F "objective=MOBILE_APP_INSTALLS" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

Effettua il polling dell'endpoint seguente tramite richieste HTTP GET per recuperare lo stato finché non riscontri un valore diverso da 2:

https://graph.facebook.com/67890123456?fields=status

Se lo stato è 1 (azione eseguita correttamente), puoi allegarla a un gruppo di inserzioni o puoi prenotarla.

Prenotazione di una previsione:

curl \
-F 'action=reserve' \
-F 'rf_prediction_id=<RF_PREDICTION_ID>' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'
 
{"id":"9876543210"}

Effettua il polling dell'endpoint seguente tramite richieste HTTP GET per recuperare lo stato finché non riscontri un valore diverso da 2:

https://graph.facebook.com/<API_VERSION>/<PREDICTION_ID>?fields=status

Se lo stato è 1 (azione eseguita correttamente), puoi allegarla a un gruppo di inserzioni. Configuriamo la struttura della tua campagna creando una campagna, un gruppo di inserzioni, le creatività, un'inserzione e assegnando la prenotazione al gruppo di inserzioni.

Creazione di una campagna pubblicitaria:

curl \
-F "name=Test" \
-F "buying_type=RESERVED" \
-F "status=ACTIVE" \
-F "objective=POST_ENGAGEMENT" \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns

{"id":"1122334455"}

Creazione di un gruppo di inserzioni:

curl  \
-F "name=TestReachSet" \
-F "status=1" \
-F "campaign_id=<CAMPAIGN_ID>" \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets"

{"id":"09876543"}

Realizzazione delle creatività dell'inserzione:

curl \
-F "name=sample creative" \
-F "type=1" \
-F "title=hello world" \
-F "body=hi i'm an ad" \
-F "link_url="https://www.facebook.com/" \
-F "image_hash=4aca812b4eadb72818a2c4124abd121a" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives"

{"id":"1323123123123"}

Creazione di un'inserzione:

// Create an ad
curl \
-F "name=my ad" \
-F "adset_id=<AD_SET_ID>" \
-F "creative={'creative_id':<CREATIVE_ID>}" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ads"

{"id":"3213213123"}

Assegnazione di una nuova previsione al gruppo di inserzioni:

curl \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"