Advantage+ Shopping Campaign

Le Advantage+ shopping campaign sono una soluzione che consente agli inserzionisti di e-commerce e vendita al dettaglio diretti al consumatore e di brand di ottenere potenzialmente prestazioni migliori, maggiore personalizzazione e maggiore efficienza. Queste campagne forniscono una maggiore flessibilità per controllare leve come creatività, targetizzazione, posizionamenti e budget, e più opportunità per ottimizzare le campagne che generano conversioni.

Invece di gestire diverse campagne con pubblico segmentato, le Advantage+ shopping campaign ti consentono di combinare tutti i gruppi di pubblico per un mercato specifico in una singola struttura della campagna. Lo scopo è semplificare la creazione e la gestione e ridurre al contempo la sovrapposizione di pubblico.

Configurazione manuale della campagna rispetto alle Advantage+ shopping campaign

Configurazione campagna BAU manualeAdvantage+ shopping campaign

Campagne BAU multiple

Sostituzione portfolio BAU


Targetizzazione manuale con 7 leve di targetizzazione


Targetizzazione automatizzata, automazione per aumentare l'efficienza della configurazione con input di 1 Paese


Allocazioni di budget rigorose in campagne multiple


Liquidità di budget all'interno di 1 campagna


Prova fino a 50 combinazioni di creatività


Consente inserzioni dinamiche e statiche con un massimo di 150 combinazioni di creatività


Questo documento descrive i passaggi che devi seguire per configurare la tua integrazione per le Advantage+ shopping campaign. Ecco cosa dovrai fare:

  1. Definire i clienti esistenti
  2. Creare la campagna
  3. Verificare la creazione della campagna
  4. Creare il gruppo di inserzioni
  5. Fornire creatività e creare le inserzioni
  6. Impostare il vincolo di età minima e l'esclusione geografica (consulta la documentazione di riferimento per i controlli degli account pubblicitari)

Passaggio 1: definire i clienti esistenti

Le Advantage+ shopping campaign ti consentono di definire i tuoi clienti esistenti come raccolta di ID di pubblico personalizzato. I clienti esistenti sono utenti che hanno già familiarità con la tua azienda/il tuo prodotto. Una volta configurata questa definizione, puoi utilizzarla per segmentare il tuo budget per le Advantage+ shopping campaign in modo da limitare la spesa sui clienti esistenti. Ti forniremo inoltre metriche sulle prestazioni delle tue campagne tra questi diversi segmenti.

Puoi definire la tua inserzione pubblicando sull'endpoint /act_{ad_account_id}. Per configurare questa definizione, dovrai includere il parametro seguente:

ParametroDescrizione

existing_customers

Array<string>

Array di ID di pubblico personalizzato ai quali l'account pubblicitario ha accesso. Attualmente le origini supportate per il pubblico personalizzato sono sito web, attività nell'app, lista dei clienti, catalogo e attività offline.


Per informazioni su come creare un pubblico personalizzato, consulta questa pagina.

Esempio

curl -X POST \
  -F 'existing_customers=[<CUSTOM_AUDIENCE_ID>, <CUSTOM_AUDIENCE_ID>]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>

Per ulteriori informazioni sul monitoraggio del pubblico nuovo ed esistente negli strumenti di monitoraggio di terze parti, consulta Parametri degli URL per tipo di pubblico.

Passaggio 2: crea la campagna

Inizia creando la tua campagna pubblicitaria. Per farlo, effettua una richiesta POST a /act_{ad_account_id}/campaigns.

Parametri


ParametroDescrizione

name
stringa

Obbligatorio
Nome della Advantage+ shopping campaign

objective
enum

Obbligatorio
Oggetto della campagna. Specifica OUTCOME_SALES per questo tipo di inserzione

special_ad_categories

lista<Object>

Obbligatorio
Categorie speciali di inserzioni associate alla Advantage+ shopping campaign

adlabels

lista<Object>

Facoltativo
Etichette delle inserzioni associate alla Advantage+ shopping campaign

buying_type
stringa

Facoltativo
Le Advantage+ shopping campaign supportano solo il valore AUCTION

execution_options

lista<enum>

Facoltativo
Valore predefinito: set. Le altre opzioni sono:

  • validate_only: quando questa opzione viene specificata, la chiamata API non eseguirà la mutazione ma opererà tramite le regole di convalida relativamente ai valori di ogni campo.
  • include_recommendations: questa opzione non può essere utilizzata da sola. Quando viene utilizzata questa opzione, verranno inclusi i consigli per la configurazione dell'oggetto pubblicitario. Una sezione separata relativa ai consigli sarà inclusa nella risposta, ma solo se esistono consigli per questa specifica.

Se la chiamata supera la convalida o il controllo, la risposta sarà {"success": true}. Se la chiamata non supera uno di questi processi, verrà restituito un errore con maggiori dettagli.

smart_promotion_type
enum

Obbligatorio
Per specificare che si tratta di una Advantage+ shopping campaign, il tipo di promozione intelligente deve essere impostato su AUTOMATED_SHOPPING_ADS

status
enum

Facoltativo
Le opzioni valide sono: PAUSED e ACTIVE.


Se lo stato è PAUSED, tutti i gruppi di inserzioni attivi e le inserzioni saranno sospesi e avranno come stato effettivo CAMPAIGN_PAUSED

Esempio di creazione di una campagna

curl -X POST \
  -F 'name=Advantage+ Shopping Campaign' \
  -F 'objective=OUTCOME_SALES' \
  -F 'status=ACTIVE' \
  -F 'special_ad_categories=[]' \
  -F 'smart_promotion_type=AUTOMATED_SHOPPING_ADS' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/campaigns

Aggiornamento

Puoi aggiornare una campagna effettuando una richiesta POST a /{campaign_id}.

Parametri


ParametroDescrizione

name
stringa

Nome dell'Advantage+ shopping campaign

special_ad_categories

lista<Object>

Categorie speciali di inserzioni associate alla Advantage+ shopping campaign

adlabels

lista<Object>

Etichette delle inserzioni associate all'Advantage+ shopping campaign

execution_options

lista<enum>

Valore predefinito: set. Le altre opzioni sono:

  • validate_only: quando questa opzione viene specificata, la chiamata API non eseguirà la mutazione ma opererà tramite le regole di convalida relativamente ai valori di ogni campo.
  • include_recommendations: questa opzione non può essere utilizzata da sola. Quando viene utilizzata questa opzione, verranno inclusi i consigli per la configurazione dell'oggetto pubblicitario. Una sezione separata relativa ai consigli sarà inclusa nella risposta, ma solo se esistono consigli per questa specifica.

Se la chiamata supera la convalida o il controllo, la risposta sarà {"success": true}. Se la chiamata non supera uno di questi processi, verrà restituito un errore con maggiori dettagli.

topline_id
stringa numerica o intero

ID bilancio

status
enum

Puoi utilizzare i seguenti stati per una chiamata API di aggiornamento:

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

Se una campagna pubblicitaria è impostata su PAUSED, i suoi oggetti secondari attivi verranno messi in pausa e presenteranno come stato effettivo CAMPAIGN_PAUSED.

Esempio di aggiornamento di una campagna

curl -X POST \
  -F 'name=Advantage+ Shopping Update Sample Campaign' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<CAMPAIGN_ID>

Passaggio 3: verifica la creazione della campagna

Per verificare di aver creato correttamente una Advantage+ shopping campaign, puoi effettuare una richiesta GET a /<AD_CAMPAIGN_ID> con il campo smart_promotion_type.

Una Advantage+ shopping campaign valida restituirà il valore del campo AUTOMATED_SHOPPING_ADS.

Esempio

curl -X GET -G \
  -d 'fields=smart_promotion_type' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<AD_CAMPAIGN_ID>

Risposta

{
  "smart_promotion_type": "AUTOMATED_SHOPPING_ADS",
  "id": <AD_CAMPAIGN_ID>
}

Passaggio 4: crea il gruppo di inserzioni

Dopo aver creato la campagna pubblicitaria, crea il tuo gruppo di inserzioni. Ad ogni Advantage+ shopping campaign può essere associato un solo gruppo di inserzioni.

Per creare un gruppo di inserzioni, effettua una richiesta POST a /act_{ad_account_id}/adsets.

Parametri


ParametroDescrizione

campaign_id
stringa numerica o intero

Obbligatorio
Una Advantage+ shopping campaign valida che desideri aggiungere a questo gruppo di inserzioni.

name
stringa

Obbligatorio
Nome della Advantage+ shopping campaign

promoted_object
Oggetto

Obbligatorio.
L'oggetto che viene promosso in tutte le inserzioni di questo gruppo. Per le Advantage+ shopping campaign, fornisci:

  • pixel_id e
  • custom_event_type: il gruppo di inserzioni per lo shopping Advantage+ supporta i seguenti eventi: PURCHASE, ADD_TO_CART, INITIATED_CHECKOUT, ADD_PAYMENT_INFO, ADD_TO_WISHLIST, CONTENT_VIEW, COMPLETE_REGISTRATION, DONATE, START_TRIAL, SUBSCRIBE, SEARCH e OTHER.

