Похожие аудитории

Вы можете включить в таргетинг пользователей, которые максимально схожи с вашей текущей клиентской аудиторией. При создании похожей аудитории Facebook берет за основу определенный набор пользователей в качестве исходной аудитории. Похожие аудитории можно использовать с любой бизнес-целью: для таргетинга на людей, которые похожи на ваших клиентов, для увеличения количества поклонников, регистраций на сайте, покупок за пределами Facebook, использования купонов, а также просто повышения узнаваемости бренда.

В качестве исходной аудитории можно использовать:

Если похожая аудитория относится к рекламной группе, Facebook обновляет состав этой похожей аудитории каждые 3 дня.

Создание

Заполнение пользовательской аудитории участниками может занять от 1 до 6 часов. Во время заполнения аудиторию можно использовать для создания и демонстрации групп объявлений. Когда аудитория будет готова, Facebook начнет демонстрировать рекламные объявления ее участникам, и показ рекламы постепенно нормализуется. См. раздел о статусе показа. Для создания похожей аудитории используйте конечную точку https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/customaudiences.

Пример вызова для создания похожей аудитории на базе пользовательской:

use FacebookAds\Object\CustomAudience;
use FacebookAds\Object\Fields\CustomAudienceFields;
use FacebookAds\Object\Values\CustomAudienceSubtypes;

$lookalike = new CustomAudience(null, 'act_<AD_ACCOUNT_ID>');
$lookalike->setData(array(
  CustomAudienceFields::NAME => 'My lookalike audience',
  CustomAudienceFields::SUBTYPE => CustomAudienceSubtypes::LOOKALIKE,
  CustomAudienceFields::ORIGIN_AUDIENCE_ID => <SEED_AUDIENCE_ID>,
  CustomAudienceFields::LOOKALIKE_SPEC => array(
    'type' => 'similarity',
    'country' => 'US',
  ),
));
$lookalike->create();
from facebookads.adobjects.customaudience import CustomAudience

lookalike = CustomAudience(parent_id='act_<AD_ACCOUNT_ID>')
lookalike.update({
    CustomAudience.Field.name: 'My lookalike audience',
    CustomAudience.Field.subtype: CustomAudience.Subtype.lookalike,
    CustomAudience.Field.origin_audience_id: '<SEED_AUDIENCE_ID>',
    CustomAudience.Field.lookalike_spec: {
        'type': 'similarity',
        'country': 'US',
    },
})

lookalike.remote_create()
print(lookalike)
curl \
  -F 'name=My lookalike audience' \
  -F 'subtype=LOOKALIKE' \
  -F 'origin_audience_id=<SEED_AUDIENCE_ID>' \
  -F 'lookalike_spec={"type":"similarity","country":"US"}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/customaudiences

Для создания похожих аудиторий с использованием SDK рекламы для PHP или Python используйте CustomAudience.

Ответ содержит следующие параметры:

Имя Описание

id

Тип: целое число

ID похожей аудитории.

Похожая аудитория на основе пользовательской аудитории

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

Имя Описание

name

Тип: строка

Обязательный параметр.

Название пользовательской аудитории.

origin_audience_id

Тип: длинное целое

Обязательный параметр.

ID пользовательской аудитории. Исходная аудитория должна включать в себя не менее 100 участников.

lookalike_spec

Тип: массив

Обязательный параметр.

См. описание ниже.

lookalike_spec.type

Тип: строка

Обязательно. См. type или ratio.

similarity или reach.

lookalike_spec.starting_ratio

Тип: число с плавающей запятой

Необязательный параметр.

Начальное процентное значение для создания похожей аудитории. Например, для параметров starting_ratio=0,01 и ratio =0,02 в похожую аудиторию будут включены 1–2 % похожих пользователей. Значение starting_ratio должно быть меньше ratio.

lookalike_spec.ratio

Тип: число с плавающей запятой

Обязательный параметр. Задайте либо type, либо ratio.

0.010.20 с шагом 0,01. Наиболее похожие x % участников исходной аудитории в выбранной стране.

lookalike_spec.allow_international_seeds

Тип: логическое значение

Необязательный параметр.

