Уведомления от приложения пользователю

This feature is no longer available for new submissions. This documentation is intended solely for developers with existing games.

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

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

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

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

Когда люди нажимают уведомление, они попадают на указанный вами URL.

Реализация

Отправка уведомлений

Чтобы создать уведомление, приложение отправляет запрос HTTP POST в API Graph /user_id/notifications с маркером app access_token. Подробнее см. в разделе о границе уведомлений API Graph.

POST /{recipient_userid}/notifications?access_token=... &template=...&href=...

Параметры

Параметр	Описание
`href`	Относительный путь или параметры GET цели (например `index.html?gift_id=123` или `?gift_id=123`). Эти данные помогут создать абсолютный целевой URL на основе параметров вашего приложения. Логика заключается в том, что если в веб-платформе этот параметр настроить для игр на Facebook.com, целевой URL будет состоять из URL игры и `href`. В противном случае уведомление не будет отображено. Абсолютный URL будет включать определенные параметры для отслеживания (`fb_source`, `notif_id`, `notif_t`) целевого URL, с помощью которых разработчики смогут выполнять отслеживание у себя.
`template`	Индивидуально указанный текст уведомления. Подробнее см. ниже в шаблоне сообщения.
`ref`	Чтобы уведомления было проще отслеживать в App Analytics, их следует разделить на группы.

Обработка возвращаемых значений

Если вызов выполнен успешно, API Graph предоставляет следующий ответ:

{
  "success": true
}

Примечание. Если вероятность взаимодействия получателя с уведомлением низкая, оно может быть не показано, даже если вызов API Graph был успешным.

В противном случае ответ API Graph будет содержать ошибку с соответствующим сообщением об исключении.

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

{
   "error": {
      "message": "(#200) Cannot send notifications to a user who has not installed the app",
      "type": "OAuthException",
      "code": 200
   }
}

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

{
   "error": {
      "message": "(#200) Cannot tag users who have not installed the app",
      "type": "OAuthException",
      "code": 200
   }
}

Если текст шаблона содержит более 180 символов, API вернет ошибку, приведенную ниже. Помните, что будут показаны только первые 120 символов текста.

{
   "error": {
      "message": "(#100) template parameter cannot be longer than 180 characters.",
      "type": "OAuthException",
      "code": 100
   }
}

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

Шаблоны сообщений

Содержание уведомления может быть любым. В поле message API Graph можно ввести не более 180 символов, а показаны будут только первые 120 из них.

Сообщения с обычным текстом

Это уведомление можно создать с помощью следующего вызова API Graph:

POST /{recipient_userid}/notifications?
     access_token=...& 
     href=...& 
     template=You have people waiting to play with you, play now!

Шаблоны индивидуальных сообщений

С помощью @[USER_ID] можно указать ID пользователей, которые будут заменены полным именем человека и выделены при отображении в уведомлении.

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

POST /{recipient_userid}/notifications?
     access_token=...& 
     href=...& 
     template=@[596824621] started a game with you, play now!

Подобно этому в уведомлении ниже используется синтаксис @[USER_ID], но в шаблоне указано более одного действующего лица (человека).

POST /{recipient_userid}/notifications?
     access_token=...& 
     href=...& 
     template=@[596824621] and @[10149999096285761] started a game with you!

API Graph проверяет каждый USER_ID, чтобы убедиться, что такой пользователь Facebook действительно существует и уже авторизован в вашем приложении. Если указанные идентификаторы не пройдут проверку, вызов API не будет выполнен.

Отслеживание результативности

Минимальная кликабельность

Кликабельность (CTR) — одна из самых важных метрик эффективности уведомлений. Высокая кликабельность свидетельствует о том, что уведомления интересны и привлекательны для людей. Низкая кликабельность говорит о том, что уведомления неэффективны. Со временем люди перестанут обращать внимание на уведомления с низкой кликабельностью или отключат их, что негативно скажется на эффективности как вашего, так и других приложений.

Чтобы сохранить интерес пользователей Facebook к каналу уведомлений, кликабельность приложений, отправляющих 50 000 уведомлений в неделю, не должна быть менее 17 % в неделю. Согласно статистике, люди дольше вовлечены в игровой процесс, если кликабельность держится на этом уровне или выше. Приложения, которые не способны поддерживать такой уровень соотношения каждую неделю, могут быть временно отключены.

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

Оптимизация вручную

Локализация шаблона сообщения

Чтобы отправить уведомление на языке, отличном от английского, необходимо вручную определить родной язык человека. После входа человека в приложение его язык можно узнать с помощью границы контекста API Graph /{user-id}?fields=locale. Узнать язык людей, играющих на Facebook.com, можно с помощью запроса HTTP POST. Зная язык игроков, разработчики могут вручную создать шаблоны сообщений на их родном языке.

Периодичность отправки

Разработчикам проще оптимизировать отправку уведомлений, если они будут знать, в какое время люди активны онлайн. После входа человека в приложение его часовой пояс можно узнать с помощью границы контекста API Graph /{user-id}?fields=timezone. Если разработчики будут знать часовой пояс игроков и воспользуются справочными параметрами, они смогут отправлять уведомления в наиболее подходящее время.

Автотаргетинг (бета-версия)

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

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

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

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