Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Doanh thu từ quảng cáo ở cấp lượt hiển thị

Khi một lượt hiển thị xảy ra, Google Mobile Ads SDK sẽ cung cấp dữ liệu doanh thu từ quảng cáo liên quan đến lượt hiển thị đó. Bạn có thể sử dụng dữ liệu này để tính toán giá trị vòng đời của người dùng hoặc chuyển dữ liệu cho các hệ thống liên quan khác.

Hướng dẫn này nhằm giúp bạn triển khai tính năng thu thập dữ liệu LTV trong ứng dụng iOS.

Điều kiện tiên quyết

Đảm bảo rằng bạn đã bật tính năng thu thập dữ liệu về doanh thu từ quảng cáo ở cấp lượt hiển thị trong giao diện người dùng AdMob.

Nhập Google Mobile Ads SDK phiên bản 9.10.0 trở lên.
Thiết lập Google Mobile Ads SDK.
Để có thể nhận mọi dữ liệu về doanh thu từ quảng cáo ở cấp lượt hiển thị, bạn cần triển khai ít nhất một định dạng quảng cáo sau đây:

Xử lý sự kiện có tính phí

Giao thức uỷ quyền của mỗi định dạng quảng cáo bao gồm một phương thức didRecordPaidEventWithAdValue:. Trong vòng đời của quảng cáo, Google Mobile Ads SDK sẽ theo dõi các sự kiện hiển thị và gọi phương thức uỷ quyền này bằng đối tượng GADAdValue nhận được.

Ví dụ sau đây xử lý các sự kiện có tính phí cho một quảng cáo có tặng thưởng:

Swift

func ad(_ ad: FullScreenPresentingAd, didRecordPaidEventWith adValue: AdValue) {
  // TODO: Send the impression-level ad revenue information to your preferred
  // analytics server directly within this callback.

  // Extract the impression-level ad revenue data.
  let value = adValue.value
  let currencyCode = adValue.currencyCode
  let precision = adValue.precision

  print(
    "Ad paid event. Value: \(value) \(currencyCode), with precision: \(precision)."
  )
}

Objective-C

- (void)ad:(id<GADFullScreenPresentingAd>)ad didRecordPaidEventWithAdValue:(GADAdValue *)adValue {
  // TODO: Send the impression-level ad revenue information to your preferred
  // analytics server directly within this callback.

  // Extract the impression-level ad revenue data.
  NSDecimalNumber *value = adValue.value;
  NSString *currencyCode = adValue.currencyCode;
  GADAdValuePrecision precision = adValue.precision;

  NSLog(@"Ad paid event. Value: %@ %@, with precision: %ld.", value, currencyCode, (long)precision);
}

Xác định tên nguồn quảng cáo sự kiện tuỳ chỉnh

Đối với các nguồn quảng cáo sự kiện tuỳ chỉnh, thuộc tính adSourceName sẽ cung cấp cho bạn tên nguồn quảng cáo Custom event. Nếu bạn sử dụng nhiều sự kiện tuỳ chỉnh, thì tên nguồn quảng cáo sẽ không đủ chi tiết để phân biệt giữa nhiều sự kiện tuỳ chỉnh. Để tìm một sự kiện tuỳ chỉnh cụ thể, hãy làm theo các bước sau:

Lấy thuộc tính adNetworkClassName.
Đặt tên riêng biệt cho nguồn quảng cáo.

Ví dụ sau đây đặt tên nguồn quảng cáo riêng biệt cho một sự kiện tuỳ chỉnh:

Swift

func uniqueAdSourceName(for loadedAdNetworkResponseInfo: AdNetworkResponseInfo) -> String {
  var adSourceName: String = loadedAdNetworkResponseInfo.adSourceName ?? ""
  if adSourceName == "Custom Event" {
    if loadedAdNetworkResponseInfo.adNetworkClassName
      == "MediationExample.SampleCustomEventSwift"
    {
      adSourceName = "Sample Ad Network (Custom Event)"
    }
  }
  return adSourceName
}ResponseInfoSnippets.swift

Objective-C

- (NSString *)uniqueAdSourceNameForAdNetworkResponseInfo:
    (GADAdNetworkResponseInfo *)loadedAdNetworkResponseInfo {
  NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
  if ([adSourceName isEqualToString:@"Custom Event"]) {
    if ([loadedAdNetworkResponseInfo.adNetworkClassName isEqualToString:@"SampleCustomEvent"]) {
      adSourceName = @"Sample Ad Network (Custom Event)";
    }
  }
  return adSourceName;
}ResponseInfoSnippets.m

Để biết thêm thông tin về nguồn quảng cáo giành chiến thắng, hãy xem bài viết Truy xuất thông tin về lượt phản hồi quảng cáo.

Tích hợp với Đối tác phân bổ ứng dụng (AAP)

Để biết thông tin đầy đủ về cách chuyển dữ liệu doanh thu từ quảng cáo đến các nền tảng phân tích, hãy tham khảo hướng dẫn của đối tác:

SDK của đối tác
Adjust
AppsFlyer
Singular
Tenjin

Các ví dụ sau đây cho thấy cách gửi dữ liệu doanh thu ở cấp lượt hiển thị cho các đối tác AAP bằng Google Mobile Ads SDK:

Điều chỉnh

Swift

func setPaidEventHandler(rewardAd: RewardedAd) {
  rewardAd.paidEventHandler = { adValue in
    guard let adRevenue = ADJAdRevenue(source: "admob_sdk") else { return }

    adRevenue.setRevenue(adValue.value.doubleValue, currency: adValue.currencyCode)
    if let adSourceName = rewardAd.responseInfo.loadedAdNetworkResponseInfo?.adSourceName {
      adRevenue.setAdRevenueNetwork(adSourceName)
    }

    Adjust.trackAdRevenue(adRevenue)
  }
}

Objective-C

- (void)setPaidEventHandler:(GADRewardedAd *)rewardAd {
  NSString *adSourceName = rewardAd.responseInfo.loadedAdNetworkResponseInfo.adSourceName;

  rewardAd.paidEventHandler = ^(GADAdValue *_Nonnull adValue) {
    ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:@"admob_sdk"];
    if (!adRevenue) {
      return;
    }

    [adRevenue setRevenue:adValue.value.doubleValue currency:adValue.currencyCode];
    if (adSourceName) {
      [adRevenue setAdRevenueNetwork:adSourceName];
    }

    [Adjust trackAdRevenue:adRevenue];
  };
}

AppsFlyer

Swift

func setPaidEventHandler(rewardedAd: RewardedAd) {
  rewardedAd.paidEventHandler = { adValue in
    let adRevenueData = AFAdRevenueData(
      monetizationNetwork: "AdMob Mediation", mediationNetwork: MediationNetworkType.googleAdMob,
      currencyIso4217Code: adValue.currencyCode, eventRevenue: adValue.value)

    var additionalParameters = [:]
    additionalParameters[kAppsFlyerAdRevenueCountry] = "US"
    additionalParameters[kAppsFlyerAdRevenueAdUnit] = rewardedAd.adUnitID
    additionalParameters[kAppsFlyerAdRevenueAdType] = "Rewarded"

    AppsFlyerLib.shared().logAdRevenue(adRevenueData, additionalParameters: additionalParameters)
  }
}

Objective-C

- (void)setPaidEventHandler:(GADRewardedAd *)rewardedAd {
  NSString *adUnitID = rewardedAd.adUnitID;

  rewardedAd.paidEventHandler = ^(GADAdValue *_Nonnull adValue) {
    AFAdRevenueData *adRevenueData = [[AFAdRevenueData alloc]
        initWithMonetizationNetwork:@"AdMob Mediation"
                   mediationNetwork:AppsFlyerAdRevenueMediationNetworkTypeGoogleAdMob
                currencyIso4217Code:adValue.currencyCode
                       eventRevenue:adValue.value];

    NSMutableDictionary *additionalParameters = [[NSMutableDictionary alloc] init];
    additionalParameters[kAppsFlyerAdRevenueCountry] = @"US";
    additionalParameters[kAppsFlyerAdRevenueAdUnit] = adUnitID;
    additionalParameters[kAppsFlyerAdRevenueAdType] = @"Rewarded";

    [[AppsFlyerLib shared] logAdRevenue:adRevenueData additionalParameters:additionalParameters];
  };
}