В каждой стране должно быть не менее 100 участников исходной аудитории. Если набрать это количество не удается и для параметра allow_international_seeds установлено значение true, Facebook подбирает соответствующее минимальное количество участников аудитории в другой стране. Значение по умолчанию — false.

lookalike_spec.country

Тип: строка

Обязательный параметр. Значение: country или location_spec.

Поиск участников похожей аудитории в указанной стране.

lookalike_spec.location_spec

Тип: массив

Обязательный параметр. country или location_spec.

Поиск участников похожей аудитории в указанных местах. Список стран или групп стран, например Asia.

lookalike_spec.location_spec.geo_locations

Тип: массив

Обязательный параметр. Не менее одной записи countries или country_groups.

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

lookalike_spec.location_spec.geo_locations.countries

Тип: массив строк

Необязательный параметр.

Целевые страны. Список кодов стран (см. статью API Targeting Search: страны). Пример:'countries': ['US'].

lookalike_spec.location_spec.geo_locations.country_groups

Тип: массив строк

Необязательный параметр.

Целевые страны в глобальных регионах и свободных торговых зонах. Массив с кодами групп стран. Полное описание возможных вариантов см. в статьях о таргетинге по местоположению (country_groups) и поиске для таргетинга (country_groups). Пример:'country_groups': ['asia','mercosur'].

lookalike_spec.location_spec.excluded_geo_locations

Тип: массив

Необязательный параметр.

Места, исключаемые из процесса создания похожей аудитории.

lookalike_spec.location_spec.excluded_geo_locations.countries

Тип: массив строк

Необязательный параметр.

То же самое, что и countries в geo_locations.

lookalike_spec.location_spec.excluded_geo_locations.country_groups

Тип: массив строк

Необязательный параметр.

То же самое, что и country_groups в geo_locations.

Типы

Аудиторию можно оптимизировать для повышения похожести или увеличения охвата.

  • Похожесть: аудитория будет включать в себя 1 % пользователей из выбранной страны, максимально похожих на участников исходной пользовательской аудитории. Охват новой аудитории будет меньше, а сопоставление — точнее.
  • Охват: аудитория будет включать в себя 5 % пользователей из выбранной страны, похожих на участников исходной пользовательской аудитории, однако сопоставление при этом будет менее точным.

Вместо использования типов в параметре ratio можно вручную указать процент максимально похожих пользователей, которые будут подбираться из указанной страны. Значение ratio задается в диапазоне от 1 до 20 % с шагом 1 %.

Похожие аудитории на основе конверсий кампании или группы объявлений

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

use FacebookAds\Object\CustomAudience;
use FacebookAds\Object\Fields\CustomAudienceFields;
use FacebookAds\Object\Values\CustomAudienceSubtypes;

$lookalike = new CustomAudience(null, 'act_<AD_ACCOUNT_ID>');
$lookalike->setData(array(
  CustomAudienceFields::SUBTYPE => CustomAudienceSubtypes::LOOKALIKE,
  CustomAudienceFields::LOOKALIKE_SPEC => array(
    'origin_ids' => <CAMPAIGN_ID>,
    'starting_ratio' => 0.03,
    'ratio' => 0.05,
    'conversion_type' => 'campaign_conversions',
    'country' => 'US',
  ),
));
$lookalike->create();
from facebookads.adobjects.customaudience import CustomAudience

lookalike = CustomAudience(parent_id='act_<AD_ACCOUNT_ID>')
lookalike.update({
    CustomAudience.Field.subtype: CustomAudience.Subtype.lookalike,
    CustomAudience.Field.lookalike_spec: {
        'origin_ids': '<CAMPAIGN_ID>',
        'starting_ratio': 0.03,
        'ratio': 0.05,
        'conversion_type': 'campaign_conversions',
        'country': 'US',
    },
})

lookalike.remote_create()
print(lookalike)
curl \
  -F 'subtype=LOOKALIKE' \
  -F 'lookalike_spec={ 
    "origin_ids": "<CAMPAIGN_ID>", 
    "starting_ratio": 0.03, 
    "ratio": 0.05, 
    "conversion_type": "campaign_conversions", 
    "country": "US" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/customaudiences

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

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

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

Имя Описание

lookalike_spec

Тип: массив

Обязательный параметр.

См. описание ниже.

lookalike_spec.origin_ids

Тип: массив целых чисел

Обязательный параметр.

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

lookalike_spec.conversion_type

Тип: строка

Обязательный параметр.

campaign_conversions. Указывает, что похожая аудитория создана на базе конверсий кампании.

lookalike_spec.country

Тип: строка

Обязательный параметр.

Страна для подбора участников похожей аудитории.

lookalike_spec.allow_international_seeds

Тип: логическое значение

Необязательный параметр.

В каждой стране должно быть не менее 100 участников исходной аудитории. Если набрать это количество не удается и для параметра allow_international_seeds установлено значение true, Facebook подбирает соответствующее минимальное количество участников в другой стране. Значение по умолчанию — false.

lookalike_spec.starting_ratio

Тип: число с плавающей запятой

Необязательный параметр.

Начальное процентное значение для создания похожей аудитории. Например, для параметров starting_ratio=0,01 и ratio=0,02 в похожую аудиторию будут включены 1–2 % похожих пользователей. Значение starting_ratio должно быть меньше ratio.

lookalike_spec.ratio

Тип: число с плавающей запятой

Обязательный параметр.

Значение в диапазоне от 0.01 до 0.20. Наиболее похожие x % участников исходной аудитории в выбранной стране.

В настоящее время для создания похожих аудиторий можно использовать следующие типы конверсий из кампаний:

  • клики по ссылке;
  • реклама предложений;
  • отметки "Нравится" Страницы;
  • установки приложений холста;
  • ответы на приглашение;
  • взаимодействие с публикацией;
  • конверсии на сайте;
  • установки мобильного приложения;
  • вовлеченность для мобильного приложения;
  • просмотры видео;
  • местная узнаваемость.

Похожие аудитории на основе аудитории поклонников Страницы

Похожую аудиторию можно создать на основе пользователей, которым нравится ваша Страница.

use FacebookAds\Object\CustomAudience;
use FacebookAds\Object\Fields\CustomAudienceFields;
use FacebookAds\Object\Values\CustomAudienceSubtypes;

$lookalike = new CustomAudience(null, 'act_<AD_ACCOUNT_ID>');
$lookalike->setData(array(
  CustomAudienceFields::SUBTYPE => CustomAudienceSubtypes::LOOKALIKE,
  CustomAudienceFields::LOOKALIKE_SPEC => array(
    'ratio' => 0.01,
    'country' => 'US',
    'page_id' => <PAGE_ID>,
    'conversion_type' => 'page_like',
  ),
));
$lookalike->create();
from facebookads.adobjects.customaudience import CustomAudience

lookalike = CustomAudience(parent_id='act_<AD_ACCOUNT_ID>')
lookalike.update({
    CustomAudience.Field.name: 'My lookalike audience',
    CustomAudience.Field.subtype: CustomAudience.Subtype.lookalike,
    CustomAudience.Field.lookalike_spec: {
        'ratio': 0.01,
        'country': 'US',
        'page_id': '<PAGE_ID>',
        'conversion_type': 'page_like',
    },
})

lookalike.remote_create()
print(lookalike)
curl \
  -F 'subtype=LOOKALIKE' \
  -F 'lookalike_spec={ 
    "ratio": 0.01, 
    "country": "US", 
    "page_id": "<PAGE_ID>", 
    "conversion_type": "page_like" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/customaudiences
Имя Описание

lookalike_spec

Тип: массив

Обязательный параметр.

См. описание ниже.

lookalike_spec.page_id

Тип: целое число

Обязательный параметр.

ID Страницы Facebook, поклонники которой будут использоваться в качестве основы для создания похожей аудитории.

lookalike_spec.conversion_type

Тип: строка

Обязательный параметр.

page_like обозначает, что эта похожая аудитория создается на основе поклонников Страницы.

lookalike_spec.country

Тип: строка

Обязательный параметр.

Страна, в которой будут подбираться пользователи для создания похожей аудитории. По умолчанию — США.

lookalike_spec.allow_international_seeds

Тип: логическое значение

Необязательный параметр.

В каждой стране должно быть не менее 100 участников исходной аудитории. Если набрать это количество не удается и для параметра allow_international_seeds установлено значение true Facebook подбирает соответствующее минимальное количество участников аудитории в другой стране. Значение по умолчанию — false.

lookalike_spec.starting_ratio

Тип: число с плавающей запятой

Необязательный параметр.

Начальное процентное значение для создания похожей аудитории. Например, для параметров starting_ratio=0,01 и ratio=0,02 в похожую аудиторию будут включены 1–2 % похожих пользователей. Значение starting_ratio всегда должно быть меньше ratio.

lookalike_spec.ratio

Тип: число с плавающей запятой

Обязательный параметр.

Значение в диапазоне от 0,01 до 0,20. Доля похожих пользователей в стране, которых нужно включить в похожую аудиторию.

Таргетинг

Таргетинг похожей аудитории настраивается аналогично таргетингу пользовательской аудитории. См. статью Таргетинг: пользовательские аудитории. Это также относится к таргетингу с исключением и объединением (AND). Настройка таргетинга при создании аудитории:

use FacebookAds\Object\AdSet;
use FacebookAds\Object\Fields\AdSetFields;
use FacebookAds\Object\Values\AdSetBillingEventValues;
use FacebookAds\Object\Values\AdSetOptimizationGoalValues;
use FacebookAds\Object\Fields\TargetingFields;
use FacebookAds\Object\Targeting;

$adset = new AdSet(null, 'act_<AD_ACCOUNT_ID>');
$adset->setData(array(
  AdSetFields::NAME => 'My AdSet',
  AdSetFields::OPTIMIZATION_GOAL => AdSetOptimizationGoalValues::REACH,
  AdSetFields::BILLING_EVENT => AdSetBillingEventValues::IMPRESSIONS,
  AdSetFields::BID_AMOUNT => 2,
  AdSetFields::DAILY_BUDGET => 1000,
  AdSetFields::CAMPAIGN_ID => <CAMPAIGN_ID>,
  AdSetFields::TARGETING => (new Targeting())->setData(array(
    TargetingFields::GEO_LOCATIONS => array(
      'countries' => array('US'),
    ),
    TargetingFields::CUSTOM_AUDIENCES => array(
      array(
        'id' => <LOOKALIKE_AUDIENCE_ID>,
      ),
    ),
  )),
));

$adset->create(array(
  AdSet::STATUS_PARAM_NAME => AdSet::STATUS_ACTIVE,
));
from facebookads.adobjects.adset import AdSet

adset = AdSet(parent_id='act_<AD_ACCOUNT_ID>')
adset.update({
    AdSet.Field.name: 'My Adset',
    AdSet.Field.daily_budget: 10000,
    AdSet.Field.campaign_id: '<CAMPAIGN_ID>',
    AdSet.Field.optimization_goal: AdSet.OptimizationGoal.link_clicks,
    AdSet.Field.billing_event: AdSet.BillingEvent.link_clicks,
    AdSet.Field.bid_amount: 150,
    AdSet.Field.daily_budget: 2000,
    AdSet.Field.targeting: {
        'geo_locations': {
            'countries': ['US'],
        },
        'custom_audiences': [
            {
                'id': <LOOKALIKE_AUDIENCE_ID>,
            },
        ],
    },
})

adset.remote_create(params={
    'status': AdSet.Status.paused,
})
AdSet adSet = new AdAccount(act_<AD_ACCOUNT_ID>, context).createAdSet()
  .setName("My AdSet")
  .setOptimizationGoal(AdSet.EnumOptimizationGoal.VALUE_REACH)
  .setBillingEvent(AdSet.EnumBillingEvent.VALUE_IMPRESSIONS)
  .setBidAmount(2L)
  .setDailyBudget(1000L)
  .setCampaignId(<CAMPAIGN_ID>)
  .setTargeting(
    new Targeting()
      .setFieldCustomAudiences(Arrays.asList(
        new IDName()
          .setFieldId(<LOOKALIKE_AUDIENCE_ID>)
      ))
      .setFieldGeoLocations(
        new TargetingGeoLocation()
          .setFieldCountries(Arrays.asList("US"))
      )
  )
  .setStatus(AdSet.EnumStatus.VALUE_ACTIVE)
  .execute();
String ad_set_id = adSet.getId();
curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ 
    "custom_audiences": [{"id":"<LOOKALIKE_AUDIENCE_ID>"}], 
    "geo_locations": {"countries":["US"]} 
  }' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/adsets

Дополнительные примеры можно найти в статье, посвященной параметрам таргетинга.

Управление аудиториями

Вы можете получить подробные сведения о пользовательских аудиториях, взятых за основу при создании похожих аудиторий, а также о самих похожих аудиториях. Мы возвращаем те же поля, что и для пользовательских аудиторий. Ниже приведен пример ответа для пользовательской аудитории, взятой за основу для создания похожих аудиторий. Параметр lookalike_audience_ids обозначает похожие аудитории, созданные на основе этой.

 {
  "id": "6006164557194",
  "account_id": 12345,
  "approximate_count": 816400,
  "lookalike_audience_ids": [
    6006183285954,
    6006183285955
  ],
  "name": "Boys Apparel",
  "parent_audience_id": 0,
  "parent_category": "Custom",
  "status": "ready",
  "subtype": "CUSTOM",
  "type": 4,
  "type_name": "Advertiser Generated",
  "time_updated": 1362439491
}, 

Значение subtype у похожих аудиторий равно 2. Мы также возвращаем параметр lookalike_spec в следующем формате:

Имя Описание

type

Тип: строка

similarity, reach или custom_ratio (возвращается всегда).

starting_ratio

Тип: число с плавающей запятой

Возвращается, если указан параметр starting_ratio.

ratio

Тип: число с плавающей запятой

Значение, кратное 0.01. Возвращается, если для параметра type задано значение custom_ratio.

country

Тип: строка

Код страны.

origin

Тип: массив

См. описание ниже.

origin.deleted

Тип: логическое значение

true — возвращается, если оригинал удален.

origin.id

Тип: целое число

ID оригинала.

origin.name

Тип: строка

Имя оригинала

origin.type

Тип: строка

custom_audience или page.

target_countries

Тип: массив строк

Все страны, используемые при создании аудитории.

Вот пример аудитории, где для параметра subtype задано значение LOOKALIKE:

{
 "id": "6006183285954",
 "account_id": 12345,
 "approximate_count": 1782100,
 "name": "Boys Apparel_lookalike_US_Similarity",
 "origin_audience_id": 6006567610735,
 "parent_audience_id": 0,
 "parent_category": "Custom",
 "status": "ready",
 "subtype": "LOOKALIKE",
 "type": 4,
 "type_name": "Advertiser Generated",
 "time_updated": 1362506552
},  

Статус готовности

После создания похожей аудитории мы возвращаем ID пользовательской аудитории. Заполнение аудитории может занять до одного часа. Получить ее статус можно с помощью конечной точки /{lookalike_audience_ID}?fields=delivery_status. Такой запрос возвращает объект JSON с полем delivery_status или код 200, если заполнение аудитории ещё идет:

"delivery_status": {
  "code": 200, 
  "description": "This audience is ready for use."
},

Во время тестирования проверяйте статус списка в Ads Manager.

Удалить похожую аудиторию можно так же, как и пользовательскую.

Неактивные аудитории

Похожая аудитория считается неактивной, если она не использовалась в активной рекламе в течение 90 дней. У неактивных похожих аудиторий другие значения approximate_count, operation_status и delivery_estimate.

ПолеОтличие для неактивной похожей аудитории

approximate_count

Получить значение размера невозможно. Вызов этого поля для неактивной похожей аудитории возвращает значение -1.

operation_status

450: эта похожая аудитория неактивна. Ее можно использовать в рекламе, однако получить прогноз до публикации кампании невозможно.
100: если аудитория не использовалась в активных группах объявлений более двух лет, начинается отсчет срока ее действия. Если ее не использовать, она будет удалена через 90 дней с этого момента.

delivery_estimate

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

delete_time

Если аудитория помечена как аудитория с истекающим сроком действия с помощью параметра operation_status (код 100), в поле delete_time указано время (в формате Unix), когда она будет удалена.

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

Удаление

Начиная с 8 июня 2021 г. всем аудиториям рекламодателей, не использовавшимся более двух лет, автоматически присваивается статус аудитории с истекающим сроком действия. Это означает, что аудитории, которые не использовались в активных группах объявлений более двух лет, автоматически переводятся в указанное состояние, а в поле delete_time заносится запланированное время удаления аудитории (90 дней с момента смены статуса).

После этого вы сможете самостоятельно удалить аудиторию или использовать ее в активной группе объявлений, чтобы предотвратить удаление. Чтобы посмотреть аудитории, для которых истекает срок действия, отфильтруйте их по полю operation_status или delete_time.

Дополнительные сведения см. в документации с обзором пользовательских аудиторий.

Рекомендации

  • Исходная пользовательская аудитория: чем она больше, тем проще нам найти достаточно данных для подбора похожих пользователей.
  • Объединение похожих аудиторий: похожие аудитории можно объединять с другими объектами таргетинга Facebook для расширения охвата по демографическим параметрам или интересам.
  • Если у исходной аудитории есть такие атрибуты, как пол или география, создаваемые на ее основе похожие аудитории могут их не использовать.

Предстоящие изменения похожих аудиторий

ОБНОВЛЕНИЕ ОТ 28 АПРЕЛЯ 2021 Г. Удаление параметров location_spec и country для похожих аудиторий отложено. О том, когда эти параметры будут удалены, мы сообщим позднее.

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

Это изменение не затронет уже существующие кампании. Оно распространяется только на новые и измененные кампании.

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

Изменения в создании похожих аудиторий

Изменения параметров местоположения

Конечная точка:act_{AD_ACCOUNT_ID}/customaudiences

Пример запроса

curl POST \
  -F 'name=My lookalike audience' \
  -F 'subtype=LOOKALIKE' \
  -F 'origin_audience_id=<SEED_AUDIENCE_ID>' \
  -F ‘lookalike_spec={
  "is_financial_service":false,
  "allow_international_seeds":true,
  "ratio":0.01,
  "type":"custom_ratio"}
  	’}\
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/customaudiences

Следующие параметры, переданные при создании аудитории, будут игнорироваться:

  • lookalike_spec.country
  • lookalike_spec.location_spec
  • lookalike_spec.location_spec.geo_locations
  • lookalike_spec.location_spec.geo_locations.countries
  • lookalike_spec.location_spec.geo_locations.country_groups
  • lookalike_spec.location_spec.excluded_geo_locations
  • lookalike_spec.location_spec.excluded_geo_locations.countries
  • lookalike_spec.location_spec.excluded_geo_locations.country_groups

Изменения параметров размера

Конечная точка:act_{AD_ACCOUNT_ID}?fields=approximate_count

Для новых похожих аудиторий нельзя задавать размер. Поле approximate_count будет возвращать значение -1 для всех похожих аудиторий.

Пример ответа

{
    "approximate_count": -1,
    "id": "6126486105659",
}

Статус готовности и работы

Конечные точки:

  • {AD_ACCOUNT_ID}?fields=delivery_status
  • {AD_ACCOUNT_ID}?fields=operation_status

Поле delivery_status для старых похожих аудиторий с параметрами местоположения будет возвращать код ошибки 400 с описанием This audience is disabled. (Эта аудитория отключена). Для новых аудиторий будет возвращаться код 200.

Поле operation_status возвращает уведомление об отключении аудитории, если это старая похожая аудитория с параметрами местоположения. Для новых аудиторий будет возвращаться код 200 с описанием Normal.

Подробнее об этих полях см. в руководстве по пользовательским аудиториям.

Изменения для групп объявлений

Создание и редактирование рекламы

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

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

Перечисленные выше изменения также действуют, если аудитории указаны в параметрах excluded_custom_audiences, flexible_spec и exclusions кампании.

Конечная точка:act_{AD_ACCOUNT_ID}/adsets

Пример запроса

