Anuncios en varios idiomas

Personaliza distintas secciones del contenido del anuncio, tales como las imágenes, el vídeo, el texto y el cuerpo, para llegar a personas que hablen distintos idiomas. Facebook optimiza el anuncio para mostrar la versión de idioma adecuada para cada persona.

De esta forma, puedes configurar de forma sencilla un anuncio en varios idiomas y entregarlo a los espectadores en el idioma más pertinente, a la vez que conservas una segmentación amplia para dicho anuncio. Esto te permite contar con contenido personalizado según el idioma del espectador, a la vez que los anuncios te siguen resultando rentables.

Para obtener información general sobre esta característica, consulta Servicio de ayuda para anunciantes, Anunciar en varios idiomas. Consulta los objetivos de la campaña publicitaria que se admiten.

Anuncios en varios idiomas es una de nuestras tres API que utilizan reglas de personalización de activos.

Primeros pasos

Antes de comenzar, consulta las restricciones para este producto. Si tu caso de uso cumple nuestras especificaciones, continúa con los pasos siguientes:

• Paso 1: Crear una campaña publicitaria 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 una vista previa del anuncio

Si no dispones de recursos para traducir manualmente el 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 mediante los elementos asset_feed_spec. Una lista de activos es una colección de distintos elementos de contenido, como imágenes, títulos o cuerpos, entre otros. Un elemento asset_feed_spec se crea en /adcreative.

Para crear un elemento asset_feed_spec, proporciona una matriz de activos para cada idioma diferente. Añade una etiqueta a cada activo para identificar a qué idioma pertenece. Facebook utiliza las etiquetas de asset_customization_rules para agrupar activos por idioma. Debes proporcionar un activo como mínimo por tipo de activo.

Parámetros disponibles

Los parámetros que se proporcionan en asset_feed_spec incluyen:

Reglas de personalización de piezas

Define los activos que deben aparecer juntos para los espectadores que hablan un idioma concreto. Cada regla tiene un elemento customization_spec que define las configuraciones regionales de las personas que ven estos activos durante la entrega de anuncios.

Proporciona exactamente una regla predeterminada que debe incluir los activos que Facebook mostrará si el idioma preferido de alguna persona no coincide con ninguna de las configuraciones regionales incluidas en la lista de activos. De esta forma, evitas la entrega insuficiente de anuncios.

Idiomas disponibles

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

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

Si la búsqueda se completa correctamente, 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 de tus 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 la lista de activos

Puedes crear una lista de activos mediante el campo asset_feed_spec en la solicitud 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 el proceso se completa correctamente, obtendrás el identificador del contenido del anuncio:

{"id":"238474593777777"}

Si el elemento asset_feed_spec no cumple con las restricciones siguientes, se mostrará un error.

Para crear un anuncio con este identificador de contenido del anuncio, realiza una llamada a POST act_AD_ACCOUNT_ID/ads. De forma alternativa, para mostrar idiomas diferentes en tu anuncio, proporciona los elementos asset_feed_spec y object_story_spec en el parámetro creative del anuncio.

Para verificar el nuevo elemento asset_feed_spec, realiza una llamada a GET en el identificador del anuncio o el identificador del 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 una vista previa del anuncio

Obtén una vista previa de las versiones de idiomas diferentes del anuncio mediante el extremo generatepreview. Añade un campo dynamic_asset_label con un elemento adlabel en una regla para ver una versión de idioma específica.

Por ejemplo, para obtener una vista previa de la versión francesa 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

Puedes utilizar nuestro servicio de traducción automática si no dispones de recursos para traducir el anuncio manualmente. Esta función traduce el texto del anuncio predeterminado a otros idiomas para que puedas llegar a una audiencia con distintos idiomas.

El origen de la traducción automática se puede encontrar en los activos de texto que especifica la regla de personalización de activos predeterminada. Las copias de anuncios traducidos automáticamente incluyen la etiqueta "Traducido automáticamente".

Para crear una versión traducida automáticamente del texto del anuncio, añade autotranslate a asset_feed_spec. A continuación, especifica los idiomas a los que quieres traducir el texto. Consulta 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

Las copias traducidas automáticamente se pueden revisar con una llamada al campo asset_feed_spec en el contenido.

Todas las ediciones de las copias traducidas automáticamente en la especificación se descartarán si se especifica el mismo idioma en el campo autotranslate. Estas ediciones se reemplazarán por nuevas traducciones del texto del anuncio predeterminado. Si necesitas definitivamente las ediciones, quita el idioma del campo autotranslate.

link_urls

Puedes añadir la URL de un enlace personalizado a la versión del anuncio traducida automáticamente.

Para ello, añade una URL language-specific al campo link_urls junto con una etiqueta adlabel y añade una nueva regla en asset_customization_rules con los códigos de configuración regional asociados y la etiqueta link_url_label de este idioma.

Restricciones

A continuación, se enumeran las restricciones y limitaciones aplicables a la lista de activos.

Formatos de anuncio

• Solo se admite 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 vídeo.

Activos, General

• Puedes proporcionar un máximo de 49 activos para cada tipo de activo, excepto 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 titles, bodies, descriptions y link_urls, para cada versión de idioma de la lista de activos.
• Todos los activos de texto deben tener el campo adlabels.
• Longitud máxima: 255 caracteres para el título, 4096 para el cuerpo y 10000 caracteres para la descripción.

Activos de imagen y vídeo

• Para conocer los tamaños de imagen recomendados por ubicación y objetivo, consulta la guía de anuncios.
• Puedes utilizar un activo de imagen o vídeo como máximo sin un elemento adlabel. Esta es la imagen o vídeo que se usa para todos los idiomas.
• Si proporcionas vídeos o imágenes adicionales, debes incluir elementos adlabels y proporcionar estas etiquetas en la regla de personalización de activos.

Activos de URL de enlace

• Si proporcionas etiquetas url_tags, las anexaremos al elemento link_url como parámetros para cada activo del anuncio.
• Si utilizas el objetivo APP_INSTALLS, el elemento link_url debe coincidir con el elemento promoted_object.object_store_url del conjunto de anuncios.

Reglas de personalización de piezas

• Debes proporcionar una regla de personalización de activos para cada variante de idioma en asset_feed_spec.
• Debes proporcionar una regla predeterminada. Esta es una regla de personalización de activos con is_default establecido en true. Actúa como regla de reserva y permite que los anuncios se muestren aunque la configuración regional de una persona no coincida con ninguno de los idiomas de asset_feed_spec.

Ubicaciones

• Anuncios en varios idiomas admite todas las ubicaciones.

Tipos de destino y objetivos disponibles

• LINK_CLICKS: sitio web y aplicaciones (Messenger no).
• APP_INSTALLS: aplicaciones para ordenadores y móviles.
• CONVERSIONS: sitio web y aplicaciones (Messenger no).
• 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

Direcciones de traducción admitidas

Se admiten las direcciones de traducción siguientes. Utiliza el código de dialecto correspondiente en el campo autotranslate: