Коэффициенты ставок

ПРИМЕЧАНИЕ. Этот API могут использовать только партнеры и рекламодатели, внесенные в список разрешенных. Чтобы получить эту возможность, обратитесь к своему представителю в Meta.

Применяя коэффициенты ставок, рекламодатели могут использовать многоуровневую стратегию ставок в одной группе объявлений с одной целевой аудиторией, что позволяет снизить необходимую степень сегментации аудитории. Обычно рекламодатели создают группы объявлений, чтобы настроить разные ставки для отдельных сегментов аудитории. Например, можно создать три группы объявлений, каждая из которых соответствует одной возрастной группе: 18–25, 26–35 и 36–65. Рекламодатель может создать одну группу объявлений, а затем настроить коэффициенты ставок для каждой группы пользователей.

Рекомендации по настройке коэффициентов ставок

• Настраивайте стратегии назначения ставок, чтобы не создавать слишком много сегментов аудитории или групп объявлений. Это поможет обеспечить больше показов без излишней сегментации кампании на множество групп объявлений с относительно небольшими аудиториями.
• Раньше можно было создать три группы объявлений, каждая из которых соответствовала одной возрастной группе, и настроить отдельные ставки для каждой из них. Теперь можно создать одну группу объявлений и изменять ставки для каждой возрастной группы с помощью коэффициентов в диапазоне от 0,09 до 1,00.
• Коэффициенты ставок нужно указывать в одном ключе user_groups.
• Коэффициенты ставок доступны для кампаний с аукционами.
• Коэффициенты ставок можно использовать при всех стратегиях назначения ставок (в частности, таких, как предельная ставка, предельная цена и минимальная цена).

Настройка категорий аудиторий

Вы можете определять категории аудиторий и назначать каждой из них коэффициент ставки. Категории аудиторий определяются на основании демографических данных, сведений об устройствах, а также данных, заданных рекламодателем. Кампании, рекламирующие недвижимость, трудоустройство или услуги кредитования, не могут назначать ставки для следующих категорий аудиторий: age, gender, locale, home_location, user_bucket и похожие аудитории custom_audience (пользовательские аудитории на основе похожих аудиторий).

age

Пользователи распределяются по возрастным группам (например, 18-25 и 26-35). Предположим, что предельная ставка для группы объявлений — 5 долларов США. Тогда для пользователей от 18 до 25 лет ставка может составлять 2,5 доллара США, для людей от 26 до 40 лет — 3,5 доллара США, для остальных — 5 долларов США. Примечание. Значение по умолчанию необязательно. В качестве коэффициента можно использовать значение 1.0.

Пример

{
    "user_groups": {
      "age": {
        "18-25": 0.5,
        "26-40": 0.7,
        "default": 1.0
      }
    }
}

booking_window

Допустимые значения разбивки: любой диапазон целых чисел не меньше 1. Например: 1-3, 4-9 и т. д.

Пример

curl -X POST \ 
  -F 'bid_adjustments=
     {"user_groups":{"booking_window":{"event_sources":["123456789"],"1-2":0.1,"3-5":0.2,"default":0.5}}}' \ 
  -F 'access_token='$access_token \ 
  https://graph.facebook.com/<API_VERSION>/<ad_set_id>

См. также пример использования коэффициентов для путешествий.

custom_audience

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

Пример

curl -X POST \ 
  -F 'bid_adjustments=
     {"user_groups":{"custom_audience":{"<CUSTOM_AUDIENCE_ID>":0.8, "<CUSTOM_AUDIENCE_ID>":1.0, "default":0.5}}}' \ 
  -F 'access_token='$access_token \ 
  https://graph.facebook.com/<API_VERSION>/<ad_set_id>

device_platform

Допустимые значения разбивки:

• mobile
• desktop

Пример

{
  "user_groups": {
    "device_platform": {
      "mobile": 0.7,
      "desktop": 0.9
    }
  }
}

gender

Группировка пользователей по полу:

• male
• female
• default

Пример

{
  "user_groups": {
    "gender": {
      "male": 0.5,
      "female": 0.7,
      "default": 1.0
    }
  }
}

home_location

Допустимые значения разбивки:

• city id
• region id
• двузначный код страны.

Найти city id и region id можно с помощью Search API. Запрос можно выполнить через Graph API Explorer или через терминал.

Примечание: Значение default можно установить только под home_location, а не cities, regions, или countries.

Пример

{
  "user_groups": {
    "home_location": {
      "cities": {
         "2420605": 0.2
      },
      "regions": {
         "3847": 0.5
      },
      "countries": {
         "US": 0.2
      },
      "default": 0.8
     }
  }
}

length_of_stay

Допустимые значения разбивки: любой диапазон целых чисел не меньше 1. Например: “1-3”, “4-9” и т. д.

Пример

curl -X POST \ 
  -F 'bid_adjustments=
  {"user_groups":{"length_of_stay":{"event_sources":["123456789"],"1-2":0.1,"3-     5":0.2,"default":0.5}}}' \ 
  -F 'access_token='$access_token \ 
  https://graph.facebook.com/<API_VERSION>/<ad_set_id>

См. также пример использования коэффициентов для путешествий.

locale

Можно использовать ID локали или группы локалей (например, 6 для американского английского или 5 для немецкого).

ID локали можно найти с помощью поиска локали для таргетинга, указав type=adlocale. Пример:

{
  "user_groups": {
    "locale": {
      6: 0.8,
      5: 0.3
    }
  }
}

position_type

Эта категория аналогична позициям в API Targeting. Допустимые значения разбивки:

Пример

{
  "user_groups": {
    "position_type":{
        "facebook_feed":0.9,
        "messenger_messenger_home":0.7,
        "instagram_stream":0.8,
        "audience_network_classic":0.5,
        "default":0.4
    }
  }
}

publisher_platform

Допустимые значения разбивки:

• facebook
• instagram
• audience_network
• messenger

Пример

{
  "user_groups": {
    "publisher_platform": {
      "facebook": 0.7,
      "instagram": 0.9,
      "default": 1.0 // We'll apply bid multiplier 1.0 if no default is specified anyway
    }
  }
}

travel_start_date

Допустимые значения разбивки: любой диапазон дат в формате _yyyymmdd_-_yyyymmdd_.

Пример

curl -X POST \ 
  -F 'bid_adjustments=
     {"user_groups":{"travel_start_date":{"event_sources":["123456789"],"20180901-20181001":0.2,"default":0.9}}}' \ 
  -F 'access_token='$access_token \ 
  https://graph.facebook.com/<API_VERSION>/<ad_set_id>

См. также пример использования коэффициентов для путешествий.

travel_start_day_of_week

Допустимые значения разбивки: целые числа от 0 до 6 включительно (0 — понедельник, 6 — воскресенье).

Пример

curl -X POST \ 
  -F 'bid_adjustments=
  {"user_groups":{"travel_start_day_of_week":{"event_sources":        ["123456789"],"0":0.1,"2":0.2,"6":0.3,"default":0.9}}}' \ 
  -F 'access_token='$access_token \ 
  https://graph.facebook.com/<API_VERSION>/<ad_set_id>

См. также пример использования коэффициентов для путешествий.

user_bucket

Вы можете отправить нам результаты работы собственного классификатора пользователей. Затем отправляйте дополнительный параметр user_bucket при инициализации пикселя или наступлении событий в приложении. Значением может быть целое число от 0 до 100.

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

• event_sources — источник для отслеживания (инициализация пикселя или событие в приложении);
• event_retention (необязательный) — время в секундах, в течение которого нужно игнорировать предыдущие значения user_bucket;
• events_dedup_mode (необязательный) — флаг, определяющий, какое значение user_bucket нужно использовать, если один источник событий отправляет разные значения user_bucket для одного и того же пользователя (значение по умолчанию — latest);
• event_source_preference (необязательный) — флаг, определяющий, какое значение user_bucket нужно использовать, если несколько источников событий отправляют разные значения user_bucket для одного и того же пользователя (значение по умолчанию — latest).

Пример

{
  "user_groups": {
   "user_bucket": {
      "event_sources": [<pixel_id>,<app_id>,...],
      "event_retention": 604800, // optional, exclude old events
      
      //optional, useful when multiple event sources have user_bucket
      "events_dedup_mode": "max"|"min"|"latest",
      
      //optional, dedup user_bucket values sent from one single event source
      "event_source_preference": "max"|"min"|"latest",
      
      "1":0.7, // these are the bid multipliers
      "2":1.0,
     }
  }
}

user_device

Допустимые значения разбивки:

• iPad
• iPhone

Другие допустимые значения можно получить с помощью Targeting Search API (параметры type=adTargetingCategory и class=user_device).

Пример

{
  "user_groups": {
    "user_device": {
      "iPad": 0.7,
      "iPhone": 0.9,
      "default": 1.0
    }
  }
}

Пример