curl POST \
  -F 'targeting={
        "geo_locations":{
            "countries":["US"],
        },
        "age_min":25,
        "age_max":40,
        "custom_audiences":[{"id": <CUSTOM_AUDIENCE_ID>}]
  ‘}\
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/adsets

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

{
  "error": {
    "message": "Invalid parameter",
    "type": "FacebookApiException",
    "code": 100,
    "error_data": {
      "blame_field_specs": [["targeting" ] ]
    },
    "error_subcode": 192342134,
    "is_transient": false,
    "error_user_title": "Missing Location while using Lookalike",
    "error_user_msg": "You need to use a location with your lookalike    audience.",
    "fbtrace_id": "F78cCCJoZPx"
  },
  "__fb_trace_id__": "F78cCCJoZPx",
  "__www_request_id__": "AcwlIc7_uK5uTXjzjIa38yc"
}

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

{
  "error": {
    "message": "Invalid parameter",
    "type": "FacebookApiException",
    "code": 100,
    "error_data": {
      "blame_field_specs": [["targeting" ] ]
    },
    "error_subcode": 192342135,
    "is_transient": false,
    "error_user_title": "",
    "error_user_msg": "Please ask the owner of the audience 1234 to share the new lookalike which does not contain location with you. You will be able to use the new audience"
    "fbtrace_id": "F78cCCJoZPx"
  },
  "__fb_trace_id__": "F78cCCJoZPx",
  "__www_request_id__": "AcwlIc7_uK5uTXjzjIa38yc"
}

Общие похожие аудитории

В период внедрения изменений возможность делиться через API похожими аудиториями между рекламными аккаунтами, для которых уже действуют изменения и теми, для которых они ещё не действуют, недоступна. Вместо этого рекомендуется использовать Audience Manager. После 24 мая 2021 г. можно будет по-прежнему делиться новыми похожими аудиториями с помощью API. Подробную информацию см. в следующем документе для разработчиков.

Конечная точка:{AD_ACCOUNT_ID}/adaccounts?adaccounts={SHARED_TO_AD_ACCOUNT_ID}

Изменения в прогнозировании охвата и показов

Конечные точки:

  • act_{AD_ACCOUNT_ID}/reachestimate
  • act_{AD_ACCOUNT_ID}/delivery_estimate

Эти конечные точки будут возвращать новый параметр targeting_status с одним из следующих описаний:

  • lookalike_container_without_country — в настройках таргетинга кампании для новой похожей аудитории не указана страна. Страну необходимо указать для прогнозирования количества пользователей.
  • lookalike_container_without_delivery_lookalike — у новой похожей аудитории нет соответствующей аудитории на стороне сервера. Чтобы у новой аудитории был охват, ее необходимо использовать в группе объявлений.
  • none — проблем с прогнозированием охвата нет.

Конечная точка reachestimate будет возвращать значение -1 для параметра users при первом использовании новой похожей аудитории и страны таргетинга. После этого она будет возвращать прогнозируемое количество пользователей.

При первом использовании новой похожей аудитории и страны таргетинга параметры estimate_dau и estimate_mau будут возвращать значение -1 для параметра users. После этого они будут возвращать прогнозируемое количество пользователей.

Примеры ответов

// Reach estimate response
{
    "users": -1,
    "estimate_ready": true,
    "targeting_status": "lookalike_container_without_delivery_lookalike"
}

// Delivery estimate response

{
    "data": [{
        "daily_outcomes_curve": [{
            "spend": 0,
            "reach": 0,
            "impressions": 0,
            "actions": 0
        }],
        "estimate_dau": -1,
        "estimate_mau": -1,
        "estimate_ready": true ,
        "targeting_status": "lookalike_container_without_delivery_lookalike"
    }]
}

Часто задаваемые вопросы

Изменения вступят в силу в день выпуска API Marketing версии 11. Изменения будут действовать для всех версий.

В период перехода от API Marketing версии 10 к версии 11 возможность делиться через API похожими аудиториями между рекламными аккаунтами, для которых уже действуют изменения и теми, для которых они ещё не действуют, не поддерживается. Вместо этого рекомендуется использовать Audience Manager. После выпуска API Marketing версии 11 можно будет снова делиться новыми похожими аудиториями с другими рекламными аккаунтами с помощью API.