Anúncios de destino – Catálogo e feed

Você precisa compartilhar informações sobre destinos para promovê-los no Facebook. Para isso, crie um catálogo e preencha-o com destinos.

Carregue arquivos CSV ou XML para "feeds de destino" com os destinos que você quer promover.

Você pode criar e gerenciar seu catálogo de destinos no Gerenciador de Comércio.

Para usar a API no gerenciamento do seu catálogo:

1. Crie um catálogo de destinos
2. Carregue seu feed no Facebook
3. Crie conjuntos de produtos a partir do catálogo de destinos
4. Associe o catálogo às origens de evento

Feed de destino – Carregar os destinos no Facebook

Um feed de destino é um arquivo com os destinos que você quer promover. Cada linha ou item no arquivo representa um destino único. Você pode usar um mais feeds de destino, desde que o conjunto dos feeds reúna todos os destinos que você quer promover.

Formatos de feed de destino aceitos

CSV – Exemplo e descrição

Exemplo de CSV | Exemplo de TSV (simples) | Exemplo de TSV (estilo JSON)

• A primeira linha deve listar os nomes de campo escolhidos na ordem em que os valores serão fornecidos. As linhas seguintes informam os valores correspondentes para cada destino.
• Os campos com espaços em branco ou vírgulas devem ficar entre "aspas duplas".
• Campos aninhados ou com diversos valores (como address, neighborhood ou image) podem ser representados por meio de valores codificados em JSON ou por um conjunto de colunas de texto "simples" rotuladas com a sintaxe de caminho JSON, por exemplo, address.city, neighborhood[0], image[0].url, image[0].tag[0] e image[0].tag[1]. As duas convenções podem ser usadas alternadamente no mesmo arquivo.

XML – Exemplo e descrição

Exemplo de XML

• Um nó XML raiz <listings> inclui um conjunto de nós <listing>, cada um representando um destino.
• O arquivo deve iniciar por uma tag de declaração <?xml válida.

Campos compatíveis – Destinos

Os campos compatíveis a seguir foram criados para itens que você adiciona ao seu catálogo de produtos.

Para catálogos localizados, consulte os campos aceitos para destinos.

Deep links de produtos

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+.

Parâmetros do objeto Image

Parâmetros do objeto Address

As seções a seguir são relevantes apenas para gerenciar seus catálogos com a API.

Criar um catálogo de destinos por meio da API

Um catálogo de destinos é um contêiner para os destinos que você quer promover. 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 seu primeiro catálogo por meio do Gerenciador de Negócios.

Defina vertical como destinations para criar um catálogo para anúncios de destino.

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

Carregar feeds de destino pela API

Depois de criar o catálogo, será necessário carregar seus feeds de destino no Facebook. Use a API para criar um objeto Feed para todo feed que você queira carregar. Aceitamos carregamentos agendados e diretos.

Filtrar catálogo para conjuntos de destinos

Um conjunto de destinos é um subconjunto do seu catálogo. Você precisa de um conjunto desse tipo para configurar anúncios de destino. Portanto, é necessário criar pelo menos um conjunto.

Os conjuntos de destinos são definidos por filtros aplicados ao catálogo correspondente. Por exemplo, você pode criar um conjunto com todos os destinos cujo preço diminuiu consideravelmente. Lembre-se de que também é possível criar um conjunto de destinos sem nenhum filtro. Nesse caso, o conjunto terá todos os destinos do seu 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

O parâmetro filter é composto pelos seguintes operadores e dados: