Эндпоинты выручки и Apple Ads

GET /apps/{appId}/revenue

Доход и загрузки одного приложения из источников, которые подключил пользователь: ежедневные единицы по странам из App Store Connect, ежедневные установки из Google Play, а из RevenueCat — MRR, доход за 28 дней, активные подписки и пробные периоды с разбивкой движения MRR. connected=false означает, что ни один источник не подключён; measured=false — что в источниках нет строк по этому приложению. Здесь нет оценочных значений.

Права

revenue:read

Кредиты

1

Тариф

Pro

Также принимает: appId (обязательный)

curl "https://storelift.net/v1/apps/sbx-lumen/revenue" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

Открыть в песочнице

GET /apps/{appId}/subscriptions

Число событий подписок одного приложения из вебхука RevenueCat / Adapty: по дням и по странам — начала пробных периодов, конверсии из пробных, начала платных подписок, продления, отмены, возвраты, проблемы с оплатой и доход, — а также месячные когорты (пользователи, платящие). Считаются события, а не пользователи. connected=false означает, что вебхук не подключён.

Права

revenue:read

Кредиты

1

Тариф

Pro

Также принимает: appId (обязательный)

curl "https://storelift.net/v1/apps/sbx-lumen/subscriptions" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

Открыть в песочнице

GET /apps/{appId}/funnel

Воронка конверсии App Store для одного приложения по аналитике App Store Connect: показы → просмотры страницы продукта → загрузки, сегодняшняя точка и история по дням, с разбивками по источникам трафика и персонализированным страницам продукта, когда Apple их предоставляет. У Google Play здесь аналога нет. connected=false означает, что App Store Connect не подключён.

Права

revenue:read

Кредиты

1

Тариф

Pro

Также принимает: appId (обязательный)

curl "https://storelift.net/v1/apps/sbx-lumen/funnel" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

Открыть в песочнице

GET /apps/{appId}/campaigns

Кампании Apple Ads, которые продвигают одно приложение (сопоставление по id приложения в App Store, а не по названию): расходы, показы, нажатия, установки, бюджет и статус показа по каждой кампании за последние 28 дней, итоги и ключевые слова и поисковые запросы с наибольшими расходами. Расходы указаны в валюте аккаунта (currency). connected=false означает, что Apple Ads не подключён.

Права

ads:read

Кредиты

1

Тариф

Pro

Также принимает: appId (обязательный)

curl "https://storelift.net/v1/apps/sbx-lumen/campaigns" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

Открыть в песочнице

GET /apps/{appId}/ads-keywords

Все ключевые слова Apple Ads, купленные для одного приложения во всех его кампаниях (последние 28 дней), по расходам: ставка, тип соответствия, группа объявлений, расходы, показы, нажатия, установки, доля нажатий, конверсия, цена нажатия и цена установки, а рядом — органическая позиция приложения по тому же слову в стране (tracked:false, если слово не отслеживается). Передайте campaign, чтобы ограничиться одной кампанией. connected=false означает, что Apple Ads не подключён.

Права

ads:read

Кредиты

1

Тариф

Pro

Также принимает: appId (обязательный)

curl "https://storelift.net/v1/apps/sbx-lumen/ads-keywords?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/ads-search-terms

Запросы, которые люди действительно вводили и которые вызвали показ рекламы приложения в Apple Ads (последние 28 дней), по расходам: поисковый запрос, ключевое слово и тип соответствия, которые его поймали, расходы, нажатия, установки, цена нажатия и установки, а рядом — органическая позиция приложения по этому запросу в стране. Это список запросов, которые стоит добавить как ключевые слова, добавить как минус-слова или перестать оплачивать, потому что приложение уже ранжируется по ним. Запросы, которые Apple скрывает из-за малого объёма, суммируются в hidden. connected=false означает, что Apple Ads не подключён.

Права

ads:read

Кредиты

1

Тариф

Pro

Также принимает: appId (обязательный)

curl "https://storelift.net/v1/apps/sbx-lumen/ads-search-terms?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/ads-commands

