Перейти к основному содержимому

Социальные действия

Обзор

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

Список поддерживаемых социальных сетей и мессенджеров для шаринга:

  • Facebook
  • Whatsapp
  • Telegram
  • Vkontakte
  • Twitter
  • Odnoklassniki
  • Viber

Для лучшего парсинга игры мессенджерами и социальными сетями мы рекомендуем разместить в игре мета-теги Open Graph. А так же заполнить заголовок и описание. Это полезно с точки зрения SEO-оптимизации. Пример размещения мета-тегов показан ниже:

// Заполните основную информацию об игре
<title>My awesome game 2</title>
<meta name="og:title" content="My awesome game 2">
<meta name="description" content="There are not enough words to describe the awesomeness of the game">
<meta name="og:description" content="There are not enough words to describe the awesomeness of the game">
<meta name="og:image" content="/img/ogimage.png">

Поддерживаемые площадки

  • Google Play
  • CrazyGames
  • Yandex Games
  • VK Games
  • VK Play
  • OK Games
  • PlayDeck
  • GameMonetize
  • GamePix
  • Площадки без поддержки
  • GameDistribution
  • SmartMarket
  • WG Playground
  • Kongregate
  • Для того, чтобы проверить, что шаринг разрешен и поддерживается на платформе FREE:

    // Поддерживается ли шаринг
    gp.socials.isSupportsShare;

    Поделиться

    FREE

    По умолчанию через вызов метода share можно поделиться ссылкой на игру. Мы сами определим ссылку в зависимости от платформы и подставим нужный текст, он берется из названия проекта в панели управления или мета-тега og:title или просто тега title.

    Площадки с нативным функционалом

  • VK Games
  • OK Games
  • Площадки без поддержки
  • CrazyGames
  • GamePix
  • GameDistribution
  • GameMonetize
  • SmartMarket
  • VK Play
  • Yandex Games
  • WG Playground
  • Kongregate
  • PlayDeck
  • Google Play
    // Проверка поддержки нативного шаринга
    gp.socials.isSupportsNativeShare;

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

    Поделиться ссылкой:

    gp.socials.share();

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

    gp.socials.share({
    text: `Мне удалось нажать 73 раза по квадрату за 5 секунд!
    Теперь я на 23 месте в списке "Самых быстрых пальцев".
    Сможешь меня обогнать?`,
    });

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

    gp.socials.share({
    url: `${gp.app.url}?invitedBy=${gp.player.id}`,
    });

    Поделиться с добавлением произвольного изображения:

    gp.socials.share({
    image: 'https://gamepush.com/img/ogimage.png',
    });
    tip

    Поддержка изображений через нативные методы социальных сетей реализована только во Вконтакте через формат вложений photo123456_123456 и Одноклассниках через формат вложений 123456, или URL изображений загруженных через GamePush на площадку gp.images.upload() для остальных параметр image будет проигнорирован, доступны только url и text.

    Полностью настраиваемый шаринг:

    gp.socials.share({
    text: 'Присоединяйся ко мне в игре "My awesome game 2"',
    url: gp.app.url,
    image: 'https://gamepush.com/img/ogimage.png',
    });

    Вы можете подписаться на событие завершения шаринга:

    gp.socials.on('share', (success) => {
    // success = true, если успешно выполнено действие "поделиться"
    });

    Опубликовать пост

    FREE

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

    Площадки с нативным функционалом

  • VK Games
  • OK Games
  • Площадки без поддержки
  • CrazyGames
  • GamePix
  • GameDistribution
  • GameMonetize
  • SmartMarket
  • VK Play
  • Yandex Games
  • WG Playground
  • Kongregate
  • PlayDeck
  • Google Play
    // Поддерживается ли нативный постинг
    gp.socials.isSupportsNativePosts;

    В платформах без нативной поддержки этого метода — будет использован оверлей с предложением поделиться, как и в случае с методом share.

    Логика использования дублирует метод share.

    gp.socials.post();

    Полностью настраиваемый пост:

    gp.socials.post({
    text: 'Присоединяйся ко мне в игре "My awesome game 2"',
    url: gp.app.url,
    image: 'https://gamepush.com/img/ogimage.png',
    });

    Вы можете подписаться на событие завершения постинга:

    gp.socials.on('post', (success) => {
    // success = true, если успешно выполнено действие "опубликовать"
    });

    Пригласить друзей

    FREE

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

    Площадки с нативным функционалом

  • VK Games
  • OK Games
  • Площадки без поддержки
  • CrazyGames
  • GamePix
  • GameDistribution
  • GameMonetize
  • SmartMarket
  • VK Play
  • Yandex Games
  • WG Playground
  • Kongregate
  • PlayDeck
  • Google Play
    // Проверка поддержки нативных инвайтов
    gp.socials.isSupportsNativeInvite;

    В платформах без нативной поддержки этого метода — будет использован оверлей с предложением пригласить друзей, такой же как и в случае с методами share или post.

    Логика использования дублирует метод share.

    gp.socials.invite();

    Настраиваемый текст для некоторых платформ:

    gp.socials.invite({
    text: 'Присоединяйся ко мне в игре "My awesome game 2"',
    });

    Вы можете подписаться на событие завершения приглашения друзей:

    gp.socials.on('invite', (success) => {
    // success = true, если успешно выполнено действие "пригласить"
    });
    tip

    Метод принимает в себя такой же объект, как и в случае share и post, но на сегодня используется только text.

    Вступить в сообщество

    FREE

    Показывает игроку оверлей с возможностью вступить в сообщество (если позволяет платформа) или открывает ссылку на сообщество в новой вкладке.

    Поддерживаемые площадки

  • CrazyGames
  • Yandex Games
  • VK Games
  • OK Games
  • GameMonetize
  • SmartMarket
  • Площадки без поддержки
  • GamePix
  • GameDistribution
  • VK Play
  • WG Playground
  • Kongregate
  • PlayDeck
  • Google Play
    // Можно ли приглашать в сообщество на текущей платформе
    gp.socials.canJoinCommunity;

    Площадки с нативным функционалом

  • VK Games
  • OK Games
  • Площадки без поддержки
  • CrazyGames
  • GamePix
  • GameDistribution
  • GameMonetize
  • SmartMarket
  • VK Play
  • Yandex Games
  • WG Playground
  • Kongregate
  • PlayDeck
  • Google Play
    // Поддерживается ли нативное вступление в сообщество
    gp.socials.isSupportsNativeCommunityJoin;

    Вступить в сообщество:

    gp.socials.joinCommunity();

    Вы можете подписаться на событие завершения вступления в сообщество:

    gp.socials.on('joinCommunity', (success) => {
    // success = true, если успешно выполнено действие "вступить в сообщество"
    });

    Работа с параметрами для шаринга

    Вам может понадобиться создать ссылку для приглашения игрока, в которой могут содержаться ID пригласителя и какой-нибудь подарок приглашаемому. Для этого необходимо добавить эти параметры в ссылку игры на площадке. Все площадки по-разному просят формировать URL. Мы объединили создание ссылок в один метод. Так же при переходе по этой ссылке вам доступны все переданные ранее параметры.

    Создать ссылку для шаринга

    FREE
    const shareUrl = gp.socials.makeShareUrl({
    // любые ваши параметры
    fromId: gp.player.id,
    gift: 'GOLD_SWORD_X5',
    });
    // https://vk.com/app7869399#eyJmcm9tSWQiOjE4MDcwMTksImdpZnQiOiJHT0xEX1NXT1JEX1g1In0=

    Считать параметры при заходе по ссылке

    FREE
    // любые ваши параметры, указанные в ссылке
    const fromId = gp.socials.getShareParam('fromId'); // 123456
    const gift = gp.socials.getShareParam('gift'); // "GOLD_SWORD_X5"

    Оставайтесь на связи

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

    Сообщество GamePush в Telegram: @gs_community.

    Для ваших обращений e-mail: [email protected]

    Желаем вам успехов!