Số ít

Swift

func setPaidEventHandler(rewardedAd: RewardedAd) {
  rewardedAd.paidEventHandler = { adValue in
    // Extract revenue and currency from AdValue.
    let revenue = adValue.value.doubleValue
    let currency = adValue.currencyCode

    // Validate revenue and currency before sending.
    guard revenue > 0, !currency.isEmpty else {
      print(
        "Invalid ad revenue data: revenue = \(revenue), currency = \(String(describing: currency))"
      )
      return
    }

    // Create ad revenue data object.
    let data = SingularAdData(
      adPlatform: "AdMob",
      withCurrency: currency,
      withRevenue: NSNumber(value: revenue)
    )

    // Send to Singular.
    Singular.adRevenue(data)
    print("Ad revenue sent: \(revenue) \(currency)")
  }
}

Objective-C

- (void)setPaidEventHandler:(GADRewardedAd *)rewardedAd {
  rewardedAd.paidEventHandler = ^(GADAdValue *_Nonnull adValue) {
    // Extract revenue and currency from AdValue.
    double revenue = adValue.value.doubleValue;
    NSString *currency = adValue.currencyCode;

    // Validate revenue and currency before sending.
    if (revenue <= 0 || currency.length == 0) {
      NSLog(@"Invalid ad revenue data: revenue = %f, currency = %@", revenue, currency);
      return;
    }

    // Create ad revenue data object.
    SingularAdData *data =
        [[SingularAdData alloc] initWithAdPlatform:@"AdMob"
                                      withCurrency:currency
                                       withRevenue:[NSNumber numberWithDouble:revenue]];

    // Send to Singular.
    [Singular adRevenue:data];
    NSLog(@"Ad revenue sent: %f %@", revenue, currency);
  };
}

Tenjin

Swift

func setPaidEventHandler(rewardedAd: RewardedAd) {
  rewardedAd.paidEventHandler = { adValue in

    var jsonDict = [:]
    jsonDict["ad_unit_id"] = rewardedAd.adUnitID
    jsonDict["value_micros"] = adValue.value
    jsonDict["currency_code"] = adValue.currencyCode

    let responseInfo = rewardedAd.responseInfo
    if let responseIdentifier = responseInfo.responseIdentifier {
      jsonDict["response_id"] = responseIdentifier
    }
    if let adNetworkClassName = responseInfo.loadedAdNetworkResponseInfo?.adNetworkClassName {
      jsonDict["mediation_adapter_class_name"] = adNetworkClassName
    }

    do {
      let jsonData = try JSONSerialization.data(withJSONObject: jsonDict, options: [])
      let jsonString = String(data: jsonData, encoding: .utf8)
      TenjinSDK.adMobImpression(fromJSON: jsonString)
    } catch {
      print("Failed to log AdMob impression: \(error)")
    }
  }
}

Objective-C

- (void)setPaidEventHandler:(GADRewardedAd *)rewardedAd {
  NSString *adUnitID = rewardedAd.adUnitID;
  GADResponseInfo *responseInfo = rewardedAd.responseInfo;

  rewardedAd.paidEventHandler = ^(GADAdValue *_Nonnull adValue) {
    NSMutableDictionary *jsonDict = [[NSMutableDictionary alloc] init];
    jsonDict[@"ad_unit_id"] = adUnitID;
    jsonDict[@"value_micros"] = adValue.value;
    jsonDict[@"currency_code"] = adValue.currencyCode;

    NSString *responseIdentifier = responseInfo.responseIdentifier;
    if (responseIdentifier) {
      jsonDict[@"response_id"] = responseIdentifier;
    }
    NSString *adNetworkClassName = responseInfo.loadedAdNetworkResponseInfo.adNetworkClassName;
    if (adNetworkClassName) {
      jsonDict[@"mediation_adapter_class_name"] = adNetworkClassName;
    }

    NSError *error = nil;
    NSData *jsonData = [NSJSONSerialization dataWithJSONObject:jsonDict options:0 error:&error];
    if (jsonData) {
      NSString *jsonString = [[NSString alloc] initWithData:jsonData encoding:NSUTF8StringEncoding];
      [TenjinSDK adMobImpressionFromJSON:jsonString];
    } else {
      NSLog(@"Failed to log AdMob impression: %@", error);
    }
  };
}

Các phương pháp triển khai hay nhất

Thiết lập trình uỷ quyền ngay sau khi bạn tạo hoặc có quyền sử dụng đối tượng quảng cáo và ngay trước khi hiển thị quảng cáo. Điều này đảm bảo rằng bạn không bỏ lỡ bất kỳ lệnh gọi lại sự kiện có tính phí nào.
Gửi thông tin về sự kiện có tính phí đến máy chủ phân tích ưu tiên của bạn ngay tại thời điểm phương thức uỷ quyền didRecordPaidEventWithAdValue: được gọi. Điều này đảm bảo rằng bạn không vô tình bỏ qua bất kỳ lệnh gọi lại nào và tránh tạo ra sự chênh lệch về dữ liệu.

GADAdValue

GADAdValue là một lớp đại diện cho giá trị bằng tiền mà bạn nhận được từ một quảng cáo, bao gồm mã tiền tệ của giá trị và loại độ chính xác được mã hoá như sau.

GADAdValuePrecision	Mô tả
`GADAdValuePrecisionUnknown`	Giá trị quảng cáo không xác định. Hệ thống sẽ trả về kết quả này khi bạn bật tính năng pingback LTV, nhưng không có đủ dữ liệu.
`GADAdValuePrecisionEstimated`	Giá trị quảng cáo được ước tính từ dữ liệu tổng hợp.
`GADAdValuePrecisionPublisherProvided`	Nhà xuất bản đã cung cấp giá trị gia tăng quảng cáo (chẳng hạn như CPM thủ công) trong một nhóm dàn xếp.
`GADAdValuePrecisionPrecise`	Giá trị chính xác mà bạn phải trả cho quảng cáo này.

Số lượt hiển thị thử nghiệm từ các nguồn quảng cáo đặt giá thầu

Sau khi một sự kiện doanh thu từ quảng cáo ở cấp lượt hiển thị xảy ra cho một nguồn quảng cáo đặt giá thầu thông qua một yêu cầu thử nghiệm, bạn chỉ nhận được các giá trị sau:

GADAdValuePrecisionUnknown: cho biết loại độ chính xác.

0: cho biết giá trị quảng cáo.

Trước đây, bạn có thể đã thấy loại độ chính xác là một giá trị khác với GADAdValuePrecisionUnknown và giá trị quảng cáo lớn hơn 0.

Để biết thông tin chi tiết về cách gửi yêu cầu quảng cáo thử nghiệm, hãy xem bài viết Bật thiết bị thử nghiệm.

Doanh thu từ quảng cáo ở cấp lượt hiển thị Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Điều kiện tiên quyết

Xử lý sự kiện có tính phí

Swift

Objective-C

Xác định tên nguồn quảng cáo sự kiện tuỳ chỉnh

Swift

Objective-C

Tích hợp với Đối tác phân bổ ứng dụng (AAP)

Điều chỉnh

Swift

Objective-C

AppsFlyer

Swift

Objective-C

Số ít

Swift

Objective-C

Tenjin

Swift

Objective-C

Các phương pháp triển khai hay nhất

GADAdValue

Số lượt hiển thị thử nghiệm từ các nguồn quảng cáo đặt giá thầu

Doanh thu từ quảng cáo ở cấp lượt hiển thị