Примеры использования методов

1. Инициализируйте объект класса AMAAppMetricaConfiguration.
2. Задайте настройки конфигурации с помощью методов класса AMAAppMetricaConfiguration. Например, включите логирование или установите таймаут сессии.
3. Передайте объект AMAAppMetricaConfiguration в метод +activateWithConfiguration: класса AMAAppMetrica.

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

- (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. Инициализируйте объект класса AMAMutableReporterConfiguration.
2. Задайте настройки конфигурации с помощью методов класса AMAMutableReporterConfiguration. Например, включите логирование или установите таймаут сессии.
3. Передайте объект AMAMutableReporterConfiguration в метод +activateReporterWithConfiguration: класса AMAAppMetrica.
4. Конфигурация применяется для репортера с указанным API key. Для каждого дополнительного 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. С помощью метода +reporterForAPIKey: класса AMAAppMetrica получите объект, который реализует протокол AMAAppMetricaReporting.

   Если репортер не был инициализирован с расширенной конфигурацией, то вызов данного метода произведет инициализацию репортера для указанного API key.

2. Используйте методы протокола AMAAppMetricaReporting для отправки событий и Revenue.

3. Чтобы сессии отслеживались правильно, настройте отправку событий о начале и приостановке сессии для каждого репортера.

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

Для этого установите значение NO для свойства autoCrashTracking конфигурации AMAAppMetricaCrashesConfiguration.

// Creating an 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];

Чтобы инициализировать библиотеку с отключенным locationTracking, установите значение NO для свойства locationTracking конфигурации AMAAppMetricaConfiguration.

// 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];

Чтобы отключить locationTracking после инициализации библиотеки, используйте метод +setLocationTrackingEnabled: класса AMAAppMetrica:

AMAAppMetrica.locationTrackingEnabled = NO;

Чтобы отправить собственную информацию о местоположении устройства, передайте объект CLLocation в метод setCustomLocation класса AMAAppMetrica.

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

Чтобы отправить собственную информацию о местоположении устройства с помощью стартовой конфигурации, передайте объект CLLocation в свойство customLocation конфигурации AMAAppMetricaConfiguration.

// 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];

Чтобы отправить собственное событие без вложенных параметров, передайте в метод +reportEvent:onFailure: класса AMAAppMetrica следующие параметры:

• message — короткое название или описание события.
• onFailure — блок, в который передается ошибка. Если вы не хотите отслеживать ошибку, то передайте в качестве блока значение nil.

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

Чтобы отправить собственное событие с вложенными параметрами, передайте в метод +reportEvent:parameters:onFailure: класса AMAAppMetrica следующие параметры:

• message — короткое название или описание события.

• parameters — вложенные параметры в виде пар «ключ-значение».

  Веб-интерфейс AppMetrica отображает до пяти уровней вложенности события. Если событие содержит шесть уровней и более, в отчете отобразятся пять верхних. С помощью API отчетов можно выгрузить до десяти уровней.

• onFailure — блок, в который передается ошибка. Если вы не хотите отслеживать ошибку, то передайте в качестве блока значение nil.

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]);
}];

Добавьте импорт:

#import <AppMetricaWebKit/AppMetricaWebKit.h>

Инициализируйте отправку вызовом метода +setupWebViewReporting:onFailure::

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];

Чтобы отправить собственное сообщение об ошибке, необходимо добавить импорт:

#import <AppMetricaCrashes/AppMetricaCrashes.h>

Далее используйте методы класса AMAAppMetricaCrashes и протокола AMAAppMetricaCrashReporting:

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

Для отправки можно использовать стандартный класс NSError, упрощенный класс AMAError или протокол AMAErrorRepresentable.

Если ошибки отправляются с использованием класса AMAError или протокола AMAErrorRepresentable, они группируются по идентификатору 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];

Чтобы отправить ProfileId, используйте метод +setUserProfileID: класса AMAAppMetrica.

AMAAppMetrica.userProfileID = @"id";

Чтобы отправить атрибуты профиля, передайте в метод +reportUserProfile:onFailure: класса AMAAppMetrica следующие параметры:

• userProfile — объект AMAUserProfile, который содержит массив обновлений атрибутов. Атрибуты профиля создаются с помощью методов класса AMAProfileAttribute.
• onFailure — блок, в который передается ошибка. Если вы не хотите отслеживать ошибку, то передайте в качестве блока значение nil.

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);
}];

Чтобы отправить объект AMAECommerce на основной API key, используйте метода +reportECommerce:onFailure: класса AMAAppMetrica.

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

Чтобы отправить объект AMAMutableRevenueInfo на основной API key, используйте метод +reportRevenue:onFailure: класса AMAAppMetrica.

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

1. Импортируйте необходимые модули:

   Swift

   Objective-C

   import AppMetricaCore
   import FairBidSDK
   

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

2. Создайте функцию для отправки Ad Revenue в 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. Добавьте расширение для преобразования формата цен Fyber в формат AppMetrica:

   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. Создайте функцию для отчета о показах OfferWall в 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. Создайте делегаты для каждого формата рекламы и соответствующие методы к ним:

   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. Импортируйте необходимые модули:

   Swift

   Objective-C

   import AppMetricaCore
   import GoogleMobileAds
   

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

2. Добавьте вспомогательное расширение для 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. Реализуйте логику загрузки рекламы и создания отчетов о показах:

   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
   

Адаптируйте реализацию для других рекламных форматов

1. Замените GADRewardedAd соответствующим классом:

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

2. Измените adType при создании объекта AdRevenueInfo:

   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. Настройте обработчик paidEventHandler на соответствующем этапе процесса загрузки рекламы для каждого формата. Реализация самого обработчика остается прежней.

4. Для баннерной рекламы установите обработчик paidEventHandler непосредственно в экземпляре GADBannerView:

   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. Для Interstitial, Rewarded interstitial и Native, установите обработчик paidEventHandler в обработчике завершения загрузки рекламы, как в примере с Rewarded.

Данные о доходах от рекламы из ironSource SDK в AppMetrica передаются с помощью AppMetricaIronSourceAdapter:

• Адаптер должен быть инициализирован до активации ironSource.
• Порядок, в котором активируются AppMetrica и адаптер, не имеет значения, но AppMetrica следует активировать только один раз в течение жизненного цикла приложения.

1. Импортируйте необходимые модули:

   Swift

   Objective-C

   import AppMetricaCore
   import AppMetricaIronSourceAdapter
   import IronSource
   

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

2. Инициализируйте AppMetricaIronSourceAdapter перед активацией ironSource. Обычно это можно сделать в коде инициализации вашего приложения, например, в структуре AppDelegate или main App для приложений SwiftUI.

   Swift

   Objective-C

   AppMetricaIronSourceAdapter.shared.initialize()
   

   [[AppMetricaIronSourceAdapter shared] initialize];
   

3. Настройте и активируйте ironSource и 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];
   

   Примечание

   AppMetricaIronSourceAdapter автоматически передает данные о доходах от рекламы из ironSource в AppMetrica. Вам не нужно вручную сообщать о показах или доходах.

1. Импортируйте необходимые модули:

   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. Создайте функцию для отправки Ad Revenue в 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. Имплементируйте соответствующие методы делегата для каждого формата рекламы:

   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. Инициализируйте объект MutableAdRevenueInfo.

2. Отправьте объект MutableAdRevenueInfo на основной API key с помощью метода +reportAdRevenue:onFailure: класса AppMetrica.

   Swift

   Objective-C

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

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

Чтобы изменить длительность таймаута, передайте значение в секундах в свойство sessionTimeout конфигурации 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];

Чтобы указать версию приложения из кода, передайте версию приложения в свойство appVersion конфигурации AMAAppMetricaConfiguration.

// 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];

Чтобы вручную отслеживать открытия приложения с помощью Universal Link/deeplink, в UISceneDelegate в метод scene(_:willConnectTo:options:) добавьте код:

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)
    }
}

Чтобы вручную отслеживать открытия приложения с помощью Universal Link/deeplink в запущенном приложении, используйте код:

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)
}

Чтобы вручную отслеживать открытия приложения с помощью Universal Link/deeplink, используйте метод +trackOpeningURL: класса AMAAppMetrica.

Чтобы вручную отслеживать открытия приложения с помощью deeplink или обработку deeplink в запущенном приложении, используйте UIApplicationDelegate и добавьте следующие изменения:

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
}

Для этого необходимо инициализировать AppMetrica SDK, используя расширенную стартовую конфигурацию AppMetricaConfiguration.

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)

Для этого установите значение false для свойства dataSendingEnabled конфигурации 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)
}

После того как пользователь дал согласие на отправку статистики (например, в настройках приложения или в соглашении при первом открытии), необходимо включить отправку с помощью метода setDataSendingEnabled(_:) класса AppMetrica.

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