Краткий обзор: валидация чеков позволяет измерять выручку от покупок в приложении и подписок и сверять ее с данными магазинов приложений, обеспечивая точный расчет рентабельности рекламных расходов (ROAS).
Переход на новую валидацию чека
Поддержка устаревшей валидации чека будет прекращена 7 сентября 2026 года. Подробнее см. в бюллетене: устаревшая валидация чека выводится из эксплуатации. Если в вашем приложении используется устаревшая валидация чека, перейдите на новую, выполнив приведенные ниже шаги настройки. Прежде чем начать, ознакомьтесь с основными различиями и подготовьтесь к миграции.
Что нового в валидации чека
| Область | Устаревший | Новая валидация чека |
|---|---|---|
| Метод SDK |
validateAndLogInAppPurchase (legacy/v1) |
validateAndLogInAppPurchase (v2), то же название и новая сигнатура в iOS и Android |
| Ввод цены и валюты | Передаются в вызове SDK | Автоматически извлекаются из магазина |
| Тип покупки | Не требуется | Обязательный параметр Тип покупки (подписка или разовая покупка) |
| Настройка параметров дохода | Не требуется | Требуется (страница настроек дохода) |
Источник значения af_revenue
|
Значение, переданное в вызове SDK | Валовое значение, возвращаемое магазином; любое пользовательское значение, переданное в вызове SDK, попадает в объект custom_data события |
| Детализация событий покупки | Одно событие af_purchase для всех типов транзакций |
Отдельные события для каждого типа транзакции: af_purchase, af_ars_trial_started, af_ars_subscription_started, а также их варианты для тестовой среды (sandbox). |
| Поддержка StoreKit 2 (iOS) | Не поддерживается | Поддерживается |
| Фильтрация мошенничества | Ограниченный | Улучшено на Android и iOS |
| Доступность SDK | Удалено из SDK AppsFlyer версии 7.0.0+ | Доступно начиная с Android версии 6.17.5, iOS версии 6.17.8 и плагинов версии 6.17.8 |
| Запись валидированных событий покупки | Поддерживается до 7 сентября 2026 г. | Текущее |
Подготовка миграции
Перед началом миграции ознакомьтесь со следующими важными моментами:
- Выполняйте миграцию постепенно, не затрагивая текущих пользователей. Включение новой валидации чека в дэшборде AppsFlyer не влияет на версии приложения, которые по-прежнему используют устаревший метод. Оба варианта продолжат работать до прекращения поддержки устаревшего метода 7 сентября 2026 г.
- Ожидайте изменений в доходе после миграции. Новая валидация чека использует валовое значение, возвращаемое магазином, тогда как устаревшая валидация чека использовала значение дохода, переданное в вызове SDK. Если в вызове SDK передавалось неваловое значение, после миграции дэшборды и постбэки партнеров, которые теперь отражают валовые значения, будут показывать другое число. Для чистого дохода используйте Выручка магазина ROI360; подробнее см. в статье Настройка выручки магазина ROI360.
-
Сообщите своим UA-партнерам об изменении дохода. Рекламные сети, которые раньше получали неваловой доход из постбэка
af_purchase, после миграции увидят другие значения. -
Спланируйте график выпуска новой версии приложения. После 7 сентября 2026 года для пользователей версий приложения, собранных с SDK ниже Android v6.17.5 или iOS v6.17.8, перестанут регистрироваться валидированные события
af_purchase. Выпустите новую версию приложения заранее, чтобы до прекращения поддержки она успела охватить большинство ваших пользователей.
Переход на "Выручку магазина ROI360"
Для перехода на функцию "Выручка магазина ROI360" не требуется изменять SDK, так как оба продукта используют один и тот же метод validateAndLogInAppPurchase (v2). Добавление коннектора покупки для автоматического определения покупки является необязательным.
Дополнительную информацию и инструкции по настройке см. в статье Настройка дохода магазина ROI360.
Обзор
Примечание.
Дополнительную информацию о валидации чека, включая принцип ее работы и способ ее включения в AppsFlyer, см. в статье О валидации чека.
Чтобы настроить валидацию чека, выполните следующие шаги по порядку:
- Настройте учётные данные магазина (iOS и Android)
-
Интеграция API validateAndLog SDK: подготовьте разработчиков к интеграции API
validateAndLogSDK AppsFlyer и настройте тестовую среду (sandbox) для тестирования. - Тестирование интеграции API validateAndLog SDK: выполните тестовые покупки и оформление подписок в тестовой среде (sandbox) на iOS и Android, чтобы убедиться, что события валидации чеков генерируются и корректно регистрируются в AppsFlyer.
- Проверка и обновление настроек: убедитесь, что в качестве типа продукта выбрана валидация чеков, и проверьте статусы ключей магазинов приложений и интеграции SDK, чтобы обеспечить точное и непрерывное измерение выручки.
-
Выпуск версий приложения с API validateAndLog SDK: выпустите обновленные версии приложения с интегрированным API
validateAndLogSDK, убедившись, что флаги тестовой среды (sandbox) отключены, а необходимые события в приложении не блокируются правилами валидации.
Шаг 1 (iOS) Настройка ключей App Store Connect
На шаге 1 получите следующие учетные данные в App Store Connect и введите их на странице Настройки выручки платформы AppsFlyer.
- Ключ для покупок в приложении
- Идентификатор ключа
- Идентификатор эмитента
Прежде чем начать:
- Настройка учетных данных включает шаги, выполняемые как в App Store Connect, так и в AppsFlyer. Держите вкладки App Store Connect и AppsFlyer открытыми во время настройки.
- Для вашего приложения iOS требуется StoreKit v1 или v2, который предоставляет фреймворк для обработки покупок в приложении и подписок.
1.1 Создание ключей App Store Connect
Чтобы настроить учетные данные iOS, выполните следующие шаги:
-
В App Store Connect перейдите в Пользователи и доступ .
-
Перейдите к Пользователи и доступ > Интеграции, и из списка Ключи выберите Покупка в приложении.
-
Нажмите +, чтобы сгенерировать новый ключ для покупки в приложении.
- Введите название для вашего ключа API.
- Нажмите Генерировать.
- Нажмите Скачать ключ для покупок в приложении рядом с ключом, который вы только что сгенерировали, чтобы скачать его. Примечание: Вы можете скачать ключ только один раз.
-
Скопируйте Идентификатор ключа , который вы только что сгенерировали, и вставьте его в настройки покупок и подписок AppsFlyer в поле Идентификатор ключа.
-
Скопируйте Идентификатор эмитента. Примечание: если Идентификатор эмитента не отображается в верхней части страницы, создайте ключ API App Store Connect (с любым уровнем доступа). После этого идентификатор эмитента появится в верхней части страницы для ключа покупки в приложении.
1.2 Создание ключей App Store Connect
- Включите валидацию чека. #enable-receipt-validation
- На этапе Ключи App Store Connect нажмите
Загрузить в поле Ключ для покупок в приложении, чтобы загрузить файл p8.
-
В разделе titled App Store Connect keys, вставьте значения, которые вы скопировали из App Store Connect.
- Идентификатор ключа
- Идентификатор эмитента
- Нажмите Валидация ключей, чтобы убедиться, что введенные вами ключи верны. Примечание: действие Проверить ключи может не работать, если ваше приложение еще не опубликовано в App Store.
- Нажмите Сохранить и продолжить.
Шаг 1 (Android). Настройка ключа сервисного аккаунта и разрешений
На шаге 1 получите следующие учетные данные из Google Play и Google Cloud и введите их на странице Настройки дохода на платформе AppsFlyer.
Прежде чем начать:
- Настройка измерения выручки от покупок в приложении и подписок включает действия, выполняемые в Google Cloud Platform, Google Play Console, и интерфейсе AppsFlyer. Мы рекомендуем не закрывать все три вкладки на протяжении всего процесса настройки.
- Для настройки в пользовательском интерфейсе AppsFlyer требуются права администратора.
1.1 Свяжите свой аккаунт разработчика Google Play со своим проектом Google Cloud
Предварительные условия: доступ к Google Play Console и проекту Google Cloud.
Чтобы связать свой аккаунт разработчика Google Play со своим проектом Google Cloud, выполните следующие действия:
- В Google Play Console откройте свой аккаунт разработчика Google Play.
- Привяжите аккаунт к своему проекту в Google Cloud. Инструкции см. в этом разделе справки Google.
-
Активируйте API разработчика Google Play. Инструкции см. в этом разделе справки Google.
1.2 Настройка сервисного аккаунта в Google Cloud Platform
Предварительные условия: доступ к Google Cloud Platform.
Чтобы настроить свой сервисный аккаунт, выполните следующие действия:
-
Создайте или найдите сервисный аккаунт:
- Перейдите в раздел Сервисные аккаунты на платформе Google Cloud и нажмите СОЗДАТЬ СЕРВИСНЫЙ АККАУНТ.
- Введите данные для сервисного аккаунта.
- Скопируйте адрес электронной почты.
- Нажмите Создать и продолжить.
- На этапе Предоставление сервисному аккаунту доступа к проекту выберите роль подписчика Pub/Sub.
-
НажмитеПродолжить>Выполнено.
- Перейдите в раздел Сервисные аккаунты на платформе Google Cloud и нажмите СОЗДАТЬ СЕРВИСНЫЙ АККАУНТ.
-
Скачайте закрытый ключ сервисного аккаунта:
- На платформе Google Cloud перейдите в раздел Сервисные аккаунты, найдите в списке нужный аккаунт (который вы только что создали) и нажмите на значок Дополнительные действия.
- Нажмите
Управление ключами.
-
Нажмите 0Добавить ключ 0> 0Создать новый ключ.
- Во всплывающем окне Создать закрытый ключ в разделе Тип ключа выберите JSON и нажмите Создать.
-
Нажмите Создать. JSON-файл с закрытым ключом будет скачан.
- Сохраните файл ключа JSON, который вы позже загрузите в AppsFlyer. Важно! Вы должны сохранить ключ. Его нельзя будет получить позже. Если вы его не сохраните, вам придется создать новый ключ.
1.3 Настройте права доступа к API в Google Play Console
Предварительные условия: доступ к Google Play Console.
Примечание: после настройки учетных данных и разрешений сервисного аккаунта может пройти некоторое время (иногда до 24 часов), прежде чем вы сможете их использовать. Это может привести к появлению ошибок на последующих этапах.
Настройка прав доступа к API в Google Play Console:
-
В Google Play Console перейдите в раздел Пользователи и разрешения, найдите созданный сервисный аккаунт и нажмите 0Пригласить новых пользователей.
-
Введите адрес электронной почты , который вы скопировали при настройке учётной записи службы на шаге 1.2.1.3.
-
В разделе Разрешения перейдите на вкладку Разрешения аккаунта и выберите оба варианта:
-
На вкладке Разрешения приложений нажмите Добавить приложение, затем выберите свое приложение. Добавьте несколько приложений, если необходимо.
-
Нажмите Пригласить пользователя.
-
Во всплывающем окне подтверждения нажмите Отправить приглашение.
1.4 Загрузите закрытый ключ сервисного аккаунта в AppsFlyer
Загрузите и выполните валидацию ключа JSON Google, который вы скачали в шаге 1.2.
Предварительные условия: права администратора в AppsFlyer.
Чтобы загрузить закрытый ключ сервисного аккаунта в AppsFlyer, выполните следующие шаги:
- Активируйте валидацию чека.
- На этапе Ключ сервисного аккаунта и разрешения в поле Загрузить ключ Google JSON нажмите
Загрузить.
- Загрузите файл JSON, который вы скачали в шаге 1.2.
-
Нажмите Валидировать ключ. Примечание.
- После установки учетных данных и разрешений аккаунта службы может пройти до 24 часов, прежде чем вы сможете их использовать. Из-за этого при попытке валидации ключа или выполнить тестовую проверку могут возникнуть ошибки.
- Чтобы обойти 24-часовой период ожидания, откройте любое приложение в Google Play Console, перейдите в раздел Монетизация > Продукты > Подписки/Покупки в приложении и внесите любое изменение. Например, отредактируйте описание вашего продукта и сохраните его. Обычно это приводит к немедленному обновлению учетных данных и разрешений аккаунта. Затем вы можете отменить эти изменения.
- Нажмите Далее. Откроется шаг Внедрение SDK.
Шаг 2. Внедрение SDK
На этом шаге вы подготовите разработчиков к интеграции API validateAndLog в SDK и настроите среду песочницы для тестирования. Минимальные версии SDK, поддерживающие последнюю версию API validateAndLog: 6.17.5 для Android и 6.17.8 для iOS.
Чтобы внедрить validateAndLog SDK API, выполните следующие шаги:
- На шаге Внедрение SDK скопируйте готовое сообщение отображаемое в дэшборде.
-
Отправьте его своим разработчикам. оно включает:
- Название и идентификатор приложения;
- Ссылку на руководство по интеграции SDK.
- Инструкции по настройке среды песочницы (
sandbox = true). - Этапы тестирования (с использованием TestFlight).
Это сообщение содержит всю информацию, необходимую вашим разработчикам для завершения интеграции и начала тестирования.
- Нажмите Далее. Откроется шаг Проверка внедрения SDK.
Шаг 3. Проверьте использование SDK
Протестируйте интеграцию доходов от покупок в приложении и подписок в среде песочницы, чтобы убедиться, что коннектор SDK интегрирован правильно, а серверные уведомления должным образом настроены и принимаются AppsFlyer.
Тестирование интеграции SDK
Чтобы проверить, получал ли AppsFlyer корректные данные validateAndLog из вашего приложения за последние 7 дней, выполните следующие действия:
- На шаге Проверка внедрения SDK нажмите Проверить внедрение SDK.
- Просмотрите результаты, включая метку времени последней полезной нагрузки, полученной AppsFlyer. Обратите внимание, что эта проверка только подтверждает, что запросы доходят до AppsFlyer, и не проверяет полноту или корректность данных.
- Чтобы полностью проверить внедрение, выполните шаги тестирования, приведенные ниже.
Особенности тестовой среды (sandbox)
В тестовой среде (sandbox):
- Только события первичной покупки приводят к тому, что validateAndLog SDK API создает событие, которое регистрируется AppsFlyer. Событие покупки в приложении называется
af_purchase_sandbox_sdk. Событие подписки называетсяaf_ars_sandbox_sdk. - События в тестовой среде имеют доход 0.
- На Android тесты, выполняемые тестировщиками лицензий (License Testers), генерируют события тестовой среды (sandbox), даже если тестовая среда не настроена в SDK.
Тестирование измерения доходов от покупок в приложении и подписок
Чтобы протестировать доходы от покупок в приложении и подписок:
- Попросите разработчиков следовать их инструкциям по настройке среды sandbox для SDK API validateAndLog.
- Выполните тестовую покупку или оформите тестовую подписку с помощью License Tester в Google Play и TestFlight на iOS.
-
Проверьте, что тестовые события отображаются одним из следующих способов:
- Просмотрите событие в инструменте просмотра событий в реальном времени.
- Просмотрите данные события в Мои дэшборды - Обзор активности.
-
Найдите следующие тестовые события:
- The
af_purchase_sandbox_sdkдля события покупки. - The
af_ars_sandbox_sdkдля события подписки.
- The
-
Убедитесь, что тестовые события включают следующее:
- Значение дохода равно 0 (чтобы не искажать реальные отчеты AppsFlyer).
- Параметр
af_sandbox_revenue, который включает значение дохода от приобретенного продукта, чтобы обеспечить корректное отражение дохода в отчетах. - Параметр
af_validatedимеет значениеtrue. Еслиaf_validatedимеет значениеfalse, вернитесь к шагу 2 выше и проверьте ключ, предоставленный магазином - Параметр
af_validation_typeимеет значениевалидация чека.
Шаг 4. Проверьте и обновите настройки
После завершения настройки и сохранения изменений вы будете перенаправлены на страницу активной конфигурации, где сможете проверить или изменить следующие настройки:
- Убедитесь, что для параметра Тип продукта выбрано значение валидация чека
- Убедитесь, что опция Проверять покупки через App Store включена.
-
Проверьте или обновите следующие настройки:
- Настройка ключа App Store
- Настройка интеграции SDK
Шаг 5. Выпустите версии приложения с SDK API validateAndLog
После выполнения всех предыдущих шагов настройки и интеграции API validateAndLog SDK AppsFlyer в приложение попросите разработчиков выпустить версию приложения с интегрированным API validateAndLog SDK.
Прежде чем разработчики выпустят новую версию приложения, убедитесь, что:
- События в приложении, которые вы хотите регистрировать как покупки в приложении или подписки, не блокируются ни одним из правил валидации, настроенных в AppsFlyer.
- Ваши разработчики установили для всех флагов тестовой среды (sandbox) значение
false.
После выпуска приложения с интегрированным API validateAndLog SDK события покупок в приложении и подписок будут регистрироваться и станут доступны во всех дэшбордах AppsFlyer, а также в агрегированных отчетах и отчетах с необработанными данными.
События генерируются только для пользователей, которые обновили приложение до версии, включающей validateAndLog SDK API. В результате до полного перехода на обновленную версию приложения ожидается расхождение между данными о доходе из приложения и данными магазина.