Как подключить App Store Connect к AdMate

App Store Connect содержит несколько видов данных: метаданные приложений, отзывы, аналитику, продажи, расчётную выручку и итоговые финансовые отчёты. AdMate может собрать их в том же приложении, которое вы используете для AdMob и RevenueCat, но для подключения нужны правильные идентификаторы и права доступа.

Настройка использует ключ API App Store Connect. Относитесь к закрытому ключу как к паролю: импортируйте его только на экране учётных данных и никогда не прикладывайте к обращению в поддержку.

AdMate

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

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

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

Что понадобится из App Store Connect

Подготовьте значения, которые Apple показывает для ключа API в разделе «Пользователи и доступ»:

Key ID, идентификатор ключа API;
Issuer ID, идентификатор издателя App Store Connect API;
содержимое или файл закрытого ключа .p8;
понятный псевдоним аккаунта для AdMate;
номер поставщика, если он нужен для запрашиваемого отчёта о продажах или финансового отчёта.

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

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

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

Откройте Настройки и управление аккаунтами.
Выберите добавление аккаунта App Store Connect.
Введите узнаваемое отображаемое имя.
Укажите Key ID и Issuer ID точно в том виде, в каком их выдаёт Apple.
Импортируйте или вставьте закрытый ключ через экран учётных данных.
Добавьте номер поставщика, если он нужен для финансовых отчётов или отчётов о продажах.
Сохраните аккаунт и дайте AdMate проверить учётные данные.
Откройте сводку аккаунта и убедитесь, что отображаются ожидаемые приложения.

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

Проверяйте каждый раздел данных отдельно

Одна «зелёная» сводка не доказывает, что доступны все конечные точки App Store Connect. Проверьте разделы, которыми вы собираетесь пользоваться:

Приложения и метаданные

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

Отзывы

Откройте раздел отзывов и проверьте известное приложение. Отзывы — это данные по магазинам и регионам; корректное пустое состояние может просто означать, что подходящих отзывов нет.

Аналитика

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

Продажи и выручка

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

Финансовые отчёты

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

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

Недействительный ключ или подпись

Снова проверьте Key ID, Issuer ID и закрытый ключ как единый набор. Действующий ключ в паре с неверным издателем всё равно не сработает. Если ключ мог быть раскрыт, отзовите его, прежде чем продолжать проверку.

Приложения загружаются, а финансовые отчёты — нет

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

Аналитика не показывает данных

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

Отображаются приложения другой организации

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

Несколько аккаунтов App Store Connect

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

Для сравнения с аналитикой подписок прочитайте, почему итоги App Store Connect и RevenueCat различаются.

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

Нужен ли AdMate пароль от моего Apple ID?

Нет. Подключение использует ключ API App Store Connect, издателя и связанные идентификаторы. Никогда не вводите и не передавайте пароль Apple ID для этой настройки.

Почему приложения загружаются, а выручка — нет?

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

Можно ли использовать один ключ на нескольких устройствах с AdMate?

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

Являются ли оценки App Store Connect окончательными бухгалтерскими значениями?

Нет. Для бухгалтерского учёта используйте закрытые финансовые отчёты и фактические платежи.