Команды Apple Ads для кампаний одного приложения — из панели, из правил автоматизации и из confirm_action — сначала новые, каждая со статусом: queued, applying, applied, failed или unknown (отправка прервалась и могла дойти до Apple, а могла и нет; проверьте в Apple Ads, прежде чем отправлять снова), временем завершения, ошибкой, если она была, и действием отмены. Передайте id, чтобы получить одну команду.

Права

ads:read

Кредиты

1

Тариф

Pro

Также принимает: appId (обязательный)

curl "https://storelift.net/v1/apps/sbx-lumen/ads-commands" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/search-popularity

Собственная поисковая популярность Apple из аккаунта Apple Ads, подключённого к этому рабочему пространству: самые популярные запросы страны в категории приложения (за неделю, в порядке Apple), каждый с местом в категории и популярностью 1-100 (в категории и по стране) и 1-5 (шкала Apple Ads), а также каждое отслеживаемое ключевое слово с пометкой inTopTerms true или false. Передайте terms, чтобы проверить другие слова. connected=false означает, что Apple Ads не подключён.

Права

ads:read

Кредиты

1

Тариф

Pro

Также принимает: appId (обязательный) · country

curl "https://storelift.net/v1/apps/sbx-lumen/search-popularity?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/pricing

Цены продуктов и коды предложений одного приложения из вебхука RevenueCat или Adapty за последние 365 дней: по продукту и стране — действующая цена (валюта, локальная цена, с какого дня) и каждый период фиксированной цены с началами пробных периодов, новыми платными подписками, конверсиями из пробных и доходом, а также каждый код предложения с первым и последним днём и числом активаций. Изменение цены отображается как новый период, поэтому «до» и «после» читаются период за периодом. connected=false означает, что ни один из вебхуков не подключён.

Права

revenue:read

Кредиты

1

Тариф

Pro

Также принимает: appId (обязательный)

curl "https://storelift.net/v1/apps/sbx-lumen/pricing?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/country-prices

Цены по странам для одного из продуктов приложения, прочитанные из App Store Connect / Google Play (Pro): по каждой стране — локальная цена, её значение в USD и индекс (США = 100), остаётся ли она автоматической ценой Apple (или Google), медиана конкурентов, которые локализуют цены (множитель к автоматической цене Apple и число конкурентов), и разница в процентах, а также рекомендуемая цена, округлённая до привлекательной ценовой точки, с причиной (медиана конкурентов или группа по доходу). Конкуренты — это конкуренты приложения на iOS, добавленные вручную; для сравнения в стране нужно минимум 3 из них. summary считает страны с ценой выше и ниже конкурентов и страны, где всё ещё автоматическая цена. state принимает значения not_connected, pending (первое чтение ещё не завершено), permission (роль ключа не позволяет читать цены), no_products или ok. products перечисляет остальные продукты; передайте product, чтобы переключиться.

Права

revenue:read

Кредиты

1

Тариф

Pro

Также принимает: appId (обязательный)

curl "https://storelift.net/v1/apps/sbx-lumen/country-prices?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/change-impact

Что дало изменение: для одного дня изменения (новая версия, скриншоты, подзаголовок, поле ключевых слов, старт кампании; по умолчанию последнее изменение на шкале изменений страницы) сравнивает одинаковое число дней до и после, рядом: позиции по ключевым словам (выросли/упали/вошли/выпали и самые крупные сдвиги), воронку App Store (показы, просмотры страницы, загрузки в день и конверсии), загрузки из отчёта о продажах, а также доход от подписок и начала пробных и платных подписок в день — каждое с изменением в процентах. Сам день изменения не входит ни в одно из окон. complete=false означает, что окно «после» ещё не закончилось. recentChanges перечисляет последние дни изменений, чтобы выбрать другой.

Права

revenue:read

Кредиты

1

Тариф

Pro

Также принимает: appId (обязательный)

curl "https://storelift.net/v1/apps/sbx-lumen/change-impact?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"