curl
  -F 'name=Test BM Adset '$(date +%s) \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=OFFSITE_CONVERSIONS' \
  -F 'daily_budget=15000' \
  -F 'campaign_id=23843038336220329' \
  -F 'promoted_object={"product_set_id":"267888283975766"}' \
  -F 'targeting={
     "geo_locations": {"countries":["AQ"]},
     "dynamic_audience_ids": ["23842885952670329"],
     "publisher_platforms": ["facebook"]
    }' \
  -F 'bid_adjustments={"user_groups":{"user_device": {"iPad": 0.7, "iPhone": 0.9, "default": 1.0}}}' \
  -F 'status=PAUSED' \
  -F 'access_token='$access_token \
  https://graph.facebook.com/<API_VERSION>/act_1653439931385336/adsets

Пример

curl
  -F 'name=Test BM Adset '$(date +%s) \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=OFFSITE_CONVERSIONS' \
  -F 'daily_budget=15000' \
  -F 'campaign_id=23843038336220329' \
  -F 'promoted_object={"product_set_id":"267888283975766"}' \
  -F 'targeting={
     "geo_locations": {"countries":["AQ"]},
     "dynamic_audience_ids": ["23842885952670329"],
     "publisher_platforms": ["facebook"]
     }' \
  -F 'bid_adjustments={"user_groups":{"user_device": {"iPad": 0.7, "iPhone": 0.9, "default": 1.0}}}' \
  -F 'status=PAUSED' \
  -F 'access_token='$access_token \
   https://graph.facebook.com/<API_VERSION>/act_1653439931385336/adsets
   {"id":"23843038339320329"}

Пример

curl
  -F 'access_token='$access_token \
  https://graph.facebook.com/VERSION/ID?fields=bid_adjustments
  {"bid_adjustments":{"user_groups":"{\"user_device\":    {\"default\":1,\"iPad\":0.7,\"iPhone\":0.9}}"},"id":"ID"}

См. также расширенный пример.

user_group_weight_spec

Допустимые значения разбивки:

• age
• gender
• device_platform
• publisher_platform
• user_device
• user_os

См. также дополнительный пример.

Пример. Параметр user_group_weight_spec представляет собой структуру JSON, которая выглядит следующим образом:

{
  <BREAKDOWN_NAME>: {
    <BREAKDOWN_VALUE_1>: <WEIGHT_VALUE> OR <NESTED_USER_GROUP_WEIGHT_SPEC>,
    <BREAKDOWN_VALUE_2>: <WEIGHT_VALUE> OR <NESTED_USER_GROUP_WEIGHT_SPEC>,
    <BREAKDOWN_VALUE_3>: <WEIGHT_VALUE> OR <NESTED_USER_GROUP_WEIGHT_SPEC>,
    ...
    "default": <WEIGHT_VALUE> OR <NESTED_USER_GROUP_WEIGHT_SPEC>, // optional, if not specified, we'll use 1.0
  }
}
{
  "age": {
    "18-25": 0.7,
    "26-35": {
      "gender": {
        "male": 0.9,
        "female": 1.0
      }
    },
    "default": 0.85
  }
}

* For users between the ages of 18 and 25, we apply bid multiplier 0.7.
* For male users between the ages of 26 and 35, we apply bid multiplier 0.9.
* For female users between the ages of 26 and 35, we apply bid multiplier 1.0.
* For all other users, we apply bid multiplier 0.85.

Значения разбивки — это возрастные группы, выраженные целыми числами. Например: 18–25, где минимальный возраст — 18 лет. Возрастные группы не должны пересекаться.

Пример

{
  "user_groups": {
    "age": {
      "18-25": 0.7,
      "30-40": 1.0,
      "default": 0.3
    }
  }
}

Дополнительный пример

> curl 
    -F 'bid_adjustments={"user_groups":{"user_device":{"iPad":0.3,"iPhone":{"user_os":{"Android":0.3,"iOS":{"age":{"18-35":0.3,"35-45":0.4}}}}}}}' -F access_token=$token https://graph.intern.facebook.com/v2.12/6089875504114
{"success":true}%
> curl -G 
   -d access_token=$token https://graph.intern.facebook.com/v2.12/6089875504114\?  fields\=bid_adjustments
{"bid_adjustments":{"user_groups":"{\"user_device\":{\"iPad\":0.3,\"iPhone\":{\"user_os\":{\"Android\":0.3,\"iOS\":{\"age\":{\"18-35\":0.3,\"35-45\":0.4}}}}}}"},"id":"6089875504114"}%

Примеры использования коэффициентов для путешествий

curl -X POST \
  -F 'bid_adjustments={"user_groups":{"travel_start_day_of_week":{"event_sources":["1862565504034757"],"1":0.1,"3":0.1,"default":0.9}}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<ADSET_ID>

  Length of Stay 'bid_adjustments={"user_groups":{"length_of_stay":{"event_sources":["1862565504034757"],"1-2":0.1,"3-7":0.2,"default":0.5}}}'
  Booking window 'bid_adjustments={"user_groups":{"booking_window":{"event_sources":["1862565504034757"],"1-2":0.1,"3-7":0.2,"default":0.5}}}'
  Travel start date: 'bid_adjustments={"user_groups":{"travel_start_date":{"event_sources":["1862565504034757"],"20180918-20190101":0.1,"default":0.5}}}'
  Day of week: 'bid_adjustments={"user_groups":{"travel_start_day_of_week":{"event_sources":["1862565504034757"],"1":0.1,"2":0.1,"0":0.2,"default":0.5}}}'

user_os

Допустимые значения разбивки:

• iOS
• Windows

Другие допустимые значения можно получить с помощью Targeting Search API (параметры type=adTargetingCategory и class=user_os).

Поддерживаемые значения:

• Android
• Windows
• Windows Phone
• iOS

Пример

{
  "user_groups": {
    "user_os": {
      "Android": 0.7,
      "iOS": 0.9,
      "default": 1.0
    }
  }
}

user_recency

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

Пример

В этом примере показано, как применить коэффициент ставки 1.0 для пользователей, инициировавших пиксель или событие в приложении в течение 86400 секунд, и т. д.

{
  "user_groups": {
    "user_recency": {
      "event_sources": [<pixel_id>,<app_id>,...],
      "0-86400": 1.0,
      "86401-172800": 0.7,
      "default": 0.5
    }
  }
}

Последовательные разбивки

Группы пользователей также можно определить с помощью нескольких последовательных разбивок. В этом случае вместо плавающего значения коэффициента ставки задается спецификация дальнейшей разбивки. Рассмотрите пример группы объявлений с предельной ставкой 5 долларов США и следующими настройками:

• ставка 4,5 доллара США для мужчин;
• ставка 3,5 доллара США для женщин в возрасте от 18 до 25 лет;
• ставка 4,0 доллара США для женщин в возрасте от 26 до 35 лет;
• ставка 5,0 долларов США для всех остальных пользователей.

{
  "user_groups": {
    "gender": {
      "male": 0.9,
      "female": {
        "age": {
          "18-25": 0.7,
          "26-35": 0.8
        }
      }
    }
  }
}

Требования для применения

• Коэффициент ставки может иметь значение от 0.09 до 1.0.

Вызовы API

Получение

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<ADSET_ID>?fields=bid_adjustments

Обновление

curl \
  -F 'bid_adjustments={"user_groups":<USER_GROUP_WEIGHT_SPEC>}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<PRODUCT_CATALOG_ID>/<ADSET_ID>

Создание или обновление коэффициента ставки для группы объявлений

Ниже приведен пример вызова API для обновления существующей группы объявлений. (Вам нужно будет подставить свои значения для ID группы объявлений, маркера доступа, источников событий и коэффициентов ставки.)

curl -X POST \
  -F 'bid_adjustments={
       "user_groups": {
         "user_bucket": {
           "event_sources": [
             "<PIXEL_ID>",
             "<APP_ID>"
           ],
           "1": 0.1,
           "2": 0.2,
           "3": 0.3,
           "default": {
             "gender": {
               "male": 0.99,
               "female": 0.12
             }
           }
         }
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<AD_SET_ID>/

Настройка тестовой кампании

Вместе со своей командой, ответственной за ведение аккаунта Meta, и специалистом по измерениям создайте тестовые кампании, чтобы протестировать прирост конверсий или провести сплит-тест. Для оценки результативности рекомендуем использовать тройной сплит-тест со следующими элементами:

• Элемент 1 (контрольная группа А), кампания 1 — одна группа объявлений с одной ставкой для всех таргетированных пользователей.
• Элемент 2 (контрольная группа Б), кампания 2 — несколько групп объявлений, каждая из которых предназначена для одной группы пользователей. Сегментировать аудиторию по параметрам пикселя или приложения можно с помощью правил, определяющих пользовательские аудитории сайта или мобильного приложения.
• Элемент 3 (тестовая группа), кампания 3 — одна группа объявлений с разными коэффициентами ставки для разных групп пользователей. Скорректированная ставка для каждой группы пользователей обязательно должна совпадать со ставкой на уровне группы объявлений для соответствующей группы в элементе 2.

Настройка сплит-тестов

Теперь следует настроить сплит-тесты и контрольные группы для оценки результативности рекламы с применением коэффициентов ставки. Тесты проводятся в течение 1–2 недель, и для них не требуется минимальный бюджет. Настройте сплит-тестирование, как описано ниже.

• Элемент 1, контрольная группа А содержит одну группу объявлений с одной ставкой. Таргетинг выполняется на основании всех значений user_bucket.
• Элемент 2, контрольная группа Б содержит несколько групп объявлений, по одной для каждого значения user_bucket. Для каждой группы объявлений необходимо задать таргетинг по отдельному значению user_bucket и соответствующую ставку. Для дальнейшей сегментации аудитории на основании других параметров пикселя Meta или событий в приложении можно использовать правила, определяющие пользовательские аудитории сайта или мобильного приложения. См. статьи о пользовательских аудиториях с сайтов и из мобильных приложений.
• Элемент 3, тестовая группа содержит одну группу объявлений со свойством bid_adjustment, определяющим разные ставки для каждого значения user_bucket. Коэффициенты должны соответствовать индивидуальным ставкам для каждой группы объявлений в элементе 2, т. е. в контрольной группе Б.

Подробные сведения см. в статье Сплит-тестирование.

Настройка тестовой кампании

Настройте рекламную кампанию согласно обычной процедуре. Если вам потребуется помощь в настройке корректировки ставок, обратитесь к представителю Meta.

Настройте группы user_groups и установите разные коэффициенты ставки для каждой группы. Группы определяются на основании демографических (например, возраст или пол) и дополнительных данных (например, количество баллов или участие в программе лояльности). Пример:

{
   "user_bucket":{
      "business_id":253286871795863,
      "1":0.7,
      "2":1.0,
      "3":{
         "gender":{
            "male":1.0,
            "female":0.8
         }
      },
      "default": 0.9
   }
}

В этом примере:

• для пользователей со значением 1 для loyalty_program применяется коэффициент ставки 0,7;
• для пользователей со значением 2 для loyalty_program применяется коэффициент ставки 1,0;
• для мужчин со значением 3 для loyalty_program применяется коэффициент ставки 1,0;
• для женщин со значением 3 для loyalty_program применяется коэффициент ставки 0,8;
• для пользователей с другим значением loyalty_program применяется коэффициент ставки 0,9;
• для всех остальных пользователей применяется коэффициент ставки 1,0.

Теперь можно создать рекламную кампанию:

curl -X POST \
  -F 'name="My Adset with bid multiplier"' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'daily_budget=3000' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'optimization_goal="OFFSITE_CONVERSIONS"' \
  -F 'bid_amount=500' \
  -F 'bid_adjustments={
       "user_groups": {
         "gender": {
           "male": 0.8,
           "female": 1
         }
       }
     }' \
  -F 'promoted_object={
       "product_set_id": "<PRODUCT_SET_ID>",
       "custom_event_type": "ADD_TO_CART"
     }' \
  -F 'targeting={
       "facebook_positions": [
         "feed"
       ],
       "geo_locations": {
         "countries": [
           "US"
         ]
       }
     }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets

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

{
  "user_groups": {
    "user_bucket": {
      "event_sources": [<pixel_id>,<app_id>,...],
      "event_source_preference": "max"|"min"|"latest", //optional, useful when multiple event sources have user_bucket
      "events_dedup_mode": "max"|"min"|"latest", //optional, dedup user_bucket values sent from one single event source
      "event_retention": 604800, // optional, exclude old events
      "1":0.7, // these are the bid multipliers
      "2":1.0,
      "default": { // used in the case that we don't have user_bucket for that user
         gender:{ // this is a nested example, but you could just do "default": 1.0,
            "male": {
              home_location: {
                  cities: { // city id, can be found in search API, eg: search?type=adgeolocation&q=Menlo Park&limit=10
                    "2420605": 0.2,
                  },
                  regions: {
                    "3847": 0.5
                  },
                  countries: {
                    "US": 0.2
                  }
                }
              }
            },
            "female": {
              "user_recency": {
                "event_sources": [<pixel_id>,<app_id>,...],
                "0-86400": 0.5,
                "86400-172800": 0.7,
                "default": 0.2
              }
            }
         },
      },
   },
}

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

Для каждого источника событий используется последнее полученное значение user_bucket для конкретного пользователя. Однако если указано несколько источников событий (например, пиксель и приложение) и в двух и более из них зафиксированы разные значения user_bucket, то используется максимальное из них.

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

curl -X POST 
  -F access_token=<access_token> \
  -F 'bid_adjustments={"user_groups": {"user_bucket": {"event_sources": [<pixel_id>,  <app_id>,...], "1": 0.1, "2": 0.2, "3": 0.3, "default": {"gender": {"male": 0.99, "female": 0.1}} }} }' \ 
  https://graph.facebook.com/<VERSION>/<ad-set-id>