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

Трекинг через Apphud — платная опция, которая доступна на тарифах Custom и Pro. У опции есть бесплатный лимит MTR < 10000$.

1. Активируйте опцию Apphud в разделе Организация → Оплата и тариф.

   • Если у вас тариф Free, перейдите на тариф Custom или Pro и заполните реквизиты. После этого опция с бесплатным лимитом будет активирована автоматически.
   • Если у вас тариф Custom или Pro, опция с бесплатным лимитом будет активирована автоматически.

2. Обновите SDK AppMetrica. AppMetrica поддерживает трекинг через Apphud начиная с версий Android 7.6.0, iOS 5.9.0.

3. Отключите автосбор покупок и подписок из Google Play, App Store в SDK AppMetrica.

   Android

   iOS

   Kotlin

   Java

   val config = AppMetricaConfig.newConfigBuilder(API_KEY)
                .withRevenueAutoTrackingEnabled(false)
                .build()
            AppMetrica.activate(context, config)
   

   AppMetricaConfig config = AppMetricaConfig.newConfigBuilder(API_KEY)
                .withRevenueAutoTrackingEnabled(false)
                .build();
            AppMetrica.activate(context, config);
   

   Swift

   Objective-C

   let configuration = AppMetricaConfiguration(apiKey: "API_KEY")!
   configuration.revenueAutoTrackingEnabled = false
   AppMetrica.activate(with: configuration)
   

   AMAAppMetricaConfiguration *configuration = [[AMAAppMetricaConfiguration alloc] initWithAPIKey:@"API_KEY"];
   configuration.revenueAutoTrackingEnabled = NO;
   [AMAAppMetrica activateWithConfiguration:configuration];
   

4. Отключите ручной сбор покупок (если он был настроен) из Google Play, App Store.

   Попробуйте поискать в коде вызовы AppMetrica#reportRevenue(Revenue) и удалить их. Подробности о реализации ручного сбора читайте в разделах для Android, iOS.

5. Если вы использовали загрузку событий In-app Revenue в POST API для сбора покупок и подписок из Google Play, App Store, — отключите его.

   Примечание

   Рекомендуется отключить все сборы (ручные и автоматические), чтобы информация не дублировалась в отчетах.

6. Подключите модуль Apphud в коде приложения.

   Android

   iOS

   Версия модуля Apphud должна совпадать с версией SDK AppMetrica.

   dependencies {
     // AppMetrica SDK
     implementation("io.appmetrica.analytics:7.6.0")
     // AppMetrica SDK Apphud module
     // You should use the same versions for AppMetrica and Apphud modules
     implementation("io.appmetrica.analytics:analytics-apphud:7.6.0")
   }
   

   Cocoapods

   SPM

   pod 'AppMetricaApphudAdapter', '~> 1.0.0'
   

   dependencies: [
       .package(
           url: "https://github.com/appmetrica/appmetrica-sdk-apphud-adapter-ios",
           from: "1.0.0"
       )
   ]
   

7. Заполните информацию о вашем приложении в разделе Настройки → Трекинг подписок (Apphud) интерфейса AppMetrica.

   Android приложение

   iOS приложение

   • Название пакета Google Play.

   • Учетная запись службы JSON.

     Для отслеживания изменений статуса подписок необходимо создать и загрузить в AppMetica json-файл сервисного аккаунта. Подробнее о том как создать json-файл читайте в документации Apphud.

   • Уведомления разработчика Google в режиме реального времени.

     После загрузки JSON-файла в интерфейсе появится строка, которую необходимо скопировать в Google Play Console → Your App → Monetization Setup. Подробнее читайте в документации Google.

   • Google Play Reduced Service Fee.

     Если вы зарегистрированы в программе Google Play Reduced Service Fee, укажите даты действия.

   

   • Bundle ID.

   • App Store Apple ID.

     Его можно найти в App Store Connect → Apps → App Information.

   • App Store Shared Secret.

     Как получить App Store Shared Secret

     1. Откройте App Store Connect, перейдите в раздел Apps и выберите свое приложение.
     2. В секции Features слева перейдите в Subscriptions.
     3. На странице найдите раздел App-Specific Shared Secret, нажмите кнопку Manage.
     4. Создайте и скопируйте Shared Secret.
     5. В интерфейсе AppMetrica перейдите в раздел Настройки → Трекинг подписок (Apphud) → iOS приложение.
     6. Вставьте Shared Secret для приложения в поле App Store Shared Secret.

   • Apple Small Business Program.

     Если вы зарегистрированы в программе Apple Small Business Program, укажите даты действия.

   • Уведомления сервера App Store.

     • API сервера App Store (StoreKit 2). Ключ для покупки в приложении.
       Закрытый ключ (In-App Purchase Key) из App Store Connect, который необходимо загрузить в AppMetrica. Подробнее о том как создать In-App Purchase Key читайте в документации Apphud.

   • URL-адрес уведомлений сервера App Store версии V1 или V2.

     После загрузки In-App Purchase Key в интерфейсе появится строка — это URL-адрес для настройки уведомлений от App Store Server Notifications.

     Как настроить уведомления от App Store Server Notifications

     1. Скопируйте URL-адрес для уведомлений сервера App Store.
     2. Откройте App Store Connect, перейдите в раздел Apps и выберите свое приложение.
     3. В секции General слева перейдите в App Information.
     4. Внизу открывшейся страницы, в блоке App Store Server Notifications у пункта Production Server URL нажмите кнопку Edit.
     5. В поле Production Server URL введите URL-адрес из AppMetrica.
     6. Ниже в форме выберите Version 2 Notifications и нажмите Save.

     

   • Issuer ID.

     Идентификатор эмитента из App Store Connect. Его можно найти в App Store Connect → Users and Access → Keys → App Store Connect API.

   

Как отключить Apphud

1. В интерфейсе AppMetrica перейдите в Организация → Оплата и тариф.

2. На карточке вашего тарифа нажмите кнопку Настроить.

3. Найдите в списке опцию Отслеживание in-app покупок и подписок Apphud и справа установите Отключено.

   

4. Нажмите кнопку Сохранить.

5. Если вы хотите отключить модуль Apphud в SDK, удалите зависимости в коде приложения.

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