Anuncios de destinos: catálogo y lista

Para promocionar destinos en Facebook, debes compartir información sobre ellos con Facebook. Con este fin, puedes crear un catálogo de destinos y, luego, completarlo con tus destinos.

Sube archivos CSV o XML para las "listas de destinos" con los destinos que quieres promocionar.

Puedes crear y administrar tu catálogo de destinos en el administrador de ventas.

Si quieres usar la API para administrar tu catálogo, sigue estos pasos:

1. Crea un catálogo de destinos
2. Sube la lista a Facebook
3. Crea conjuntos de productos del catálogo de destinos
4. Asocia el catálogo con los orígenes de eventos

Lista de destinos: subir tus destinos a Facebook

Una lista de destinos es un archivo con los destinos que quieres promocionar. Cada línea o artículo del archivo representa un destino individual. Puedes usar una o más listas de destinos, siempre que entre todas contengan todos los destinos que quieres promocionar.

Formatos admitidos de listas de destinos

CSV: ejemplo y descripción

CSV de ejemplo | TSV de ejemplo (plano) | TSV de ejemplo (estilo JSON)

• En la primera fila, debes mencionar los nombres de los campos elegidos en el orden en el que se presentarán los valores. Las filas siguientes contienen los valores correspondientes a cada destino.
• Los campos que contienen espacios en blanco o comas deben escribirse entre "comillas dobles".
• Los campos anidados o de varios valores, como address, neighborhood o image, se pueden representar con valores cifrados mediante JSON o por un conjunto de columnas "planas" de texto sin formato y etiquetadas mediante sintaxis de ruta JSON, como address.city, neighborhood[0], image[0].url, image[0].tag[0] y image[0].tag[1]. Se pueden utilizar ambas convenciones indistintamente en el mismo archivo.

XML: ejemplo y descripción

XML de ejemplo

• Un nodo XML raíz <listings> contiene un conjunto de nodos <listing>; cada uno representa un destino.
• El archivo debe comenzar con una etiqueta de declaración <?xml válida.

Campos admitidos: destinos

Los siguientes campos compatibles están diseñados para los artículos que agregas a tu catálogo de productos.

Para obtener información sobre los catálogos localizados, consulta Campos admitidos para destinos.

Enlaces profundos del producto

Proporciona enlaces profundos en la lista siguiendo la especificación de App Links. La información de los enlaces profundos en la lista tiene prioridad sobre cualquier información que recopile Facebook con metadatos de App Links mediante nuestro rastreador web.

Si ya tienes información de los enlaces profundos de App Links, no necesitas especificar estos datos. Facebook usa información de App Links para mostrar el enlace profundo correcto. Para mostrar enlaces profundos en tus anuncios, consulta Anuncios del catálogo Advantage+, Plantilla de anuncio.

Parámetros de objetos de imagen

Parámetros de objetos de dirección

Las siguientes secciones solo te resultarán relevantes si quieres administrar tus catálogos mediante esta API.

Crear un catálogo de destinos mediante la API

Un catálogo de destinos es un contenedor para los destinos que quieres promocionar. Para usar la API de catálogos, asegúrate de tener el nivel de acceso de la API de marketing apropiado y de aceptar las Condiciones del servicio. Para ello, crea tu primer catálogo mediante el administrador comercial.

Para crear un catálogo de destinos para anuncios de destinos, configura vertical en 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

Subir la lista de destinos mediante la API

Una vez que hayas creado el catálogo, deberás subir tus listas de destinos a Facebook. Usa la API para crear un objeto de lista para cada lista que quieras subir. Admitimos subidas directas y programadas.

Filtrar el catálogo de destinos por conjuntos de destinos

Un conjunto de destinos es un subconjunto de tu catálogo. Para configurar anuncios de destinos, necesitas un conjunto de destinos. Por lo tanto, debes crear al menos uno.

Los conjuntos de destinos se definen mediante filtros que se aplican al catálogo de destinos. Por ejemplo, puedes crear un conjunto de destinos con todos los destinos que tuvieron una reducción de precio importante. Ten en cuenta que también puedes crear un conjunto de destinos sin filtros. En ese caso, el conjunto de destinos incluirá todos los destinos de tu catálogo.

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

El parámetro filter está compuesto por los siguientes operadores y datos: