Вы можете включить в таргетинг пользователей, которые максимально схожи с вашей текущей клиентской аудиторией. При создании похожей аудитории 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 похожей аудитории. |
Вы можете создавать похожие аудитории на основе пользовательских аудиторий с числом участников не менее 100, включая пользовательские аудитории для сайта и мобильного приложения.
Имя | Описание |
---|---|
Тип: строка | Обязательный параметр. Название пользовательской аудитории. |
Тип: длинное целое | Обязательный параметр. ID пользовательской аудитории. Исходная аудитория должна включать в себя не менее 100 участников. |
Тип: массив | Обязательный параметр. См. описание ниже. |
Тип: строка | Обязательно. См.
|
Тип: число с плавающей запятой | Необязательный параметр. Начальное процентное значение для создания похожей аудитории. Например, для параметров |
Тип: число с плавающей запятой | Обязательный параметр. Задайте либо
|
Тип: логическое значение | Необязательный параметр. В каждой стране должно быть не менее 100 участников исходной аудитории. Если набрать это количество не удается и для параметра |
Тип: строка | Обязательный параметр. Значение: Поиск участников похожей аудитории в указанной стране. |
Тип: массив | Обязательный параметр. Поиск участников похожей аудитории в указанных местах. Список стран или групп стран, например |
Тип: массив | Обязательный параметр. Не менее одной записи Включение в аудиторию пользователей из указанных мест. |
Тип: массив строк | Необязательный параметр. Целевые страны. Список кодов стран (см. статью API Targeting Search: страны). Пример: |
Тип: массив строк | Необязательный параметр. Целевые страны в глобальных регионах и свободных торговых зонах. Массив с кодами групп стран. Полное описание возможных вариантов см. в статьях о таргетинге по местоположению ( |
Тип: массив | Необязательный параметр. Места, исключаемые из процесса создания похожей аудитории. |
Тип: массив строк | Необязательный параметр. То же самое, что и |
Тип: массив строк | Необязательный параметр. То же самое, что и |
Аудиторию можно оптимизировать для повышения похожести или увеличения охвата.
Вместо использования типов в параметре 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 постоянно обновляет взятую за основу модель прогнозирования по мере появления новых конверсий в соответствующих кампаниях и группах объявлений.
Имя | Описание |
---|---|
Тип: массив | Обязательный параметр. См. описание ниже. |
Тип: массив целых чисел | Обязательный параметр. Массив ID рекламных объектов. В качестве модели для создания похожей аудитории берутся пользователи, совершающие конверсию благодаря этой рекламе. Один или несколько ID кампаний или ID групп объявлений либо их сочетание. |
Тип: строка | Обязательный параметр.
|
Тип: строка | Обязательный параметр. Страна для подбора участников похожей аудитории. |
Тип: логическое значение | Необязательный параметр. В каждой стране должно быть не менее 100 участников исходной аудитории. Если набрать это количество не удается и для параметра |
Тип: число с плавающей запятой | Необязательный параметр. Начальное процентное значение для создания похожей аудитории. Например, для параметров |
Тип: число с плавающей запятой | Обязательный параметр. Значение в диапазоне от |
В настоящее время для создания похожих аудиторий можно использовать следующие типы конверсий из кампаний:
Похожую аудиторию можно создать на основе пользователей, которым нравится ваша Страница.
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
Имя | Описание |
---|---|
Тип: массив | Обязательный параметр. См. описание ниже. |
Тип: целое число | Обязательный параметр. ID Страницы Facebook, поклонники которой будут использоваться в качестве основы для создания похожей аудитории. |
Тип: строка | Обязательный параметр.
|
Тип: строка | Обязательный параметр. Страна, в которой будут подбираться пользователи для создания похожей аудитории. По умолчанию — США. |
Тип: логическое значение | Необязательный параметр. В каждой стране должно быть не менее 100 участников исходной аудитории. Если набрать это количество не удается и для параметра |
Тип: число с плавающей запятой | Необязательный параметр. Начальное процентное значение для создания похожей аудитории. Например, для параметров starting_ratio=0,01 и ratio=0,02 в похожую аудиторию будут включены 1–2 % похожих пользователей. Значение starting_ratio всегда должно быть меньше 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
в следующем формате:
Имя | Описание |
---|---|
Тип: строка |
|
Тип: число с плавающей запятой | Возвращается, если указан параметр |
Тип: число с плавающей запятой | Значение, кратное |
Тип: строка | Код страны. |
Тип: массив | См. описание ниже. |
Тип: логическое значение |
|
Тип: целое число | ID оригинала. |
Тип: строка | Имя оригинала |
Тип: строка |
|
Тип: массив строк | Все страны, используемые при создании аудитории. |
Вот пример аудитории, где для параметра 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
.
Поле | Отличие для неактивной похожей аудитории |
---|---|
| Получить значение размера невозможно. Вызов этого поля для неактивной похожей аудитории возвращает значение |
|
|
| Получить значение прогнозируемого показа невозможно. Вызов для этого поля для неактивной похожей аудитории возвращает значение |
| Если аудитория помечена как аудитория с истекающим сроком действия с помощью параметра |
Вы можете запустить кампанию с использованием неактивной похожей аудитории. Параметры прогнозируемого охвата станут доступны после публикации новой рекламы.
Начиная с 8 июня 2021 г. всем аудиториям рекламодателей, не использовавшимся более двух лет, автоматически присваивается статус аудитории с истекающим сроком действия. Это означает, что аудитории, которые не использовались в активных группах объявлений более двух лет, автоматически переводятся в указанное состояние, а в поле delete_time
заносится запланированное время удаления аудитории (90 дней с момента смены статуса).
После этого вы сможете самостоятельно удалить аудиторию или использовать ее в активной группе объявлений, чтобы предотвратить удаление. Чтобы посмотреть аудитории, для которых истекает срок действия, отфильтруйте их по полю operation_status
или delete_time
.
Дополнительные сведения см. в документации с обзором пользовательских аудиторий.
ОБНОВЛЕНИЕ ОТ 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.