In-Game Store / Реферальная программа
  На главную

In-Game Store

Реферальная программа

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

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

Примечание

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

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

Основные возможности:
  • Предоставление в качестве награды одного или нескольких товаров следующих типов:
    • виртуальная валюта;
    • виртуальный предмет;
    • бандл с товарами.
  • Кастомизация виджета реферальной программы.
  • Генерация реферальных ссылок.
  • Изменение выбранной реферальной программы для приглашаемого пользователя, до того как он совершит первую покупку.
Ограничения:
  • В проекте может быть только одна реферальная программа.
  • Пользователи не могут приглашать самих себя.

Сценарий приглашающего пользователя

  1. Приглашающий пользователь переходит в Web Shop.
  2. Приглашающий пользователь авторизуется или регистрируется на сайте.
  3. Приглашающий пользователь открывает виджет реферальной программы и изучает условия программы.
  4. Приглашающий пользователь получает реферальную ссылку в виджете.
  5. Приглашающий пользователь делится ссылкой с приглашаемым пользователем.
  6. Приглашаемый пользователь переходит по ссылке и выполняет условие программы.
  7. Приглашающий пользователь открывает виджет реферальной программы и нажимает кнопку получения награды.

Сценарий приглашаемого пользователя

  1. Приглашаемый пользователь получает реферальную ссылку с описанием условий программы и наград.
  2. Приглашаемый пользователь переходит в Web Shop по реферальной ссылке.
  3. Приглашаемый пользователь регистрируется в Web Shop.
  4. Приглашаемый пользователь совершает первую покупку в Web Shop.
  5. Приглашаемый пользователь получает награду.
Примечание
Приглашаемый пользователь может сменить реферальную программу до совершения первой покупки и перейти по реферальной ссылке другого приглашающего пользователя. Например, пользователь перешел по реферальной ссылке инфлюенсера, но затем решил присоединиться к реферальной программе друга и перешел по его ссылке.

Как настроить

Создание реферальной программы

  1. Откройте проект в Личном кабинете.
  2. В боковом меню нажмите Store.
  3. В панели Live-ops and promotion tools нажмите:
    • Подключить — если у вас еще нет акций или наград;
    • Настроить — если вы уже подключили акции или награды.
  1. На вкладке Реферальная программа нажмите Создать реферальную программу.
  2. Задайте необходимые параметры:
    • Укажите название реферальной программы.
    • Введите описание.
  1. Нажмите Далее.
  2. Добавьте награды, которые получат приглашающий и приглашаемый пользователи:
    • Чтобы добавить награду для приглашающего пользователя, в разделе Награда для приглашающих игроков укажите артикулы товаров и их количество.
    • Чтобы добавить награду для приглашаемого пользователя, в разделе Награда для приглашенных укажите артикулы товаров и их количество.
Примечание

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

Поэтому следует предоставлять ему награду, которая может повторяться.

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

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

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

Настройка виджета

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

В настройках виджета вы также можете настроить содержание блока частых вопросов для реферальной программы в соответствии с особенностями вашей игры.

  1. Настройте локализацию. Все тексты виджета переводятся на языки проекта, указанные в Личном кабинете в разделе Настройки проекта > Общие настройки > Языки проекта.
    Чтобы изменить переводы по умолчанию, нажмите на текст дважды и введите свой вариант.
  2. Нажмите Publish.
  3. Скопируйте код виджета в открывшемся окне и добавьте на сайт.

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

Добавление кода виджета на сайт

Если вы самостоятельно реализуете интерфейс сайта, добавьте код виджета в код вашего сайта. Если вы используете Xsolla Site Builder, чтобы добавить виджет реферальной программы на ваш сайт:
  1. Откройте проект в Личном кабинете.
  2. В боковом меню нажмите Site Builder.
  3. В разделе Сайты выберите ваш сайт и нажмите Открыть Конструктор сайтов.
  4. Нажмите Добавить блок.
  5. Выберите блок Ваш код.
  6. Добавьте код виджета реферальной программы.

Настройка авторизации

Если вы используете Xsolla Site Builder для создания Web Shop, доработка виджета не требуется, функциональность авторизации пользователя в виджете реализована на стороне Xsolla.

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

Авторизация в виджете происходит посредством авторизации на сайте, на котором расположен виджет.

Возможны 2 сценария в зависимости от того, где авторизуется пользователь — на сайте или в виджете:

  • Если пользователь авторизуется на сайте, необходимо передать авторизационный токен пользователя в виджет с помощью метода onTokenChange(). При выходе пользователя из системы в качестве параметра метода передайте null.
  • Если пользователь авторизуется через виджет, виджет вызовет функцию requestAuth, переданную ему при инициализации. В ответе сайт должен вернуть авторизационный токен пользователя.
Пример кода для запуска (инициализации) виджета:
Copy
Full screen
Small screen

window.XESApi.init({
requestAuth: requestAuth,
token: getToken()
})

API виджета предоставляет набор функций и методов для авторизации пользователя в виджете:

ПараметрТипОписание
init
(config: Config) => voidМетод, который используется для инициализации виджета.
Методу init() передается конфигурация виджета:
ПараметрТипОписание
requestAuth
()=> Promise Функция, которую виджет вызывает при авторизации пользователя.
token
string or nullТекущий токен авторизации пользователя. Если на момент инициализации виджета токен неизвестен, передайте значение null.
ПараметрТипОписание
onTokenChange
(token: string/null) => voidМетод для передачи в виджет текущего токена пользователя. При выходе пользователя из системы передайте null.

Как внести изменения

Внесение изменений в настройки реферальной программы

Вы можете внести изменения в действующую реферальную программу:
  • изменить список товаров, которые предоставляются в качестве наград;
  • изменить описания.
Чтобы внести изменения:
  1. Перейдите к созданной реферальной программе.
  2. Нажмите Редактировать.
  1. Обновите тексты или артикулы товаров пользователей.
  2. Нажмите Сохранить.

После сохранения изменений пользователи увидят обновленные условия программы и получат новые награды.

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

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

Внесение изменений в настройки виджета

Вы можете внести изменения в цвета, шрифты и компоненты виджета. Для этого:
  1. Перейдите к настройке виджета.
  2. Внесите необходимые изменения.
  3. Нажмите Опубликовать.
Интерфейс виджета будет обновлен. Если пользователь находится на странице сайта, он увидит изменения в виджете после обновления страницы.

Состояния виджета

Виджет реферальной программы может иметь разные состояния в зависимости от типа пользователя — приглашающий или приглашаемый, статуса авторизации пользователя, выполнения условий программы.

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

Кнопка для открытия виджета:

СостояниеОписаниеДля кого отображаетсяКомпоненты, которые можно редактироватьИзображение
Просмотр деталейПривлечение пользователя участвовать в программе.Авторизованные пользователи, которые еще не участвуют в программе.Цвета фона и текста. Текст кнопки для открытия виджета и текст кнопки просмотра деталей.Widget state 1
Ожидание авторизацииПобуждение пользователя авторизоваться через виджет.Неавторизованные пользователи, которые перешли по реферальной ссылке.Цвета фона и текста. Тексты кнопок.Widget state 2
Ожидание первой покупкиПобуждение пользователя совершить первую покупку.Пользователи, которые перешли по реферальной ссылке и авторизовались на сайте.Цвета фона и текста. Тексты кнопок.Widget state 3
Получение наградыПобуждение пользователя получить награду.Приглашающие пользователи, чьи друзья выполнили условия программы, и они могут получить награду.Цвета фона и текста. Тексты кнопок.Widget state 4
Закрытие виджетаВиджет открыт, кнопка превратилась в значок ×.Авторизованные пользователи, которые открыли детали виджета.Цвета фона и текста. Цвет кнопки.Widget state 5
По умолчаниюВиджет закрыт.Пользователи, которые закрыли виджет.Цвета фона и текста. Текст кнопки открытия виджета.Widget state 6

Страница виджета для приглашающего пользователя:

ОписаниеДля кого отображаетсяКомпоненты, которые можно редактироватьИзображение
  • Детали реферальной программы.
  • Кнопка для отправки реферальной ссылки.
  • Список наград со статусами:
    • Claimed — награда за приглашенного пользователя получена.
    • In progress — приглашенный пользователь авторизовался на сайте, но еще не совершил покупку.
    • Claim — приглашенный пользователь авторизовался на сайте и совершил первую покупку. Приглашающий пользователь может получить награду.
Авторизованный приглашающий пользователь, чей друг перешел по реферальной ссылке и авторизовался на сайте.Цвета фона и текста. Текст виджета, тексты кнопок.Crystal
Раздел частых вопросов.Авторизованный приглашающий пользователь, который нажал кнопку информации о программе.Добавление и удаление блоков с вопросами. Цвета фона и текста. Содержание вопросов и ответов.Crystal

Страница виджета для приглашаемого пользователя:

ОписаниеДля кого отображаетсяКомпоненты, которые можно редактироватьИзображение
Текст виджета призывает совершить покупку на сайте. После совершения покупки пользователю отображается уведомление о получении бонуса.Пользователи, которые перешли по реферальной ссылке и авторизовались.Цвета фона и текста. Текст виджета, тексты кнопок.Crystal
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Последнее обновление: 22 октября 2024

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!