Inserzioni per i voli: elenco e catalogo

Per promuovere il tuo inventario di voli su Facebook, devi condividere le informazioni sui tuoi voli con Facebook. Puoi farlo creando e compilando un catalogo di voli con relative tratte. Esistono tre metodi per compilare il tuo catalogo e mantenerlo aggiornato.

1. Carica file CSV o XML per gli "elenchi di voli" dal tuo inventario di voli
2. Usa le attività degli eventi per compilare in automatico il tuo catalogo
3. Combina un elenco di voli con voli creati in automatico

Puoi creare e gestire i tuoi cataloghi di voli in Gestione delle vendite:

1. Crea un catalogo di voli
2. Carica il tuo elenco su Facebook
3. Crea insiemi di prodotti dal tuo catalogo di voli
4. Associa il catalogo alle origini degli eventi

Elenco di voli: caricamento dei voli su Facebook

Un elenco di voli è un file con il tuo inventario di voli. Ogni riga o voce del file rappresenta una singola tratta. Puoi usare uno o più elenchi di voli, purché tutti gli elenchi contengano il tuo inventario di voli completo.

Formati degli elenchi di voli supportati

CSV > Esempio - Descrizione

CSV di esempio | TSV di esempio (non strutturato)

• La prima riga deve elencare i nomi dei campi scelti nell'ordine in cui saranno assegnati i valori. Le righe seguenti devono fornire i valori corrispondenti per ogni volo.
• I campi che contengono spazi o virgole devono essere compresi tra "virgolette doppie".
• I campi nidificati o con più valori, ad esempio image, possono essere rappresentati usando valori con codifica JSON o tramite una serie di colonne a testo semplice senza struttura, etichettate usando una sintassi con percorso in stile JSON come image[0].url, image[0].tag[0], image[0].tag[1]. Entrambe le convenzioni possono essere usate in modo intercambiabile all'interno dello stesso file.

XML > Esempio - Descrizione

XML di esempio

• Un nodo XML <listings> radice comprende una serie di nodi <listing>, dove ciascuno rappresenta un volo.
• Il file deve iniziare con un tag di dichiarazione <?xml valido.

Campi supportati: inserzioni per i voli

I seguenti campi supportati sono progettati per gli elementi da aggiungere al tuo catalogo prodotti.

Per i cataloghi localizzati, vedi i campi supportati per le inserzioni per i voli.

Parametri dell'oggetto image

Deep link dei prodotti

Fornisci i deep link nell'elenco seguendo la specifica App Links. Le informazioni sui deep link nell'elenco hanno la precedenza su qualsiasi informazione raccolta da Facebook con i metadati App Links con il nostro crawler web.

Se disponi già di informazioni sui deep link provenienti da App Links, non devi specificare questi dati. Facebook usa le informazioni provenienti da App Links per visualizzare il deep link corretto. Per visualizzare i deep link nelle tue inserzioni, consulta Inserzioni del catalogo Advantage+, modello di inserzione.

Creazione automatica dei voli: aggiunta di tratte al catalogo usando le attività degli eventi

Facebook può aggiungere automaticamente tratte al tuo catalogo in base alle attività dell'evento del pixel e dell'app. Ogni volta che viene ricevuto un evento con una tratta non ancora esistente nel catalogo, questa può essere aggiunta in automatico. Ciò ti consente di usare le inserzioni per i voli per tutti i voli senza dover gestire alcun elenco.

Per abilitare questa opzione, effettua una richiesta POST al tuo catalogo voli e imposta generate_items_from_events su true.

curl \
  -F 'flight_catalog_settings={generate_items_from_events:1}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<VERSION>/<CATALOG_ID>

Le tratte aggiunte in automatico non hanno immagini (da visualizzare nell'inserzione). Pertanto, devi fornire un'immagine generica da usare in tutte le tratte create automaticamente.

curl \
  -F 'fallback_image_url=http://example.com/some.image_1.jpg' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<VERSION>/<CATALOG_ID>

Non appena il tuo catalogo sarà associato a un pixel e/o un'app e riceverà eventi delle inserzioni per i voli, verrà compilato. Puoi effettuare una verifica tramite query del catalogo.

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<CATALOG_ID>/flights

Combinato: uso degli elenchi di voli con i voli creati automaticamente

Puoi combinare il caricamento di un elenco di voli con tratte create automaticamente. La combinazione di queste opzioni ti consente di sfruttare le inserzioni per i voli per tutti i tuoi voli, fornendo al contempo immagini personalizzate per le tue tratte più importanti usando un elenco di voli.

Puoi farlo combinando la procedura di caricamento di un elenco di voli con quella di compilazione automatica del catalogo.

Le seguenti sezioni sono pertinenti solo se desideri gestire i tuoi cataloghi mediante questa API.

Creazione di un catalogo di voli mediante l'API

Un catalogo di voli contiene il tuo inventario di voli. Per usare l'API Catalog, assicurati di avere il livello di accesso dell'API Marketing corretto e di aver accettato le Condizioni d'uso creando il tuo primo catalogo mediante Business Manager.

Per creare un catalogo di voli per le inserzioni per i voli, imposta vertical su flights:

curl -X POST \
  -F 'name="Test Flight Catalog"' \
  -F 'vertical="flights"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v10.0/{business-id}/owned_product_catalogs

Caricamento dei tuoi elenchi di voli mediante l'API

Una volta creato il tuo catalogo, devi caricare i tuoi elenchi di voli su Facebook. Usa l'API per creare un oggetto feed per ciascun elenco che desideri caricare. Supportiamo caricamenti programmati e diretti.

Come filtrare il catalogo di voli in insiemi di voli

Un insieme di voli è un sottoinsieme del tuo catalogo. Per configurare le inserzioni per i voli, devi creare almeno un insieme di voli.

Gli insiemi di voli sono definiti dai filtri applicati al catalogo di voli. Ad esempio, puoi creare un insieme di voli con tutte le tratte con partenza da Londra. Tieni presente che puoi anche creare un insieme di voli senza alcun filtro. In questo caso, l'insieme di voli conterrà tutti i voli del tuo catalogo.

use FacebookAds\Object\ProductSet;
use FacebookAds\Object\Fields\ProductSetFields;

$flight_set = new ProductSet(null, <PRODUCT_CATALOG_ID>);

$flight_set->setData(array(
  ProductSetFields::NAME => 'Test Flight Set',
  ProductSetFields::FILTER => array(
    'origin_airport' => array(
      'eq' => 'LHR',
    ),
  ),
));

$flight_set->create();

from facebookads.adobjects.productset import ProductSet

flight_set = ProductSet(None, <PRODUCT_CATALOG_ID>)

flight_set[ProductSet.Field.name] = 'Test Flights Set'
flight_set[ProductSet.Field.filter] = {
    'origin_airport': {
        'eq': 'SFO',
    },
}

flight_set.remote_create()

curl \
  -F 'name=Test Flight Set' \
  -F 'filter={"origin_airport":{"eq":"LHR"}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<PRODUCT_CATALOG_ID>/product_sets

Il parametro filter è composto dai seguenti operatori e dati: