使用示例

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 密钥的报告员。 您可以为每个额外的API密钥设置自己的配置。

// 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密钥初始化报告器。

2. 使用 AMAAppMetricaReporting 协议的方法来发送事件和收入。

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

要将库初始化为禁用locationTracking，请将locationTracking属性设置为AMAAppMetricaConfiguration配置的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];

要在初始化库后禁用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 类）：

• 消息：事件的简短名称或描述。
• 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 类）：

• 消息：事件的简短名称或描述。

• 参数：嵌套参数以键值对形式表示。

  网页界面AppMetrica显示事件最多五级嵌套。 如果事件有六级或更高级别，报告中只显示前五级。 您可以使用Reporting 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:
• -报告错误:选项:失败时:
• -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 类）传递以下参数：

• 用户配置文件：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 密钥，请使用 +reportECommerce:onFailure: 方法，该方法属于 AMAAppMetrica 类。

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

要将 AMAMutableRevenueInfo 实例发送到主 API 密钥，请使用 +reportRevenue:onFailure: 方法（属于 AMAAppMetrica 类）。

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

1. 导入必要的模块：

   Swift

   面向对象的 C

   import AppMetricaCore
   import FairBidSDK
   

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

2. 创建一个函数，用于将广告收入数据传递到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
       adRevenueInfo.payload = [
         "original_ad_type": String(impressionData.placementType.rawValue),
       ]
   
       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];
       adRevenueInfo.payload = @{
           @"original_ad_type": @(impressionData.placementType)
       };
   
       [AppMetrica reportAdRevenue:adRevenueInfo completion:^(NSError *error) {
           if (error) {
               NSLog(@"Failed to report ad revenue to AppMetrica: %@", error);
           }
       }];
   }
   

3. 添加一个扩展，将 Fyber 价格转换为 AppMetrica 格式：

   Swift

   面向对象的 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
       adRevenueInfo.payload = [
           "original_ad_type": "offerWall"
       ]
   
       AppMetrica.reportAdRevenue(adRevenueInfo) { error in
           print("Failed to report OfferWall show to AppMetrica: \(error)")
       }
   }
   

   - (void)reportOfferWallShowToAppMetricaWithPlacementId:(NSString *)placementId {
       AMAMutableAdRevenueInfo *adRevenueInfo = [[AMAMutableAdRevenueInfo alloc] initWithAdRevenue:[NSDecimalNumber zero] currency:@"USD"];
   
       adRevenueInfo.adType = AMAAdTypeOther;
       adRevenueInfo.adUnitID = placementId;
       adRevenueInfo.payload = @{
           @"original_ad_type": @"offerWall"
       };
   
       [AMAYandexMetrica 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

   面向对象的 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"
           }
       }
   }
   
   enum GAAdType: String {
       case banner = "bannerAd"
       case interstitial = "interstitialAd"
       case rewarded = "rewardedAd"
       case native = "nativeAd"
       case appOpen = "appOpenAd"
   }
   
   

   @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
   
   typedef NSString *GAAdType NS_TYPED_ENUM;
   
   GAAdType GAAdTypeBanner = @"bannerAd";
   GAAdType GAAdTypeInterstitial = @"interstitialAd";
   GAAdType GAAdTypeRewarded = @"rewardedAd";
   GAAdType GAAdTypeNative = @"nativeAd";
   GAAdType GAAdTypeAppOpen = @"appOpen";
   

3. 实现广告加载逻辑并生成展现报告：

   Swift

   面向对象的 C

   class ViewController: UIViewController, GADFullScreenContentDelegate {
       var rewardedAd: GADRewardedAd?
   
       func requestRewardedAd() {
           let originalType: GAAdType = .rewarded
           let adType: AdType = .rewarded
   
           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 = adType
                       adRevenueInfo.adNetwork = adSourceName ?? "AdMob"
                       adRevenueInfo.adUnitID = adUnitId
                       adRevenueInfo.adPlacementID = adSourceId
                       adRevenueInfo.precision = precision.description
   
                       // Create payload with additional information
                       var payload: [String: String] = [
                           "original_ad_type": originalType.rawValue
                       ]
                       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 {
       GAAdType originalType = GAAdTypeRewarded;
       AMAAdType adType = AMAAdTypeRewarded;
       [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
               AMAMutableAdRevenueInfo *adRevenueInfo = [[AMAMutableAdRevenueInfo alloc] initWithAdRevenue:value.doubleValue currency:currencyCode];
               adRevenueInfo.adType = adType;
               adRevenueInfo.adNetwork = @"AdMob";
               adRevenueInfo.adUnitID = adUnitId;
               adRevenueInfo.precision = [NSString stringWithFormat:@"%ld", (long)precision];
               adRevenueInfo.payload = @{
                   @"original_ad_type": originalType
               };
   
               // Report to AppMetrica
               [AMAYandexMetrica reportAdRevenue:adRevenueInfo onFailure:^(NSError *error) {
                   NSLog(@"Failed to report ad revenue: %@", error);
               }];
           };
       }];
   }
   
   @end
   

调整实现以支持其他广告格式

1. 将 GADRewardedAd 替换为适当的类：

   • Banner: GADBannerView
   • Interstitial: GADInterstitialAd
   • Native: GADNativeAd
   • AppOpen: GADAppOpenAd

2. 修改 originalType 和 adType 参数在 requestRewardedAd 方法中：

   Swift

   Objective-C

   // For banner ads
   let originalType: GAAdType = .banner
   let adType: AdType = .banner
   
   // For interstitial and rewarded interstitial ads
   let originalType: GAAdType = .interstitial
   let adType: AdType = .interstitial
   
   // For native ads
   let originalType: GAAdType = .native
   let adType: AdType = .native
   
   // For rewarded ads (current example)
   let originalType: GAAdType = .native
   let adType: AdType = .rewarded     
   
   // For app open ads
   let originalType: GAAdType = .appOpen
   let adType: AdType = .appOpen
   

   // For banner ads
   GAAdType originalType = GAAdTypeBanner;
   AMAAdType adType = AMAAdTypeBanner;
   
   // For interstitial and rewarded interstitial ads
   GAAdType originalType = GAAdTypeInterstitial;
   AMAAdType adType = AMAAdTypeInterstitial;
   
   // For native ads
   GAAdType originalType = GAAdTypeNative;
   AMAAdType adType = AMAAdTypeNative;
   
   // For rewarded ads (current example)
   GAAdType originalType = GAAdTypeRewarded;
   AMAAdType adType = AMAAdTypeRewarded;
   
   // For app open ads
   GAAdType originalType = GAAdTypeAppOpen;
   AMAAdType adType = AMAAdTypeOther;
   

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. 对于中断广告、带奖励的中断广告和原生广告，请将paidEventHandler添加到广告加载完成处理程序中，如带奖励广告的示例所示。

来自 ironSource SDK 的广告收入数据通过 AppMetricaIronSourceAdapter 传递到 AppMetrica：

• 适配器可通过 CocoaPods 获取。 将以下行添加到你的 Podfile：

  pod 'AppMetricaIronSourceAdapter'
  

• 必须在激活 ironSource 之前初始化适配器。

• AppMetrica 仅应在应用生命周期中激活一次。 不管是在初始化适配器之前还是之后做，都没有关系。

1. 导入所需的模块：

   Swift

   Objective-C

   import AppMetricaCore
   import AppMetricaIronSourceAdapter
   import IronSource
   

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

2. 在激活 ironSource 之前，初始化 AppMetricaIronSourceAdapter。 通常可以在应用程序的初始化代码中完成这一步。 例如，在AppDelegate结构中，或者主应用程序中用于SwiftUI应用。

   Swift

   面向对象的C

   AppMetricaIronSourceAdapter.shared.initialize()
   

   [[AppMetricaIronSourceAdapter shared] initialize];
   

3. 配置并激活 ironSource 和 AppMetrica：

   Swift

   面向对象的 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];
   

1. 导入必要的模块：

   Swift

   面向对象的 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. 创建一个函数，用于将广告收入数据传递到AppMetrica：

   Swift

   Objective-C

   enum ATAdType: String {
       case rewarded = "rewardedAd"
       case interstitial = "interstitialAd"
       case splash = "splashAd"
       case banner = "bannerAd"
       case native = "nativeAd"
       case mediaVideo = "mediaVideoAd"
   }
   
   func reportToAppMetrica(
       _ extra: [AnyHashable: Any],
       placementID: String,
       adType: AdType,
       originalAdType: ATAdType
   ) {
       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] = [
           "original_ad_type": originalAdType.rawValue
       ]
       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)")
       }
   }
   

   typedef NSString *ATAdType NS_TYPED_ENUM;
   
   ATAdType ATAdTypeRewarded = @"rewardedAd";
   ATAdType ATAdTypeInterstitial = @"interstitialAd";
   ATAdType ATAdTypeSplash = @"splashAd";
   ATAdType ATAdTypeBanner = @"bannerAd";
   ATAdType ATAdTypeNative = @"nativeAd";
   ATAdType ATAdTypeMediaVideo = @"mediaVideoAd";
   
   - (void)reportToAppMetricaWithExtra:(NSDictionary<AnyHashable, id> *)extra
                           placementID:(NSString *)placementID
                                adType:(AdType)adType
                        originalAdType:(ATAdType)originalAdType {
       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];
       payload[@"original_ad_type"] = originalAdType;
       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,
               originalAdType: .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,
               originalAdType: .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,
               originalAdType: .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,
               originalAdType: .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,
               originalAdType: .splash
           )
       }
       // Implement other delegate methods as needed
   }
   
   class YourMediaVideoDelegate: NSObject, ATMediaVideoDelegate {
       func mediaVideoDidStartPlaying(forPlacementID placementID: String, extra: [AnyHashable : Any]) {
           reportToAppMetrica(
               extra,
               placementID: placementID,
               adType: .other,
               originalAdType: .mediaVideo
           )
       }
       // 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 密钥，使用 +reportAdRevenue:onFailure: 方法（AppMetrica 类）。

   Swift

   面向对象的 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];

要手动跟踪通过通用链接或深层链接打开应用，请在 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)
    }
}

要手动跟踪通过通用链接或深层链接在运行中的应用打开，请使用以下代码：

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

要手动跟踪通过通用链接或深层链接打开应用，请使用 +trackOpeningURL: 方法，该方法属于 AMAAppMetrica 类。

要手动跟踪通过深链或在运行的应用中处理深链的应用打开，请使用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
}

要做到这一点，请使用AppMetricaAppMetricaConfiguration扩展的启动配置来初始化SDK。

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