Отправка In-App покупок на Android

Для SDK AppMetrica версии 4.0 и выше доступен автоматический сбор данных о покупках внутри приложения. Для включения и выключения автосбора используется метод sdk withRevenueAutoTrackingEnabled.

Тестирование и ручная отправка информации о покупках

В AppMetrica нет возможности сегментировать Revenue на "тестовые" и "не тестовые". Если для отладки покупок вы используете основной API key, то тестовые покупки будут попадать в общую статистику. Поэтому, чтобы отладить отправку Revenue, используйте отправку статистики на дополнительный API key с помощью репортера. Подробнее о работе репортера в разделе Примеры использования.

Шаг 1. Создайте тестовое приложение в AppMetrica

Заполните параметры приложения: ссылка в магазине приложений (если приложение еще не опубликовано — оставьте поле пустым), название, категория, часовой пояс для построения отчетов.

Чтобы добавить еще одно приложение, нажмите кнопку Добавить приложение в выпадающем списке в интерфейсе AppMetrica.

Шаг 2. (Опционально) Включите валидацию

Для валидации покупок на Android используется локальная валидация с помощью публичного ключа.

Чтобы включить валидацию, создайте публичный ключ и укажите его в настройках:

1. В интерфейсе Google получите license key. Подробнее в документации Google.
2. В интерфейсе AppMetrica перейдите в настройки приложения из меню слева.
3. Перейдите на вкладку Revenue.
4. В блоке Валидация покупок для Google Play укажите полученный license key.
5. Нажмите Включить валидацию.

Шаг 3. Протестируйте отправку Revenue

Ниже описаны этапы отправки Revenue на дополнительный API key:

void handlePurchase(Purchase purchase) {
    ...
    // Creating the Revenue.Receipt instance.
    // It is used for checking purchases in Google Play.
    Revenue.Receipt revenueReceipt = Revenue.Receipt.newBuilder()
            .withData(purchase.getOriginalJson())
            .withSignature(purchase.getSignature())
            .build();
    // Creating the Revenue instance.
    Revenue revenue = Revenue.newBuilder(99000000, Currency.getInstance("RUB"))
            .withProductID("com.yandex.service.299")
            .withQuantity(2)
            .withReceipt(revenueReceipt)
            .withPayload("{\"source\":\"Google Play\"}")
            .build();
    // Sending the Revenue instance using reporter.
    AppMetrica.getReporter(getApplicationContext(), "Testing API key").reportRevenue(revenue);
}

// Creating the Revenue instance.
Revenue revenue = Revenue.newBuilder(99000000, Currency.getInstance("RUB"))
        .withProductID("com.yandex.service.299")
        .withQuantity(2)
        // Passing the OrderID parameter in the .withPayload(String payload) method to group purchases.
        .withPayload("{\"OrderID\":\"Identifier\", \"source\":\"Google Play\"}")
        .build();
// Sending the Revenue instance using reporter.
AppMetrica.getReporter(getApplicationContext(), "Testing API key").reportRevenue(revenue);

Шаг 4. Убедитесь, что покупки отображаются в отчетах

1. Совершите тестовые покупки в приложении.

2. Убедитесь, что в отчете Revenue количество покупок и общая выручка совпадает с отправленными.

   Информация в отчете может отсутствовать, если:

   • валидация включена и покупка не прошла валидацию;
   • информация о покупке не отправилась.

3. Если в отчете нет данных, выгрузите все покупки с помощью ресурса Logs API:

   curl -X GET \
   'https://api.appmetrica.yandex.ru/logs/v1/export/revenue_events.json?application_id=1111&date_since=2018-10-10&date_until=2018-10-11&fields=revenue_order_id,revenue_quantity,revenue_price,revenue_currency,is_revenue_verified' \
   -H 'Authorization: OAuth oauth_token'
   

   Если в выгрузке есть события и в поле is_revenue_verified указано значение false, то покупки не прошли валидацию.

Шаг 5. Настройте отправку Revenue на основной API Key

После отладки повторите последовательность шагов 2–4 для основного API key.

Чтобы отправить объект Revenue на основной API key, используйте метод AppMetrica.reportRevenue(Revenue revenue).

...
// Sending the Revenue instance.
AppMetrica.reportRevenue(revenue);

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