Si quieres promocionar tu inventario de vuelos en Facebook, debes compartir la información correspondiente mediante la plataforma. Para ello, crea un catálogo de vuelos y rellénalo con las rutas correspondientes. Puedes rellenar tu catálogo y mantenerlo actualizado de tres formas.
Puedes crear y administrar tus catálogos de vuelos en Commerce Manager:
Una lista de vuelos es un archivo que contiene tu inventario. Cada línea o artículo del archivo representa una sola ruta. Puedes usar una o varias listas de vuelos, siempre que el conjunto de todas ellas abarque tu inventario al completo.
CSV de muestra | TSV de muestra (aplanado)
"
comillas dobles"
. image
, se pueden representar con valores cifrados mediante JSON o un conjunto de columnas “aplanadas” de texto sin formato etiquetadas con sintaxis de ruta JSON (por ejemplo, image[0].url
, image[0].tag[0]
y image[0].tag[1]
). Se pueden utilizar ambas convenciones indistintamente en el mismo archivo.<listings>
contiene un conjunto de nodos <listing>
, cada uno de los cuales representa un vuelo.<?xml
válida.El analizador de listas detecta automáticamente las codificaciones de texto UTF8
, UTF16
o UTF32
, y adopta de forma predeterminada la codificación LATIN1
si encuentra una secuencia de bytes inesperada. Puedes proporcionar texto en cualquier idioma en los valores de los campos, pero los nombres de estos deben facilitarse tal y como se indica a continuación, en inglés.
Los siguientes campos admitidos se han diseñado para los artículos que añades al catálogo de productos.
En el caso de catálogos localizados, consulta los campos admitidos para anuncios de vuelos.
Campo y tipo | Descripción |
---|---|
Tipo: cadena | Obligatorio. Código IATA del origen. Se admiten códigos IATA de aeropuertos y ciudades. Utiliza la búsqueda de códigos IATA para validar tus códigos IATA. Sugerencia: Para mejorar el rendimiento, evita utilizar un espacio para este campo de identificador único. Ejemplo: |
Tipo: cadena | Obligatorio. Código IATA del destino Se admiten códigos IATA de aeropuertos y ciudades. Utiliza la búsqueda de códigos IATA para validar tus códigos IATA. Sugerencia: Para mejorar el rendimiento, evita utilizar un espacio para este campo de identificador único. Ejemplo: |
Tipo: objeto | Obligatorio. Máximo de elementos: 20. Datos de imagen para este vuelo. Puedes proporcionar hasta 20 imágenes del vuelo. Cada imagen contiene dos campos: Consulta Parámetros del objeto “image” |
Tipo: cadena | Obligatorio. Tamaño máximo: 5000 Párrafo breve en el que se describe la ruta. |
Tipo: cadena | Obligatorio solo si no especificas un enlace profundo en el nivel de anuncio. Puedes utilizar el campo Enlace al sitio externo donde puedes ver el vuelo. Si se especifica un enlace profundo en el nivel de anuncio, este tendrá prioridad. |
Tipo: cadena | Nombre de la ciudad de origen. Ejemplo: |
Tipo: cadena | Nombre de la ciudad de destino. Ejemplo: |
Tipo: cadena | Precio del vuelo. Debes especificar el valor con una divisa. Ejemplo: |
Tipo: elemento | Establece un enlace profundo a la página de detalles del vuelo en tu aplicación para móviles mediante App Links. Puedes especificar enlaces profundos (por orden de prioridad, de la más alta a la más baja) de las siguientes formas:
|
Tipo: cadena | Precio del vuelo de ida. Debes especificar el valor con una divisa. Ejemplo: |
Tipo: entero | Prioridad del vuelo. Valor de 0 (prioridad más baja) a 5 (prioridad más alta). Un vuelo sin este valor tendrá una prioridad igual a 0. Ejemplo: |
Tipo: cadena | Controla si un artículo está activo o archivado en el catálogo. Solo los artículos activos aparecen en los anuncios, las tiendas y otros canales. Valores admitidos: Ejemplo: Nota: Es posible que algunas plataformas de socios, como Shopify, sincronicen los artículos con tu catálogo con un estado denominado provisional, que se comporta igual que Anteriormente, este campo se llamaba |
Nombre y tipo del campo | Descripción |
---|---|
Tipo: cadena | Obligatorio. URL de la imagen del vuelo. Sigue estas especificaciones de imagen:
|
Tipo: cadena | Cadena que representa el contenido de la imagen. Puede haber varias etiquetas asociadas con una imagen. Ejemplos:
Opcional. |
Si tienes aplicaciones independientes para iPhone y iPad, proporciona la información específica para estos dispositivos. Si no las tienes, especifica únicamente la información para iOS.
Nombre y tipo del campo | Descripción |
---|---|
Tipo: string | Esquema personalizado destinado a la aplicación para iOS. Ejemplo: |
Tipo: string | Identificador de la aplicación en App Store. Ejemplo: 1234. |
Tipo: string | Nombre de la aplicación (debe ser apropiado para mostrarse). Ejemplo: |
Tipo: string | Esquema personalizado destinado a la aplicación para iPhone. Ejemplo: |
Tipo: string | Identificador de la aplicación en App Store. Ejemplo: |
Tipo: string | Nombre de la aplicación (debe ser apropiado para mostrarse). Ejemplo: |
Tipo: string | Esquema personalizado destinado a la aplicación para iPhone. Ejemplo: |
Tipo: string | Identificador de la aplicación en App Store. Ejemplo: |
Tipo: string | Nombre de la aplicación (debe ser apropiado para mostrarse). Ejemplo: |
Tipo: string | Esquema personalizado destinado a la aplicación para Android. Ejemplo: |
Tipo: string | Nombre completo de un paquete para la generación de intención. Ejemplo: |
Tipo: string | Nombre completo de una clase “Activity” para la generación de intención. Ejemplo: |
Tipo: string | Nombre de la aplicación (debe ser apropiado para mostrarse). Ejemplo: |
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.
Facebook puede añadir automáticamente rutas a tu catálogo en función de la actividad de los eventos de la aplicación y del píxel. Cada vez que se recibe un evento con una ruta que todavía no existe en el catálogo, esta puede añadirse de forma automática. Esto te permite utilizar anuncios de vuelos para todos tus vuelos sin tener que utilizar listas.
Para activar esta opción, envía una solicitud POST
a tu catálogo de vuelos y establece generate_items_from_events
en true
.
curl \ -F 'flight_catalog_settings={generate_items_from_events:1}' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<VERSION>/<CATALOG_ID>
Las rutas que se añaden de forma automática no incluyen ninguna imagen para mostrar en el anuncio. Por lo tanto, tienes que facilitar una imagen genérica para usarla con todas las rutas que se generen automáticamente.
curl \ -F 'fallback_image_url=http://example.com/some.image_1.jpg' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<VERSION>/<CATALOG_ID>
Tu catálogo se empieza a rellenar en cuanto se asocia a un píxel o una aplicación y recibe eventos de anuncios de vuelos. Para verificarlo, consulta el catálogo.
curl \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<VERSION>/<CATALOG_ID>/flights
Puedes combinar la carga de una lista de vuelos con las rutas generadas de forma automática. Al combinar estas opciones podrás utilizar los anuncios de vuelos para todos tus vuelos y, al mismo tiempo, facilitar imágenes personalizadas para las rutas más importantes a través de una lista de vuelos.
Para ello, solo tienes que combinar los pasos para subir una lista de vuelos y rellenar automáticamente el catálogo.
Las secciones siguientes solo son relevantes si quieres administrar tus catálogos con esta API.
Consulta la referencia del catálogo de productos.
Un catálogo de vuelos es un contenedor para tu inventario. Para utilizar la API de catálogo, asegúrate de tener el nivel de acceso a la API de marketing adecuado y de haber aceptado las Condiciones del servicio. Para ello, crea tu primer catálogo a través de Business Manager.
Para crear un catálogo de vuelos para anuncios de vuelos, establece vertical
en 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
Una vez que hayas creado el catálogo, debes subir tus listas de vuelos a Facebook. Utiliza la API para crear un objeto “feed” para cada lista que quieras subir. Admitimos subidas programadas y directas.
Un conjunto de vuelos es un subconjunto del catálogo. Si quieres configurar anuncios de vuelos, debes crear, como mínimo, un conjunto de vuelos.
Los conjuntos de vuelos se definen por los filtros que se aplican al catálogo. Por ejemplo, puedes crear un conjunto de vuelos que incluya todas las rutas que salen de Londres. Ten en cuenta que también puedes crear un conjunto de vuelos sin aplicar ningún filtro. En este caso, el conjunto incluirá todos los vuelos de tu catálogo.
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
El parámetro filter
anterior está formado por los operadores y datos siguientes:
Operadores | Tipo de filtro |
---|---|
| Contiene subcadena. No distingue mayúsculas de minúsculas. |
| No contiene subcadena. No distingue mayúsculas de minúsculas. |
| Contiene subcadena. No distingue mayúsculas de minúsculas. |
| No contiene subcadena. No distingue mayúsculas de minúsculas. |
| Igual a. No distingue mayúsculas de minúsculas. |
| No es igual a. No distingue mayúsculas de minúsculas. |
| Menor que. Solo para campos numéricos. |
| Menor o igual que. Solo para campos numéricos. |
| Mayor que. Solo para campos numéricos. |
| Mayor o igual que. Solo para campos numéricos. |
Datos | Datos que se filtran |
---|---|
| Código IATA del origen. |
| Código IATA del destino. |
| Precio del vuelo. El precio se indica en céntimos de la divisa correspondiente. |
| Párrafo breve en el que se describe la ruta. |