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

Обзор

Для увеличения аудитории мы предлагаем использовать социальные действия — поделиться, опубликовать пост и пригласить друзей в игру. Такие платформы как 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">

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

✅CrazyGames

✅Yandex Games

✅VK Games

✅VK Play

✅OK Games

✅Poki

✅GameDistribution

✅GameMonetize

✅GamePix

Площадки без поддержки

❌SmartMarket

Для того, чтобы проверить, что шаринг разрешен и поддерживается на платформе:

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

Поделиться

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

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

✅VK Games

✅OK Games

Площадки без поддержки

❌CrazyGames

❌GamePix

❌GameDistribution

❌GameMonetize

❌Poki

❌SmartMarket

❌VK Play

❌Yandex Games

// Проверка поддержки нативного шаринга
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, если успешно выполнено действие "поделиться"
});

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

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

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

✅VK Games

✅OK Games

Площадки без поддержки

❌CrazyGames

❌GamePix

❌GameDistribution

❌GameMonetize

❌Poki

❌SmartMarket

❌VK Play

❌Yandex Games

// Поддерживается ли нативный постинг
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, если успешно выполнено действие "опубликовать"
});

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

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

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

✅VK Games

✅OK Games

Площадки без поддержки

❌CrazyGames

❌GamePix

❌GameDistribution

❌GameMonetize

❌Poki

❌SmartMarket

❌VK Play

❌Yandex Games

// Проверка поддержки нативных инвайтов
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.

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

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

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

✅CrazyGames

✅Yandex Games

✅VK Games

✅OK Games

✅GameMonetize

✅SmartMarket

Площадки без поддержки

❌GamePix

❌GameDistribution

❌Poki

❌VK Play

// Можно ли приглашать в сообщество на текущей платформе
gp.socials.canJoinCommunity;

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

✅VK Games

✅OK Games

Площадки без поддержки

❌CrazyGames

❌GamePix

❌GameDistribution

❌GameMonetize

❌Poki

❌SmartMarket

❌VK Play

❌Yandex Games

// Поддерживается ли нативное вступление в сообщество
gp.socials.isSupportsNativeCommunityJoin;

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

gp.socials.joinCommunity();

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

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

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

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

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

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

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

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

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

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

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

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

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