Базовый таргетинг

Базовый (основной) таргетинг ведется по следующим группам параметров:

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

Ограничения

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

Демографические данные и события

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

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

Таргетинг по демографическим данным:

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::RELATIONSHIP_STATUSES => array(2, 4),
    TargetingFields::LIFE_EVENTS => array(
      array(
        'id' => 6003054185372,
        'name' => 'Recently Moved',
      ),
    ),
    TargetingFields::INDUSTRIES => array(
      array(
        'id' => 6009003307783,
        'name' => 'Accounting and finance',
      ),
    ),
  )),
));
$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.optimization_goal: AdSet.OptimizationGoal.reach,
    AdSet.Field.billing_event: AdSet.BillingEvent.impressions,
    AdSet.Field.bid_amount: 150,
    AdSet.Field.daily_budget: 2000,
    AdSet.Field.campaign_id: <CAMPAIGN_ID>,
    AdSet.Field.targeting: {
        'geo_locations': {
            'countries': ['US'],
        },
        'relationship_statuses': [2, 4],
        'life_events': [
            {
                'id': 6003054185372,
                'name': 'Recently Moved',
            },
        ],
        'industries': [
            {
                'id': 6009003307783,
                'name': 'Accounting and finance',
            },
        ],
    },
})
adset.remote_create(params={
    'status': AdSet.Status.active,
})

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()
      .setFieldGeoLocations(
        new TargetingGeoLocation()
          .setFieldCountries(Arrays.asList("US"))
      )
      .setFieldIndustries(Arrays.asList(
        new IDName()
          .setFieldId("6009003307783")
          .setFieldName("Accounting and finance")
      ))
      .setFieldLifeEvents(Arrays.asList(
        new IDName()
          .setFieldId("6003054185372")
          .setFieldName("Recently Moved")
      ))
      .setFieldRelationshipStatuses(Arrays.asList(2L, 4L))
  )
  .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={ 
    "geo_locations": {"countries":["US"]}, 
    "industries": [{"id":6009003307783,"name":"Accounting and finance"}], 
    "life_events": [{"id":6003054185372,"name":"Recently Moved"}], 
    "relationship_statuses": [2,4] 
  }' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/adsets

Доступные поля

Имя	Описание
`genders` массив	Таргетинг по полу. `1` — мужской пол, `2` — женский. Значение по умолчанию — все пользователи.
`age_min` целое число	Минимальный возраст. Значение по умолчанию — 18. Если этот параметр используется, значение должно быть не меньше 13. Если в приложении настроены собственные возрастные ограничения, они будут применяться для объявлений с целями APP_INSTALL. Например, если для `age_min` задано значение 13, а минимальный возраст для приложения — 18, то для таргетинга рекламы будет использоваться значение 18.
`age_max` целое число	Максимальный возраст. Если этот параметр используется, значение должно быть не больше 65.

Местоположение

При поиске данных для этого типа таргетинга используйте Targeting Search API. В таргетинге по местоположению используются два параметра: geo_locations — целевые местоположения, excluded_geo_locations (необязательный) — исключенные регионы.

Используйте поле country_groups параметра geo_locations, чтобы настроить таргетинг по более крупным географическим регионам, таким как Европа или Северная Америка.

Using radius can cause an error, code: 100, subcode 1815946, when targeting multiple locations. We recommend creating an ad for each location or not using radius in your call.

Доступные поля

Имя	Описание
`countries` массив	Таргетинг по странам. Массив кодов стран (подробнее). Пример:`'countries': ['US']`.
`regions` массив	Область, провинция или регион. Доступные значения см. здесь. Ограничение: 200. Пример:`'regions': [{'key':'3847'}]`.
`cities` массив	Укажите `key`, `radius` и `distance_unit`. Подробнее об использовании `key` см. в этом разделе. `radius` — это расстояние (радиус) вокруг города. Допустимые значения: от 10 до 50 миль или от 17 до 80 км. `distance_unit` — единица измерения расстояния. Допустимые значения: миля, километр. Ограничение: 250. Пример:`'cities': [{'key':'2430536', 'radius':12, 'distance_unit':'mile'}]`.
`zips` массив	Почтовые индексы для таргетинга (см. статью Поиск для таргетинга). Ограничение: 50 000 (предыдущее ограничение — 2 500). Если указано больше 2 500 индексов, из них создается массив `location_cluster`. Пример: `'zips':[{'key':'US:94304'},{'key':'US:00501'}]`. Чтобы считать массив `location_cluster` и получить местоположения для таргетинга, используйте запрос `GET /location_cluster_ID`.
`places` массив	Укажите определенное место. Ограничение: 200. Пример:`"places":[{"key":129672430416115,"name":"SFO", "radius":10, "distance_unit":"mile"}]`.
`custom_locations` массив	Доступно для всех целей. Укажите точное место — широту и долготу или адрес центральной точки. Также задайте радиус зоны. Допустимые значения: от 0,63 до 50 миль или от 1 до 80 км. `distance_unit` — единица измерения расстояния. Допустимые значения: миля, километр (по умолчанию используются мили). Ограничение: 200. Возможность указать только абонентский ящик в `address_string` не поддерживается: необходимо задать как минимум точный адрес. Пример:`'custom_locations':[{'address_string': '1601 Willow Road, Menlo Park, CA', 'radius': 5},{'latitude': 36, 'longitude': -121.0, 'radius': 5, 'distance_unit': 'kilometer'},]`.
`custom_locations.latitude` число с плавающей запятой	Географическая широта места.
`custom_locations.longitude` число с плавающей запятой	Географическая долгота места.
`custom_locations.name` строка	Название точки, расположенной по этому адресу. Для таргетинга по местоположению можно использовать только значения `latitude` и `longitude` без указания `address_string`.
`custom_locations.radius` число с плавающей запятой	Радиус вокруг точки с указанной широтой и долготой (если не задано значение `distance_unit`, по умолчанию измеряется в милях). Допустимые значения: от 0,63 до 50 миль или от 1 до 80 км.
`custom_locations.distance_unit` строка	Необязательный параметр. Допустимые значения: `kilometer` или `mile`. По умолчанию используется `mile`.
`custom_locations.address_string` строка	Адрес, соответствующий указанным широте и долготе, например 1601 Willow Rd, Menlo Park, CA. Рекомендуемый формат: номер дома и название улицы, город, область (штат, провинция), страна. Почтовый индекс не указывается.
`geo_markets` массив	Код рынка в формате DMA:501. Поддерживаются все расчетные рыночные территории (Designated Marketing Area, DMA). Коды DMA можно определить путем поиска по названиям DMA. Ограничение: 2 500. Пример:`'geo_markets':[{'key': 'DMA:501', 'name': 'New York'},{'key': 'DMA:543', 'name': 'Springfield-Holyoke'},]`.
`electoral_district` массив	Код избирательного округа. Список округов см. здесь. Пример:`'electoral_districts':[{'key':'US:AK00'},{'key':'US:CA01'},{'key':'US:NY14'}]`.
`location_types` массив	Примечание. Начиная с версии 18.0 единственным возможным вариантом будет массив `['home', 'recent']`. Для версий старше 18.0, если параметр `location_types` не указан, по умолчанию будет использоваться массив `['home', 'recent']`. `recent` — люди, которые недавно были в выбранном месте (согласно данным с их мобильных устройств). Исключение местоположений не поддерживается. `home` — люди, у которых выбранное местоположение указано в профиле Facebook как город проживания. Facebook проверяет его по IP-адресу и информации о местоположении, указанной в профилях их друзей.
`country_groups` массив	Глобальные географические регионы и свободные экономические зоны. Задается в виде массива кодов групп стран. `worldwide` — весь мир. `africa` — Африка. `afta` — свободная экономическая зона АСЕАН. `android_app_store` — страны, поддерживающие платные приложения в магазине приложений для Android. `android_free_store` — страны, поддерживающие бесплатные приложения в магазине приложений для Android. `apec` — зона свободной торговли АТЭС. `asia` — Азия. `caribbean` — Карибский бассейн. `central_america` — Центральная Америка. `cisfta` — свободная экономическая зона Содружества Независимых Государств. `eea` — Европейская экономическая зона. `emerging_markets` — страны развивающихся рынков. `europe` — Европа. `gcc` — Совет сотрудничества арабских государств Персидского залива. `itunes_app_store` — страны, поддерживающие магазин приложений iTunes. `mercosur` — страны Меркосур. `nafta` — Североамериканская зона свободной торговли. `north_america` — Северная Америка. `oceania` — Океания. `south_america` — Южная Америка. Подробнее о группах стран см. здесь. Пример:`'country_groups': ['asia','mercosur']`.

Примеры

Таргетинг по странам


curl -X POST \
  -F 'name="My Reach Ad Set"' \
  -F 'optimization_goal="REACH"' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'targeting={
       "geo_locations": {
         "countries": [
           "US"
         ]
       },
       "facebook_positions": [
         "feed"
       ]
     }' \
  -F 'status="PAUSED"' \
  -F 'promoted_object={
       "page_id": "<PAGE_ID>"
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets

Open In Graph API Explorer Open In Postman


'use strict';
const bizSdk = require('facebook-nodejs-business-sdk');
const AdAccount = bizSdk.AdAccount;
const AdSet = bizSdk.AdSet;

const access_token = '<ACCESS_TOKEN>';
const app_secret = '<APP_SECRET>';
const app_id = '<APP_ID>';
const id = '<AD_ACCOUNT_ID>';
const api = bizSdk.FacebookAdsApi.init(access_token);
const showDebugingInfo = true; // Setting this to true shows more debugging info.
if (showDebugingInfo) {
  api.setDebug(true);
}

const logApiCallResult = (apiCallName, data) => {
  console.log(apiCallName);
  if (showDebugingInfo) {
    console.log('Data:' + JSON.stringify(data));
  }
};

let fields, params;
fields = [
];
params = {
  'name' : 'My Reach Ad Set',
  'optimization_goal' : 'REACH',
  'billing_event' : 'IMPRESSIONS',
  'bid_amount' : '2',
  'daily_budget' : '1000',
  'campaign_id' : '<adCampaignLinkClicksID>',
  'targeting' : {'geo_locations':{'countries':['US']},'facebook_positions':['feed']},
  'status' : 'PAUSED',
  'promoted_object' : {'page_id':'<pageID>'},
};
const adsets = (new AdAccount(id)).createAdSet(
  fields,
  params
);
logApiCallResult('adsets api call complete.', adsets);

Open In Graph API Explorer Open In Postman


require __DIR__ . '/vendor/autoload.php';

use FacebookAds\Object\AdAccount;
use FacebookAds\Object\AdSet;
use FacebookAds\Api;
use FacebookAds\Logger\CurlLogger;

$access_token = '<ACCESS_TOKEN>';
$app_secret = '<APP_SECRET>';
$app_id = '<APP_ID>';
$id = '<AD_ACCOUNT_ID>';

$api = Api::init($app_id, $app_secret, $access_token);
$api->setLogger(new CurlLogger());

$fields = array(
);
$params = array(
  'name' => 'My Reach Ad Set',
  'optimization_goal' => 'REACH',
  'billing_event' => 'IMPRESSIONS',
  'bid_amount' => '2',
  'daily_budget' => '1000',
  'campaign_id' => '<adCampaignLinkClicksID>',
  'targeting' => array('geo_locations' => array('countries' => array('US')),'facebook_positions' => array('feed')),
  'status' => 'PAUSED',
  'promoted_object' => array('page_id' => '<pageID>'),
);
echo json_encode((new AdAccount($id))->createAdSet(
  $fields,
  $params
)->exportAllData(), JSON_PRETTY_PRINT);

Open In Graph API Explorer Open In Postman

View on GitHub


from facebook_business.adobjects.adaccount import AdAccount
from facebook_business.adobjects.adset import AdSet
from facebook_business.api import FacebookAdsApi

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<AD_ACCOUNT_ID>'
FacebookAdsApi.init(access_token=access_token)

fields = [
]
params = {
  'name': 'My Reach Ad Set',
  'optimization_goal': 'REACH',
  'billing_event': 'IMPRESSIONS',
  'bid_amount': '2',
  'daily_budget': '1000',
  'campaign_id': '<adCampaignLinkClicksID>',
  'targeting': {'geo_locations':{'countries':['US']},'facebook_positions':['feed']},
  'status': 'PAUSED',
  'promoted_object': {'page_id':'<pageID>'},
}
print AdAccount(id).create_ad_set(
  fields=fields,
  params=params,
)

Open In Graph API Explorer Open In Postman

View on GitHub


import com.facebook.ads.sdk.*;
import java.io.File;
import java.util.Arrays;

public class SAMPLE_CODE_EXAMPLE {
  public static void main (String args[]) throws APIException {

    String access_token = \"<ACCESS_TOKEN>\";
    String app_secret = \"<APP_SECRET>\";
    String app_id = \"<APP_ID>\";
    String id = \"<AD_ACCOUNT_ID>\";
    APIContext context = new APIContext(access_token).enableDebug(true);

    new AdAccount(id, context).createAdSet()
      .setName(\"My Reach Ad Set\")
      .setOptimizationGoal(AdSet.EnumOptimizationGoal.VALUE_REACH)
      .setBillingEvent(AdSet.EnumBillingEvent.VALUE_IMPRESSIONS)
      .setBidAmount(2L)
      .setDailyBudget(1000L)
      .setCampaignId(\"<adCampaignLinkClicksID>\")
      .setTargeting(
          new Targeting()
            .setFieldFacebookPositions(Arrays.asList(\"feed\"))
            .setFieldGeoLocations(
              new TargetingGeoLocation()
                .setFieldCountries(Arrays.asList(\"US\"))
            )
        )
      .setStatus(AdSet.EnumStatus.VALUE_PAUSED)
      .setPromotedObject(\"{\\"page_id\\":\\"<pageID>\\"}\")
      .execute();

  }
}

Open In Graph API Explorer Open In Postman

View on GitHub


require 'facebook_ads'

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<AD_ACCOUNT_ID>'

FacebookAds.configure do |config|
  config.access_token = access_token
  config.app_secret = app_secret
end

ad_account = FacebookAds::AdAccount.get(id)
adsets = ad_account.adsets.create({
    name: 'My Reach Ad Set',
    optimization_goal: 'REACH',
    billing_event: 'IMPRESSIONS',
    bid_amount: '2',
    daily_budget: '1000',
    campaign_id: '<adCampaignLinkClicksID>',
    targeting: {'geo_locations':{'countries':['US']},'facebook_positions':['feed']},
    status: 'PAUSED',
    promoted_object: {'page_id':'<pageID>'},
})

Open In Graph API Explorer Open In Postman

View on GitHub

Таргетинг по местоположению с исключениями


curl -X POST \
  -F 'name="My Reach Ad Set"' \
  -F 'optimization_goal="REACH"' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'targeting={
       "excluded_geo_locations": {
         "regions": [
           {
             "key": "3847"
           }
         ]
       },
       "geo_locations": {
         "countries": [
           "US"
         ]
       },
       "facebook_positions": [
         "feed"
       ]
     }' \
  -F 'status="PAUSED"' \
  -F 'promoted_object={
       "page_id": "<PAGE_ID>"
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets

Имя	Описание
`min_population` целое число	Минимальная численность населения целевых городов.
`max_population` целое число	Максимальная численность населения целевых городов.

Базовый таргетинг

Ограничения

Демографические данные и события

Доступные поля

Местоположение

Доступные поля

Примеры

Таргетинг по странам

Таргетинг по местоположению с исключениями

Таргетинг по индексам

Таргетинг по пользовательским местоположениям, DMA и типам местоположений.

Поиск и таргетинг

Шаг 1

Шаг 2

Шаг 3

Шаг 4

Шаг 5

Таргетинг на несколько городов

Таргетинг по интересам

Доступные поля

Таргетинг по поведению

Доступные поля

Ресурсы