targeting
Oggetto di targetizzazione

Obbligatorio
Una struttura di targetizzazione per il gruppo di inserzioni della Advantage+ shopping campaign. Può essere specificato solo geo_locations.

geo_locations
array

Obbligatorio
Utilizzato per limitare il pubblico del gruppo di inserzioni sulla base dei parametri seguenti:

daily_budget
int64

Facoltativo
Il budget giornaliero definito nella valuta del tuo account, consentito solo per i gruppi di inserzioni con una durata (differenza tra end_time e start_time) maggiore di 24 ore.


Uno tra daily_budget e lifetime_budget deve essere maggiore di 0.

lifetime_budget
int64

Facoltativo
Budget totale, definito nella valuta del tuo account. Se specificato, devi specificare anche un valore per end_time.


Uno tra daily_budget e lifetime_budget deve essere maggiore di 0.

end_time
datetime

Obbligatorio quando lifetime_budget è specificato.
Quando crei un gruppo di inserzioni con un daily_budget, specifica end_time=0 per impostare il gruppo di inserzioni come continuo senza data di fine. Marca temporale UNIX UTC


Esempio: 2015-03-12 23:59:59-07:00 o 2015-03-12 23:59:59 PDT.

optimization_goal
enum

Facoltativo
Seleziona OFFSITE_CONVERSIONS come obiettivo di ottimizzazione per massimizzare il numero di conversioni. Seleziona VALUE come obiettivo di ottimizzazione per massimizzare il valore delle conversioni. In Gestione inserzioni, visualizziamo il valore più elevato come strategia di offerta.

bid_strategy
enum

Facoltativo

  • LOWEST_COST_WITHOUT_CAP: Facebook imposta automaticamente un'offerta per tuo conto in modo da consentirti di ottenere i risultati al costo minore. L'offerta effettiva viene aumentata automaticamente in base alle necessità per ottenere i risultati desiderati a seconda del tuo optimization_goal. Questa è la bid_strategy predefinita quando optimization_goal è OFFSITE_CONVERSION o VALUE.
  • LOWEST_COST_WITH_MIN_ROAS: opzione di offerta specifica per l'ottimizzazione del valore. Devi specificare un roas_average_floor, ovvero il ritorno minimo desiderato dalla spesa pubblicitaria. Consulta Ritorno minimo sulle offerte di spesa degli inserzionisti.
  • COST_CAP: ottieni più risultati possibile mentre noi facciamo il possibile per rispettare il costo per azione che hai impostato. Devi indicare un valore limite nel campo bid_amount. Nota: il rispetto dei limiti di costi non è garantito. Consulta Limite di costo.

bid_amount

Obbligatorio se bid_strategy è COST_CAP.

bid_constraints
Oggetto JSON

Facoltativo

  • optimization_goal deve essere VALUE.
  • bid_strategy deve essere LOWEST_COST_WITH_MIN_ROAS.
  • L'offerta ROAS minimo utilizza bid_constraints per superare il "ROAS floor", ma non puoi usarlo con bid_constraints; usa invece roas_average_floor. Consulta Ritorno minimo sulle offerte di spesa degli inserzionisti.
  • L'intervallo di roas_average_floor valido è [100, 10000000] (valore max e min inclusi). Questo significa che l'intervallo di valori validi per "ROAS minimo" è [0.01, 1000.0] o [1%, 100000.0%] (valore max e min inclusi).

billing_event
enum

Obbligatorio
Un evento di fatturazione per il gruppo di inserzioni. Per le Advantage+ shopping campaign, è supportato solo IMPRESSIONS.

existing_customer_budget_percentage
numero

Facoltativo
Specifica la percentuale massima del budget che può essere spesa sui clienti esistenti associati a questo account pubblicitario. Valori inferiori possono portare a costi per conversione più alti. I valori validi sono compresi tra 0 e 100.

adlabels

lista<Object>

Facoltativo

Specifica una lista di etichette da associare a questo oggetto.

start_time
datetime

Facoltativo.
L'ora di inizio del gruppo. Marca temporale UNIX UTC


Esempio: 2015-03-12 23:59:59-07:00 o 2015-03-12 23:59:59 PDT.

time_start
datetime

Facoltativo

Ora di inizio

time_stop
datetime

Facoltativo

Ora di fine

attribution_spec

lista<JSON Object>

Facoltativo
Specifica di attribuzione della conversione utilizzata per attribuire le conversioni per l'ottimizzazione.

Esempio di creazione di un gruppo di inserzioni

curl -X POST \
  -F 'name=Advantage+ Shopping Sample Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'promoted_object={ "pixel_id": "<PIXEL_ID>", "CUSTOM_EVENT_TYPE": "PURCHASE" }' \
  -F 'daily_budget=<NUM>' \
  -F 'existing_customer_budget_percentage=<NUM>' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'targeting={"geo_locations": {"countries": ["US"]}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adsets

Aggiornamento

Puoi aggiornare un gruppo di inserzioni effettuando una richiesta POST a /{ad_set_id}.

Parametri


ParametroDescrizione

adlabels

lista<Object>

Specifica una lista di etichette da associare a questo oggetto. Questo campo è facoltativo.

daily_budget
int64

Il budget giornaliero definito nella valuta del tuo account, consentito solo per i gruppi di inserzioni con una durata (differenza tra end_time e start_time) maggiore di 24 ore.


Uno tra daily_budget e lifetime_budget deve essere maggiore di 0.

existing_customer_budget_percentage
numero

Specifica la percentuale massima del budget che può essere spesa sui clienti esistenti associati a questo account pubblicitario. Valori inferiori possono portare a costi per conversione più alti. I valori validi sono compresi tra 0 e 100.

end_time
datetime

Ora di fine, obbligatoria quando viene specificato lifetime_budget.


Esempio: 2015-03-12 23:59:59-07:00 o 2015-03-12 23:59:59 PDT


Quando crei un gruppo di inserzioni con un budget giornaliero, specifica end_time=0 per impostare il gruppo di inserzioni come continuo senza data di fine.


Marca temporale UNIX UTC.

execution_options

lista<enum>

Valore predefinito: set. Le altre opzioni sono:

  • validate_only: quando questa opzione viene specificata, la chiamata API non eseguirà la mutazione ma opererà tramite le regole di convalida relativamente ai valori di ogni campo.
  • include_recommendations: questa opzione non può essere utilizzata da sola. Quando viene utilizzata questa opzione, verranno inclusi i consigli per la configurazione dell'oggetto pubblicitario. Una sezione separata relativa ai consigli sarà inclusa nella risposta, ma solo se esistono consigli per questa specifica.

Se la chiamata supera la convalida o il controllo, la risposta sarà {"success": true}. Se la chiamata non supera uno di questi processi, verrà restituito un errore con maggiori dettagli.

start_time
datetime

L'ora di inizio del gruppo. Il parametro deve essere indicato nella marca temporale UTC UNIX.


Esempio: 2015-03-12 23:59:59-07:00 o 2015-03-12 23:59:59 PDT.

status
enum

Opzioni disponibili per gli aggiornamenti:

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

Se viene impostato su PAUSED, tutte le inserzioni attive verranno sospese e presenteranno come stato effettivo ADSET_PAUSED.

lifetime_budget
int64

Il budget totale definito nella valuta del tuo account. Se specificato, devi specificare anche un valore per end_time.


Uno tra daily_budget e lifetime_budget deve essere maggiore di 0.

time_start
datetime

Ora di inizio

time_stop
datetime

Ora di fine

targeting
Oggetto di targetizzazione

Struttura di targetizzazione per il tuo gruppo di inserzioni. I valori validi per la targetizzazione sono geo_locations.

geo_locations
array

Obbligatorio
Utilizzato per limitare il pubblico del gruppo di inserzioni sulla base dei parametri seguenti:

attribution_spec

lista<JSON Object>

Facoltativo
Specifica di attribuzione della conversione utilizzata per attribuire le conversioni per l'ottimizzazione.

Esempio di aggiornamento di un gruppo di inserzioni

curl -X POST \
  -F 'name=Advantage+ Shopping Sample Updated Ad Set' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<AD_SET_ID>

Passaggio 5: fornisci la creatività e crea le inserzioni

Dopo aver creato un gruppo di inserzioni, puoi creare la tua inserzione pubblicando sull'endpoint /act_{ad_account_id}/ads. Puoi includere i seguenti parametri

Parametri


ParametroDescrizione

name
stringa

Obbligatorio
Nome dell'inserzione

adset_id
int64

Obbligatorio
ID del gruppo di inserzioni, richiesto alla creazione.

creative
AdCreative

Obbligatorio
La specifica della creatività o l'ID della creatività dell'inserzione che questa inserzione deve utilizzare. I campi validi sono:

  • object_story_spec
  • product_set_id
  • use_page_actor_override
  • creative_id

Per maggiori informazioni sulle creatività, guarda qui


Fornisci la creatività nel formato seguente: {"creative_id": <CREATIVE_ID>}


Oppure fornisci una specifica della creatività:

{
        "creative": {
          "name": <NAME>, 
          "object_story_spec": <SPEC>,
          "product_set_id": <PRODUCT_SET_ID>
        }
}

status
enum

Facoltativo
Solo ACTIVE e PAUSED sono validi durante la creazione. Durante l'esecuzione del test, è consigliabile impostare le inserzioni sullo stato PAUSED in modo da non incorrere in spese accidentali.

adlabels

lista<Object>

Facoltativo
Etichette delle inserzioni associate a questa inserzione

execution_options

lista<enum>

Facoltativo
Valore predefinito: set.

  • validate_only: quando questa opzione viene specificata, la chiamata API non eseguirà la mutazione ma opererà tramite le regole di convalida relativamente ai valori di ogni campo.
  • synchronous_ad_review: questa opzione non deve essere utilizzata da sola. Deve essere sempre specificata con validate_only. Quando queste opzioni vengono specificate, la chiamata API esegue le convalide dell'integrità delle inserzioni, che includono il controllo della lingua dei messaggi, la regola del 20% di testo dell'immagine e così via, oltre alle logiche di convalida.
  • include_recommendations: questa opzione non può essere utilizzata da sola. Quando viene utilizzata questa opzione, verranno inclusi i consigli per la configurazione dell'oggetto pubblicitario. Una sezione separata relativa ai consigli sarà inclusa nella risposta, ma solo se esistono consigli per questa specifica.

Se la chiamata supera la convalida o il controllo, la risposta sarà {"success": true}. Se la chiamata non supera uno di questi processi, verrà restituito un errore con maggiori dettagli.

Esempio di creazione di un'inserzione

curl -X POST \
  -F 'name=Advantage+ Shopping campaign Sample Ad' \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={"name": <NAME>, "object_story_spec": <SPEC>}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/ads

Campi delle creatività

CampoDescrizione

object_story_spec
AdCreativeObjectStorySpec

Obbligatorio
Utilizzalo per creare un nuovo post della Pagina non pubblicato e trasformare il post in un'inserzione. Il contenuto e l'ID della Pagina per creare un nuovo post della Pagina non pubblicato.

use_page_actor_override
AdCreative

Obbligatorio
Se true, visualizziamo la Pagina Facebook associata alle inserzioni della Advantage+ shopping campaign.

Esempio di creazione della creatività

curl -X POST \
  -F 'object_story_spec=<SPEC>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives

Aggiornamento

Puoi aggiornare un'inserzione effettuando una richiesta POST a /{ad_id}.

Parametri


ParametroDescrizione

name
stringa

Nuovo nome dell'inserzione

adlabels

lista<Object>

Etichette dell'inserzione associate a questa inserzione.

execution_options

lista<enum>

Valore predefinito: set. Le altre opzioni sono:

  • validate_only: quando questa opzione viene specificata, la chiamata API non eseguirà la mutazione ma opererà tramite le regole di convalida relativamente ai valori di ogni campo.
  • synchronous_ad_review: questa opzione non deve essere utilizzata da sola. Deve essere sempre specificata con validate_only. Quando queste opzioni vengono specificate, la chiamata API esegue le convalide dell'integrità delle inserzioni, che includono il controllo della lingua dei messaggi, la regola del 20% di testo dell'immagine e così via, oltre alle logiche di convalida.
  • include_recommendations: questa opzione non può essere utilizzata da sola. Quando viene utilizzata questa opzione, verranno inclusi i consigli per la configurazione dell'oggetto pubblicitario. Una sezione separata relativa ai consigli sarà inclusa nella risposta, ma solo se esistono consigli per questa specifica.

Se la chiamata supera la convalida o il controllo, la risposta sarà {"success": true}. Se la chiamata non supera uno di questi processi, verrà restituito un errore con maggiori dettagli.

status
enum

Le opzioni sono:

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

Durante l'esecuzione del test, è consigliabile impostare le inserzioni sullo stato PAUSED in modo da non incorrere in spese accidentali.

creative
AdCreative

La specifica delle creatività dell'inserzione che deve essere utilizzata da questa inserzione. I campi validi sono object_story_spec, asset_feed_spec e use_page_actor_override e possono essere visualizzati qui. Per maggiori informazioni sulle creatività, guarda qui


Fornisci la creatività nel seguente formato:

{
    "creative": {
      "name": <NAME>, 
      "object_story_spec": <SPEC>,
      "product_set_id": <PRODUCT_SET_ID>
    }
}

Esempio di aggiornamento dell'inserzione

curl -X POST \
  -F 'name=Advantage+ Shopping campaign Sample Update Ad' \
  -F 'creative={"name": <NAME>, "object_story_spec": <SPEC>}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<AD_ID>