Inserzioni per le destinazioni: elenco e catalogo

Per promuovere destinazioni su Facebook, devi condividerne le informazioni con Facebook. Puoi farlo creando e compilando un catalogo di destinazioni.

Crea file CSV o XML per gli "elenchi di destinazioni" con le destinazioni che desideri promuovere.

Puoi creare e gestire il tuo catalogo di destinazioni in Gestore delle vendite.

Per usare l'API per la gestione del catalogo:

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

Elenco di destinazioni: caricamento delle destinazioni su Facebook

Un elenco di destinazioni è un file con le destinazioni che desideri promuovere. Ogni riga o voce del file rappresenta una singola destinazione. Puoi usare uno o più elenchi di destinazioni, purché tutti gli elenchi contengano tutte le destinazioni che desideri promuovere.

Formati dell'elenco di destinazioni supportati

CSV: esempio e descrizione

CSV di esempio | TSV di esempio (non strutturato) | TSV di esempio (stile JSON)

• La prima riga deve contenere i nomi scelti per i campi nell'ordine in cui saranno assegnati i valori. Le righe seguenti devono fornire i valori corrispondenti per ogni destinazione.
• I campi che contengono spazi o virgole devono essere compresi tra "virgolette doppie".
• I campi nidificati o con più valori, ad esempio address, neighborhood o 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 (ad es. address.city, neighborhood[0], 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 e descrizione

XML di esempio

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

Campi supportati: destinazioni

I seguenti campi supportati sono progettati per le voci che aggiungi al catalogo prodotti.

Per i cataloghi localizzati, vedi i campi supportati per le destinazioni.

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.

Parametri dell'oggetto image

Parametri dell'oggetto address

Le seguenti sezioni sono pertinenti solo per la gestione dei tuoi cataloghi mediante questa API.

Creazione di un catalogo di destinazioni mediante l'API

Un catalogo di destinazioni contiene le destinazioni che desideri promuovere. 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 destinazioni per le inserzioni per le destinazioni, imposta vertical su destinations.

curl -X POST \
  -F 'name="Test Destination Catalog"' \
  -F 'vertical="destinations"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v10.0/BUSINESS_ID/owned_product_catalogs

Caricamento degli elenchi di destinazione mediante l'API

Una volta creato il tuo catalogo, devi caricare i tuoi elenchi di destinazioni 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 destinazioni in insiemi di destinazioni

Un insieme di destinazioni è un sottoinsieme del tuo catalogo. Per configurare le inserzioni per le destinazioni, ti serve un insieme di destinazioni. Pertanto, ne devi creare almeno uno.

Gli insiemi di destinazioni sono definiti dai filtri applicati al catalogo di destinazioni. Ad esempio, puoi creare un insieme di destinazioni con tutte le destinazioni alle quali è stata applicata una considerevole riduzione del prezzo. Tieni presente che puoi anche creare un insieme di destinazioni senza alcun filtro. In questo caso, l'insieme di destinazioni conterrà tutte le destinazioni del tuo catalogo.

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

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

$destination_set->setData(array(
  ProductSetFields::NAME => 'Test Destination Set',
  ProductSetFields::FILTER => array(
    'price_change' => array(
      'lt' => -20,
    ),
  ),
));

$destination_set->create();

from facebookads.adobjects.productset import ProductSet

destination_set = ProductSet(None, <PRODUCT_CATALOG_ID>)

destination_set[ProductSet.Field.name] = 'Test Destination Set'
destination_set[ProductSet.Field.filter] = {
    'price_change': {
        'lt': -20,
    },
}

destination_set.remote_create()

curl \
  -F 'name=Test Destination Set' \
  -F 'filter={"price_change":{"lt":-20}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.10/<PRODUCT_CATALOG_ID>/product_sets

Il parametro filter è composto dai seguenti operatori e dati: