Загрузка платежей

Методы

Для загрузки платежей на сервер MyTracker используйте следующие методы:

• customRevenue и customRevenueBatch для передачи универсального дохода
• googlePlayProductTransaction, googlePlaySubscriptionTransaction и googlePlaySubscriptionToken для передачи in-app платежей и подписок в приложениях Google Play
• appStoreProductTransaction, appStoreSubscriptionTransaction и appStoreSubscriptionReceipt для передачи in-app платежей и подписок в приложениях App Store

Все загруженные данные будут включены в общую статистику и появятся в интерфейсе MyTracker в течение 4 часов

Платежи Google Play

MyTracker может отслеживать in-app платежи и подписки в приложениях Google Play автоматически (подробнее см. раздел Трекинг дохода). Но если автоматического трекинга недостаточно, или с ним возникли проблемы, вы можете загрузить недостающие платежи самостоятельно с помощью S2S API.

Рассмотрим несколько примеров использования методов S2S API:

Пример 1 — Загрузить исторические данные по in-app платежам

Если в MyTracker нет данных о совершённых в приложении платежах, например когда платежи сделаны до подключения MyTracker SDK, используйте метод googlePlayProductTransaction.

Пример 2 — Загрузить исторические данные по подпискам

Если в MyTracker нет данных по подпискам, например, когда подписки оформлены до подключения MyTracker SDK:

1. Загрузите исторические данные с помощью метода googlePlaySubscriptionTransaction.
2. Включите трекинг будущих продлений с помощью метода googlePlaySubscriptionToken.

Пример 3 — Отслеживать действующие подписки

Если MyTracker не отслеживает подписку автоматически, например, когда подписка оформлена до подключения MyTracker SDK:

1. Загрузите исторические данные с помощью метода googlePlaySubscriptionTransaction.
2. Включите трекинг продлений с помощью метода googlePlaySubscriptionToken.

Пример 4 — Загрузить данные после настройки верификации

Если вы не сразу передали ключ верификации в MyTracker и первые платежи не прошли валидацию:

1. Убедитесь, что вы загрузили Google Play credentials в MyTracker.
2. Загрузите недостающие данные по in-app платежам через googlePlayProductTransaction.
3. Загрузите недостающие данные по подпискам через googlePlaySubscriptionTransaction.
4. Включите трекинг подписок с помощью метода googlePlaySubscriptionToken.

Пример 5 — Восстановить данные после сбоя трекинга

Если часть данных по in-app платежам или подпискам потеряна из-за сбитой настройки трекинга, например, в результате неудачного обновления приложения:

1. Загрузите недостающие данные по in-app платежам через googlePlayProductTransaction.
2. Загрузите недостающие данные по подпискам через googlePlaySubscriptionTransaction.
3. Включите трекинг оформленных за это время подписок с помощью метода googlePlaySubscriptionToken.

Повторная передача данных или загрузка уже полученных ранее транзакций не приведёт к ошибке, так как на стороне MyTracker сработает дедупликация

googlePlayProductTransaction

Используйте метод googlePlayProductTransaction, чтобы загрузить сведения по in-app платежам в приложении Google Play.

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

• token — MyTracker отправит запрос на подтверждение in-app платежа в Google Play API. Если платёж корректен, MyTracker отнесёт его к верифицированным платежам, если нет, то платёж будет сохранен как неверифицированный.
• isVerified — MyTracker отнесёт in-app платёж к верифицированным по умолчанию.

Если не передан ни token, ни isVerified или переданы сразу оба эти параметра, то запрос обработан не будет.

Загружать исторические данные по in-app платежам следует в хронологическом порядке, иначе сведения по первым платежам будут искажены

Формат запроса:

https://tracker-s2s.my.com/v1/googlePlayProductTransaction/?idApp=XXX

Обязательные параметры: идентификатор пользователя customUserId и/или один из идентификаторов устройства: instanceId, gaid, androidId, appSetId (транзакции будут привязаны к пользователю и/или к устройству), время события eventTimestamp, а также параметры из таблицы ниже.

* — обязательный параметр.

googlePlaySubscriptionTransaction

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

Загружать исторические данные по подпискам следует в хронологическом порядке, иначе сведения по первым платежам будут искажены

Формат запроса:

https://tracker-s2s.my.com/v1/googlePlaySubscriptionTransaction/?idApp=XXX

Обязательные параметры: идентификатор пользователя customUserId и/или один из идентификаторов устройства: instanceId, gaid, androidId, appSetId (транзакции будут привязаны к пользователю и/или к устройству), время события eventTimestamp, а также параметры из таблицы ниже.

* — обязательный параметр.

googlePlaySubscriptionToken

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

Все будущие платежи по подписке будут привязаны к одному и тому же устройству и пользователю, которые вы укажите в методе

Рекомендуем передавать параметр subscriptionPeriod — период действия подписки. C помощью этого параметра MyTracker сможет рассчитать время последнего продления, и в будущем определять время продлений даже в случае задержки данных со стороны Google Play. Без subscriptionPeriod последнее продление и все дальнейшие будут записываться на момент поступления данных из Google Play.

Формат запроса:

https://tracker-s2s.my.com/v1/googlePlaySubscriptionToken/?idApp=XXX

Обязательные параметры: идентификатор пользователя customUserId и/или один из идентификаторов устройства: instanceId, gaid, androidId, appSetId (транзакции будут привязаны к пользователю и/или к устройству), а также параметры из таблицы ниже.

* — обязательный параметр.

Платежи App Store

MyTracker может отслеживать in-app платежи и подписки в приложениях App Store автоматически (подробнее см. раздел Трекинг дохода). Но если автоматического трекинга недостаточно, или с ним возникли проблемы, вы можете загрузить недостающие платежи самостоятельно с помощью S2S API.

Рассмотрим несколько примеров использования методов S2S API:

Пример 1 — Загрузить исторические данные по in-app платежам

Если в MyTracker нет данных о совершённых в приложении платежах, например, когда платежи сделаны до подключения MyTracker SDK, используйте метод appStoreProductTransaction.

Пример 2 — Загрузить исторические данные по подпискам

Если в MyTracker нет данных по подпискам, например, когда подписки оформлены до подключения MyTracker SDK:

1. Загрузите исторические данные с помощью метода appStoreSubscriptionTransaction.
2. Передайте чек по действующим подпискам с помощью метода appStoreSubscriptionReceipt.

Пример 3 — Отслеживать действующие подписки

Если MyTracker не отслеживает действующую подписку автоматически, например, когда подписка оформлена до подключения MyTracker SDK, загрузите сведения по подписке с помощью метода appStoreSubscriptionReceipt.

Пример 4 — Загрузить данные после настройки верификации

Если вы не сразу передали ключ верификации в MyTracker и в результате пропустили часть продлений по подпискам:

1. Убедитесь, что вы загрузили App Store credentials в MyTracker.
2. Загрузите недостающие данные по подпискам через appStoreSubscriptionTransaction.
3. Включите трекинг подписок с помощью метода appStoreSubscriptionReceipt.

Пример 5 — Восстановить данные после сбоя трекинга

Если часть данных по in-app платежам или подпискам потеряна из-за сбитой настройки трекинга, например, в результате неудачного обновления приложения:

1. Загрузите недостающие данные по in-app платежам через appStoreProductTransaction.
2. Загрузите недостающие данные по подпискам через appStoreSubscriptionTransaction.
3. Включите трекинг оформленных за это время подписок с помощью метода appStoreSubscriptionReceipt.

Повторная передача данных или загрузка уже полученных ранее транзакций не приведёт к ошибке, так как на стороне MyTracker сработает дедупликация

appStoreProductTransaction

Метод appStoreProductTransaction в стадии бета-тестирования. При возникновении вопросов, пожалуйста, обратитесь в нашу службу поддержки

Используйте метод appStoreProductTransaction, чтобы загрузить сведения по in-app платежам в приложении App Store. Все загруженные платежи будут сохранены в MyTracker как верифицированные.

Загружать исторические данные по in-app платежам следует в хронологическом порядке, иначе сведения по первым платежам будут искажены

Формат запроса:

https://tracker-s2s.my.com/v1/appStoreProductTransaction/?idApp=XXX

Обязательные параметры: идентификатор пользователя customUserId и/или один из идентификаторов устройства: instanceId, idfa, iosVendorId(транзакции будут привязаны к пользователю и/или к устройству), время события eventTimestamp, а также параметры из таблицы ниже.

* — обязательный параметр.

appStoreSubscriptionTransaction

Метод appStoreSubscriptionTransaction в стадии бета-тестирования. При возникновении вопросов, пожалуйста, обратитесь в нашу службу поддержки

Используйте метод appStoreSubscriptionTransaction, чтобы загрузить сведения об отдельных транзакциях по подпискам App Store.

Загружать исторические данные по подпискам следует в хронологическом порядке, иначе сведения по первым платежам будут искажены

Формат запроса:

https://tracker-s2s.my.com/v1/appStoreSubscriptionTransaction/?idApp=XXX

Обязательные параметры: идентификатор пользователя customUserId и/или один из идентификаторов устройства: instanceId, idfa, iosVendorId (транзакции будут привязаны к пользователю и/или к устройству), время события eventTimestamp, а также параметры из таблицы ниже.

* — обязательный параметр.

appStoreSubscriptionReceipt

Метод appStoreSubscriptionReceipt в стадии бета-тестирования. При возникновении вопросов, пожалуйста, обратитесь в нашу службу поддержки

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

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

Формат запроса:

https://tracker-s2s.my.com/v1/appStoreSubscriptionReceipt/?idApp=XXX

Обязательные параметры: идентификатор пользователя customUserId и/или один из идентификаторов устройства:instanceId, idfa, iosVendorId (транзакции будут привязаны к пользователю и/или к устройству), а также параметры из таблицы ниже.

* — обязательный параметр.

Универсальный доход

Универсальный доход — это любые финансовые поступления, которые не могут быть переданы в MyTracker как доход от рекламы, in-app платёж или платёж по подписке. Например, это могут быть офлайн-платежи, покупки через сервис VK Pay, платежи из магазинов AppGallery и RuStore. То есть любой доход, для которого пока не предусмотрен специальный механизм сбора данных.

Передать информацию по универсальным доходам можно только через S2S API с помощью методов customRevenue и customRevenueBatch.

customRevenue

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

Формат запроса:

https://tracker-s2s.my.com/v1/customRevenue/?idApp=XXX

Обязательные параметры: идентификатор пользователя customUserId и/или один из идентификаторов устройства: instanceId, lvid, gaid, androidId, idfa, iosVendorId (транзакции будут привязаны к пользователю и/или к устройству), eventTimestamp, а также параметры из таблицы ниже.

* — обязательный параметр.

customRevenueBatch

Используйте метод customRevenueBatch для пакетной передачи данных по доходу. Метод аналогичен customRevenue, но позволяет передать сразу несколько платёжных транзакций.

Формат запроса:

https://tracker-s2s.my.com/v1/customRevenueBatch/?idApp=XXX

Обязательные параметры:

Параметры

Все параметры передаются в теле POST запроса в формате json.

Ограничение на максимальный размер загружаемых данных — 10Кб.

Пример запроса

curl https://tracker-s2s.my.com/v1/customRevenue/?idApp=666 \
–k –X POST --header "Authorization: aaaaaAAAaaa01aaaaaaa1aaAAA11a" \
-d '{"customUserId": "1", "idTransaction": "order1234",
"currency": "USD", "total": 1.99, "eventTimestamp": "1580213208",
"instanceId": "00000000-0000-0000-0000-000000000000"}'

Коды ответов