Интеграция Xsolla с AppsFlyer

Краткий обзор: Xsolla, интегрированный партнёр AppsFlyer, является технический партнер в сфере игровой коммерции, специализирующийся на обработке платежей вне традиционных платформ приложений. Интеграция между Xsolla и AppsFlyer позволяет Xsolla автоматизировать покупки в веб-магазине и отправлять доходы в AppsFlyer, чтобы получать полную информацию о ROAS и LTV игр, включая покупки, совершённые в веб-магазине Xsolla.

 Важно!

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

Типы интеграции

Существует два возможных метода интеграции с Xsolla:

  • Интеграция технического партнёра: эта интеграция позволяет Xsolla отправлять покупки в веб-магазине и доход как внутренние события приложения, тем самым повышая ROAS и LTV кампаний в мобильном приложении помимо стандартных покупок в магазине приложений.
  • Интеграции веб-SDK PBA: такая интеграция позволяет Xsolla отправлять покупки в веб-магазине и доход в виде веб-событий, что позволяет AppsFlyer измерять эффективность веб-кампаний, направляя пользователей игр непосредственно в веб-магазин.

Необходимые условия: 

  • Перед настройкой интеграции обязательно свяжитесь с партнёром и откройте у него аккаунт.
  • Чтобы интеграция функционировала правильно, обязательно передайте идентификатор пользователя клиента (CUID) в AppsFlyer и убедитесь, что он соответствует идентификатору пользователя, переданному Xsolla. Такая синхронизация позволяет пользователям входить в веб-магазин Xsolla и обеспечивает точную отправку данных пользователя в AppsFlyer.

Настройка интеграции с технологическим партнёром

Активация и редактирование интеграции

  1. Чтобы активировать: В AppsFlyer в боковом меню выберите Сотрудничество> Маркетплейс партнеров.
    Чтобы изменить: В AppsFlyer в боковом меню выберите Сотрудничество> Активные интеграции.
  2. Найдите партнера и выберите его.
  3. Нажмите Настроить интеграцию. Вы будете перенаправлены на страницу настройки интеграции.
  4. На вкладке Интеграция выберите приложение для интеграции и нажмите Активировать партнера.
    Примечание: Этот переключатель должен быть включен (активирован) всё время, пока вы работаете с этим партнёром.
  5. Завершите настройку, используя соответствующие вкладки, как описано ниже.

Окно настройки использует только вкладку Интеграция.

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

Вкладка «Интеграция»

Активация партнёра

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

Расширенные настройки конфиденциальности

Для приложений iOS появляется переключатель Режим расширенной конфиденциальности. Когда он включен, он ограничивает предоставление партнёру идентификаторов пользователей. Обратите внимание, что когда в настройках приложения включен переключатель Агрегированная расширенная конфиденциальность, то переключатель Расширенная конфиденциальность (для iOS 14.5+ и выше) включен по умолчанию и заблокирован. 

Постбэки по умолчанию

AppsFlyer отправляет постбэки в Xsolla после установки приложения пользователями. В этом разделе можно определить эти постбэки.

  • Off(Выкл.): постбэки об установках не отправляются в Xsolla.
    Примечание: Интеграция Xsolla с AppsFlyer не требует отправки постбэков об установке. Поэтому рекомендуется установить значение Off (Выкл.).
  • Все медиа-источники, включая органические: постбэки об установках отправляются для событий, атрибутированных любому партнёру, а также для органических событий.

default_postbacks.png

Постбэки по внутренним событиям приложения

В этом разделе можно настроить отправку партнёру постбэков о своих событиях в AppsFlyer. 

xsolla-af-login-3.jpg

  1. Активируйте Постбэки по внутренним событиям приложения.
  2. Нажмите Добавить событие, чтобы добавить событие SDK или между серверами в список.
  3. Заполните следующие параметры:
    Название параметра Описание
    Событие AppsFlyer

    Название события, полученное AppsFlyer из SDK, интегрированного в приложение, или из межсерверного события.

    Примечание:

    • Для Xsolla обязательно добавьте событие af_login или любое другое событие, которое представляет собой вход пользователя в мобильное приложение, как показано на скриншоте выше.
    • Xsolla рекомендует избегать отправки событий, которые происходят слишком часто, и не включать CUID (например, af_app_opened), поскольку это может помешать работе интеграции.
    сопоставлено с событием партнёра Введите соответствующее название события, которое нужно отправить в Xsolla. В Xsolla гибкие правила наименования, поэтому в этом поле можно использовать любое название.
    для пользователей из Выберите Все медиа-источники, включая органические, чтобы отправлять постбэки для событий, атрибутированных любому партнёру, а также для органических событий.
    включая
    • Нет значений и дохода Отправьте только само событие без каких-либо параметров (ценностей, значений или выручки).
    • Ценности, значения и отсутствие выручки: отправляются все параметры, кроме значения дохода.
    • Значение и доход: отправляются все параметры события, включая значение дохода (если оно есть в событии).
    Примечание: Интеграция Xsolla с AppsFlyer не требует отправки значений или дохода. Поэтому применим любой выбранный вариант. 
  4. Нажмите Сохранить интеграцию.

Вкладка «Ссылки атрибуции»

Ссылки атрибуции недоступны для Xsolla.

Вкладка «Затраты»

Данные о затратах не поддерживаются при интеграции с Xsolla.

Вкладка «Доходы от рекламы»

Данные о доходах от рекламы не поддерживаются при интеграции с Xsolla.

Вкладка «Разрешения»

Разрешения недоступны для Xsolla.

Настройка интеграции веб-SDK PBA

Эта интеграция позволяет представлять текущие данные LTV (пожизненной ценности) и аналитические данные для анализа эффективности приложения на дэшборде PBA.

См. инструкции по настройке интеграции:

  1. В AppsFlyer: Добавьте приложение Xsolla. Выберите в качестве платформы Веб (PBA) и введите следующие данные:
    • Используйте домен вашего Веб-магазина в качестве URL-адреса веб-приложения. Например, если ваш домен в веб-магазине — www.webshop.com, используйте его в качестве URL-адреса вашего веб-приложения.
    • В качестве имени приложения можно использовать любое значение.
  2. В AppsFlyer: Добавьте пакет Xsolla со следующей информацией:
    1.  
      1. Введите любое наименование в качестве названия пакета.
      2. Выберите созданное на предыдущем этапе веб-приложение в качестве веб-приложения пакета.
  3. In Xsolla: Подключите AppsFlyer к аккаунту издателя Xsolla:
    1. Откройте свой проект в своём аккаунте издателя.
    2. Выберите свой сайт и нажмите Настроить.
    3. На вкладке Настройки сайта перейдите в раздел Приложения.
    4. В блоке AppsFlyer нажмите «Подключиться».
      xsolla-connect.jpg
    5. В поле Ключ разработчика AppsFlyer введите ключ веб-разработчика AppsFlyer. Смотрите ниже, как найти этот ключ в AppsFlyer.
    6. Нажмите Подключить.

Как найти ключ веб-разработчика в AppsFlyer

  1. На странице Мои приложения нажмите Посмотреть пакеты бренда.
  2. Нажмите значок «Копировать» в строке пакета Xsolla.

xsolla-brand-bundle2.jpg

Идентификация событий Xsolla в AppsFlyer

Интеграция с технологическими партнерами (S2S):

Xsolla отправляет AppsFlyer два внутренних события приложения:

  • xsolla-billing-payment – покупка товара
  • xsolla-billing-return – возврат купленного товара

Оба события относятся к внутренним событиям мобильного приложения.

Интеграция веб-SDK:

Xsolla отправляет AppsFlyer множество веб-событий, адаптированных под конкретную деятельность рекламодателя. Самый важный из них – это «ПОКУПКА», в котором содержится доход.
Веб-события Xsolla будут отображаться в отчетах PBA по веб-атрибуции и отчётах DataLocker о сырых данных по «веб-событиям».

Характеристики и ограничения

Поддержка ПК/ консолей – интеграция AppsFlyer с Xsolla на данном этапе не поддерживает приложения для ПК/ консолей