---
metadata:
- name: generator
content: Diplodoc Platform v5.50.6
alternate:
- https://boost.yandex.com/doc/en/analytics/content/data-collection/apphud/apphud-about.md
- https://boost.yandex.com/doc/ru/analytics/content/data-collection/apphud/apphud-about.md
---
> **Documentation Index:** Fetch the complete configuration index at https://boost.yandex.com/doc/en/llms.txt
# Boost and Apphud
Boost is integrated with [Apphud](https://docs.apphud.com/docs/what-is-apphud), one of the leading solutions for tracking purchases and subscriptions in mobile apps. Apphud delivers 99.9% accuracy in tracking app revenue, which ensures that all possible purchase scenarios are taken into account.
Advantages:
- Save your development resources. No integrations with third-party solutions are needed, and you can set up the Apphud module in a [few steps](#enable-apphud).
- Keep your data accurate and up to date. The service tracks subscriptions for every purchase scenario and can be adapted to specific app stores and operating systems.
- Revenue data is available in your reports. You can segment your audience by income or other purchase parameters and learn which channels and regions generate the most paying users. View reports on [revenue](https://boost.yandex.com/doc/en/analytics/content/mobile-reports/revenue-report.md), [events](https://boost.yandex.com/doc/en/analytics/content/mobile-reports/events-report.md), [audience](https://boost.yandex.com/doc/en/analytics/content/mobile-reports/audience-report.md), and [user acquisition](https://boost.yandex.com/doc/en/analytics/content/mobile-reports/user-acquisition-report.md).
Features:
- App Store & iOS
- Support for full refunds, including updates on changes to the refund amount.
- Support for family shared subscriptions. Family sharing transactions shared with other users are ignored.
- Correct calculation of the App Store commissions.
- Support for paid trials and promotional offers.
- Support for subscription offer codes.
- Automatic purchase restoring through the SDK.
- Google Play & Android
- Support for subscriptions with multiple basic plans.
- Support for complex scenarios, for example: a free trial + paid discount + regular price.
- Support for all offer types: free trials, discounts, fixed prices, and absolute discounts.
## How to enable Apphud {#enable-apphud}
Tracking via Apphud is a paid feature available with the Custom and Pro [plans](https://boost.yandex.com/doc/en/analytics/content/common/pricing/uae-currency.md#pro-upgrade). This option comes with a free `MTR limit of $10,000`.
{% note warning "" %}
1. Tracking via Apphud may be unavailable in some regions.
2. Apphud only works with Google Play and the App Store. It doesn't collect data from other app stores, such as Huawei AppGallery.
{% endnote %}
1. Activate Apphud under **Organization** → **Payment and plan**.
- If you are on the Free plan, upgrade to the Custom or Pro plan and complete the required information. Once upgraded, the option and the free limit are activated automatically.
- If you already have the Custom or Pro plan, the option and the free limit are activated automatically.
2. Update the AppMetrica SDK. It supports tracking via Apphud starting from version [7.6.0 for Android](https://boost.yandex.com/doc/en/analytics/content/sdk/android/analytics/quick-start.md) and [5.9.0 for iOS](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/quick-start.md).
3. Disable automatic collection of purchase and subscription data from Google Play or the App Store in the AppMetrica SDK.
{% list tabs %}
- Android
{% list tabs %}
- Kotlin
```kotlin translate=no
val config = AppMetricaConfig.newConfigBuilder(API_KEY)
.withRevenueAutoTrackingEnabled(false)
.build()
AppMetrica.activate(context, config)
```
- Java
```java translate=no
AppMetricaConfig config = AppMetricaConfig.newConfigBuilder(API_KEY)
.withRevenueAutoTrackingEnabled(false)
.build();
AppMetrica.activate(context, config);
```
{% endlist %}
- iOS
{% list tabs %}
- Swift
```swift translate=no
let configuration = AppMetricaConfiguration(apiKey: "API_KEY")!
configuration.revenueAutoTrackingEnabled = false
AppMetrica.activate(with: configuration)
```
- Objective-C
```obj-c translate=no
AMAAppMetricaConfiguration *configuration = [[AMAAppMetricaConfiguration alloc] initWithAPIKey:@"API_KEY"];
configuration.revenueAutoTrackingEnabled = NO;
[AMAAppMetrica activateWithConfiguration:configuration];
```
{% endlist %}
{% endlist %}
4. Disable manual collection of purchase data (if configured) from Google Play or the App Store.
Try searching for `AppMetrica#reportRevenue(Revenue)` calls in your code and removing them. For instructions on how to enable manual collection, see the relevant sections for [Android](https://boost.yandex.com/doc/en/analytics/content/sdk/android/analytics/android-operations.md#send-revenue-key) and [iOS](https://boost.yandex.com/doc/en/analytics/content/sdk/ios/analytics/ios-operations.md#send-revenue-key).
5. If you're using the [POST API](https://boost.yandex.com/doc/en/analytics/content/mobile-api/post/about.md) to [send in-app revenue data](https://boost.yandex.com/doc/en/analytics/content/mobile-api/post/post-revenue.md) for Google Play and App Store purchases and subscriptions, disable this option.
{% note info %}
We recommend disabling all data collection (both manual and automatic) to prevent duplicate data in reports.
{% endnote %}
6. Integrate the Apphud module into your app code.
{% list tabs %}
- Android
The version of your Apphud module must match the version of your AppMetrica SDK.
```kotlin translate=no
dependencies {
// AppMetrica SDK
implementation("io.appmetrica.analytics:8.5.0")
// AppMetrica SDK Apphud module
// You should use the same versions for AppMetrica and Apphud modules
implementation("io.appmetrica.analytics:analytics-apphud:8.5.0")
}
```
- iOS
{% list tabs %}
- Cocoapods
```ruby translate=no
pod 'AppMetricaApphudAdapter', '~> 1.0.0'
```
- SPM
```swift translate=no
dependencies: [
.package(
url: "https://github.com/appmetrica/appmetrica-sdk-apphud-adapter-ios",
from: "1.0.0"
)
]
```
{% endlist %}
{% endlist %}
7. Enter your app details under **Settings** → **Subscriptions tracking (Apphud)** in the Analytics module interface.
{% list tabs %}
- Android app
- Google Play package name.
- JSON service account.
To track subscription status updates, create and upload a service account JSON file to Analytics module. For information on how to create a JSON file, see the [Apphud documentation](https://docs.apphud.com/docs/google-play-service-credentials).
- Real-time Google developer notifications.
Once you upload the JSON file, a string will appear in the interface. Copy this string to **Google Play Console** → **Your App** → **Monetization Setup**. For more information, see the [Google documentation](https://developer.android.com/google/play/billing/getting-ready#configure-rtdn).
- Google Play Reduced Service Fee.
If you're registered for the [Google Play Reduced Service Fee](https://support.google.com/googleplay/android-developer/answer/11131145) program, specify your enrollment dates.
{style="border: solid 1px #cccccc; max-width: 700px;"}
- iOS app
- Bundle ID.
- App Store Apple ID.
You can find it under **[App Store Connect](https://appstoreconnect.apple.com/)** → **Apps** → **App Information**.
- App Store Shared Secret.
{% cut "How to get an App Store Shared Secret" %}
1. Open App Store Connect, go to [Apps](https://appstoreconnect.apple.com/apps), and select your app.
2. Go to **Subscriptions** from the **Features** menu on the left.
3. On the page, find the **App-Specific Shared Secret** section and click **Manage**.
4. Create and copy a **Shared Secret**.
5. In the Analytics module interface, go to **Settings** → **Subscriptions tracking (Apphud)** → **iOS application**.
6. Insert the **Shared Secret** for the app in the **App Store Shared Secret** field.
{% endcut %}
- Apple Small Business Program.
If you're registered for the [Apple Small Business Program](https://developer.apple.com/app-store/small-business-program), specify your enrollment dates.
- App Store server notifications.
- App Store Server API (StoreKit 2). In-app purchase key.
A private key from App Store Connect that you need to upload to Analytics module. For information on how to generate an in-app purchase key, see the [Apphud documentation](https://docs.apphud.com/docs/app-store-credentials).
- URL for App Store Server Notifications V1 or V2.
Once you upload the In-App Purchase Key, a string will appear in the interface. This is a URL for configuring App Store Server Notifications.
{% cut "How to set up App Store server notifications" %}
1. Copy the URL for App Store server notifications.
2. Open App Store Connect, go to [Apps](https://appstoreconnect.apple.com/apps), and select your app.
3. Go to **App Information** from the **General** menu on the left.
4. At the bottom of the page that opens, find the **App Store Server Notifications** section and click **Edit** next to **Production Server URL**.
5. In the **Production Server URL** field, enter the URL from Analytics module.
6. In the form below, select **Version 2 Notifications** and click **Save**.
{% endcut %}
{style="border: solid 1px #cccccc; max-width: 700px;"}
- Issuer ID.
Issuer ID from App Store Connect. You can find it under **App Store Connect** → **Users and Access** → **Keys** → **App Store Connect API**.
{style="border: solid 1px #cccccc; max-width: 700px;"}
{% endlist %}
## How to get access in the Apphud dashboard {#access}
In the Analytics module integration, when a user uploads certificates for their app, an Apphud dashboard is created. It is registered for the company owner's email address. After that, the user gets access to their app and all the Apphud reports included in the plan they selected.
### How to grant access for other employees {#user-access}
In the Apphud dashboard, you can set up access to the app for other employees of your company.
If the user who uploaded the certificates isn't the app owner, they can ask the app owner to undergo the [access recovery procedure](https://docs.apphud.com/docs/access-recovery) and then go to the Apphud dashboard and grant this user access to the app.
## How to disable Apphud {#disable-apphud}
1. In the Analytics module interface, go to **Organization** → **Payment and plan**.
2. In the box with your pricing plan, click **Settings**.
3. Find the **Tracking in-app purchases and Apphud subscriptions** option in the list and select **Disabled** next to it.
{style="border: solid 1px #cccccc; max-width: 700px;"}
4. Click **Save**.
5. To disable the Apphud module, remove its dependencies from your app's code.
If you didn't find the answer you were looking for, you can use the feedback form to submit your question. Please describe the problem in as much detail as possible. Attach a screenshot if possible.
Contact support
Suggest an improvement for documentation