Anuncios en varios idiomas

Puedes personalizar distintas partes del contenido del anuncio, como la imagen, el video, el texto y el cuerpo, a fin de llegar a hablantes de distintos idiomas. Facebook optimiza el anuncio para mostrar la versión de idioma correcta a las personas adecuadas.

Eso te ayuda a configurar fácilmente un anuncio en distintos idiomas y a entregar la versión más pertinente para cada espectador, sin dejar de tener una segmentación amplia. Esto te permite contar con contenidos personalizados en función del idioma del espectador, sin perder la eficacia en función de los costos del anuncio.

Para obtener información general sobre esta función, consulta Servicio de ayuda para anunciantes, Muestra tus anuncios a un público multilingüe. Mira los objetivos de campaña publicitaria admitidos.

La API de anuncios en varios idiomas es una de nuestras tres API que usan las reglas de personalización de activos.

Primeros pasos

Antes de empezar, verifica las restricciones para este producto. Si tu caso de uso cumple con nuestras especificaciones, continúa con lo siguientes pasos:

• Paso 1: Crear una campaña de anuncios y un conjunto de anuncios
• Paso 2: Proporcionar contenido a través de asset_feed_spec; consulta también Idiomas disponibles.
• Paso 3: Crear un anuncio con asset_feed_spec en creative_spec
• Paso 4 (opcional): Obtener la vista previa del anuncio

Si no tienes los recursos necesarios para traducir manualmente tu anuncio, consulta nuestro servicio de traducción automática.

Paso 2: Proporcionar contenido a través de asset_feed_spec

El contenido de los anuncios en varios idiomas se especifica usando asset_feed_spec. Una lista de activos es una colección de diferentes elementos de contenido, como imágenes, títulos, texto, etc. Crea una asset_feed_spec en /adcreative.

Para crear una asset_feed_spec, proporciona una matriz de activos para cada idioma. Agrega una etiqueta para etiquetar cada activo de modo que se identifique el idioma al que pertenece. Facebook usa las etiquetas en asset_customization_rules para agrupar activos por idioma. Debes proporcionar al menos un activo por tipo de activo.

Parámetros disponibles

Entre los parámetros que se deben proporcionar en asset_feed_spec se incluyen los siguientes:

Reglas de personalización de activos

Define los activos que aparecen juntos para espectadores que hablen en un idioma específico. Cada regla tiene una customization_spec que define las configuraciones regionales de las personas que pueden visualizar los activos durante la entrega de anuncios.

Debes proporcionar exactamente una regla predeterminada. La regla incluye los activos que muestra Facebook si el idioma preferido de una persona no coincide con ninguna de las configuraciones regionales de la lista de activos. Esto ayuda a prevenir la entrega insuficiente de anuncios.

Idiomas disponibles

Las configuraciones regionales que proporciones en customization_spec deben ser ID de configuraciones regionales admitidos en la segmentación de anuncios. Consulta Segmentación y ubicación, Configuraciones regionales. Puedes buscar idiomas específicos mediante el punto de conexión /search. Usa el parámetro q para buscar un nombre de idioma específico. Deja este parámetro en blanco para obtener una lista de todos los idiomas admitidos:

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

Si es correcto, obtendrás una lista de idiomas:

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

Debes usar las claves de estos resultados de búsqueda como configuraciones regionales en las reglas de personalización de activos. Para obtener más información, consulta Búsqueda de segmentación.

Paso 3: Crear anuncios con especificaciones de lista de activos

Puedes crear una lista de activos usando el campo asset_feed_spec en 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

Si es correcto, obtienes el identificador del contenido del anuncio:

{"id":"238474593777777"}

Si tu asset_feed_spec no cumple con las siguientes restricciones, verás un error.

Para crear un anuncio con este identificador de contenido del anuncio, haz una llamada a POST act_AD_ACCOUNT_ID/ads. Como alternativa, para mostrar distintos idiomas en un anuncio, proporciona asset_feed_spec y object_story_spec en el parámetro creative del anuncio.

Para verificar la nueva asset_feed_spec, puedes hacer una llamada GET sobre el identificador del anuncio o el identificador de contenido del anuncio:

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

Paso 4 (opcional): Obtener la vista previa del anuncio

