Para promover o seu inventário de voos no Facebook, compartilhe informações sobre seus voos com o Facebook. Para isso, crie um catálogo de voos e preencha-o com rotas de voo. Há três formas de preencher o catálogo e mantê-lo atualizado.
Crie e gerencie os seus catálogos de voos no Gerenciador de Comércio:
Um feed de voos é um arquivo com o seu inventário de voos. Cada linha ou item no arquivo representa uma única rota. Você pode usar um ou mais feeds de voos, contanto que todos os feeds reunidos contenham o seu inventário de voos completo.
Exemplo de CSV | Exemplo de TSV (simples)
"
aspas duplas"
. image
, podem ser representados por valores JSON codificados ou por um conjunto de colunas simples, com texto sem formatação, rotuladas com a sintaxe de caminho JSON, como image[0].url
, image[0].tag[0]
, image[0].tag[1]
. As duas convenções podem ser usadas alternadamente no mesmo arquivo.<listings>
raiz inclui um conjunto de nós <listing>
, cada um representando um voo.<?xml
válida.O analisador de feed detecta automaticamente codificações de texto UTF8
, UTF16
ou UTF32
e adota LATIN1
como padrão caso encontre sequências de byte inesperadas. É possível fornecer texto nos valores de campo em qualquer idioma, mas os nomes de campo devem ser fornecidos exatamente como mostrado abaixo, em inglês.
Os campos compatíveis a seguir foram desenvolvidos para itens que você adiciona ao seu catálogo de produtos.
Para catálogos localizados, veja campos compatíveis para anúncios de voos.
Campo e tipo | Descrição |
---|---|
tipo: string | Obrigatório. Código IATA da origem. Compatível com o código IATA do aeroporto e da cidade. Use a pesquisa da IATA para validar esses códigos. Dica: para aumentar o desempenho, evite usar um espaço nesse campo de identificador único. Exemplo: |
tipo: string | Obrigatório. Código IATA do destino. Compatível com o código IATA do aeroporto e da cidade. Use a pesquisa da IATA para validar esses códigos. Dica: para aumentar o desempenho, evite usar um espaço nesse campo de identificador único. Exemplo: |
tipo: objeto | Obrigatório. Máximo de itens: 20 Dados da imagem do voo. Você pode enviar até 20 imagens para o voo. Cada imagem contém dois campos: Consulte Parâmetros do objeto Image. |
tipo: string | Obrigatório. Tamanho máximo: 5.000 Um parágrafo curto descrevendo a rota. |
tipo: string | Obrigatório somente se você não especificar um deep link no nível do anúncio. Use o campo Link do site externo onde é possível visualizar o voo. Se um deep link for especificado no nível do anúncio, ele terá precedência. |
tipo: string | Nome da cidade de origem. Exemplo: |
tipo: string | O nome da cidade de destino. Exemplo: |
tipo: string | Preço do voo. Você deve definir o valor com a moeda. Exemplo: |
tipo: elemento | Deep link que encaminha diretamente para a página de detalhes do voo no seu app para celular usando App Links. Você pode especificar deep links (em ordem de prioridade, da mais alta para a mais baixa):
|
tipo: string | Preço do voo de ida. Você deve definir o valor com a moeda. Exemplo: |
tipo: número inteiro | Prioridade do voo. Valor entre 0 (prioridade mais baixa) e 5 (prioridade mais alta). Um voo sem esse valor terá prioridade = 0. Exemplo: |
tipo: string | Controla se um item está ativo ou foi arquivado no seu catálogo. Apenas itens ativos podem ser vistos por pessoas nos seus anúncios, lojas ou outros canais. Valores compatíveis: Exemplo: Observação: algumas plataformas parceiras como a Shopify podem sincronizar itens ao seu catálogo com um status chamado staging. Ele se comporta da mesma forma que Esse campo era chamado anteriormente de |
Nome e tipo de campo | Descrição |
---|---|
tipo: string | Obrigatório. A URL da imagem do voo. Siga estas especificações de imagem:
|
tipo: string | Uma string que representa o que está na imagem. É possível associar diversas marcações a uma imagem. Exemplos:
Opcional. |
Se você tiver aplicativos separados para iPhone e iPad, insira informações específicas do iPhone e iPad. Caso contrário, especifique somente informações do iOS.
Nome e tipo de campo | Descrição |
---|---|
tipo: cadeia de caracteres | Um esquema personalizado para o aplicativo iOS. Exemplo: |
tipo: cadeia de caracteres | O ID do aplicativo da App Store. Exemplo: 1234 |
tipo: cadeia de caracteres | O nome do aplicativo (adequado para exibição). Exemplo: |
tipo: cadeia de caracteres | Um esquema personalizado para o aplicativo do iPhone. Exemplo: |
tipo: cadeia de caracteres | O ID do aplicativo da App Store. Exemplo: |
tipo: cadeia de caracteres | O nome do aplicativo (adequado para exibição). Exemplo: |
tipo: cadeia de caracteres | Um esquema personalizado para o aplicativo do iPhone. Exemplo: |
tipo: cadeia de caracteres | O ID do aplicativo da App Store. Exemplo: |
tipo: cadeia de caracteres | O nome do aplicativo (adequado para exibição). Exemplo: |
tipo: cadeia de caracteres | Um esquema personalizado para o aplicativo do Android. Exemplo: |
tipo: cadeia de caracteres | Um nome de pacote totalmente qualificado para geração de intenção. Exemplo: |
tipo: cadeia de caracteres | Um nome de classe de atividade totalmente qualificado para geração de intenção. Exemplo: |
tipo: cadeia de caracteres | O nome do aplicativo (adequado para exibição). Exemplo: |
Forneça deep links no feed seguindo a especificação de App Links. As informações de deep link no feed têm prioridade sobre as que o Facebook coleta com metadados de App Links no nosso rastreador da web.
Não será necessário especificar esses dados se você já tiver informações de deep link do App Links. O Facebook usa as informações do App Links para exibir o deep link certo. Para exibir deep links nos seus anúncios, consulte a documentação sobre os modelos de Anúncios de Catálogo Advantage+.
O Facebook pode adicionar rotas automaticamente ao seu catálogo com base no pixel e nas atividades de evento do app. Toda vez que um evento for recebido com uma rota que ainda não exista no catálogo, ela poderá ser adicionada automaticamente. Dessa forma, você pode usar anúncios para todos os seus voos sem precisar lidar com feeds de voos.
Para possibilitar isso, faça uma solicitação POST
para o seu catálogo de voos e defina generate_items_from_events
como true
.
curl \ -F 'flight_catalog_settings={generate_items_from_events:1}' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<VERSION>/<CATALOG_ID>
As rotas adicionadas automaticamente não têm uma imagem (para exibição no anúncio). Por isso, você deve fornecer uma imagem genérica para usar em todas as rotas geradas de modo automático.
curl \ -F 'fallback_image_url=http://example.com/some.image_1.jpg' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<VERSION>/<CATALOG_ID>
Assim que for associado a um pixel e/ou app e estiver recebendo eventos de anúncios de voos, o seu catálogo será preenchido. Para verificar isso, faça uma consulta no catálogo.
curl \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<VERSION>/<CATALOG_ID>/flights
É possível combinar o envio de um feed de voos com rotas geradas automaticamente. A combinação dessas opções permite utilizar anúncios para todos os seus voos, além de fornecer imagens personalizadas para as rotas mais importantes usando um feed de voos.
Para isso, basta combinar as etapas de carregamento do feed de voos e de preenchimento automático do catálogo.
As seções a seguir são relevantes somente se você deseja gerenciar catálogos usando esta API.
Um catálogo de voos é um contêiner para o seu inventário de voos. Para usar a API de catálogo, verifique se você tem o nível de acesso à API de Marketing adequado e se aceitou os Termos de Serviço ao criar o seu primeiro catálogo por meio do Gerenciador de Negócios.
Para criar um catálogo de voo para anúncios, defina vertical
como 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
Depois de criar o catálogo, é necessário carregar os seus feeds de voos no Facebook. Use a API para criar um objeto de feed para todo feed que você queira carregar. Oferecemos compatibilidade com carregamentos agendados e diretos.
Um conjunto de voos é um subconjunto do seu catálogo. Para configurar anúncios de voos, é necessário criar pelo menos um conjunto de voos.
Os conjuntos de voos são definidos por filtros aplicados ao catálogo de voos. Por exemplo, você pode criar um conjunto de voos com todas as rotas que partem de Londres. Também é possível criar um conjunto de voos sem nenhum filtro. Nesse caso, o conjunto de voos conterá todos os voos do seu 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
O parâmetro filter
é composto pelos seguintes operadores e dados:
Operadores | Tipo de filtro |
---|---|
| Contém substring. O operador não diferencia letras maiúsculas de minúsculas. |
| Não contém substring. O operador não diferencia letras maiúsculas de minúsculas. |
| Contém substring. O operador não diferencia letras maiúsculas de minúsculas. |
| Não contém substring. O operador não diferencia letras maiúsculas de minúsculas. |
| Igual a. O operador não diferencia letras maiúsculas de minúsculas. |
| Não é igual a. O operador não diferencia letras maiúsculas de minúsculas. |
| Menor que. Somente para campos numéricos. |
| Menor ou igual a. Somente para campos numéricos. |
| Maior que. Somente para campos numéricos. |
| Maior ou igual a. Somente para campos numéricos. |
Dados | Os dados que estão sendo filtrados |
---|---|
| Código IATA da origem. |
| Código IATA do destino. |
| Preço do voo. O preço é definido em centavos. |
| Um parágrafo curto descrevendo a rota. |