Послеустановочная аналитика — Сторонние службы

Последнее обновление:

Для более полного анализа данных о покупках внутри приложений (IAP) со сравнением между платформами и сетями можно также настроить интеграцию «сервер-сервер» для импорта информации о покупках внутри приложений от сторонних отслеживающих служб. После интеграции вы сможете просматривать сторонние данные на панели пользователя Chartboost.

Используете как Chartboost SDK, так и стороннюю интеграцию?

По умолчанию, проще всего продолжить принимать данные SDK для событий ПУА и не обращать внимания на события ПУА «сервер-сервер». Можете обратиться в поддержку или к своему менеджеру учетной записи, чтобы узнать, как переключиться от SDK к сторонней интеграции, после чего мы начнем принимать данные о событиях «сервер-сервер», игнорируя события Chartboost SDK. Это позволит избежать дублирования событий и сохранить единственный канал входящих данных. Если нужно, наша служба поддержки всегда поможет вернуть приложения к прежней конфигурации.

Содержание


Указания для Adjust

1. Откройте приложение, для которого хотите передавать данные о IAP в Chartboost.

2. Нажмите Settings, затем Partner Setup

3. В разделе Networks выберите Chartboost

4. Установите переключатель Revenue Forwarding в положение ON, а Attributed Only – в положение OFF.  Parameter Forwarding тоже лучше оставить отключенным, если вы не намерены получать значения Event Label от Adjust SDK.

5. Укажите "purchase" в поле EVENT LABEL для всех событий покупки внутри приложения, которые вы отслеживаете через Adjust, в разделе Chartboost Event Linking.  Оставьте поля EVENT FIELD, MAIN LEVEL и SUB LEVEL пустыми.

Частые вопросы об Adjust

При обратной передаче данных о покупках внутри приложений в Chartboost, передаются ли автоматически те поля, которые показаны в разделе "Event Linking" на панели Adjust?

Нет, в Chartboost передается только Event Label (как "product_id"). 

Для чего предназначены текстовые поля справа от названия каждого события?

Добавляйте в эти поля значения событий; при передаче этих событий в Chartboost они сохраняются в текстовых полях как числовые значения событий.

Есть ли ограничения на кол-во событий, которые можно перечислить в разделе "Events Linking"?

Нет. Это прокручиваемое окно, и вы можете добавить туда все события покупок, которые уже отслеживаете с помощью Adjust.


Указания для AppsFlyer

1. Войдите на панель управления приложением AppsFlyer и нажмите слева пункт Media Source Configuration

2. Найдите и нажмите Chartboost S2S, затем перейдите на вкладку In App Events

3. Заполните раздел Send In-App Events to Chartboost, как показано ниже, и добавьте ид. своего приложения Chartboost в поле chartboost_app_id.

4. Кроме того, вам понадобится обратиться в службу поддержки за токеном, который следует ввести в поле Chartboost Event Tag:

Примечание: сейчас AppsFlyer поддерживает только отправку в Chartboost событий покупок.  В будущем появится поддержка отслеживания уровней и событий.


Указания для Apsalar

Чтобы получать IAP-данные от Apsalar, нужно создать новую обратную передачу (Setup > Attribution Tracking > Create New Postback) со следующими параметрами:

  • Postback Recipient: Chartboost
  • Application: укажите приложение
  • Event Type: Custom event (затем выберите в раскрывающемся списке конкретное событие выручки)
  • Postback Status: Active, begin sending immediately
  • Attribution Rules: Send all events from all sources

Кроме того, вам нужно указать ид. приложения в Chartboost, токен (обратитесь в службу поддержки, если у вас еще его нет) и ключ, идентифицирующий названия продуктов IAP; эти данные вносятся в три поля раздела Preview:


Указания для Kochava

Указания об обратной передаче событий можно найти в центре технической поддержки Kochava.


Указания для TUNE

  • Откройте панель конфигурации Chartboost на вкладке Integrated Partners.
  • Выберите Postbacks и нажмите Add Postback URL.

 

 

  • Найдите Chartboost в разделе Advertising Partner Postback Template.
  • В разделе Chartboost Postback Template выберите значение iOS or Android в раскрывающемся списке Platform.
  • Выберите Chartboost IAP Postback | purchase | All в раскрывающемся меню Postback Template.
  • Добавьте ид. и подпись своего приложения в Chartboost и сохраните настройки.

 

 


Другие сторонние службы

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

Сторонние ПУА-вызовы «сервер-сервер» содержат информацию о покупках внутри приложения и токен API для проверки запроса (обратитесь к нам, чтобы получить свой токен):

{

    "app_id": "54ecc0535beacdc1e1eff778"
    "ifa": "8c2d20ef2f4248209f65b35e3c398731"
    "iap": {
        "product_id": "com.sample.gems.001"
"currency": "EUR", "price": 3.99, "localized_description": "TheFirstGemsPack", "localized_title": "GemsPack" } }

Ниже приводится информация о самом вызове «сервер-сервер»; чтобы получить свой токен API, обратитесь к нам.

Подробности ПУА-запроса «сервер-сервер»

Метод

POST

Конечная точка

https://live.chartboost.com

Путь

/event_service/v3/track

Заголовки

(учтите, что заголовки содержат информацию для проверки подлинности)

Имя заголовка Пример Описание
X-Chartboost-Token 2782f24948b6dff2551ff321f70266c415e0d251 Ваш токен API
X-Chartboost-Signature 173e6aeff28e4b76b488d5acf49ed8ebb8e95559 О генерации см. этот пункт. Это НЕ ТО ЖЕ САМОЕ, что подпись приложения в Chartboost!

Тело JSON: параметры объекта покупки внутри приложения

Параметры Приложения iOS Приложения Android Пример Описание
currency Обязательное Обязательное "USD" Трехбуквенный код валюты ISO 4217
localized_description Необязательное Необязательное "Небольшой пакет с монетами" Описание предмета на языке игрока
price Обязательное Обязательное 0.99 Цена предмета в валюте, указанной в параметре currency
localized_title Необязательное Необязательное "Малый пакет с монетами" Название предмета на языке игрока
product_id Обязательное Обязательное "com.app.exampleapp.1234" Код товара (SKU)

Тело JSON: параметры запроса

Параметры Приложения iOS Приложения Android Пример Описание
app_id
Обязательное Обязательное "54ecc0535b1acdc1e1eff778" Ид. приложения Chartboost (можно найти на панели пользователя Chartboost) 
ifa Обязательное Нет "61109b4c0f164fbc82ec5475313ae000" (32 знака; допустимы дефисы и любой регистр) Идентификатор для рекламы
gaid Нет Обязательное "38400000-8cf0-11bd-b23e-10b96e40000d" (32 знака + 4 дефиса) Ид. рекламы Google Services (только для Android)
uuid Нет Необязательное (если не передан GAID либо если приложение Amazon) "358414046356276" Для устаревших идентификаторов Android либо игр Amazon
iap Обязательное Обязательное   JSON c подробностями о покупке внутри приложения; см. ниже раздел «Покупки внутри приложения»

Открытый ключ / «Секрет разработчика» (только Google Play/Amazon)

Если вы настраиваете ПУА «сервер-сервер» для игр на Google Play или Amazon Appstore, то вам также понадобится добавить открытый ключ своего приложения или, соответственно, свой ключ «Секрет разработчика» для Amazon в поле на странице «Изменить приложение» для данной игры:

Построение запроса

Начните с конечной точки:

https://live.chartboost.com/event_service/v3/track

Добавьте заголовки и параметры в тело JSON:

{

    "app_id": "54ecc0535b1acdc1e1eff778"
    "ifa": "61109b4c0f164fbc82ec5475313ae000"
    "iap": {
        "product_id": "com.sample.gems.001"
"currency": "EUR", "price": 3.99, "localized_description": "TheFirstGemsPack", "localized_title": "GemsPack" } }

Теперь все готово – успешные запросы получат: {"status":200,"message":"Success"}.

Если вызов получает HTTP-код ошибки «500», то вашему серверу следует повторить попытку вызова «сервер-сервер», но позднее – скажем, через 2 секунды, потом через 4, 8, 16 секунд и так далее, пока вызов не окажется успешным.