Как подключить RevenueCat к AdMate

Подключение RevenueCat даёт AdMate представление, ориентированное на подписки, рядом с отчётами о рекламе и магазинах. Оно может показывать проекты, транзакции и метрики, которые предоставляет RevenueCat, не превращая API AdMate в серверное хранилище доходов.

Учётные данные RevenueCat дают широкие права. Тщательно подготовьте подключение, используйте режим авторизации, который предлагает ваша текущая версия AdMate, и никогда не вставляйте секретный ключ в публичное обращение или на скриншот.

AdMate

Все ваши доходы на одной панели

Отслеживайте AdMob, AdSense, RevenueCat и App Store Connect в нескольких аккаунтах с фильтрами по приложению, платформе и стране

Следите за доходами, кликами, eCPM, подписками, установками и выплатами на iPhone, iPad, Mac и Apple Watch

Выберите правильный доступ к RevenueCat

AdMate поддерживает настройку аккаунтов RevenueCat и несколько проектов. В зависимости от текущего аккаунта и версии экран учётных данных может использовать поддерживаемую авторизацию API v2, включая секретные ключи проектов, а также может предложить авторизацию на уровне аккаунта.

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

Перед настройкой:

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

Добавьте аккаунт RevenueCat

Откройте в AdMate Настройки и управление аккаунтами.
Найдите RevenueCat и выберите добавление аккаунта.
Выберите способ авторизации, который показывает текущая версия приложения.
Введите или авторизуйте запрошенные учётные данные, не изменяя ни одного символа.
Дайте AdMate проверить аккаунт и получить доступные проекты.
Если речь идёт о нескольких организациях или клиентах, дайте подключению узнаваемое название.
Откройте сводку RevenueCat и убедитесь, что выбраны нужный проект и период.

Если вы используете несколько секретных ключей проектов, свяжите каждый с правильным проектом. Не называйте каждую запись просто «RevenueCat»: описательный псевдоним предотвращает случайное сравнение данных разных клиентов.

Что проверить после подключения

Начните с идентификации, а уже потом переходите к итогам:

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

Затем сравните закрытый период с панелью RevenueCat. Небольшие расхождения могут объясняться временем обновления, правилами валют или определениями метрик. Полностью отсутствующий проект обычно указывает на область действия учётных данных или привязку проекта, а не на ошибку расчёта.

Доступ к панели и вебхуки — это разные вещи

AdMate использует RevenueCat двумя разными способами:

приложение для устройств Apple запрашивает настроенные пользователем проекты для данных панели;
API AdMate может принимать вебхуки RevenueCat для уведомлений.

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

API хранит временный контекст устройства и проекта, чтобы уведомление могло показать понятные названия и валюту. Этот контекст не является серверной копией полной истории доходов пользователя или его токена доступа.

Если проект не отображается

Учётные данные проходят проверку, но виден только один проект

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

Для действующего проекта не отображаются метрики

Выберите завершённый диапазон дат с известными транзакциями, проверьте фильтры проекта и магазина и обновите данные в основном приложении. Новый или неактивный проект вполне может вернуть ноль.

Авторизация внезапно перестала работать

Ключ мог быть отозван, заменён или скопирован с пробелами. Проверьте его статус в RevenueCat и замените в AdMate. Не храните отозванный ключ в качестве запасного.

Название проекта верное, но итог выглядит неправильно

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

Защитите учётные данные

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

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

Часто задаваемые вопросы

Может ли AdMate подключить несколько проектов RevenueCat?

Да. Модель аккаунтов поддерживает несколько проектов и учётных данных проектов. Назовите и проверьте каждый проект, прежде чем объединять представления.

Достаточно ли публичного ключа SDK RevenueCat?

Используйте тот тип учётных данных, который запрашивает настройка RevenueCat в AdMate. Публичные ключи SDK приложений и секретные учётные данные API предназначены для разных целей.

Отправляет ли AdMate все доходы от подписок в свой API?

Нет. Приложение напрямую запрашивает настроенные сервисы. Контекст RevenueCat в API нужен для уведомлений через вебхуки и не является хранилищем доходов.

Что отправить в поддержку?

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