Исследование прироста

Создайте и проведите эксперимент для измерения эффективности своей кампании на Facebook. Выберите стратегию рекламы, которая позволяет добиться оптимального эффекта. Подробные сведения см. в справке по исследованию рекламы.

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

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

Подготовка исследований

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

Чтобы создать исследование, выполните следующий вызов POST:

'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

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

Пример: настройка исследования прироста с одной тестовой группой

curl \
  -F 'name="new study"' \
  -F 'description="description of my study"' \
  -F 'start_time=1435622400' \
  -F 'end_time=1436918400' \
  -F 'cooldown_start_time=1433116800' \
  -F 'observation_end_time=1438300800' \
  -F 'viewers=[<USER_ID1>, <USER_ID2>]' \
  -F 'type=LIFT' \
  -F 'cells=[{name:"test group",description:"description of my test group",treatment_percentage:90,control_percentage:10,adaccounts:[<ACCOUNT_ID1>,<ACCOUNT_ID2>]}]' \
  -F 'objectives=[{name:"new objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID>}]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

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

Создание тестовой группы

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

Пример: получение тестовых групп исследования

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>/cells'

Пример: обновление или изменение данных о группах, долей исследуемой и контрольной групп путем передачи ID группы в параметре cells

curl \
  -F 'cells=[{id:<CELL_ID>,treatment_percentage:80,control_percentage:20}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>'

Пример: получение всех созданных исследований в ad_studies для компании

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

Вы также можете посмотреть все исследования, связанные с вашим рекламным аккаунтом, с помощью запроса GET к {ad-account-ID/include_all_studies=true} с указанием маркера доступа.

Настройка нескольких тестовых групп

Вы можете подготовить исследование с несколькими тестовыми группами пользователей Facebook. Такой подход позволяет оценить дополнительный эффект от применения различных стратегий рекламы на Facebook (например, с использованием разных вариантов таргетинга) с точки зрения достижения бизнес-целей. Чтобы создать исследование с несколькими тестовыми группами, укажите их список в параметре cells.

curl \
  -F 'name="new study"' \
  -F 'description="description of my study"' \
  -F 'start_time=1435622400' \
  -F 'end_time=1436918400' \
  -F 'cooldown_start_time=1433116800' \
  -F 'observation_end_time=1438300800' \
  -F 'viewers=[<USER_ID1>, <USER_ID2>]' \
  -F 'type=LIFT' \
  -F 'cells=[{name:"group A",description:"description of group A",treatment_percentage:50,control_percentage:20,campaigns:[<CAMPAIGN_ID1>]},{name:"group B",description:"description of group B",treatment_percentage:20,control_percentage:10,campaigns:[<CAMPAIGN_ID2>]}]' \
  -F 'objectives=[{name:"new objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID>}]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

Параметр control_percentage определяет контрольную выборку для каждой тестовой группы относительно общего числа пользователей. Предположим, у вас есть исследование с двумя тестовыми группами: в группе А исследуемая группа составляет 50 %, а контрольная — 20 %, в группе Б доля исследуемой группы — 20 %, а контрольной — 10 %. Это означает, что контрольная группа в группе А составляет примерно 28,6 % (20 %/70 %), а в группе Б — примерно 33,3 % (10 %/30 %).

Как правило, сумма долей исследуемой и контрольной групп во всех тестовых группах должна составлять 100. Однако в некоторых случаях это число может быть и меньше 100. Пример — ситуация, когда у вас три тестовых группы одинакового размера, т. е. по 33 %.

Тестовые группы в исследовании можно обновлять, добавлять и удалять.

• Чтобы обновить существующую тестовую группу, используйте ее ID.
• Чтобы добавить новую тестовую группу, передайте новый объект тестовой группы.
• Чтобы удалить тестовую группу, просто не указывайте ее в параметре cells при обновлении исследования:

curl \
  -F 'cells=[{id:<CELL_ID1>,treatment_percentage:60,control_percentage:10},{name:"group C",description:"replacing group B",treatment_percentage:25,control_percentage:5,campaigns:[<CAMPAIGN_ID3>]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>'

Определение целей рекламы

Определите цели рекламы, для которых нужно проводить измерение, и решите, как вы будете передавать данные о конверсиях в Facebook. Для исследования прироста необходима хотя бы одна цель. Изменить цели после запуска исследования невозможно. Подробные сведения см. в справке по целям исследования рекламы.

Пример: создание цели CONVERSIONS и ее добавление в исследование

curl \
  -F 'name="new study"' \
  -F 'description="description of my study"' \
  -F 'start_time=1435622400' \
  -F 'end_time=1436918400' \
  -F 'cooldown_start_time=1433116800' \
  -F 'observation_end_time=1438300800' \
  -F 'viewers=[<USER_ID1>, <USER_ID2>]' \
  -F 'type=LIFT' \
  -F 'cells=[{name:"test group",description:"description of my test group",treatment_percentage:90,control_percentage:10,adaccounts:[<ACCOUNT_ID1>,<ACCOUNT_ID2>]}]' \
  -F 'objectives=[{name:"new objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID>}]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

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

Создание цели

Чтобы создать цель, передайте список объектов JSON objectives при создании нового исследования. Цели содержат указанные ниже данные.

Для одного исследования также можно указать несколько целей. Результаты обобщаются по заданным целям. Ниже приведен пример исследования с несколькими целями.

curl \
  -F 'name="another study"' \
  -F 'description="description of another study"' \
  -F 'start_time=1435622400' \
  -F 'end_time=1436918400' \
  -F 'cooldown_start_time=1433116800' \
  -F 'observation_end_time=1438300800' \
  -F 'viewers=[<USER_ID1>, <USER_ID2>]' \
  -F 'type=LIFT' \
  -F 'cells=[{name:"test group",description:"description of my test group",treatment_percentage:90,control_percentage:10,adaccounts:[<ACCOUNT_ID1>,<ACCOUNT_ID2>]}]' \
  -F 'objectives=[{name:"first objective objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID1>},{id:<APP_ID2>}]},{name:"scond  objective",type:"CONVERSIONS",applications:[{id:<APP_ID3>,event_names:["fb_mobile_purchase"]}],adspixels:[{id:<FB_PIXEL_ID>,event_names:["fb_pixel_purchase","fb_pixel_lead"]}]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

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

Пример: обновление источников измерений applications цели и удаление ее источников измерений adspixels

curl \
  -F 'objectives=[{id:<OBJECTIVE_ID>,name:"new objective name",applications:[{id:<APP_ID>}],adspixels:[]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>'

Пример: получение целей исследования

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'

Отчеты

Получение целей

Цели исследования определяются на этапе его настройки. Инструкции по определению целей исследования см. в руководстве по настройке.

Чтобы получить заданные для исследования цели, выполните вызов GET к его границе контекста objectives.

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'

Получение результатов

Чтобы извлечь результаты для цели, выполните вызов GET к узлу цели, указав results в параметре fields. По полю last_updated_results можно определить, когда результаты для этой цели обновлялись в последний раз.

Пример ответа в виде кода JSON, разобранного для простоты понимания:

Команда:

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'

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

С покупателями:

{
	"results": [
	"{"cell_id":"<cell_id>",
	"population_test":2334212,
	"population_control":123407,
	"population_reached":1862084,
	"impressions":19020874,
	"spend":26059,
	"buyers_control_raw_scaled":37672.615701199,
	"buyers_exposed":30085.482427228,
	"buyers_frequentist_pValue":0.00064950107027983,
	"conversions_control_raw_scaled":110918.27003534,
	"conversions_exposed":86961.044050743,
	"conversions_raw_pValue":0.12863848309723,
	"conversions_test":104412.89695396,
	"conversions_control_scaled":104575.81331581,
	"conversions_incremental":-162.91636184894,
	"conversions_notExposed":87123.960412592,
	"conversions_confidence":0.69291721817069,
	"conversions_multicell_confidence":null,
	"conversions_incremental_lower":-3470.6251396487,
	"conversions_incremental_upper":3235.0644420632,
	"conversions_multicell_rank":null,
	"conversions_incremental_share":-0.001873440730011,
	"conversions_CPiC":-159.95324044961,
	"buyers_test":40732.369934386,
	"buyers_control_scaled":41990.129061459,
	"buyers_incremental":-1257.7591270729,
	"buyers_notExposed":36617.935710157,
	"buyers_confidence":0.19318944031404,
	"buyers_multicell_confidence":null,
	"buyers_incremental_lower":-2905.5296282828,
	"buyers_incremental_upper":426.25813050358,
	"buyers_multicell_rank":null,
	"buyers_incremental_share":-0.041806181107957,
	"buyers_CPiB":-20.718593440578}"
	  ],
	  "id": "<objective_id>"
}

Без покупателей:

{
	"results": [
	"{"cell_id":"<cell_id>",
	"population_test":2334212,
	"population_control":123407,
	"population_reached":1862084,
	"impressions":19020874,
	"spend":26059,
	"conversions_control_raw_scaled":110918.27003534,
	"conversions_exposed":86961.044050743,
	"conversions_raw_pValue":0.12863848309723,
	"conversions_test":104412.89695396,
	"conversions_control_scaled":104575.81331581,
	"conversions_incremental":-162.91636184894,
	"conversions_notExposed":87123.960412592,
	"conversions_confidence":0.69291721817069,
	"conversions_multicell_confidence":null,
	"conversions_incremental_lower":-3470.6251396487,
	"conversions_incremental_upper":3235.0644420632,
	"conversions_multicell_rank":null,
	"conversions_incremental_share":-0.001873440730011,
	"conversions_CPiC":-159.95324044961}"
	  ],
	  "id": "<objective_id>"
}

Разбивка результатов

Помимо получения результатов по каждой цели, вы можете выполнить разбивку результатов с помощью параметра breakdowns.

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'

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

Результаты возвращают объекты JSON в массиве с учетом доступных разбивок. Например, если указан параметр cell_id, результаты разбиваются по количеству групп в исследовании. Можно задать одну или несколько разбивок. Однако для отображения результатов комбинация разбивок должна содержать по крайней мере 100 конверсий из тестовой и контрольной групп вместе.

{
  "id": "<STUDY_OBJECTIVE_ID>",
  "results": [
  {
    "cell_id": "<CELL_ID1>",
    ...
    Default fields where the values are specific to the <CELL_ID1> breakdown
    ...
  },
  {
    "cell_id": "<CELL_ID2>",
    ...
    Default fields where the values are specific to the <CELL_ID2> breakdown
    ...
  }],
}

Результаты для конкретной даты

Чтобы получить результаты для определенной даты, укажите ее в вызове API. Обратите внимание: результат будет совпадать с ответом, который вы получили бы, выполнив этот вызов в эту дату, не задавая поле даты. Дата должна быть не ранее 30 дней с текущего числа.

curl -G \
      -d 'access_token=<ACCESS_TOKEN>' \
      'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&ds=2020-03-01'