Anúncios em vários idiomas

Personalize diferentes partes do criativo do anúncio, como a imagem, o vídeo, o texto e o corpo de um anúncio, para interagir com os falantes de idiomas diferentes. O Facebook otimiza seu anúncio para mostrar a versão correta do idioma às pessoas certas.

Isso ajuda você a configurar facilmente um anúncio em vários idiomas e veicular a versão de idioma mais relevante do seu anúncio para um usuário ao mesmo tempo que mantém um direcionamento amplo do anúncio. Isso permite que você tenha um conteúdo personalizado com base no idioma do usuário e, ao mesmo tempo, mantenha anúncios com melhor custo-benefício.

Para obter informações gerais sobre esse recurso, consulte Central de Ajuda para Anúncios, Anuncie para um público multilíngue. Consulte os objetivos de campanha de anúncios com suporte.

A opção de anúncios em vários idiomas é uma das nossas três APIs que usam regras de personalização de ativos.

Primeiros passos

Antes de começar, confira as restrições para esse produto. Se o seu caso de uso atender às nossas especificações, prossiga para as seguintes etapas:

• Etapa 1: Criar uma campanha de anúncios e um conjunto de anúncios
• Etapa 2: Fornecer o criativo por meio de asset_feed_spec — consulte também os Idiomas disponíveis.
• Etapa 3: Criar um anúncio com asset_feed_spec em creative_spec
• Etapa 4 (opcional): Ver prévia do seu anúncio

Se você não tiver recursos para traduzir seu anúncio manualmente, confira nosso serviço de tradução automática.

Etapa 2: Fornecer o criativo por meio de asset_feed_spec

Criativos de anúncios em vários idiomas são especificados usando asset_feed_specs. Um feed de ativos é uma coleção de diferentes elementos de criativo, como imagens, títulos, corpos e assim por diante. Crie um asset_feed_spec em /adcreative.

Para criar um asset_feed_spec, forneça uma matriz de ativos para cada idioma. Adicione um rótulo para marcar cada ativo para identificar o idioma a que cada um pertence. O Facebook usa os rótulos em asset_customization_rules para agrupar ativos por idioma. Forneça pelo menos um ativo por tipo.

Parâmetros disponíveis

Os parâmetros a serem fornecidos no asset_feed_spec incluem:

Regras de personalização de ativo

Defina os ativos que aparecem juntos para os visualizadores que falam um determinado idioma. Cada regra tem um customization_spec, que define as localidades das pessoas que visualizarem esses ativos durante a veiculação de anúncio.

Forneça exatamente uma regra padrão. Essa regra deve incluir os ativos que o Facebook exibe se o idioma preferencial de um usuário não corresponder a nenhuma localidade especificada no feed de ativos. Isso ajuda a evitar a veiculação insuficiente de seus anúncios.

Idiomas disponíveis

As localidades fornecidas em customization_spec devem ser IDs de localização com suporte no direcionamento de anúncios. Consulte Direcionamento e posicionamento, Localidades. Você pode pesquisar um idioma específico usando o ponto de extremidade /search. Use o parâmetro q para pesquisar o nome de um idioma específico. Deixe esse parâmetro em branco para obter a lista de todos os idiomas compatíveis:

curl -G \
  -d "type=adlocale" \
  -d "q=en" \
  -d "limit=2" \
  -d "access_token=<ACCESS_TOKEN>" \ 
  https://graph.facebook.com/v21.0/search

Em caso de sucesso, você terá uma lista de idiomas:

{
  "data": [
    {
      "key": 6,
      "name": "English (US)"
    },
    {
      "key": 24,
      "name": "English (UK)"
    }
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MAZDZD",
    }
  }
}

Você deve usar as chaves nos resultados dessa pesquisa como localidades nas regras de personalização de ativos. Para obter mais informações, consulte Pesquisa de direcionamento.

Etapa 3: Criar anúncios usando especificações de feed de ativo

Você pode criar um feed de ativos usando o campo asset_feed_spec em POST ad_account_ID/adcreatives:

curl \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
     }' \
  -F 'asset_feed_spec={
       "ad_formats": ["SINGLE_IMAGE"],
       "bodies": [
         {
           "text": "Try our delicious guacamole recipe!",
           "adlabels": [{"name": "english"}],
         },
         {
           "text": "Essayez notre délicieuse recette de guacamole!",
           "adlabels": [{"name": "french"}],
         },
       ],
       "titles": [
         {
           "text": "Jaspers Market",
           "adlabels": [{"name": "english"}],
         },
         {
           "text": "Jaspers Market",
           "adlabels": [{"name": "french"}],
         },
       ],
       "descriptions": [
         {
           "text": "The best avocados!",
           "adlabels": [{"name": "english"}],
         },
         {
           "text": "Les meilleurs avocats!",
           "adlabels": [{"name": "french"}],
         },
       ],
       "link_urls": [
         {
           "website_url": "www.jaspersmarket.com/en",
           "adlabels": [{"name": "english"}],
         },
         {
           "website_url": "www.jaspersmarket.com/fr",
           "adlabels": [{"name": "french"}],
         },
       ],
       "images": [
         {
           "hash": "<IMAGE_HASH>",
         },
       ],
       "call_to_action_types": ["SHOP_NOW"],
       "asset_customization_rules": [
         {
           "customization_spec": {
             "locales": [9,44],
           },
           "title_label": {"name": "french"},
           "body_label": {"name": "french"},
           "description_label": {"name": "french"},
           "link_url_label": {"name": "french"},
         },
         {
             "is_default": true,
           "customization_spec": {
             "locales": [24]
           },
           "title_label": {"name": "english"},
           "body_label": {"name": "english"},
           "description_label": {"name": "english"},
           "link_url_label": {"name": "english"},
         },
       ]
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Em caso de sucesso, você recebe o ID do criativo do anúncio:

{"id":"238474593777777"}

Se seu asset_feed_spec atender às restrições abaixo, você receberá um erro.

Para criar um anúncio com esse ID de criativo do anúncio, chame POST act_AD_ACCOUNT_ID/ads. Como alternativa, para exibir idiomas diferentes em seu anúncio, forneça asset_feed_spec e object_story_spec no parâmetro creative do anúncio.

Para verificar o novo asset_feed_spec, chame GET no ID do anúncio ou no ID do criativo do anúncio:

curl -G \
-d 'fields=object_story_spec,asset_feed_spec' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<CREATIVE_ID>

Etapa 4 (opcional): Pré-visualizar o anúncio

Veja uma prévia das diferentes versões de idiomas do anúncio usando o ponto de extremidade generatepreview. Adicione um campo dynamic_asset_label com um adlabel em uma regra para visualizar uma versão de idioma específico.

Por exemplo, para ver uma prévia da versão em francês do criativo acima:

curl -G \
  --data-urlencode 'creative={ 
    "object_story_spec": { 
      "page_id": "<PAGE_ID>" 
    },
    "asset_feed_spec": {
      ...
    }
  }' \
  -d 'ad_format=DESKTOP_FEED_STANDARD' \
  -d 'dynamic_asset_label=french'
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews

Traduções automáticas

Você pode usar nosso serviço de tradução automática se não tiver os recursos para traduzir manualmente o seu anúncio. Esse recurso traduz sua cópia do anúncio padrão para idiomas adicionais para que você possa alcançar um público multilíngue.

A origem para a tradução automática pode ser encontrada nos ativos de texto especificados pela regra de personalização de ativo padrão. Cópias de anúncios traduzidas automaticamente são rotuladas como "Traduzida automaticamente".

Para criar uma versão traduzida automaticamente de sua cópia do anúncio, adicione autotranslate a asset_feed_spec. Em seguida, especifique os idiomas para os quais deseja que sua cópia seja traduzida. Veja o exemplo:

curl \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
     }' \
  -F 'asset_feed_spec={
       "ad_formats": ["SINGLE_IMAGE"],
       "autotranslate": ["fr_XX"],
       "bodies": [
         {
           "text": "Try our delicious guacamole recipe!",
           "adlabels": [{"name": "english"}],
         }
       ],
       "titles": [
         {
           "text": "Jaspers Market",
           "adlabels": [{"name": "english"}]
         }
       ],
       "descriptions": [
         {
           "text": "The best avocados!",
           "adlabels": [{"name": "english"}]
         }
       ],
       "link_urls": [
         {
           "website_url": "www.jaspersmarket.com",
           "adlabels": [{"name": "english"}]
         }
       ],
       "images": [
         {
           "hash": "<IMAGE_HASH>"
         },
       ],
       "call_to_action_types": ["SHOP_NOW"],
       "optimization_type": "LANGUAGE",
       "asset_customization_rules": [
         {
           "is_default": true,
           "customization_spec": {
             "locales": [6]
           },
           "title_label": {"name": "english"},
           "body_label": {"name": "english"},
           "description_label": {"name": "english"},
           "link_url_label": {"name": "english"}
         }
       ]
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

É possível revisar os textos traduzidos automaticamente com uma chamada do campo asset_feed_spec no criativo.

Quaisquer edições nas cópias traduzidas automaticamente nas especificações serão descartadas se o mesmo idioma for especificado no campo autotranslate. Essas edições serão substituídas por novas traduções da cópia do anúncio padrão. Se você realmente precisar das edições, remova o idioma do campo autotranslate.

link_urls

Você pode adicionar uma URL de link personalizado à versão do anúncio traduzida automaticamente.

Para fazer isso, adicione uma URL language-specific ao campo link_urls juntamente com um adlabel e adicione uma nova regra em asset_customization_rules com os códigos de localidade associados e o link_url_label para o idioma em questão.

Restrições

Veja a seguir as restrições e os limites no feed de ativos.

Formatos de anúncio

• Somente um formato do anúncio por asset_feed_spec
• Para o formato SINGLE_IMAGE, você deve fornecer pelo menos uma imagem.
• Para o formato SINGLE_VIDEO, você deve fornecer pelo menos um vídeo

Ativos, geral

• Você pode fornecer no máximo 49 ativos para cada tipo, exceto call_to_action_types.
• Você deve fornecer exatamente um ativo call_to_action_type para todos os objetivos.

Ativos de texto

• Você deve fornecer pelo menos um ativo de texto, como titles, corpos, descriptions e link_urls para cada idioma no feed de ativos.
• Todos os ativos de texto devem ter o campo adlabels.
• Tamanho máximo: 255 caracteres para o título, 4.096 caracteres para o corpo e 10.000 caracteres para a descrição.

Ativos de imagem e vídeo

• Para obter os tamanhos de imagem recomendados por posicionamento e objetivo, consulte o Guia de anúncios.
• Você pode usar até um ativo de imagem ou vídeo sem um adlabel. Usamos essa imagem ou esse vídeo para todas as versões do idioma.
• Se você fornecer vídeos ou imagens adicionais, deverá incluir adlabels e fornecer esses rótulos em sua regra de personalização de ativos.

Ativos de URL de link

• Se você fornecer url_tags, nós os anexaremos ao link_url como parâmetros para cada ativo no anúncio.
• Se você usar o objetivo APP_INSTALLS, seu link_url deve ser o mesmo que o promoted_object.object_store_url do conjunto de anúncios.

Regras de personalização de ativo

• Você deve fornecer uma regra de personalização de ativos para cada variante de idioma em asset_feed_spec.
• Forneça também uma regra padrão. Ela é uma regra de personalização de ativo com is_default definido como true. Ela funciona como uma regra alternativa e permite que os anúncios sejam exibidos mesmo quando a localidade de alguém não corresponde a nenhum dos idiomas em asset_feed_spec.

Posicionamentos

• Anúncios em vários idiomas permitem todos os posicionamentos.

Objetivos e tipos de destinos disponíveis

• LINK_CLICKS - Sites e aplicativos, sem Messenger.
• APP_INSTALLS - Aplicativos para desktop e celular.
• CONVERSIONS - Sites e aplicativos, sem Messenger.
• REACH - Todos os tipos de destino.
• BRAND_AWARENESS - Todos os tipos de destino.
• VIDEO_VIEWS - Todos os tipos de destino.

Tipos de compras aceitos

• REACH - Alcance e frequência
• AUCTION

Direções de tradução aceitas

As direções de tradução a seguir são aceitas. Use o código de dialeto correspondente no campo autotranslate: