Как настроить уведомления AdMate и вебхуки RevenueCat

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

Разделение этих задач крайне важно для безопасности и диагностики.

AdMate

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

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

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

Две настройки, две цели

Подключение панели

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

Доставка вебхуков

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

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

Подготовьте контекст приложения

Подключите и проверьте аккаунт RevenueCat в AdMate.
Выберите нужные проекты и приложения.
Откройте настройку вебхуков или уведомлений в приложении.
Синхронизируйте контекст устройства, который запрашивает процесс.
Подтвердите язык, валюту и названия проектов.
Разрешите уведомления на уровне операционной системы.

Контекст API имеет ограниченный срок действия и должен обновляться через поддерживаемый в приложении процесс. Это не постоянная финансовая база данных.

Настройте RevenueCat

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

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

Проверьте всю цепочку

Проверьте всю цепочку:

RevenueCat принимает настройку вебхука.
Поддерживаемое событие успешно доставляется.
API AdMate может определить контекст устройства и проекта.
Служба платформы принимает доставку push-уведомления.
Устройство всё ещё зарегистрировано и разрешает уведомления.
Отображаемые проект, приложение, язык и валюта верны.

Успешное обновление панели проверяет только другой путь.

Устранение неполадок

RevenueCat сообщает об ошибке вебхука

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

Вебхук срабатывает, но уведомление не приходит

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

В уведомлении неверное название проекта

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

Одно устройство работает, а другое нет

У каждого устройства своя регистрация и свой контекст. Проверьте разрешения и контекст на проблемном устройстве.

Правила безопасности

Не храните авторизацию вебхуков и ключи провайдеров в Git.
Не записывайте в журналы полные данные с идентификаторами клиентов или транзакций.
Не используйте API вебхуков как хранилище данных о доходах.
Немедленно заменяйте раскрытые данные авторизации.
Удаляйте контекст устройства, если оно больше не должно получать события.

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

Хранит ли AdMate на своём сервере всю мою историю RevenueCat?

Нет. API обрабатывает события вебхуков и временный контекст устройства и проекта; приложение запрашивает настроенные сервисы напрямую.

Зачем нужны и аккаунт панели, и вебхук?

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

Может ли вебхук исправить отсутствующие метрики на панели?

Нет. Проверьте авторизацию RevenueCat в приложении и сопоставление проектов.

Что должно быть в безопасном обращении в поддержку?

Тип события, примерное время, скрытый статус и контекст устройства и приложения — но никогда не секретные ключи и не полные идентификаторы клиентов.