Публикация

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

Игроки могут публиковать моменты из игры в разных местах на Facebook, среди которых:

  • Лента игрока;
  • Ленты друзей;
  • переписки в Messenger;
  • группы Facebook.

Сведения

Игроки могут делиться снимками экрана и видеоклипами игрового процесса. Публикация в Ленте игрока может содержать пользовательское сообщение.

Чтобы задать изображение, текст и подпись кнопки для контента, который будет опубликован в историях в Ленте и сообщениях в Messenger, выполните вызов FBInstant.shareAsync(). Когда пользователь нажимает кнопку, игра запускается. Из этой точки входа у разработчика появляется доступ к FBInstant.getEntrypointData(), который возвращает объект data, переданный в FBInstant.shareAsync().

Процесс использования функции

Ниже описан процесс использования функции публикации.

  1. Игрок достигает определенных результатов: проходит уровень, выполняет сложное задание, получает достижение.

    Предложите игроку поделиться успехом, но не вызывайте API, пока он не нажмет кнопку "Поделиться" (см. правило 7.4.f для разработчиков Facebook).

  2. Как только игрок нажмет кнопку "Поделиться", вызовите метод shareAsync и передайте ему изображение, GIF-файл или видео, которые должны появиться в Ленте, а также полезные данные, которые позволят новым игрокам правильно вступить в вашу игру.

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

  3. Публикация появляется в Ленте.

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

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

Мы рекомендуем располагать по крайней мере одну хорошо заметную кнопку "Поделиться" на экране результатов и на других важных страницах. Предлагайте своим игрокам чаще делиться контентом с помощью внутриигровых подсказок в значимые моменты, в том числе с использованием контекста и описания (например, поставлен очередной рекорд по очкам или получен редкий предмет). Дополнительные сведения см. в рекомендациях.

Зачем нужно интегрировать эту функцию

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

Узнайте, как компания Awesome Prototype использовала публикацию для повышения удержания.

Начало работы

В этом разделе приведена информация о том, как интегрировать функцию публикации для каждого поддерживаемого SDK.

Моментальные игры

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

  • FBInstant.shareAsync вызывает в игре диалог "Поделиться". Разработчик может указать:
    • изображение, которым нужно поделиться;
    • полезные данные, которые позволят новым игрокам попасть непосредственно на соответствующий уровень в игре;
    • параметр для создания контекста и переключения на него игрока, который делает публикацию.

Устаревшие веб-игры

Вызовите FB.gamingservices.uploadImageToMediaLibrary в SDK Gaming Services для JavaScript.

  • FB.gamingservices.uploadImageToMediaLibrary позволяет загружать медиафайлы асинхронно (игрок делает публикацию после завершения сеанса).
  • Если установить для параметра shouldLaunchMediaDialog значение TRUE, диалог "Поделиться" открывается сразу же.

Рекомендации

См. рекомендации по публикации значимых моментов.

Примеры

Публикация определенного места назначения или режима игры

Шаг 1. Возникает момент, которым можно поделиться

Игрок совершает новое открытие или завершает создание персонажа и решает поделиться успехом.

Шаг 2. Игрок изменяет информацию в диалоге "Поделиться" и публикует ее в Ленте

В игре необходимо выполнить следующий вызов:

FBInstant.shareAsync

Шаг 3. Друг видит публикацию

Друг видит публикацию и нажимает ее, чтобы присоединиться к игре.

Шаг 4. Друг запускает игру

Друг попадает в соответствующее место игры и начинает играть.

Бонусы за приглашение

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

Шаг 1. В игре предлагаются бонусы

В игре предлагаются бонусы за приглашение в нее друзей.

Шаг 2. Игрок решает поделиться

В игре необходимо выполнить следующий вызов:

FBInstant.shareAsync({
  intent: 'REQUEST',
  Image: base64Picture,
  text: ‘Come play with your friend!’,
  data: {payload: ‘...’},
  switchContext: false,
    

Шаг 3. Друг видит публикацию

Друг видит публикацию и нажимает ее, чтобы присоединиться к игре.

Шаг 4. Новый игрок получает бонусы за присоединение к игре

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

В игре необходимо выполнить следующий вызов:

FBInstant.getEntryPointData()

Шаг 5. Пригласивший игрок получает бонусы за публикацию

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

В игре необходимо выполнить следующий вызов:

FBInstant.updateAsync({
  action: 'CUSTOM',
  cta: 'Join The Fight',
  image: base64Picture,
  text: {
    default: 'You have a new reward!',
    localizations: {}}
  template: 'VILLAGE_INVASION',
  data: { payload: '...' },
  strategy: 'IMMEDIATE',
  notification: 'NO_PUSH',
})

Часто задаваемые вопросы об этой функции

В чем разница между поощрением за публикацию и бонусом за приглашение?

Дарить игроку А подарки просто за приглашение другого пользователя или публикацию какого-либо контента в Ленте запрещено. Однако он может получить бонус, если пригласил игрока Б и тот начал играть. В такой ситуации игрок Б также может получить бонус. Подробнее об этом правиле.

Содержание документации

Публикация для моментальных игр

Узнайте, как дать игрокам возможность делиться своими игровыми успехами в профиле или в Лентах своих друзей.

Публикация для нативных приложений

Узнайте, как дать возможность активно публиковать игровой контент в Facebook и Instagram.

См. также