SDK integration

The SDK for iOS is provided as modules with source code.

Step 1. Enable the libraryStep 1. Enable the library

pod 'AppMetricaAnalytics', '~> 5.2.0'

pod 'AppMetricaCore', '~> 5.2.0'
pod 'AppMetricaCrashes', '~> 5.2.0'
pod 'AppMetricaWebKit', '~> 5.2.0'

pod 'AppMetricaCore', '~> 5.2.0' # The main module for working with the AppMetrica SDK, mandatory for connection
pod 'AppMetricaAdSupport', '~> 5.2.0' # Required for collecting IDs. IDFAs won't be collected without it
pod 'AppMetricaCrashes', '~> 5.2.0' # The module for detecting crashes and sending errors
pod 'AppMetricaWebKit', '~> 5.2.0' # The module for setting up event sending from the WebView's JS code

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

.target(
   name: "MyTargetName",
   dependencies: [
      .product(name: "AppMetricaCore", package: "AppMetrica"),
      .product(name: "AppMetricaCrashes", package: "AppMetrica"),
      .product(name: "AppMetricaWebKit", package: "AppMetrica"),
      // .product(name: "AppMetricaAdSupport", package: "AppMetrica"), // This module is disabled
   ]
),

Step 2. Initialize the libraryStep 2. Initialize the library

import AppMetricaCore

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
    // Initializing the AppMetrica SDK.
    let configuration = AppMetricaConfiguration(apiKey: "API key")
    AppMetrica.activate(with: configuration!)
}

#import <AppMetricaCore/AppMetricaCore.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    // Initializing the AppMetrica SDK.
    AMAAppMetricaConfiguration *configuration = [[AMAAppMetricaConfiguration alloc] initWithAPIKey:@"API key"];
    [AMAAppMetrica activateWithConfiguration:configuration];
    return YES;
}

AppMetrica allows tracking pre-installed apps. For more information, see Tracking pre-installed apps.

Step 3. (Optional) Configure sending of events, profile attributes, and revenueStep 3. (Optional) Configure sending of events, profile attributes, and revenue

1. To collect information on user actions in the app, set up sending your own events. For more information, see Sending your own events.

2. To collect information about users, set up sending profile attributes. For more information, see Profiles.

   Note

   Unlike events, a profile attribute can take only one value. When you send a new attribute value, the old value is overwritten.

3. To track in-app purchases, set up Revenue sending. For more information, see In-App purchases.

Step 4. Test the library operationStep 4. Test the library operation

To test how the library works:

1. Start the app with the AppMetrica SDK and use it for a while.
2. Make sure your device is connected to the internet.
3. In the AppMetrica interface, make sure that:
   • There is a new user in the Audience report.
   • The number of sessions in the Engagement → Sessions report has increased.
   • There are events and profile attributes in the Events and Profiles reports.

TroubleshootingTroubleshooting

The number of sessions does not increaseThe number of sessions does not increase

Check your session tracking settings. For more information, see Tracking user activity.

There are no events in the reportThere are no events in the report

1. Perform a minimum of 10 app actions that trigger the event sending. It's necessary because AppMetrica accumulates events in the buffer and sends to the server in several parts.

2. Wait for 10 minutes and check the report. Reports don't display events immediately.

Problems with Swift Package ManagerProblems with Swift Package Manager

Read the article Problems when using Swift Package Manager.

My problem is not listedMy problem is not listed

If your problem is not listed, contact support service. Specify the following:

1. The source code snippet that shows the SDK integration to your app.

2. Application ID in the AppMetrica web interface.

3. Device ID.

   How to get Apple IDFA

   1. Install the AppMetrica app on the test device.

   2. Log in and select your app from the list.

   3. In the upper-left corner, click → Device.

   4. The Apple IDFA is shown in the IDFA field. Enter it in the AppMetrica web interface.

      Note

      You can enable attribution testing in the AppMetrica app. Enable Attribution testing for that.

4. Device model and manufacturer, platform and OS version, AppMetrica SDK version.

Learn moreLearn more

• My app didn't pass AppStore moderation
• How do I enable user location sending?

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.