Para promocionar tu inventario de vuelos en Facebook, debes compartir con Facebook información sobre tus vuelos. Para poder hacerlo, debes crear un catálogo de vuelos y luego completarlo con las rutas de vuelo. Existen tres maneras de completar tu catálogo y mantenerlo actualizado.
Puedes crear y administrar tus catálogos de vuelos en el Administrador de catálogos:
Una lista de vuelos es un archivo que contiene tu inventario de vuelos. Cada línea o artículo del archivo representa una ruta individual. Puedes usar una o más listas de vuelos, siempre que entre todas contengan tu inventario de vuelos completo.
Ejemplo de CSV | Ejemplo de TSV (aplanado)
"
comillas dobles"
. image
, pueden representarse con valores con código JSON o con un conjunto de columnas de texto sin formato "aplanadas", etiquetadas con sintaxis de ruta JSON, como image[0].url
, image[0].tag[0]
, image[0].tag[1]
. Se pueden utilizar ambas convenciones indistintamente en el mismo archivo.<listings>
raíz incluye un conjunto de nodos <listing>
, cada uno de los cuales representa un vuelo.<?xml
válida.El analizador de listas detecta automáticamente codificaciones de texto UTF8
, UTF16
o UTF32
y adopta de forma predeterminada el valor LATIN1
si encuentra secuencias de bytes imprevistas. Puedes proporcionar texto en valores de campo en cualquier idioma. Sin embargo, los nombres de los campos se deben proporcionar en inglés, exactamente como figura abajo.
Los siguientes campos disponibles están diseñados para los artículos que agregues a tu catálogo de productos.
Para catálogos localizados, consulta campos admitidos para anuncios de vuelos.
Campo y tipo | Descripción |
---|---|
Tipo: cadena | Obligatorio Código IATA del aeropuerto de origen. Admite códigos IATA de aeropuertos y ciudades. Usa la búsqueda de códigos IATA para validar tus códigos IATA. Consejo: Para mejorar el rendimiento, evita usar un espacio en este campo de identificador único. Ejemplo: |
Tipo: cadena | Obligatorio Código IATA del aeropuerto de destino. Admite códigos IATA de aeropuertos y ciudades. Usa la búsqueda de códigos IATA para validar tus códigos IATA. Consejo: Para mejorar el rendimiento, evita usar un espacio en este campo de identificador único. Ejemplo: |
Tipo: objeto | Obligatorio Máximo de artículos: 20 Datos de imágenes de este vuelo. Puedes proporcionar hasta 20 imágenes del vuelo. Cada imagen contiene dos campos: Consulta los parámetros de objetos de imagen. |
Tipo: cadena | Obligatorio Tamaño máximo: 5000 Párrafo breve en el que se describe la ruta. |
Tipo: cadena | Obligatorio únicamente si no especificas un enlace profundo a nivel del anuncio. Puedes usar el campo Enlace al sitio web externo en el que puedes ver el vuelo. Si se especifica un enlace profundo en el nivel del anuncio, ese enlace 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 | Enlace profundo que dirige a la página de detalles del vuelo en tu app para celulares mediante App Links. Puedes especificar enlaces profundos (en orden de prioridad, de mayor a menor):
|
Tipo: cadena | Precio de un tramo del vuelo. 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á prioridad=0. Ejemplo: |
Tipo: cadena | Controla si un artículo está activo o archivado en tu catálogo. Las personas solo pueden ver los artículos activos en tus anuncios, tiendas o cualquier otro canal. Valores admitidos: Ejemplo: Nota: Algunas plataformas asociadas, como Shopify, pueden sincronizar artículos en tu catálogo con un estado llamado preparación, que se comporta similar a Anteriormente, este campo se llamaba |
Nombre y tipo de campo | Descripción |
---|---|
Tipo: cadena | Obligatorio La URL de la imagen del vuelo. Sigue estas especificaciones de imágenes:
|
Tipo: cadena | Una cadena que representa lo que se muestra en la imagen. Puede haber varias etiquetas asociadas a una imagen. Ejemplos:
Opcional. |
Si tienes aplicaciones distintas para iPhone y iPad, especifica la información concreta para cada dispositivo. De lo contrario, especifica información solo para iOS.
Nombre y tipo del campo | Descripción |
---|---|
Tipo: string | Esquema personalizado de la aplicación para iOS. Ejemplo: |
Tipo: string | Identificador de la aplicación para la App Store. Ejemplo: 1234 |
Tipo: string | Nombre de la aplicación (adecuado para mostrarse). Ejemplo: |
Tipo: string | Esquema personalizado de la aplicación para iPhone. Ejemplo: |
Tipo: string | Identificador de la aplicación para la App Store. Ejemplo: |
Tipo: string | Nombre de la aplicación (adecuado para mostrarse). Ejemplo: |
Tipo: string | Esquema personalizado de la aplicación para iPhone. Ejemplo: |
Tipo: string | Identificador de la aplicación para la App Store. Ejemplo: |
Tipo: string | Nombre de la aplicación (adecuado para mostrarse). Ejemplo: |
Tipo: string | Esquema personalizado de la aplicación para Android. Ejemplo: |
Tipo: string | Nombre de paquete que reúne todos los requisitos para la generación de la intención. Ejemplo: |
Tipo: string | Nombre de clase de actividad que reúne todos los requisitos para la generación de la intención. Ejemplo: |
Tipo: string | Nombre de la aplicación (adecuado para mostrarse). Ejemplo: |
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.
Facebook puede agregar rutas automáticamente a tu catálogo en función de la actividad del píxel y de los eventos de la app. Cada vez que se recibe un evento con una ruta que todavía no existe en el catálogo, se puede agregar automáticamente. Esto te permite usar anuncios de vuelos para todos tus vuelos sin tener que lidiar con listas de vuelos.
Para activar esta función, realiza una solicitud POST
a tu catálogo de vuelos y configura 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 agregan automáticamente no tienen imagen (para mostrar en el anuncio). Por lo tanto, debes proporcionar una imagen genérica para usar con las rutas generadas 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>
No bien el catálogo se asocie a un píxel o una app y comience a recibir eventos de anuncios de vuelos, tu catálogo se completará. Puedes verificar esto consultando el catálogo.
curl \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<VERSION>/<CATALOG_ID>/flights
Puedes combinar subir una lista de vuelos con rutas generadas automáticamente. Combinar estas opciones te permite aprovechar los anuncios de vuelos para todos tus vuelos, y a la vez proporcionar imágenes personalizadas para las rutas más importantes usando una lista de vuelos.
Para hacerlo, simplemente combina el paso subir una lista de vuelos con completar automáticamente tu catálogo.
Las siguientes secciones te resultarán relevantes solamente si quieres administrar tus catálogos mediante esta API.
Un catálogo de vuelos es un contenedor para tu inventario de vuelos. 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 vuelos para anuncios de vuelos, configura 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
Cuando hayas creado el catálogo, tienes que subir tus listas de vuelos a Facebook. Usa la API para crear un objeto de lista para las listas que quieras subir. Admitimos subidas directas y programadas.
Un conjunto de vuelos es un subconjunto de tu catálogo. Para configurar anuncios de vuelos, debes crear al menos un conjunto de vuelos.
Los conjuntos de vuelos se definen mediante filtros que se aplican al catálogo de vuelos. Por ejemplo, puedes crear un conjunto de vuelos con todas las rutas que salen de Londres. Ten en cuenta que también puedes crear un conjunto de vuelos sin filtros. En ese caso, el conjunto de vuelos contendrá 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
está compuesto por los siguientes operadores y datos:
Operadores | Tipo de filtro |
---|---|
| Contiene una subcadena. El operador distingue mayúsculas de minúsculas. |
| No contiene una subcadena. El operador distingue mayúsculas de minúsculas. |
| Contiene una subcadena. El operador distingue mayúsculas de minúsculas. |
| No contiene una subcadena. El operador distingue mayúsculas de minúsculas. |
| Igual a. El operador distingue mayúsculas de minúsculas. |
| No es igual a. El operador 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 |
---|---|
| El código IATA del aeropuerto de origen. |
| Código IATA del aeropuerto de destino. |
| Precio del vuelo. El precio se expresa en centavos. |
| Párrafo breve en el que se describe la ruta. |