Многоязычные объявления

Компоненты рекламных креативов (изображения, видео, тексты, тело объявлений) можно сделать многоязычными. Facebook будет автоматически определять, на каком языке показывать рекламу каждому конкретному пользователю.

Многоязычные объявления удобны тем, что для них можно использовать широкие параметры таргетинга. Таким образом, пользователи видят контент, персонализированный для их языка, а вы не тратите на рекламу лишних средств.

Общую информацию о многоязычной рекламе см. в Справочном центре для рекламодателей. Также см. список поддерживаемых целей кампаний.

API многоязычных объявлений — один из наших трех API, использующих правила кастомизации креативов.

Начало работы

Прежде чем начинать, ознакомьтесь с ограничениями для этого продукта. Если в вашем случае выполняются все наши условия, переходите к следующим этапам.

• 1. Создайте кампанию и группу объявлений.
• 2. Добавьте креатив через asset_feed_spec (также см. раздел Доступные языки).
• 3. Создайте объявление, указав asset_feed_spec в creative_spec.
• 4. (Необязательно). Проверьте объявление в режиме предпросмотра.

Если у вас нет возможности вручную перевести свое объявление, попробуйте воспользоваться нашей службой автоматического перевода.

2. Добавьте креатив через asset_feed_spec

Для добавления рекламных креативов на разных языках используется объект asset_feed_spec. Фид объектов — это подборка разных элементов, из которых состоят креативы: изображений, заголовков, текстов и т. д. Чтобы создать asset_feed_spec, используйте /adcreative.

При создании asset_feed_spec нужно предоставить массив объектов для каждого языка. Помечайте каждый объект ярлыком, указывающим на его язык. Facebook использует эти ярлыки в правилах asset_customization_rules, чтобы группировать объекты по языкам. Добавьте как минимум по одному объекту каждого типа.

Доступные параметры

В asset_feed_spec используются следующие параметры:

Правила кастомизации креативов

Вы можете указать, какие объекты будут входить в состав объявлений для каждого конкретного языка. У каждого правила есть параметр customization_spec, определяющий локали пользователей, которым показываются эти объекты.

Используйте ровно одно правило по умолчанию. Определите в нем объекты, которые Facebook будет показывать людям, чей предпочитаемый язык не совпадает ни с какими локалями, заданными в фиде объектов. Это нужно, чтобы обеспечить достаточный охват рекламы.

Доступные языки

В customization_spec можно использовать только ID локалей, поддерживаемые в параметрах таргетинга рекламы. Подробнее см. в этом разделе. Для поиска нужного языка используйте конечную точку /search. Для поиска по названию языка используйте параметр q. Если оставить этот параметр пустым, вы получите список всех поддерживаемых языков:

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

Если запрос будет выполнен успешно, вы получите список языков:

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

Ключи из результатов поиска нужно указать в качестве локалей в правилах кастомизации креативов. Дополнительные сведения см. в статье Поиск для таргетинга.

3. Создайте объявления с использованием спецификаций фида объектов

Для создания фида объектов можно использовать поле asset_feed_spec в 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": "J45p3r5m4RK374VOc4DO2",
         },
       ],
       "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/API_VERSION/act_AD_ACCOUNT_ID/adcreatives

Если код будет выполнен успешно, вы получите ID рекламного креатива:

{"id":"238474593777777"}

Если asset_feed_spec нарушает ограничения (см. ниже), выводится ошибка.

Чтобы создать объявление на основе рекламного креатива с нужным ID, выполните вызов POST act_AD_ACCOUNT_ID/ads. Чтобы объявление показывалось на разных языках, задайте значения asset_feed_spec и object_story_spec в параметре creative.

Чтобы проверить asset_feed_spec, выполните вызов GET для ID объявления или рекламного креатива:

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

4. (Необязательно). Проверьте объявление в режиме предпросмотра

Для предпросмотра разных языковых версий одного объявления можно использовать конечную точку generatepreview. Чтобы посмотреть версию на конкретном языке, задайте в правиле поле dynamic_asset_label и укажите adlabel.

