Параметры отслеживания и конверсии

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

В API Marketing 2.3 и более ранних версий параметры конверсии — это настройки рекламы, для которой используются ставки типа оптимизированная CPM. Эти параметры позволяют оптимизировать показ рекламы по определенным действиям и отражать эти действия в отчетах по конверсиям. В версиях API начиная с 2.4 параметры conversion_specs доступны только для чтения. Чтобы настроить оптимизацию показа рекламы, используйте optimization_goal в параметрах групп объявлений.

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

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

Параметры отслеживания по умолчанию

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

Если выбрана цель NONE или App Install/Engagement Ads, параметры отслеживания по умолчанию будут заменены. Чтобы использовать именно их, добавьте их в пользовательскую конфигурацию.

Допускаются значения типа "строка" и "массив", например 'APPLICATION_ID' и ['APPLICATION_ID'].

Настройки для CPM: billing_event=IMPRESSIONS, optimization_goal=IMPRESSIONS.
Настройки для CPC: billing_event=CLICKS, optimization_goal=CLICKS.
Настройки для оптимизированной CPM: billing_event=IMPRESSIONS, optimization_goal = необходимое действие.
Настройки для CPA: billing_event и optimization_goal = необходимое действие.

Цель	Креатив, тип ставки	Параметры отслеживания	Описание
CANVAS_APP_ ENGAGEMENT	Реклама, повышающая вовлеченность для приложения холста, с целью `optimization_goal= APP_INSTALLS`	[{'action.type': 'app_engagement', 'application': 'APPLICATION_ID'}, {'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}]	См. метапараметры app_engagement и post_engagement.
CANVAS_APP_ INSTALLS	Реклама для установки приложения холста, которая оптимизируется не для `optimization_goal= APP_INSTALLS`	[{'action.type': 'app_engagement', 'application': 'APPLICATION_ID'}, {'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}]	См. метапараметры app_engagement и post_engagement.
CONVERSIONS	Реклама со ссылками и фотореклама в публикациях Страницы, где `promoted_object` — ID пикселя, а `optimization_goal= OFFSITE_CONVERSIONS`	{'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}, {'action.type':'like', 'page':PAGE_ID}	Параметры взаимодействия с публикациями и отметок "Нравится" Страницы. Количество кликов по ссылке в определенной публикации Страницы, если ссылка только одна; количество взаимодействий с публикацией; сколько раз люди создавали истории или взаимодействовали со Страницей.
CONVERSIONS	Реклама со ссылками и фотореклама в публикациях Страницы, которая оптимизируется не для `optimization_goal= OFFSITE_CONVERSIONS`	{'action.type': 'offsite_conversion', 'fb_pixel': 'FACEBOOK_PIXEL_ID'}, {'action.type':{'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}, {'action.type':'like', 'page':PAGE_ID}	Параметры конверсий, взаимодействия с публикациями и отметок "Нравится" Страницы. Количество кликов по ссылке в определенной публикации Страницы, если ссылка только одна; количество взаимодействий с публикацией; сколько раз люди создавали истории или взаимодействовали со Страницей.
CONVERSIONS	Реклама со ссылкой на сайт, где `promoted_object` — ID пикселя, а `optimization_goal= OFFSITE_CONVERSIONS`	{'action.type': 'link_click', 'object':'URL'}, {'action.type':'like', 'page':PAGE_ID}	Параметры отметок "Нравится" Страницы и кликов по ссылкам. Количество кликов по ссылке в определенной публикации Страницы, если ссылка только одна; количество взаимодействий с публикацией; сколько раз люди создавали истории или взаимодействовали со Страницей.
CONVERSIONS	Реклама со ссылкой на сайт, которая оптимизируется не для `optimization_goal= OFFSITE_CONVERSIONS`	{'action.type': 'offsite_conversion', 'fb_pixel': 'FACEBOOK_PIXEL_ID'}, {'action.type': 'link_click', 'object':'URL'}, {'action.type':'like', 'page':PAGE_ID}	Параметры конверсий, отметок "Нравится" Страницы и кликов по ссылкам. Количество кликов по ссылке в определенной публикации Страницы, если ссылка только одна; количество взаимодействий с публикацией; сколько раз люди создавали истории или взаимодействовали со Страницей.
EVENT_RESPONSES	Реклама мероприятий, которая оптимизируется не для `optimization_goal= EVENT_RESPONSES`	[{'action.type':'rsvp' , 'response':'yes', 'event':'EVENT_ID'}, {'action.type':'rsvp' , 'response':'maybe', 'event':'EVENT_ID'}, [{'action.type':'rsvp' , 'response':'no', 'event':'EVENT_ID'}]	Количество разных ответов на приглашения ("да", "может быть", "нет").
EVENT_RESPONSES	Реклама мероприятий, для которой задано значение `optimization_goal= EVENT_RESPONSES`	Пусто (отслеживаемые действия указываются в параметрах конверсий)	Количество разных ответов на приглашения ("да", "может быть", "нет").
LINK_CLICKS	Реклама со ссылками и фотореклама в публикациях Страницы с любыми типами ставок	{'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}	Взаимодействие с публикацией. Количество кликов по ссылкам на сторонние сайты, URL с определенным доменом, сторонним ссылкам на Страницах или в публикациях.
LINK_CLICKS	Реклама со ссылкой на сайт, которая оптимизируется для `optimization_goal= LINK_CLICKS`	{'action.type':'like', 'page':PAGE_ID}]	Отметки "Нравится" Страницы. Количество кликов по ссылкам на сторонние сайты, URL с определенным доменом, сторонним ссылкам на Страницах или в публикациях.
LINK_CLICKS	Реклама со ссылкой на сайт, которая оптимизируется не для `optimization_goal= LINK_CLICKS`	{'action.type': 'link_click', 'object':'URL'}, {'action.type':'like', 'page':PAGE_ID}	Клики на сайт, отметки "Нравится" Страницы. Количество кликов по ссылкам на сторонние сайты, URL с определенным доменом, сторонним ссылкам на Страницах или в публикациях.
MOBILE_APP_ ENGAGEMENT	Реклама для повышения вовлеченности в мобильном приложении с любыми типами ставок	{'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'} Для рекламы, повышающей вовлеченность в приложении, необходимо задать параметр отслеживания с ID приложения на Facebook: [{'action.type': 'mobile_app_install', 'application': 'APP_ID'}, {'action.type': 'app_custom_event', 'application':APP_ID}]	См. метапараметр post_engagement. Также количество событий в приложении.
MOBILE_APP_ INSTALLS	Реклама для установки мобильного приложения с любыми типами ставок	{'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'} strong>В настройках рекламы для установки приложения необходимо задать параметр отслеживания с ID приложения на Facebook: [{'action.type': 'app_custom_event', 'application':APP_ID}, {'action.type': 'mobile_app_install', 'application': 'APP_ID'}]	См. метапараметр post_engagement. Также количество скачиваний после просмотра рекламы для установки мобильного приложения (если известна версия iOS/Android) и количество событий в приложении.
NONE	Любой тип рекламы	См. параметры отслеживания по умолчанию для разных типов рекламы.
PAGE_LIKES	Реклама для продвижения публикаций или увеличения количества отметок "Нравится" Страницы с любыми типами ставок	{'action.type': 'page_engagement', 'page':'PAGE_ID'}	См. метапараметр вовлеченности на Странице.
POST_ENGAGEMENT	Реклама публикаций Страницы, которая оптимизируется не для `optimization_goal= POST_ENGAGEMENT`	{'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}	См. метапараметр взаимодействий с публикациями Страницы.
POST_ENGAGEMENT	Реклама публикаций Страницы с оптимизацией для `optimization_goal= POST_ENGAGEMENT`	Пусто	См. метапараметр взаимодействий с публикациями Страницы.
POST_ENGAGEMENT (тестирование)	Любые	{'action.type': 'dwell', 'post':'POST_ID', 'page':'PAGE_ID'}	Небольшой процент этой рекламы имеет тип отслеживания `dwell`, ориентированный на людей, взаимодействующих с объявлением хотя бы минуту.
PRODUCT_ CATALOG_SALES	Динамическая реклама товаров	{'action.type': 'post_engagement', 'page': PAGE_ID, 'post': POST_ID}	Количество кликов по ссылке в определенной публикации Страницы, если ссылка только одна; количество взаимодействий с публикацией; сколько раз люди создавали истории или взаимодействовали со Страницей. Вы можете указать другую группу товаров, но по умолчанию используется группа, заданная в продвигаемом объекте.

Метапараметры

В одном параметре можно задать несколько типов действий с одним объектом.

Объект	Параметр конверсии	Описание
Приложение	{"action.type":["app_engagement"], "application":["APPLICATION_ID"]}	Сколько раз люди создавали истории `app_story` или взаимодействовали с контентом через app_use, app_install, credit_spent.
Страница	{"action.type":["page_engagement"], "page":["PAGE_ID"]}	Сколько раз люди выполняли любое из следующих действий в контексте указанной Страницы: отметили посещение, оставили комментарий, подписались, поставили отметку "Нравится", поставили отметку "Нравится" публикации Страницы, упомянули, добавили публикацию на Страницу, поделились публикацией, ответили на вопрос. Также количество следующих действий в контексте указанной Страницы: переходы по ссылкам, просмотры фото и нативных видео на Facebook.
Публикация Страницы	{"action.type":["post_engagement"], "post":["POST_ID"], "page":["PAGE_ID"]}	Сколько раз люди выполняли любое из следующих действий в контексте указанной публикации: оставили комментарий, подписались на вопрос, поставили отметку "Нравится", поделились, ответили на вопрос. Также количество следующих действий: клики по ссылкам, отметки "Нравится" Страницы, просмотры фото, воспроизведения видео на Facebook и встроенных роликов с YouTube. Для невстроенных видео используйте link_click.

Пользовательские параметры отслеживания

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

Действие (тип объекта)	Описание, сведения о параметрах отслеживания	Параметр отслеживания или конверсии
app_custom_event (приложение)	Специально настроенное событие в приложении. Количество специально настроенных событий в мобильном приложении.	{'action.type': 'app_custom_event', 'application':APP_ID}
app_install (приложение)	Установка приложения. Количество установок приложения холста или мобильного приложения.	[{'action.type':'app_install', 'application':APP_ID}, {'action.type': 'mobile_app_install', 'application':APP_ID}]
app_use (приложение)	Количество использований приложения.	{'action.type':'app_use', 'application':APP_ID}
checkin (место)	Отметка посещения места. Количество отметок посещений места или дочерних мест этой Страницы.	{'action.type':'checkin', 'page': PAGE_ID}, {'action.type':'checkin', 'page.parent:PAGE_ID}
comment (публикация)	Комментарий к публикации. Количество комментариев к любой или конкретной публикации Страницы.	{'action.type':'comment', 'post.wall':PAGE_ID}, {'action.type':'comment', 'post':POST_ID, 'post.wall':PAGE_ID}
credit_spend (приложение)	Случаи расходования купонов в приложении.	'action.type':'credit_spent', 'application':APP_ID}
follow (вопрос)	Подписка на объект. Количество ответов или подписок на вопрос.	{'action.type':'vote', 'question':QUESTION_ID, 'question.creator':PAGE_ID}, {'action.type':'follow', 'question':QUESTION_ID, 'question.creator':PAGE_ID}
leadgen_quality_conversion (пиксель)	События конверсии лидов (CRM) нижней части воронки.	{'action.type': 'leadgen_quality_conversion', 'fb_pixel': 'FACEBOOK_PIXEL_ID'}, {'action.type': 'leadgen_quality_conversion', 'dataset': 'OFFLINE_EVENT_SET_ID'}
like (Страница, публикация)	Отметка "Нравится" для объекта. Количество отметок "Нравится" Страницы или публикации.	{'action.type':'like', 'page':PAGE_ID} , {'action.type':'like', 'post.wall':PAGE_ID} , {'action.type':'like', 'post':POST_ID, 'post.wall':PAGE_ID}
link_click (Страница, публикация, URL, домен URL)	Клик по ссылке. Количество кликов по ссылкам на сторонние сайты, URL с определенным доменом, сторонним ссылкам на Страницах или в публикациях.	{'action.type':['link_click'], 'object':['URL']}, {'action.type':['link_click'], 'object.domain': ['URL_DOMAIN']}, {'action.type':['link_click'], 'post.wall':['PAGE_ID']}, {'action.type':['link_click'], 'post':['POST_ID'], 'post.wall':['PAGE_ID']}
mention (Страница)	Упоминание Страницы. Количество упоминаний Страницы.	{'action.type':'mention', 'object':PAGE_ID'}
offsite_conversion (пиксель)	Количество конверсий на сторонних сайтах и совокупный доход.	{'action.type': 'offsite_conversion', 'fb_pixel': 'FACEBOOK_PIXEL_ID'}
photo_view (Страница)	Просмотр фото. Количество просмотров фото, воспроизведений видео или кликов по ссылкам репоста фото/видео/ссылки в любой или конкретной публикации Страницы.	{'action.type':'photo_view', 'post.wall':PAGE_ID} {'action.type':'photo_view', 'post':POST_ID, 'post.wall':PAGE_ID}
post (публикация)	Публикация истории. Количество публикаций людей на Странице.	{'action.type':'post', 'post.wall':PAGE_ID}
receive_offer (предложение)	Принятие предложения. Количество людей, которые приняли конкретное предложение.	{'action.type':'receive_offer', 'offer':OFFER_ID}
rsvp (мероприятие)	Ответы на приглашение. Количество ответов на приглашение ("да", "может быть"). Допустимые значения: `yes`, `maybe` и `no`.	{'action.type':'rsvp', 'event': EVENT_ID}, {'action.type':'rsvp', 'response':'yes', 'event': EVENT_ID}, {'action.type':'rsvp', 'response':'no', 'event': EVENT_ID}, {'action.type':'rsvp', 'response':'maybe', 'event': EVENT_ID}
tab_view (Страница)	Просмотр вкладки Страницы. Количество просмотров определенной вкладки Страницы. Если вас интересуют просмотры всех вкладок, просто укажите Страницу.	{'action.type':'tab_view', 'page.tab.name': 'PAGE_TAB_NAME', 'page':PAGE_ID}, {'action.type':'tab_view', 'page':PAGE_ID}
video_play (публикация)	Просмотр видео. Количество просмотров видео в любой или конкретной видеопубликации на Странице.	{'action.type':'video_play', 'post.wall':PAGE_ID},{'action.type':'video_play', 'post':POST_ID, 'post.wall':PAGE_ID}

Примеры

Отслеживание с помощью пикселя

Чтобы отслеживать эффективность разных пикселей в рекламе, задайте пиксель отслеживания в поле tracking_specs объявления. Пример:

tracking_specs="[
  &#123;&#039;action.type&#039;:&#039;offsite_conversion&#039;,&#039;fb_pixel&#039;:1&#125;,
  &#123;&#039;action.type&#039;:&#039;offsite_conversion&#039;,&#039;fb_pixel&#039;:2&#125;,
  &#123;&#039;action.type&#039;:&#039;offsite_conversion&#039;,&#039;fb_pixel&#039;:3&#125;
]"

Так вы сможете отслеживать эффективность пикселей "1", "2" и "3". Чтобы оптимизировать только по пикселю "1", задайте promoted_object родительской группы объявлений. Это полезно, если вы хотите оптимизировать по CHECKOUT и параллельно отслеживать количество REGISTRATION и ADD_TO_CART.

Если вы указали ID пикселя в promoted_object для оптимизации по этому пикселю, он будет отслеживаться автоматически, поэтому не нужно задавать этот же пиксель в tracking_specs.

Использование параметров конверсий

Поле conversion_specs используется в объявлениях. Формат поля: {'action.type':'{ACTION}', ... }, где каждое действие применяется к объекту. Примеры параметров конверсий для разных типов рекламы:

Тип рекламы	Параметр конверсии
Реклама со ссылкой на сайт в социальном контексте	{'action.type':'link_click', 'object':'URL'}
Реклама для увеличения количества отметок "Нравится" Страницы	{'action.type':'like', 'page':PAGE_ID}
Реклама со ссылкой в публикации Страницы	{'action.type':['link_click'], 'post': [POST_ID], 'post.wall':[PAGE_ID]}
Остальные типы рекламы публикаций Страницы	{'action.type':'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}
Реклама мероприятия	{'action.type':'rsvp' , 'response':'yes', 'event':'EVENT_ID'}
Реклама предложения	{'action.type':'receive_offer', 'offer':OFFER_ID, 'offer.creator':PAGE_ID}
Реклама для установки мобильного приложения	Недоступно: нельзя создать такую рекламу с целью NONE
Реклама для повышения вовлеченности в мобильном приложении	Недоступно: поддерживаются только ставки CPM и CPC
Реклама для установки приложения холста	Недоступно: нельзя создать такую рекламу с целью NONE
Реклама для повышения вовлеченности в приложении холста	Недоступно: нельзя создать такую рекламу с целью NONE

Некоторые параметры конверсий содержат по несколько действий, применимых к одному объекту. Они называются метапараметрами. Примеры:

Объект	Параметр конверсии	Описание
Страница	{"action.type":["page_engagement"], "page":["PAGE_ID"]}	Сколько раз люди выполняли следующие действия в контексте указанной Страницы: отметили посещение, оставили комментарий, подписались, поставили отметку "Нравится", поставили отметку "Нравится" публикации Страницы, упомянули, добавили публикацию на Страницу, поделились публикацией, ответили на вопрос. Также количество следующих действий на указанной Странице: просмотры фото, воспроизведения нативных видео на Facebook.
Публикация Страницы	{"action.type":["post_engagement"], "post":["POST_ID"], "page":["PAGE_ID"]}	Сколько раз люди выполняли любое из следующих действий с указанной публикацией: оставили комментарий, подписались на вопрос, поставили отметку "Нравится", поделились, приняли предложение, ответили на вопрос. Также количество следующих действий: клики по ссылкам, отметки "Нравится" Страницы, просмотры фото, воспроизведения видео на Facebook и встроенных роликов с YouTube. Для невстроенных видео используйте `link_click`.
Приложение	{"action.type":["app_engagement"], "application":["APPLICATION_ID"]}	Сколько раз люди создавали `app_story` или взаимодействовали с контентом через `app_use`, `app_install` или `credit_spent`.