Usage examples

1. Initialize an instance of the AMAAppMetricaConfiguration class.
2. Specify the configuration settings using methods of the AMAAppMetricaConfiguration class. For example, enable logging or set a session timeout.
3. Pass the AMAAppMetricaConfiguration instance to the +activateWithConfiguration: method of the AMAAppMetrica class.

The parameters of the extended configuration are applied from the time of library initialization. To configure the library while the app is running, use the AMAAppMetrica class methods.

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    // Creating an extended library configuration.
    AMAAppMetricaConfiguration *configuration = [[AMAAppMetricaConfiguration alloc] initWithAPIKey:@"API key"];
    // Setting up the configuration. For example, to enable logging.
    configuration.logsEnabled = YES;
    // ...
    // Initializing the AppMetrica SDK.
    [AMAAppMetrica activateWithConfiguration:configuration];
    return YES;
}

1. Initialize an instance of the AMAMutableReporterConfiguration class.
2. Specify the configuration settings using methods of the AMAMutableReporterConfiguration class. For example, enable logging or set a session timeout.
3. Pass the AMAMutableReporterConfiguration instance to the +activateReporterWithConfiguration: method of the AMAAppMetrica class.
4. This configuration is used for a reporter with the specified API key. You can set up your own configuration for each additional API key.

// Creating an extended library configuration.
// To create it, pass an API key that is different from the app's API key.
AMAMutableReporterConfiguration *reporterConfiguration = [[AMAMutableReporterConfiguration alloc] initWithAPIKey:@"API key"];
// Setting up the configuration. For example, to enable logging.
reporterConfiguration.logsEnabled = YES;
// ...
// Initializing a reporter.
[AMAAppMetrica activateReporterWithConfiguration:[reporterConfiguration copy]];

1. Use the +reporterForAPIKey: method of the AMAAppMetrica class to get the instance that implements the AMAAppMetricaReporting protocol.

   If the reporter was not initialized with the extended configuration, calling this method will initialize the reporter for the specified API key.

2. Use methods of the AMAAppMetricaReporting protocol to send events and revenue.

3. To ensure that sessions are tracked correctly, set up sending session start and pause events for each reporter.

id<AMAAppMetricaReporting> reporter = [AMAAppMetrica reporterForAPIKey:@"API key"];
[reporter resumeSession];
// ...
[reporter reportEvent:@"Updates installed" onFailure:^(NSError *error) {
    NSLog(@"REPORT ERROR: %@", [error localizedDescription]);
}];
// ...
[reporter pauseSession];

To do this, set the NO value for the autoCrashTracking property of the AMAAppMetricaCrashesConfiguration configuration.

// Creating a crashes configuration.
AMAAppMetricaCrashesConfiguration *configuration = [[AMAAppMetricaCrashesConfiguration alloc] init];
// Disabling sending the information on crashes of the application.
configuration.autoCrashTracking = NO;
// Set the configuration in AppMetricaCrashes.
[[AMAAppMetricaCrashes crashes] setConfiguration:configuration];

To initialize a library with locationTracking disabled, set the locationTracking property of the AMAAppMetricaConfiguration configuration to NO.

// Creating an extended library configuration.
AMAAppMetricaConfiguration *configuration = [[AMAAppMetricaConfiguration alloc] initWithAPIKey:@"API key"];
// Disabling sending information about the device location.
configuration.locationTracking = NO;
// Initializing the AppMetrica SDK.
[AMAAppMetrica activateWithConfiguration:configuration];

To disable locationTracking after initializing the library, use the +setLocationTrackingEnabled: method of the AMAAppMetrica class:

AMAAppMetrica.locationTrackingEnabled = NO;

To send custom device location, pass the CLLocation instance to the setCustomLocation method of the AMAAppMetrica class.

- (void)locationManager:(CLLocationManager *)manager
    didUpdateToLocation:(CLLocation *)newLocation
           fromLocation:(CLLocation *)oldLocation
{
    AMAAppMetrica.customLocation = newLocation;
}

To send custom device location using the startup configuration, pass the CLLocation instance to the customLocation property of the AMAAppMetricaConfiguration configuration.

// Creating an extended library configuration.
AMAAppMetricaConfiguration *configuration = [[AMAAppMetricaConfiguration alloc] initWithAPIKey:@"API key"];
// Set a custom location.
configuration.customLocation = [[CLLocation alloc] initWithLatitude:0 longitude:0];
// Initializing the AppMetrica SDK.
[AMAAppMetrica activateWithConfiguration:configuration];

To send a custom event without nested parameters, pass the following parameters to the +reportEvent:onFailure: method of the AMAAppMetrica class:

• message: Short name or description of the event.
• onFailure: The block the error is passed to. If you do not want to track the error, pass nil for this block.

NSString *message = @"Updates installed";
[AMAAppMetrica reportEvent:message onFailure:^(NSError *error) {
    NSLog(@"DID FAIL REPORT EVENT: %@", message);
    NSLog(@"REPORT ERROR: %@", [error localizedDescription]);
}];

To send a custom event with nested parameters, pass the following parameters to the +reportEvent:parameters:onFailure: method of the AMAAppMetrica class:

• message: Short name or description of the event.

• parameters: Nested parameters as key-value pairs.

  The AppMetrica web interface displays up to five nesting levels for events. So if an event has six or more levels, only the top five are shown in the report. You can use the Reporting API to export up to ten levels.

• onFailure: The block the error is passed to. If you do not want to track the error, pass nil for this block.

NSString *message = @"Updates installed";
NSDictionary *params = @{@"key1": @"value1", @"key2": @"value2"};
[AMAAppMetrica reportEvent:message parameters:params onFailure:^(NSError *error) {
    NSLog(@"DID FAIL REPORT EVENT: %@", message);
    NSLog(@"REPORT ERROR: %@", [error localizedDescription]);
}];

Add the import:

#import <AppMetricaWebKit/AppMetricaWebKit.h>

Initialize the sending by calling the +setupWebViewReporting:onFailure: method:

WKUserContentController *userController = [[WKUserContentController alloc] init];
[AMAAppMetrica setupWebViewReporting:[[AMAJSController alloc] initWithUserContentController:userController] onFailure:nil];
[userController addScriptMessageHandler:myHandler name:myScriptName];
WKWebViewConfiguration *configuration = [[WKWebViewConfiguration alloc] init];
configuration.userContentController = userController;
WKWebView *webView = [[WKWebView alloc] initWithFrame:CGRectZero configuration:configuration];

To send a custom error message, add the import:

#import <AppMetricaCrashes/AppMetricaCrashes.h>

Then use the methods of the AMAAppMetricaCrashes class and the AMAAppMetricaCrashReporting protocol:

• -reportError:onFailure:
• -reportError:options:onFailure:
• -reportNSError:onFailure:
• -reportNSError:options:onFailure:

To send error messages, you can use the standard NSError class, the simplified AMAError class, or the AMAErrorRepresentable protocol.

If errors are sent using the AMAError class or the AMAErrorRepresentable protocol, they're grouped by the identifier.

AMAError *underlyingError = [AMAError errorWithIdentifier:@"Underlying AMAError"];
AMAError *error = [AMAError errorWithIdentifier:@"AMAError identifier"
                                        message:@"Another custom message"
                                     parameters:@{ @"foo": @"bar" }
                                      backtrace:NSThread.callStackReturnAddresses
                                underlyingError:underlyingError];
[[AMAAppMetricaCrashes crashes] reportError:error onFailure:nil];

To send the ProfileId, use the +setUserProfileID: method of the AMAAppMetrica class.

AMAAppMetrica.userProfileID = @"id";

To send profile attributes, pass the following parameters to the +reportUserProfile:onFailure: method of the AMAAppMetrica class:

• userProfile: The AMAUserProfile instance that contains an array of attribute updates. To create profile attributes, use methods of the AMAProfileAttribute class.
• onFailure: The block the error is passed to. If you do not want to track the error, pass nil for this block.

AMAMutableUserProfile *profile = [[AMAMutableUserProfile alloc] init];
// Updating a single user profile attribute.
id<AMACustomCounterAttribute> timeLeftAttribute = [AMAProfileAttribute customCounter:@"time_left"];
[profile apply:[timeLeftAttribute withDelta:-4.42]];
// Updating multiple attributes.
[profile applyFromArray:@[
    // Updating predefined attributes.
    [[AMAProfileAttribute name] withValue:@"John"],
    [[AMAProfileAttribute gender] withValue:AMAGenderTypeMale],
    [[AMAProfileAttribute birthDate] withAge:24],
    [[AMAProfileAttribute notificationsEnabled] withValue:NO],
    // Updating custom attributes.
    [[AMAProfileAttribute customString:@"born_in"] withValueIfUndefined:@"Moscow"],
    [[AMAProfileAttribute customString:@"address"] withValueReset],
    [[AMAProfileAttribute customNumber:@"age"] withValue:24],
    [[AMAProfileAttribute customCounter:@"logins_count"] withDelta:1],
    [[AMAProfileAttribute customBool:@"has_premium"] withValue:YES]
]];
// ProfieID is set using the method of the AMAAppMetrica class.
[AMAAppMetrica setUserProfileID:@"id"];

// Sending profile attributes.
[AMAAppMetrica reportUserProfile:[profile copy] onFailure:^(NSError *error) {
    NSLog(@"Error: %@", error);
}];

To send the AMAECommerce instance to the main API key, use the +reportECommerce:onFailure: method of the AMAAppMetrica class.

// ...
// Sending an e-commerce event.
[AMAAppMetrica reportECommerce:[AMAECommerce showScreenEventWithScreen:screen] onFailure:nil];

To send the AMAMutableRevenueInfo instance to the main API key, use the +reportRevenue:onFailure: method of the AMAAppMetrica class.

// ...
// Sending the Revenue instance.
[AMAAppMetrica reportRevenue:[revenueInfo copy] onFailure:^(NSError *error) {
   NSLog(@"Revenue error: %@", error);
}];

1. Import the required modules:

   Swift

   Objective-C

   import AppMetricaCore
   import FairBidSDK
   

   #import <AppMetricaCore/AppMetricaCore.h>
   #import <FairBidSDK/FairBidSDK.h>
   

2. Create a function for passing ad revenue data to AppMetrica:

   Swift

   Objective-C

   func reportToAppMetrica(_ impressionData: FYBImpressionData, placementId: String, adType: AdType) {
       let revenue = impressionData.netPayout.map { NSDecimalNumber(decimal: $0.decimalValue) } ?? .zero
       let currency = impressionData.currency ?? "USD"
   
       let adRevenueInfo = MutableAdRevenueInfo(adRevenue: revenue, currency: currency)
       adRevenueInfo.adType = adType
       adRevenueInfo.adNetwork = impressionData.demandSource
       adRevenueInfo.adUnitID = impressionData.creativeId
       adRevenueInfo.precision = impressionData.priceAccuracy.appMetricaPrecision
   
       AppMetrica.reportAdRevenue(adRevenueInfo) { error in
           print("Failed to report ad revenue to AppMetrica: \(error)")
       }
   }
   

   void reportToAppMetrica(FYBImpressionData *impressionData, NSString *placementId, AdType adType) {
       NSDecimalNumber *revenue = impressionData.netPayout ? [[NSDecimalNumber alloc] initWithDecimal:impressionData.netPayout.decimalValue] : [NSDecimalNumber zero];
       NSString *currency = impressionData.currency ? impressionData.currency : @"USD";
   
       MutableAdRevenueInfo *adRevenueInfo = [[MutableAdRevenueInfo alloc] initWithAdRevenue:revenue currency:currency];
       adRevenueInfo.adType = adType;
       adRevenueInfo.adNetwork = impressionData.demandSource;
       adRevenueInfo.adUnitID = impressionData.creativeId;
       adRevenueInfo.precision = [impressionData.priceAccuracy appMetricaPrecision];
   
       [AppMetrica reportAdRevenue:adRevenueInfo completion:^(NSError *error) {
           if (error) {
               NSLog(@"Failed to report ad revenue to AppMetrica: %@", error);
           }
       }];
   }
   

3. Add an extension for converting Fyber prices to the AppMetrica format:

   Swift

   Objective-C

   extension FYBImpressionDataPriceAccuracy {
       var appMetricaPrecision: String {
           switch self {
           case .undisclosed: return "undisclosed"
           case .predicted: return "predicted"
           case .programmatic: return "programmatic"
           @unknown default: return "unknown"
           }
       }
   }
   

   @implementation NSNumber (FYBImpressionDataPriceAccuracyAppMetricaPrecision)
   
   + (NSString *)appMetricaPrecisionForFYBImpressionDataPriceAccuracy:(FYBImpressionDataPriceAccuracy)accuracy {
       switch (accuracy) {
           case FYBImpressionDataPriceAccuracyUndisclosed:
               return @"undisclosed";
           case FYBImpressionDataPriceAccuracyPredicted:
               return @"predicted";
           case FYBImpressionDataPriceAccuracyProgrammatic:
               return @"programmatic";
           default:
               return @"unknown";
       }
   }
   
   @end
   

4. Create a function for sending Offerwall impression reports to AppMetrica:

   Swift

   Objective-C

   func reportOfferWallShowToAppMetrica(placementId: String) {
       let adRevenueInfo = MutableAdRevenueInfo(adRevenue: NSDecimalNumber.zero, currency: "USD")
       adRevenueInfo.adType = .other
       adRevenueInfo.adUnitID = placementId
   
       AppMetrica.reportAdRevenue(adRevenueInfo) { error in
           print("Failed to report OfferWall show to AppMetrica: \(error)")
       }
   }
   

   - (void)reportOfferWallShowToAppMetricaWithPlacementId:(NSString *)placementId {
       YMMMutableAdRevenueInfo *adRevenueInfo = [[YMMMutableAdRevenueInfo alloc] initWithAdRevenue:[NSDecimalNumber zero] currency:@"USD"];
   
       adRevenueInfo.adType = YMMAdTypeOther;
       adRevenueInfo.adUnitID = placementId;
   
       [YMMYandexMetrica reportAdRevenueWithInfo:adRevenueInfo completionHandler:^(NSError * _Nullable error) {
           if (error) {
               NSLog(@"Failed to report OfferWall show to AppMetrica: %@", error);
           }
       }];
   }
   

5. Create delegates and their corresponding methods for each ad format:

   Swift

   Objective-C

   class YourBannerDelegate: NSObject, FYBBannerDelegate {
       func bannerDidShow(_ banner: FYBBannerAdView, impressionData: FYBImpressionData) {
           reportToAppMetrica(impressionData, placementId: banner.options.placementId, adType: .banner)
       }
       // Implement other delegate methods as needed
   }
   
   class YourInterstitialDelegate: NSObject, FYBInterstitialDelegate {
       func interstitialDidShow(_ placementId: String, impressionData: FYBImpressionData) {
           reportToAppMetrica(impressionData, placementId: placementId, adType: .interstitial)
       }
       // Implement other delegate methods as needed
   }
   
   class YourRewardedDelegate: NSObject, FYBRewardedDelegate {
       func rewardedDidShow(_ placementId: String, impressionData: FYBImpressionData) {
           reportToAppMetrica(impressionData, placementId: placementId, adType: .rewarded)
       }
       // Implement other delegate methods as needed
   }
   
   class YourOfferWallDelegate: NSObject, OfferWallDelegate {
       func didShow(_ placementId: String?) {
           reportOfferWallShowToAppMetrica(placementId: placementId ?? "unknown")
       }
       // Implement other delegate methods as needed
   }
   

   // YourBannerDelegate
   @interface YourBannerDelegate : NSObject <FYBBannerDelegate>
   @end
   
   @implementation YourBannerDelegate
   - (void)bannerDidShow:(FYBBannerAdView *)banner impressionData:(FYBImpressionData *)impressionData {
       [self reportToAppMetricaWithImpressionData:impressionData placementId:banner.options.placementId adType:AdTypeBanner];
   }
   // Implement other delegate methods as needed
   @end
   
   // YourInterstitialDelegate
   @interface YourInterstitialDelegate : NSObject <FYBInterstitialDelegate>
   @end
   
   @implementation YourInterstitialDelegate
   - (void)interstitialDidShowWithPlacementId:(NSString *)placementId impressionData:(FYBImpressionData *)impressionData {
       [self reportToAppMetricaWithImpressionData:impressionData placementId:placementId adType:AdTypeInterstitial];
   }
   // Implement other delegate methods as needed
   @end
   
   // YourRewardedDelegate
   @interface YourRewardedDelegate : NSObject <FYBRewardedDelegate>
   @end
   
   @implementation YourRewardedDelegate
   - (void)rewardedDidShowWithPlacementId:(NSString *)placementId impressionData:(FYBImpressionData *)impressionData {
       [self reportToAppMetricaWithImpressionData:impressionData placementId:placementId adType:AdTypeRewarded];
   }
   // Implement other delegate methods as needed
   @end
   
   // YourOfferWallDelegate
   @interface YourOfferWallDelegate : NSObject <OfferWallDelegate>
   @end
   
   @implementation YourOfferWallDelegate
   - (void)didShowWithPlacementId:(NSString *)placementId {
       // Assuming reportOfferWallShowToAppMetrica is implemented elsewhere
       [self reportOfferWallShowToAppMetricaWithPlacementId:placementId ? placementId : @"unknown"];
   }
   // Implement other delegate methods as needed
   @end
   

1. Import the required modules:

   Swift

   Objective-C

   import AppMetricaCore
   import GoogleMobileAds
   

   #import <AppMetricaCore/AppMetricaCore.h>
   #import <GoogleMobileAds/GoogleMobileAds.h>
   

2. Add a helper extension for GADAdValuePrecision:

   Swift

   Objective-C

   extension GADAdValuePrecision: CustomStringConvertible {
       public var description: String {
           switch self {
           case .precise: return "precise"
           case .estimated: return "estimated"
           case .publisherProvided: return "publisher_defined"
           case .unknown: fallthrough
           @unknown default: return "unknown"
           }
       }
   }
   

   @interface GADAdValuePrecisionHelper : NSObject
   
   + (NSString *)stringFromAdValuePrecision:(GADAdValuePrecision)precision;
   
   @end
   
   @implementation GADAdValuePrecisionHelper
   
   + (NSString *)stringFromAdValuePrecision:(GADAdValuePrecision)precision {
       switch (precision) {
           case GADAdValuePrecisionPrecise:
               return @"precise";
           case GADAdValuePrecisionEstimated:
               return @"estimated";
           case GADAdValuePrecisionPublisherProvided:
               return @"publisher_defined";
           case GADAdValuePrecisionUnknown:
           default:
               return @"unknown";
       }
   }
   
   @end
   

3. Implement the logic for loading ads and generating impression reports:

   Swift

   Objective-C

   class ViewController: UIViewController, GADFullScreenContentDelegate {
       var rewardedAd: GADRewardedAd?
   
       func requestRewardedAd() {
           GADRewardedAd.load(
               withAdUnitID: "AD_UNIT_ID", request: GADRequest()
           ) { [weak self] (ad, error) in
               if let error = error {
                   print("Rewarded ad failed to load with error: \(error.localizedDescription)")
                   return
               }
               if let ad = ad {
                   self?.rewardedAd = ad
                   self?.rewardedAd?.paidEventHandler = { adValue in
                       // Extract the impression-level ad revenue data
                       let value = adValue.value
                       let precision = adValue.precision
                       let currencyCode = adValue.currencyCode
   
                       // Get the ad unit ID
                       let adUnitId = ad.adUnitID
   
                       // Get additional response info
                       let responseInfo = ad.responseInfo
                       let loadedAdNetworkResponseInfo = responseInfo.loadedAdNetworkResponseInfo
                       let adSourceId = loadedAdNetworkResponseInfo?.adSourceID
                       let adSourceInstanceId = loadedAdNetworkResponseInfo?.adSourceInstanceID
                       let adSourceInstanceName = loadedAdNetworkResponseInfo?.adSourceInstanceName
                       let adSourceName = loadedAdNetworkResponseInfo?.adSourceName
                       let mediationGroupName = responseInfo.extrasDictionary["mediation_group_name"] as? String
                       let mediationABTestName = responseInfo.extrasDictionary["mediation_ab_test_name"] as? String
                       let mediationABTestVariant = responseInfo.extrasDictionary["mediation_ab_test_variant"] as? String
   
                       // Create AdRevenueInfo object
                       let adRevenueInfo = MutableAdRevenueInfo(adRevenue: value, currency: currencyCode)
                       adRevenueInfo.adType = .rewarded
                       adRevenueInfo.adNetwork = adSourceName ?? "AdMob"
                       adRevenueInfo.adUnitID = adUnitId
                       adRevenueInfo.adPlacementID = adSourceId
                       adRevenueInfo.precision = precision.description
   
                       // Create payload with additional information
                       var payload: [String: String] = [:]
                       if let adSourceInstanceId = adSourceInstanceId {
                           payload["ad_source_instance_id"] = adSourceInstanceId
                       }
                       if let adSourceInstanceName = adSourceInstanceName {
                           payload["ad_source_instance_name"] = adSourceInstanceName
                       }
                       if let mediationGroupName = mediationGroupName {
                          payload["mediation_group_name"] = mediationGroupName
                       }
                       if let mediationABTestName = mediationABTestName {
                          payload["mediation_ab_test_name"] = mediationABTestName
                       }
                       if let mediationABTestVariant = mediationABTestVariant {
                          payload["mediation_ab_test_variant"] = mediationABTestVariant
                       }
   
                       adRevenueInfo.payload = payload
   
                       // Report to AppMetrica
                       AppMetrica.reportAdRevenue(adRevenueInfo) { error in
                           print("Failed to report ad revenue: \(error)")
                       }
                   }
               }
            }
       }
   }
   

   @interface ViewController : UIViewController <GADFullScreenContentDelegate>
   
   @property (nonatomic, strong) GADRewardedAd *rewardedAd;
   
   @end
   
   @implementation ViewController
   
   - (void)requestRewardedAd {
       [GADRewardedAd loadWithAdUnitID:@"AD_UNIT_ID"
                               request:[GADRequest request]
                     completionHandler:^(GADRewardedAd * _Nullable rewardedAd, NSError * _Nullable error) {
   
           if (error) {
               NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
               return;
           }
   
           self.rewardedAd = rewardedAd;
           __weak typeof(self) weakSelf = self; // Avoid strong reference cycles
           self.rewardedAd.paidEventHandler = ^(GADAdValue *adValue) {
               // Extract the impression-level ad revenue data
               NSDecimalNumber *value = adValue.value;
               GADAdValuePrecision precision = adValue.precision;
               NSString *currencyCode = adValue.currencyCode;
   
               // Get the ad unit ID
               NSString *adUnitId = weakSelf.rewardedAd.adUnitID;
   
               // Create AdRevenueInfo object
               YMMMutableAdRevenueInfo *adRevenueInfo = [[YMMMutableAdRevenueInfo alloc] initWithAdRevenue:value.doubleValue currency:currencyCode];
               adRevenueInfo.adType = YMMAdTypeRewarded;
               adRevenueInfo.adNetwork = @"AdMob";
               adRevenueInfo.adUnitID = adUnitId;
               adRevenueInfo.precision = [NSString stringWithFormat:@"%ld", (long)precision];
   
               // Report to AppMetrica
               [YMMYandexMetrica reportAdRevenue:adRevenueInfo onFailure:^(NSError *error) {
                   NSLog(@"Failed to report ad revenue: %@", error);
               }];
           };
       }];
   }
   
   @end
   

Adapt the implementation for other ad formats

1. Replace GADRewardedAd with an appropriate class:

   • Banner: GADBannerView
   • Interstitial: GADInterstitialAd
   • Rewarded interstitial: GADRewardedInterstitialAd
   • Native: GADNativeAd

2. Change the adType when creating an AdRevenueInfo object:

   Swift

   Objective-C

   adRevenueInfo.adType = .banner       // For banner ads
   adRevenueInfo.adType = .interstitial // For interstitial and rewarded interstitial ads
   adRevenueInfo.adType = .native       // For native ads
   adRevenueInfo.adType = .rewarded     // For rewarded ads (current example)
   

   // For banner ads
   adRevenueInfo.adType = AdTypeBanner;
   
   // For interstitial and rewarded interstitial ads
   adRevenueInfo.adType = AdTypeInterstitial;
   
   // For native ads
   adRevenueInfo.adType = AdTypeNative;
   
   // For rewarded ads (current example)
   adRevenueInfo.adType = AdTypeRewarded;
   

3. Configure the paidEventHandler at the appropriate stage of the ad loading process for each format. The implementation of the handler itself remains the same.

4. For banner ads, add the paidEventHandler directly to the GADBannerView instance:

   Swift

   Objective-C

   bannerView.paidEventHandler = { adValue in
       // Use the same implementation as in the rewarded ad example
   }
   

   bannerView.paidEventHandler = ^(GADAdValue *adValue) {
       // Use the same implementation as in the rewarded ad example
   };
   

5. For interstitial, rewarded interstitial, and native ads, add the paidEventHandler to the ad loading completion handler as shown in the example with rewarded ads.

Ad Revenue data from the ironSource SDK is passed to AppMetrica via the AppMetricaIronSourceAdapter:

• The adapter must be initialized before activating ironSource.
• AppMetrica should only be activated once during the app lifecycle. It doesn't matter if you do it before or after initializing the adapter.

1. Import the required modules:

   Swift

   Objective-C

   import AppMetricaCore
   import AppMetricaIronSourceAdapter
   import IronSource
   

   #import <AppMetricaCore/AppMetricaCore.h>
   #import <AppMetricaIronSourceAdapter/AppMetricaIronSourceAdapter.h>
   import <IronSource/IronSource.h>
   

2. Initialize the AppMetricaIronSourceAdapter before activating ironSource. You can usually do this in the app's initialization code. For example, in the AppDelegate structure or the main App for SwiftUI apps.

   Swift

   Objective-C

   AppMetricaIronSourceAdapter.shared.initialize()
   

   [[AppMetricaIronSourceAdapter shared] initialize];
   

3. Configure and activate ironSource and AppMetrica:

   Swift

   Objective-C

   // Initialize IronSource
   IronSource.initWithAppKey("YOUR_IRONSOURCE_APP_KEY", adUnits: [IS_BANNER, IS_INTERSTITIAL, IS_REWARDED_VIDEO])
   
   // Activate AppMetrica
   guard let configuration = AppMetricaConfiguration(apiKey: "YOUR_APPMETRICA_API_KEY") else { return }
   AppMetrica.activate(with: configuration)
   

   // Initialize IronSource
   [IronSource initWithAppKey:@"YOUR_IRONSOURCE_APP_KEY" adUnits:@[IS_BANNER, IS_INTERSTITIAL, IS_REWARDED_VIDEO]];
   
   // Activate AppMetrica
   AppMetricaConfiguration *configuration = [[AppMetricaConfiguration alloc] initWithApiKey:@"YOUR_APPMETRICA_API_KEY"];
   if (configuration == nil) {
       return;
   }
   [AppMetrica activateWithConfiguration:configuration];
   

   Note

   The AppMetricaIronSourceAdapter automatically passes ad revenue data from ironSource to AppMetrica. You don't need to report impressions or revenue manually.

1. Import the required modules:

   Swift

   Objective-C

   import AppMetricaCore
   import AnyThinkSDK
   import AnyThinkBanner
   import AnyThinkNative
   import AnyThinkInterstitial
   import AnyThinkRewardedVideo
   import AnyThinkMediaVideo
   

   #import <AppMetricaCore/AppMetricaCore.h>
   #import <AnyThinkSDK/AnyThinkSDK.h>
   import <AnyThinkBanner/AnyThinkBanner.h>
   import <AnyThinkNative/AnyThinkNative.h>
   import <AnyThinkInterstitial/AnyThinkInterstitial.h>
   import <AnyThinkRewardedVideo/AnyThinkRewardedVideo.h>
   import <AnyThinkMediaVideo/AnyThinkMediaVideo.h>
   

2. Create a function for passing ad revenue data to AppMetrica:

   Swift

   Objective-C

   func reportToAppMetrica(_ extra: [AnyHashable: Any], placementID: String, adType: AdType) {
       guard let revenue = extra[kATADDelegateExtraPublisherRevenueKey] as? Double,
             let currency = extra[kATADDelegateExtraCurrencyKey] as? String else {
           print("Missing required revenue information")
           return
       }
   
       let adRevenueInfo = MutableAdRevenueInfo(adRevenue: NSDecimalNumber(value: revenue), currency: currency)
   
       adRevenueInfo.adType = adType
       adRevenueInfo.adNetwork = extra[kATADDelegateExtraNetworkNameKey] as? String
       adRevenueInfo.adUnitID = extra[kATADDelegateExtraAdunitIDKey] as? String
       adRevenueInfo.adPlacementID = placementID
       adRevenueInfo.precision = extra[kATADDelegateExtraPrecisionKey] as? String
   
       // Additional information in payload
       var payload: [String: String] = [:]
       if let networkFirmId = extra[kATADDelegateExtraNetworkFirmIdKey] as? Int {
           payload["network_firm_id"] = String(networkFirmId)
       }
       payload["adsource_id"] = extra[kATADDelegateExtraAdSourceIdKey] as? String
       // Add other relevant information to payload...
   
       adRevenueInfo.payload = payload
   
       AppMetrica.reportAdRevenue(adRevenueInfo) { error in
           print("Failed to report ad revenue to AppMetrica: \(error)")
       }
   }
   

   - (void)reportToAppMetricaWithExtra:(NSDictionary<AnyHashable, id> *)extra placementID:(NSString *)placementID adType:(AdType)adType {
       NSNumber *revenue = extra[kATADDelegateExtraPublisherRevenueKey];
       NSString *currency = extra[kATADDelegateExtraCurrencyKey];
   
       if (revenue == nil || currency == nil) {
           NSLog(@"Missing required revenue information");
           return;
       }
   
       MutableAdRevenueInfo *adRevenueInfo = [[MutableAdRevenueInfo alloc] initWithAdRevenue:[NSDecimalNumber decimalNumberWithDecimal:[revenue decimalValue]] currency:currency];
   
       adRevenueInfo.adType = adType;
       adRevenueInfo.adNetwork = extra[kATADDelegateExtraNetworkNameKey];
       adRevenueInfo.adUnitID = extra[kATADDelegateExtraAdunitIDKey];
       adRevenueInfo.adPlacementID = placementID;
       adRevenueInfo.precision = extra[kATADDelegateExtraPrecisionKey];
   
       // Additional information in payload
       NSMutableDictionary<NSString *, NSString *> *payload = [NSMutableDictionary new];
       NSNumber *networkFirmId = extra[kATADDelegateExtraNetworkFirmIdKey];
       if (networkFirmId != nil) {
           payload[@"network_firm_id"] = [networkFirmId stringValue];
       }
       payload[@"adsource_id"] = extra[kATADDelegateExtraAdSourceIdKey];
       // Add other relevant information to payload...
   
       adRevenueInfo.payload = payload;
   
       [AppMetrica reportAdRevenue:adRevenueInfo completion:^(NSError * _Nullable error) {
           if (error) {
               NSLog(@"Failed to report ad revenue to AppMetrica: %@", error);
           }
       }];
   }
   

3. Implement the corresponding delegate methods for each ad format:

   Swift

   Objective-C

   class YourBannerDelegate: NSObject, ATBannerDelegate {
       func bannerView(_ bannerView: ATBannerView, didShowAdWithPlacementID placementID: String, extra: [AnyHashable : Any]) {
           reportToAppMetrica(extra, placementID: placementID, adType: .banner)
       }
       // Implement other delegate methods as needed
   }
   
   class YourNativeDelegate: NSObject, ATNativeADDelegate {
       func didShowNativeAd(in adView: ATNativeADView, placementID: String, extra: [AnyHashable : Any]) {
           reportToAppMetrica(extra, placementID: placementID, adType: .native)
       }
       // Implement other delegate methods as needed
   }
   
   class YourInterstitialDelegate: NSObject, ATInterstitialDelegate {
       func interstitialDidShow(forPlacementID placementID: String, extra: [AnyHashable : Any]) {
           reportToAppMetrica(extra, placementID: placementID, adType: .interstitial)
       }
       // Implement other delegate methods as needed
   }
   
   class YourRewardedVideoDelegate: NSObject, ATRewardedVideoDelegate {
       func rewardedVideoDidShow(forPlacementID placementID: String, extra: [AnyHashable : Any]) {
           reportToAppMetrica(extra, placementID: placementID, adType: .rewarded)
       }
       // Implement other delegate methods as needed
   }
   
   class YourSplashDelegate: NSObject, ATSplashDelegate {
       func splashDidShow(forPlacementID placementID: String, extra: [AnyHashable : Any]) {
           reportToAppMetrica(extra, placementID: placementID, adType: .other)
       }
       // Implement other delegate methods as needed
   }
   
   class YourMediaVideoDelegate: NSObject, ATMediaVideoDelegate {
       func mediaVideoDidStartPlaying(forPlacementID placementID: String, extra: [AnyHashable : Any]) {
           reportToAppMetrica(extra, placementID: placementID, adType: .other)  media video
       }
       // Implement other delegate methods as needed
   }
   

   #import <AppMetricaCore/AppMetricaCore.h>
   #import <AnyThinkSDK/AnyThinkSDK.h>
   import <AnyThinkBanner/AnyThinkBanner.h>
   import <AnyThinkNative/AnyThinkNative.h>
   import <AnyThinkInterstitial/AnyThinkInterstitial.h>
   import <AnyThinkRewardedVideo/AnyThinkRewardedVideo.h>
   import <AnyThinkMediaVideo/AnyThinkMediaVideo.h>
   

1. Initialize the MutableAdRevenueInfo instance.

2. Send the MutableAdRevenueInfo instance to the main API key using the +reportAdRevenue:onFailure: method of the AppMetrica class.

   Swift

   Objective-C

   AppMetrica.report(adRevenue: adRevenueInfo) { error in
       print("AdRevenue error: \(error)")
   }
   

   [AMAAppMetrica reportAdRevenue:[adRevenueInfo copy] onFailure:^(NSError *error) {
       NSLog(@"AdRevenue error: %@", error);
   }];
   
   

To change the timeout length, pass the value in seconds to the sessionTimeout property of the library configuration AMAAppMetricaConfiguration.

// Creating an extended library configuration.
AMAAppMetricaConfiguration *configuration = [[AMAAppMetricaConfiguration alloc] initWithAPIKey:@"API key"];
// Setting the session timeout.
configuration.sessionTimeout = 15;
// Initializing the AppMetrica SDK.
[AMAAppMetrica activateWithConfiguration:configuration];

To specify the app version from the code, pass it to the appVersion property of the AMAAppMetricaConfiguration configuration.

// Creating an extended library configuration.
AMAAppMetricaConfiguration *configuration = [[AMAAppMetricaConfiguration alloc] initWithAPIKey:@"API key"];
// Setting the app version.
configuration.appVersion = @"1.13.2";
// Initializing the AppMetrica SDK.
[AMAAppMetrica activateWithConfiguration:configuration];

To manually track app openings via universal links or deeplinks, in UISceneDelegate, add the following code to the scene(_:willConnectTo:options:) method:

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
    // Universal Link
    if let userActivity = connectionOptions.userActivities.first {
        if userActivity.activityType == NSUserActivityTypeBrowsingWeb,
           let url = userActivity.webpageURL {
            AppMetrica.trackOpeningURL(url)
        }
    }
    
    // Deep Link
    if let context = connectionOptions.urlContexts.first {
        AppMetrica.trackOpeningURL(context.url)
    }
}

To manually track app openings via universal links or deeplinks in a running app, use the following code:

func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
    guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
          let url = userActivity.webpageURL else { return }
    AppMetrica.trackOpeningURL(url)
}

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let context = URLContexts.first else { return }
    AppMetrica.trackOpeningURL(context.url)
}

To manually track app openings via universal links or deeplinks, use the +trackOpeningURL: method of the AMAAppMetrica class.

To manually track app openings using deeplinks or deeplink handling in a running app, use UIApplicationDelegate and add the following modifications:

func application(_ application: UIApplication, openURL url: URL, sourceApplication: String?, annotation: AnyObject) -> Bool {
    AppMetrica.trackOpeningURL(url)
    return true
}

// Delegate for tracking Universal links.
func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
    if userActivity.activityType == NSUserActivityTypeBrowsingWeb {
        if let url = userActivity.webpageURL {
            AppMetrica.trackOpeningURL(url)
        }
    }
    return true
}

To do this, initialize the AppMetrica SDK using the AppMetricaConfiguration extended startup configuration.

var isFirstLaunch = false
// Creating an extended library configuration.
guard let configuration = AppMetricaConfiguration(apiKey: "API key") else {
    print("AppMetricaConfiguration initialization failed.")
    return // or return someDefaultValue or throw someError
}
// Implement the logic for detecting whether the app is starting for the first time.
// For example, you can check for files (settings, databases, and so on),
// which the app creates on its first launch.
if conditions {
    isFirstLaunch = true
}
configuration.handleFirstActivationAsUpdate = !isFirstLaunch
// Initializing the AppMetrica SDK.
AppMetrica.activate(with: configuration)

To do this, set the false value for the dataSendingEnabled property of the AppMetricaConfiguration.

// Creating an extended library configuration.
if let configuration = AppMetricaConfiguration(apiKey: "API key") {
    // Disabling sending statistics.
    configuration.dataSendingEnabled = false
    // Initializing the AppMetrica SDK.
    AppMetrica.activate(with: configuration)
}

After the user has consented to sending statistics (for example, in the app settings or in the agreement on the first start of the app), you should enable sending using the setDataSendingEnabled(_:) method of the AppMetrica class.

// Checking the status of the boolean variable. It shows the user confirmation.
if flag {
    // Enabling sending statistics.
    AppMetrica.setDataSendingEnabled(true);
}