Например, вот как можно посмотреть французский вариант креатива из примера выше:

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/<API_VERSION>/act_<AD_ACCOUNT_ID>/generatepreviews

Автоматический перевод

Если вы не можете обратиться к переводчикам, воспользуйтесь нашим сервисом автоматического перевода. Он переведет стандартный текст вашей рекламы на другие языки, на которых говорят ваши потенциальные клиенты.

Исходный текст берется из текстовых объектов, заданных в стандартном правиле кастомизации креативов. Перевод помечается как автоматический.

Чтобы рекламный текст переводился автоматически, добавьте в asset_feed_spec поле autotranslate и укажите нужные языки. Пример:

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"],
       "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/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives/?fields=asset_feed_spec

Чтобы посмотреть автоматически переведенную рекламу, вызовите поле asset_feed_spec креатива.

Если в поле autotranslate задан тот же язык, вы не сможете редактировать автоматически переведенный на него рекламный текст: внесенные изменения не будут сохраняться. Для каждого показа ваш стандартный рекламный текст переводится заново. Если вам нужно использовать именно версию с правками, удалите соответствующий язык из поля autotranslate.

link_urls

В автоматически переведенную версию рекламы можно добавить пользовательскую ссылку.

Для этого укажите URL (language-specific) и adlabel в поле link_urls. Затем добавьте в asset_customization_rules новое правило с соответствующими кодами локалей и link_url_label для нужного языка.

Ограничения

Ниже перечислены ограничения для лент объектов.

Форматы рекламы

• Только один формат рекламы на один параметр asset_feed_spec.
• Для формата SINGLE_IMAGE нужно задать как минимум одно изображение.
• Для формата SINGLE_VIDEO нужно задать как минимум одно видео.

Общие ограничения для объектов

• Для каждого типа объектов, кроме call_to_action_types, можно задать не более 49 объектов.
• Для каждой цели необходимо задать по одному объекту типа call_to_action_type.

Текстовые объекты

• Для каждой языковой версии в ленте объектов необходимо задать как минимум по одному текстовому объекту (title, основной текст, description, link_urls).
• Все текстовые объекты должны содержать поле adlabels.
• Максимальная длина: заголовок — 255 символов, основной текст — 4 096 символов, описание — 10 000 символов.

Изображения и видео

• Рекомендуемые размеры изображений для разных целей и мест размещения см. в руководстве по рекламе.
• Можно использовать не более одного изображения или видео без adlabel. Это изображение или видео будет использоваться для всех языковых версий.
• Если вы хотите добавить другие изображения (видео), укажите для них ярлыки adlabel и задайте эти ярлыки в правиле кастомизации креативов.

Ссылки

• Если вы зададите url_tags, они будут добавляться к link_url в качестве параметров для каждого объекта в объявлении.
• Если ваша цель — APP_INSTALLS, то link_url и promoted_object.object_store_url группы объявлений должны совпадать.

Правила кастомизации креативов

• Настройте для каждой локали в asset_feed_spec отдельное правило кастомизации креативов.
• Одно правило необходимо задать как используемое по умолчанию (значение is_default — true). Это правило применяется как резервное и обеспечивает показ рекламы пользователям с локалями, не указанными в asset_feed_spec.

Места размещения

• Для многоязычных объявлений поддерживаются все места размещения.

Доступные цели и места назначения

• LINK_CLICKS — сайт и приложения (без Messenger).
• APP_INSTALLS — приложения для ПК и мобильные приложения.
• CONVERSIONS — сайт и приложения (без Messenger).
• REACH — все типы мест назначения.
• BRAND_AWARENESS — все типы мест назначения.
• VIDEO_VIEWS — все типы мест назначения.

Поддерживаемые закупочные типы

• REACH — охват и частота.
• AUCTION.

Поддерживаемые языковые пары

Ниже перечислены языковые пары, поддерживаемые функцией автоматического перевода. Чтобы использовать ее, укажите в поле autotranslate нужный код локали: