Catálogo

Catálogo localizado para anúncios de catálogo Advantage+

Visão geral

Use este guia ao configurar seu catálogo localizado para anúncios de catálogo Advantage+.

Seu catálogo é um objeto (ou contêiner) com informações sobre seus produtos, no qual você adiciona seu estoque.

Como funciona

A Meta oferece a funcionalidade de catálogo localizado para que você promova itens em anúncios ou lojas para outros países. O caso de uso mais comum é localizar a moeda, o preço e o título ou a descrição. Também é possível criar um URL localizado para direcionar o cliente ao produto no site do país/idioma. Saiba como configurar o catálogo localizado.

Criar um modelo para anúncios de catálogo Advantage+

Ao criar um modelo para os Anúncios de Catálogo Advantage+, você pode especificar personalizações no criativo em diferentes idiomas. Por exemplo, convém exibir um cabeçalho diferente para visualizadores do anúncio que falam outro idioma.

Além dos outros campos nos dados do modelo do criativo (na especificação da história do objeto), é possível especificar uma matriz de personalizações no campo customization_rules_spec, em que cada personalização tem este formato:

Nome do campoDescriçãoAceita parâmetros de modelo

customization_spec

Tipo: objeto

Obrigatório.

Descreve o idioma da personalização. Saiba como criar anúncios de catálogo Advantage+ para vários idiomas e países.

Exemplo: {'language' => 'en_XX'}

Não

message

Tipo: string

Opcional.

Mensagem do anúncio, visível no Instagram.

Exemplo: Test {{product.name | titleize}}

Sim

link

Tipo: string

Opcional.

Link para seu site, usado para gerar a legenda do anúncio. Este campo sempre é substituído pelo campo link do seu feed de produtos, exceto o cartão final dos anúncios em carrossel, que direcionam para ele. Não pode ser um URL em Facebook.com.

Exemplo: //link.com


Para anúncios de coleção, você pode usar link para fornecer um documento de experiências instantâneas, como detalhado em Anúncios de coleção.

Exemplo: https://fb.com/canvas_doc/CANVAS_ID

Não

name

Tipo: string

Opcional.

Nome ou título do anúncio, visível no Instagram.

Exemplo: Headline {{product.price}}

Sim

description

Tipo: string

Opcional.

Descrição do anúncio. Não é visível no Instagram.

Exemplo: Description {{product. description}}

Sim

template_url_spec

Tipo: objeto

Opcional.

Pode ser usado para fornecer um deep link da web, conforme detalhado em Modelos e rastreamento de cliques. Observação: apenas o deep link da web é compatível.

Exemplo: {'web' => {'url' => DEEP_LINK}}
Exemplo: {'web' => {'url' => 'example://link/?id={{product. retailer_id}}'}}

Sim

video_id

Tipo: número inteiro

Opcional.

Apenas para anúncios de coleção, é possível usar video_id para fornecer um vídeo para a mídia principal da coleção, conforme detalhado em Anúncios de coleção.

Exemplo: 1234

Não

picture

Tipo: string

Opcional.

Apenas para anúncios de coleção, é possível usar picture a fim de fornecer uma imagem para a mídia principal da coleção, conforme detalhado em Anúncios de coleção.

Exemplo: https://url/image.jpg

Não

Ao especificar a matriz de personalizações, somente uma das personalizações deve definir somente o customization_spec. Isso identifica o idioma do texto não personalizado que foi usado em template_data.

Na renderização do anúncio, o idioma é escolhido com base no idioma da interface do usuário e em outros sinais. A Meta também usa propriedades de produtos do feed de idioma do catálogo para fazer a correspondência, conforme disponibilidade.

Veja também Introdução aos anúncios de catálogo Advantage+, Campos compatíveis para produtos e Formatos de feed compatíveis.

Modelo para anúncios de coleção

Ao criar anúncios de coleção, é possível especificar personalizações ao criativo, da mesma forma que os anúncios de catálogo Advantage+ em vários idiomas por meio de customization_rules_spec.

Limitações:

  • Nos anúncios de coleção, link precisa ser criado usando modelos – Vitrine instantânea, antigo "Vender produtos, Grade (1932289657009030)"
  • O modelo para anúncios de coleção é veiculado apenas por meio de um posicionamento do feed do celular do Facebook.

Exemplos

Visualizar anúncios de catálogo Advantage+ em vários idiomas ou de vários países em outro idioma ou país

curl -X GET \
  -d 'ad_format="DESKTOP_FEED_STANDARD"' \
  -d 'product_item_ids=[
       "<PRODUCT_ITEM_ID>"
     ]' \
  -d 'dynamic_customization={
       "language": "fr_XX",
       "country": "FR"
     }' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<CREATIVE_ID>/previews

Criar um modelo de anúncios de catálogo Advantage+ em carrossel com vários idiomas

curl -X POST \
  -F 'name="Dynamic Ad Template Creative Sample"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "template_data": {
         "message": "English Test {{product.name | titleize}}",
         "link": "http://www.example.com/englishurl",
         "name": "English Headline {{product.price}}",
         "description": "English Description {{product.description}}",
         "customization_rules_spec": [
           {
             "customization_spec": {
               "language": "en_XX"
             }
           },
           {
             "customization_spec": {
               "language": "fr_XX"
             },
             "message": "French Test {{product.name | titleize}}",
             "link": "http://www.example.com/frenchurl",
             "name": "French Headline {{product.price}}",
             "description": "French Description {{product.description}}",
             "template_url_spec": {
               "web": {
                 "url": "http://www.example.com/frenchdeeplink"
               }
             }
           }
         ]
       }
     }' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'template_url_spec={
       "web": {
         "url": "http://www.example.com/englishdeeplink"
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Criar um anúncio de coleção com mídia principal de imagem em vários idiomas

curl -X POST \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "picture": "<IMAGE_URL>",
         "link": "<CANVAS_LINK>",
         "name": "English Creative title",
         "message": "English Creative message",
         "call_to_action": {
           "type": "LEARN_MORE"
         },
         "retailer_item_ids": [
           0,
           0,
           0,
           0
         ],
         "customization_rules_spec": [
           {
             "customization_spec": {
               "language": "en_XX"
             }
           },
           {
             "customization_spec": {
               "language": "fr_XX"
             },
             "picture": "<IMAGE_URL_FR>",
             "link": "<CANVAS_LINK_FR>",
             "name": "French Creative title",
             "message": "French Creative message"
           }
         ]
       }
     }' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Criar um anúncio de coleção com mídia principal de vídeo em vários idiomas

curl -X POST \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "video_data": {
         "video_id": "<VIDEO_ID>",
         "image_url": "<IMAGE_URL>",
         "title": "English Creative title",
         "message": "English Creative message",
         "call_to_action": {
           "type": "LEARN_MORE",
           "value": {
             "link": "<CANVAS_LINK>"
           }
         },
         "retailer_item_ids": [
           0,
           0,
           0,
           0
         ],
         "customization_rules_spec": [
           {
             "customization_spec": {
               "language": "en_XX"
             }
           },
           {
             "customization_spec": {
               "language": "fr_XX"
             },
             "video_id": "<VIDEO_ID_FR>",
             "picture": "<IMAGE_URL_FR>",
             "link": "<CANVAS_LINK_FR>",
             "name": "French Creative title",
             "message": "French Creative message"
           }
         ]
       }
     }' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Criar um anúncio de coleção com mídia principal de vídeo dinâmico em vários idiomas

curl -X POST \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "template_data": {
         "format_option": "collection_video",
         "link": "<CANVAS_LINK>",
         "name": "English Creative title",
         "message": "English Creative message",
         "call_to_action": {
           "type": "LEARN_MORE"
         },
         "retailer_item_ids": [
           0,
           0,
           0,
           0
         ],
         "customization_rules_spec": [
           {
             "customization_spec": {
               "language": "en_XX"
             }
           },
           {
             "customization_spec": {
               "language": "fr_XX"
             },
             "link": "<CANVAS_LINK_FR>",
             "name": "French Creative title",
             "message": "French Creative message"
           }
         ]
       }
     }' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Saiba mais