Obtén la vista previa de las versiones en distintos idiomas de tu anuncio usando el punto de conexión generatepreview. Agrega un campo dynamic_asset_label con una adlabel en una regla para visualizar la versión en un idioma específico.

Por ejemplo, para obtener la vista previa de la versión en francés del contenido anterior:

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

Traducciones automáticas

Si no cuentas con los recursos necesarios para traducir tu anuncio, puedes usar nuestro servicio de traducción automática. Esta funcionalidad traduce el texto del anuncio predeterminado a otros idiomas para que puedas alcanzar a públicos que hablen diferentes idiomas.

La fuente de la traducción automática se puede encontrar en los activos de texto especificados por la regla de personalización de activos predeterminada. Los textos de anuncios traducidos de forma automática tienen la etiqueta “Traducido automáticamente”.

Para crear una versión automáticamente traducida del texto del anuncio, agrega autotranslate a asset_feed_spec. Luego, especifica los idiomas a los que desees traducir el texto. Mira el ejemplo:

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

Los textos traducidos automáticamente se pueden revisar con una llamada al campo asset_feed_spec del anuncio.

Las ediciones que se apliquen al texto automáticamente traducido de la especificación se ignorarán si se especifica el mismo idioma en el campo autotranslate. Estas ediciones se reemplazarán por traducciones nuevas del texto del anuncio predeterminado. Si necesitas las ediciones, elimina el idioma del campo autotranslate.

link_urls

Puedes agregar una URL con enlace personalizada a la versión automáticamente traducida del anuncio.

Para hacerlo, agrega una URL language-specific al campo link_urls junto con una adlabel, y también añade una nueva regla a asset_customization_rules con los códigos de configuración regional asociados y link_url_label para este idioma.

Restricciones

Las siguientes son las restricciones y los límites de la lista de activos.

Formatos de anuncios

• Solo un formato de anuncio por asset_feed_spec
• Para el formato SINGLE_IMAGE, debes proporcionar al menos una imagen.
• Para el formato SINGLE_VIDEO, debes proporcionar al menos un video.

Activos, general

• Puedes proporcionar 49 activos como máximo para cada tipo de activo, con la excepción de call_to_action_types.
• Debes proporcionar exactamente un activo call_to_action_type para todos los objetivos.

Activos de texto

• Debes proporcionar al menos un activo de texto, como title, bodies, description y link_urls, para cada versión de idioma de la lista de activos.
• Todos los activos de texto deben tener el campo adlabels.
• Extensión máxima: 255 caracteres para el título, 4096 para el texto y 10.000 para la descripción.

Activos de imagen y video

• Consulta la guía de anuncios para obtener los tamaños de imagen recomendados para las ubicaciones y los objetivos.
• Puedes usar hasta un activo de imagen o video sin adlabel. Usamos esa imagen o ese video en todas las versiones de idioma.
• Si proporcionas videos o imágenes adicionales, debes incluir adlabel, y esas etiquetas deben incluirse en la regla de personalización de activos.

Activos de URL de enlace

• Si proporcionas url_tags, las anexamos a link_url como parámetros para cada activo del anuncio.
• Si usas el objetivo APP_INSTALLS, link_url debe coincidir con promoted_object.object_store_url en el conjunto de anuncios.

Reglas de personalización de activos

• Debes proporcionar una regla de personalización de activos para cada variante de idioma en asset_feed_spec.
• Debes proporcionar una regla predeterminada. Es una regla de personalización de activos con is_default fijado en el valor true. Funciona como regla de respaldo y permite que los anuncios se muestren incluso si la configuración regional de una persona no coincide con ninguno de los idiomas de asset_feed_spec.

Ubicaciones

• Los anuncios en varios idiomas admiten todas las ubicaciones.

Objetivos y tipos de destino disponibles

• LINK_CLICKS: sitio web y apps, sin Messenger.
• APP_INSTALLS: apps para computadoras o celulares.
• CONVERSIONS: sitio web y apps, sin Messenger.
• REACH: todos los tipos de destino.
• BRAND_AWARENESS: todos los tipos de destino.
• VIDEO_VIEWS: todos los tipos de destino.

Tipos de compra admitidos

• REACH: alcance y frecuencia
• AUCTION

Pares de idiomas admitidos

Se admiten los siguientes pares de idiomas para la traducción. Usa el código de dialecto correspondiente en el campo autotranslate: