Партнерская сеть / Как настроить программу с creator tag
 На главную

Партнерская сеть

  • Руководство по интеграции

  • Возможности

  • Инструкции

  • Расширения

  • Справочники

  • Как настроить программу с creator tag

    Как это работает

    Creator tag — это уникальный код, который игрок может получить при просмотре онлайн-трансляций на YouTube или Twitch или в других форматах/сервисах и использовать во время внутриигровых покупок, чтобы поддержать своего любимого инфлюенсера. Решение позволяет вам построить доверительные отношения с инфлюенсерами и увеличить свой доход за счет атрибуции (отслеживания) всех внутриигровых покупок.

    Сценарий игрока

    1. Игрок копирует creator tag или переходит по ссылке для его подключения из сервиса, где инфлюенсер поделился своим кодом. Инфлюенсер может использовать следующие сервисы:
      • Twitch;
      • YouTube;
      • Facebook Gaming;
      • прочие социальные сети.
    2. Игрок вводит creator tag в поле на странице, где вы реализовали его подключение. Если игрок переходит по ссылке, creator tag применяется автоматически.

    Монетизация

    Вы получаете доход со всех внутриигровых покупок. С каждой покупки вычитается доля прибыли инфлюенсера, чей creator tag был применен при ее совершении.

    Note
    Игровая платформа и платежная система могут взимать дополнительную комиссию с платежей.

    Для кого подходит

    Для партнеров, у которых есть игра:

    • с ожидаемым ежемесячным доходом не менее $20 000;
    • с товарами, доступными для покупки только внутри игры.

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

    Настройка программы с creator tag

    Чтобы настроить программу с creator tag:

    1. Отправьте заявку на am@xsolla.com (или на bizdev@xsolla.com, если вы впервые интегрируете продукт Иксоллы) и дождитесь ее согласования. Укажите в заявке следующую информацию:
      • название игры;
      • жанр;
      • разработчик (опционально);
      • издатель (опционально);
      • официальный сайт игры;
      • описание;
      • Steam App ID (опционально);
      • дата релиза, если игра еще не опубликована (опционально);
      • ссылка на промоматериалы (опционально);
      • бизнес-модель:
        • премиум;
        • free-to-play.
      • игровая платформа:
        • PC;
        • Steam;
        • мобильная;
        • веб-платформа.
      • Период участия в программе.
      • Процент Revenue share.
      • Дату окончания действия Revenue sharing. Это последний день, когда инфлюенсер может получить долю прибыли от продаж.
      • Список инфлюенсеров. Для каждого укажите: email-адрес, канал в социальной сети и creator tag. При выборе инфлюенсеров учитывайте следующие ограничения:
        • Вывод средств с баланса доступен только для инфлюенсеров старше 18 лет.
        • Иксолла не работает с инфлюенсерами, чьи банковские аккаунты зарегистрированы в странах, которые являются объектами санкций США.

    1. Реализуйте механизм подключения creator tag игроком одним из следующих способов:
      • При переходе по ссылке. В этом случае значение будет подгружаться в поле для ввода creator tag автоматически.
      • С помощью ручного ввода.

    1. Определите, где будет находиться страница с полем для ввода creator tag:
      • в интерфейсе игры;
      • на рекламном сайте игры;
      • в платежном интерфейсе каждый раз при оплате покупки.

    Note
    Рекомендуется реализовать подключение creator tag в интерфейсе игры, чтобы код автоматически применялся к каждой покупке игрока.

    1. Отправьте на am@xsolla.com ссылку на страницу, на которой выполняется подключение creator tag (если механизм реализован в интерфейсе или на рекламном сайте игры).
    2. Реализуйте в игре механизмы привязки creator tag к покупкам игроков, которые его подключили, и отслеживания этих покупок.

    Управление программой с creator tag

    Чтобы эффективно управлять программой с creator tag:

    1. Регулярно передавайте информацию о покупках Иксолле с помощью метода Создание транзакций. Рекомендуемая частота передачи данных — один раз в сутки.

    Note
    В случае оформления возврата покупки, к которой применен creator tag, передавайте эту информацию Иксолле с помощью метода Отмена транзакций.

    1. Добавляйте в программу новых инфлюенсеров (опционально).

    Note
    Если вы добавляете инфлюенсеров через Иксоллу, регулярно подгружайте их список с помощью метода Получение инфлюенсеров с creator tag. Рекомендуемая частота получения данных — один раз в сутки.

    1. С помощью метода Передача статистики по creator tag передавайте Иксолле информацию о статистике по игрокам, которые подключили creator tag инфлюенсера (опционально).

    Добавление инфлюенсеров в программу

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

    Самостоятельное добавление

    Чтобы самостоятельно добавить инфлюенсеров в программу:

    1. Последовательно реализуйте вызов методов Создание creator tag для инфлюенсера и Добавление инфлюенсера в программу.
    2. Чтобы пригласить инфлюенсера в программу, отправьте сообщение на influencer@xsolla.com, в котором укажите email, канал в социальной сети и creator tag инфлюенсера, используемый в методе Создание creator tag для инфлюенсера.

    Добавление через Иксоллу

    Чтобы добавить инфлюенсера в программу через Иксоллу, отправьте сообщение на influencer@xsolla.com, в котором укажите email, канал в социальной сети и creator tag, который вы хотите присвоить инфлюенсеру.

    Методы по работе с creator tag

    Получение инфлюенсеров с creator tag

    Получает список инфлюенсеров в программе, которые подключили creator tag.

    ПараметрТипОписание
    limit
    integerЧисло инфлюенсеров в списке (по умолчанию: 20, максимально: 100).
    offset
    integerЗначение, на которое происходит смещение при подгрузке инфлюенсеров в списке (по умолчанию: 0).
    Copy
    Full screen
    Small screen
    Запрос
    GET https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/deals?limit=3&offset=0 HTTP/1.1
    Ответ
    {
      "items": [
        {
          "creator_tag": "creatorOne",
          "revenue_share_percent": 5
        },
        {
          "creator_tag": "creatorTwo",
          "revenue_share_percent": 10
        },
        {
          "creator_tag": "creatorThree",
          "revenue_share_percent": 50
        }
      ],
      "total_count": 32
    }

    Создание транзакций

    Создает/обновляет транзакции, к которым применялся creator tag. В теле запроса передается массив следующих объектов:

    ПараметрТипОписание
    creator_tag
    stringУникальный код инфлюенсера в программе. Обязательный.
    transaction_id
    stringID транзакции. Обязательный.
    transaction_currency
    stringКод валюты, в которой совершена транзакция. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217. Обязательный.
    transaction_value
    numberСумма транзакции. Обязательный.
    transaction_date
    stringДата транзакции в формате YYYY-MM-DD’T’HH:MM:SS. Обязательный.
    platform_id
    stringПлатформа, на которой совершена транзакция. Обязательный.
    user_id
    stringID игрока. Обязательный.
    item_id
    stringID купленного товара. Обязательный.
    item_name
    stringНазвание купленного товара. Обязательный.
    Copy
    Full screen
    Small screen
    Запрос
    PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/transactions HTTP/1.1
    
    X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
    Content-Type: application/json
    
    [
      {
        "transaction_id": "123456789",
        "creator_tag": "creatorOne",
        "platform_id": "steam",
        "user_id": "0123456",
        "transaction_date": "2020-04-10T06:06:24.830Z",
        "item_id": "GAME_sku_1",
        "item_name": "hk416",
        "transaction_currency_code": "USD",
        "transaction_value": 5
      },
      {
        "transaction_id": "123456788",
        "creator_tag": "creatorOne",
        "platform_id": "steam",
        "transaction_date": "2020-04-10T06:06:24.830Z",
        "item_id": "GAME_sku_2",
        "item_name": "hk416",
        "transaction_currency_code": "EUR",
        "transaction_value": 10
      },
      {
        "transaction_id": "123456781",
        "creator_tag": "creatorOne",
        "platform_id": "xbox",
        "transaction_date": "2020-04-10T06:06:24.830Z",
        "item_id": "GAME_sku_1",
        "item_name": "hk416",
        "transaction_currency_code": "USD",
        "transaction_value": 3
      }
    ]

    Отмена транзакций

    Отменяет транзакции, к которым применялся creator tag. В теле запроса передается массив следующих объектов:

    ПараметрТипОписание
    transaction_id
    stringID транзакции, которую требуется отменить. Обязательный.
    refund_id
    stringВнешний ID возврата платежа.
    reason
    stringПричина возврата платежа.
    refund_date
    stringДата возврата платежа в формате YYYY-MM-DD’T’HH:MM:SS. Обязательный.
    Copy
    Full screen
    Small screen
    Запрос
    PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/transactions HTTP/1.1
    
    X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
    Content-Type: application/json
    
    [
      {
        "transaction_id": "123456789",
        "creator_tag": "creatorOne",
        "platform_id": "steam",
        "user_id": "0123456",
        "transaction_date": "2020-04-10T06:06:24.830Z",
        "item_id": "GAME_sku_1",
        "item_name": "hk416",
        "transaction_currency_code": "USD",
        "transaction_value": 5
      },
      {
        "transaction_id": "123456788",
        "creator_tag": "creatorOne",
        "platform_id": "steam",
        "transaction_date": "2020-04-10T06:06:24.830Z",
        "item_id": "GAME_sku_2",
        "item_name": "hk416",
        "transaction_currency_code": "EUR",
        "transaction_value": 10
      },
      {
        "transaction_id": "123456781",
        "creator_tag": "creatorOne",
        "platform_id": "xbox",
        "transaction_date": "2020-04-10T06:06:24.830Z",
        "item_id": "GAME_sku_1",
        "item_name": "hk416",
        "transaction_currency_code": "USD",
        "transaction_value": 3
      }
    ]

    Передача статистики по creator tag

    Позволяет передавать статистику по подключению creator tag инфлюенсера (по дням). Эта информация будет размещаться в разделе Статистика в Кабинете инфлюенсера. В теле запроса передается массив следующих объектов:

    ПараметрТипОписание
    date
    stringДата передачи статистики по creator в формате YYYY-MM-DD. Обязательный.
    creator_tag
    stringУникальный код инфлюенсера в программе. Обязательный.
    new_supporters
    integerЧисло новых игроков, которые использовали creator tag инфлюенсера. Обязательный.
    total_supporters
    integerЧисло всех игроков, которые использовали creator tag инфлюенсера. Обязательный.
    Copy
    Full screen
    Small screen
    Запрос
    PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/supporters HTTP/1.1
    
    X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
    Content-Type: application/json
    
    [
      {
        "date": "2020-04-10",
        "creator_tag": "creatorOne",
        "new_supporters": 125,
        "total_supporters": 35900
      },
      {
        "date": "2020-04-10",
        "creator_tag": "creatorTwo",
        "new_supporters": 123,
        "total_supporters": 34567
      }
    ]

    Создание creator tag для инфлюенсера

    Позволяет создавать creator tag для новых инфлюенсеров в программе. В теле запроса передается массив следующих объектов:

    ПараметрТипОписание
    creator_tag
    stringУникальный код инфлюенсера в программе. Обязательный.
    creator_email
    stringEmail инфлюенсера. Обязательный.
    creator_channels
    array of stringsСсылка на канал инфлюенсера. Каналов может быть несколько. Обязательный.
    Copy
    Full screen
    Small screen
    Запрос
    PUT https://influencer.xsolla.com/api/partner/v2/tags HTTP/1.1
    
    X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
    Content-Type: application/json
    
    {
      "creator_tag": "creatorOne",
      "creator_email": "influencer@example.com",
      "creator_channels": [
        "https://www.twitch.tv/creatorOne"
      ]
    }

    Добавление инфлюенсера в программу

    Позволяет добавлять нового инфлюенсера в программу. В теле запроса передается массив следующих объектов:

    ПараметрТипОписание
    creator_tag
    stringУникальный код инфлюенсера в программе. Обязательный.
    revenue_share
    integerПроцент прибыли, который получает инфлюенсер за каждую покупку, к которой применялся его creator tag. Обязательный.
    Copy
    Full screen
    Small screen
    Запрос
    PUT https://influencer.xsolla.com/api/partner/v2/tags HTTP/1.1
    
    X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
    Content-Type: application/json
    
    {
      "creator_tag": "creatorOne",
      "creator_email": "influencer@example.com",
      "creator_channels": [
        "https://www.twitch.tv/creatorOne"
      ]
    }

    Была ли статья полезна?
    Спасибо!
    Что может сделать страницу еще лучше? Сообщение
    Жаль, что так произошло
    Расскажите, почему статья не была полезна. Сообщение
    Спасибо за обратную связь!
    Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
    Оценить страницу
    Оценить страницу
    Что может сделать страницу еще лучше?

    В другой раз

    Спасибо за обратную связь!
    Последнее обновление: 20 июля 2021

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

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