Anuncios de destinos: catálogo y lista

Para promocionar destinos en Facebook, es necesario compartir información sobre ellos con Facebook. Para hacerlo, crea un catálogo de destinos y, a continuación, llénalo.

Subir archivos CSV o XML para “listas de destino” con los destinos que quieras promocionar

Puedes crear y administrar el catálogo de destinos en Commerce Manager.

Para utilizar la API para administrar el catálogo:

1. Crear un catálogo de destinos
2. Subir la lista a Facebook
3. Crear conjuntos de productos a partir del catálogo de destinos
4. Asociar el catálogo a los orígenes de eventos

Lista de destinos: subir los 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 solo destino. Puedes usar una o varias listas de destinos, siempre que, en conjunto, abarquen todos los destinos que quieres promocionar.

Formatos de lista de destinos admitidos

CSV: ejemplo y descripción

Ejemplo de CSV | Ejemplo de TSV (aplanado) | Ejemplo de TSV (estilo JSON)

• La primera fila debe enumerar los nombres de campo elegidos en el mismo orden en que se proporcionarán los valores. Después, las líneas subsiguientes proporcionan los valores correspondientes para cada destino.
• Los campos que contienen espacios en blanco o comas deben ir entre "comillas dobles".
• Los campos anidados o con varios valores, como address, neighborhood o image, se pueden representar con valores codificados en JSON o con un conjunto de columnas sin formato "aplanadas" etiquetadas con una sintaxis de ruta de acceso 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

Ejemplo de XML

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

Campos admitidos: destinos

Los siguientes campos admitidos se han diseñado para los artículos que añades al catálogo de productos.

Para obtener información sobre catálogos localizados, consulta la documentación sobre campos admitidos para destinos.

Enlaces profundos de productos

Proporcionar enlaces profundos en una sección de noticias de acuerdo con la especificación de App Links. La información de enlaces profundos de la sección de noticias tiene prioridad frente a cualquier información que Facebook recopile con metadatos de App Links con el rastreador web.

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

Parámetros del objeto “image”

Parámetros del objeto “address”

Las secciones siguientes solo se aplican a la administración de 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 del catálogo, asegúrate de tener el nivel de acceso a la API de marketing correspondiente y de aceptar las Condiciones del servicio. Para ello, crea tu primer catálogo mediante Business Manager.

Para crear un catálogo de destinos para anuncios de destinos, define vertical como 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 las listas de destinos mediante la API

Una vez que hayas creado el catálogo, debes subir las listas de destinos a Facebook. Crea un objeto “feed” para cada lista que quieras subir con la API. Admitimos cargas programadas y directas.

Filtrar el catálogo de destino por conjuntos de destino

Un conjunto de destinos es un subconjunto del catálogo. Para configurar anuncios de destino, 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 cuyo precio haya bajado mucho. Ten en cuenta que también puedes crear un conjunto de destinos sin aplicar ningún filtro. En ese caso, el conjunto de destinos contendrá todos los destinos del 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á formado por los operadores y datos siguientes: