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

Вы можете создавать аудитории из людей, которые взаимодействовали с вашим контентом на Facebook или в Instagram. В настоящее время поддерживаются аудитории для Страницы, бизнес-профиля Instagram, рекламы для лидов, объявлений Instant Experience, покупок и дополненной реальности.

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

С сентября 2018 года параметр subtype больше нельзя использовать для пользовательских аудиторий с сайтов и из приложений, а также для пользовательских аудиторий на основе вовлеченности и данных об офлайн-конверсиях. Единственное исключение — пользовательские аудитории на основе вовлеченности для видео: в них subtype ещё поддерживается.
Если вы создаете аудитории пользователей из Европы или добавляете таких пользователей в таргетинг, ознакомьтесь с нашими изменениями от 2 декабря 2020 года (без привязки к версии).

Создание аудитории

Чтобы создать пользовательскую аудиторию на основе вовлеченности, сначала нужно принять в Ads Manager соответствующее Пользовательское соглашение.

Вот как создать аудиторию из людей, которые взаимодействовали с вашей Страницей, на основе события page_engaged:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Параметры

Имя	Описание
`name` Строка	Обязательный параметр. Имя пользовательской аудитории.
`rule` Объект JSON	Обязательный параметр. Правило определения аудитории. Используется тот же синтаксис, что и для пользовательских аудиторий с сайтов.

Аудитории на основе вовлеченности — это разновидность пользовательских аудиторий. См. перечень доступных полей для таких аудиторий.

Примечание. Каждый рекламный аккаунт может создавать не более 500 пользовательских аудиторий на основе вовлеченности.

Правила оценки вовлеченности

Определить, кого Facebook добавляет в пользовательскую аудиторию, можно с помощью правил для аудитории.

Укажите поля type и id в event_sources правила, чтобы задать type и id объекта вовлеченности. Поле id может соответствовать и одному ID объекта, и массиву ID одинакового типа.

Поддерживаемые источники событий и ID объектов вовлеченности:

page — ID Страницы Facebook;
lead — ID формы для лидов;
ig_lead_generation — ID формы для лидов;
canvas — ID холста;
ig_business — ID бизнес-профиля Instagram;
shopping_page — ID Страницы магазина на Facebook;
shopping_ig — ID в магазина в Instagram;
ar_experience — Instant Expereince с использованием эффекта дополненной реальности;
ar_effects — принадлежащий вам эффект в Facebook или Instagram (за исключением эффектов, используемых в объявлениях).

Каждое правило содержит object_id и event_name.

Страницы

В поле object_id задайте ID своей Страницы. В качестве event_name укажите одно из следующих событий вовлеченности:

page_engaged — посещение Страницы или взаимодействие с ее контентом или рекламой на Facebook или в Messenger. Это самый широкий тип вовлеченности, который включает в себя все остальные типы.
page_visited — посещение страницы.
page_liked — добавление отметки "Нравится" для Страницы. (См. сведения об удержании и правилах, применяемых к отметкам "Нравится" для Страницы.)
page_messaged — отправка сообщения Странице.
page_cta_clicked — клик по кнопке призыва к действию на Странице. Примеры таких кнопок: "Связаться с нами", "Купить".
page_or_post_save — сохранение Страницы или публикации на ней.
page_post_interaction — взаимодействие с любой публикацией Страницы. К взаимодействиям относятся реакции ("Нравится", "Супер", "Ха-ха", "Ух ты!", "Сочувствую", "Возмутительно"), репосты, комментарии, клики по ссылкам и пролистывание кольцевых галерей.

Реклама для лидов

Задайте в поле object_id значение FORM_ID и укажите в rule, какое событие рекламы для лидов нужно отслеживать:

lead_generation_submitted — заполнение и отправка формы.
lead_generation_dropoff — закрытие формы без отправки. При этом неважно, заполнил ли пользователь какие-нибудь поля.
lead_generation_opened — открытие формы генерации лидов. При этом неважно, отправил ли пользователь форму или нет.

Instant Experience

Задайте в поле object_id значение "CANVAS_ID". Укажите в rule, какое событие нужно отслеживать:

instant_shopping_document_open;
instant_shopping_document_pause;
instant_shopping_document_resume;
instant_shopping_document_close;
instant_shopping_did_scroll;
instant_shopping_element_click;
instant_shopping_element_impression.

Бизнес-профиль в Instagram

Задайте в поле object_id значение "INSTAGRAM_BUSINESS_PROFILE_ID" и укажите в rule, какое событие бизнес-профиля в Instagram нужно отслеживать:

ig_business_profile_all — посещение бизнес-профиля в Instagram или взаимодействие с его контентом или рекламой. Это самый широкий тип вовлеченности, который включает в себя все остальные типы. Он объединяет ig_business_profile_engaged, ig_user_messaged_business и ig_user_messaged_business.
ig_business_profile_engaged — взаимодействие с бизнес-профилем в Instagram, его контентом или рекламой.
ig_user_messaged_business — отправка сообщения бизнес-профилю в Instagram.
ig_business_profile_visit — посещение бизнес-профиля в Instagram.
ig_business_profile_ad_saved — сохранение органического контента или рекламы бизнес-профиля в Instagram.
ig_ad_like.
ig_ad_comment.
ig_ad_share.
ig_ad_save.
ig_ad_cta_click.
ig_ad_carousel_swipe.
ig_organic_like.
ig_organic_comment.
ig_organic_share.
ig_organic_save.
ig_organic_swipe.
ig_organic_carousel_swipe.

Тип "Автор медиаконтента в Instagram" при создании пользовательских аудиторий на основе вовлеченности для видео пока не поддерживается.

Покупки

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

VIEW_CONTENT — просмотр страницы с информацией о товаре. Этот вариант доступен по всему миру.
ADD_TO_CART — добавление товара в корзину. Этот вариант доступен только для компаний, предоставляющих возможность оформить заказ, при условии что потребитель находится в Соединенных Штатах Америки.
PURCHASE — покупка товара. Этот вариант доступен только для компаний, предоставляющих возможность оформить заказ, при условии что потребитель находится в Соединенных Штатах Америки.

Вот как создать правило, которое будет добавлять в аудиторию людей, просмотревших ваш товар:

curl -i -X POST
-F 'name="test_api"'\
-F 'rule= {
	"inclusions": {
		"operator": "or",
		"rules": [
			{
				"event_sources": [
					{
						"id": "<ID>",
						"type": "shopping_ig"
					}
				]
				"retention_seconds": <RETENTION_SECONDS>,
				"filter": {
					"operator": "and",
					"filters": [
						{
						"field":"event",
						"operator":"eq",
						"value": "VIEW_CONTENT"
						}
					]
				}
			}
		]
	}
}
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

В Европе параметры page_messaged и ig_user_messaged_business могут быть недоступны в связи с новыми правовыми нормами в отношении конфиденциальности.

Дополненная реальность

Пользовательская аудитория на основе вовлеченности для дополненной реальности может состоять из двух частей: AR-опыт и AR-эффект.

Для пользовательской аудитории на основе вовлеченности для AR-опыта задайте в параметре object_id значение ID контейнера данных объявления с AR-эффектом, а в поле event_name используйте параметр ar_camera_open или camera_cta_click.
Для пользовательской аудитории на основе вовлеченности для AR-эффекта задайте в параметре object_id значение ID AR-эффекта, а в поле event_name используйте параметр ar_effect_open.

Максимальный срок удержания

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

реклама для генерации лидов — 90 дней;
бизнес-профиль в Facebook — 730 дней;
страница — 730 дней
- примечание: удержание не применяется к аудитории на основании отметок "Нравится" Страницы;
Instant Experience (прежнее название — "холст") — 730 дней;
покупки — 365 дней (данные доступны с апреля 2020 года);
дополненная реальность — 365 дней.

Правила оценки вовлеченности с разделом исключений

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

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

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       },
       "exclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_cta_clicked"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

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

Несколько правил

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

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 },
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Несколько страниц

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

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

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               },
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

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

Удержание и правила для отметок "Нравится" Страницы

Удержание не применяется к аудитории на основании отметок "Нравится" Страницы (retention_seconds=0). Кроме того, правила для отметок "Нравится" Страницы нельзя объединить с другими событиями Страницы.

Вот пример создания аудитории на основании отметок "Нравится" Страницы:

curl -X POST \
  -F 'name="Page Likes Audience Name"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 0,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_liked"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences