查看 2022 年 Google I/O 大会上介绍的 Firebase 新动态。了解详情

Hướng dẫn: Tối ưu hóa tần suất quảng cáo AdMob

Bước 3: Xử lý các giá trị thông số Cấu hình từ xa trong mã ứng dụng của bạn


Giới thiệu: Tối ưu hóa tần suất quảng cáo AdMob bằng Firebase
Bước 1: Sử dụng AdMob để tạo các biến thể đơn vị quảng cáo mới để thử nghiệm
Bước 2: Thiết lập thử nghiệm A / B trong bảng điều khiển Firebase

Bước 3: Xử lý các giá trị thông số Cấu hình từ xa trong mã ứng dụng của bạn

Bước 4: Bắt đầu kiểm tra A / B và xem lại kết quả kiểm tra trong bảng điều khiển Firebase
Bước 5: Quyết định có triển khai định dạng quảng cáo mới hay không


Ở cuối bước cuối cùng, bạn đã tạo tham số Cấu hình từ xa ( INTERSTITIAL_AD_KEY ). Trong bước này, bạn sẽ thêm logic vào mã của ứng dụng để biết những gì ứng dụng của bạn sẽ hiển thị dựa trên giá trị của thông số đó.

Thêm các SDK bắt buộc

Trước khi sử dụng Cấu hình từ xa trong mã ứng dụng của bạn, hãy thêm cả SDK cấu hình từ xa và SDK Firebase cho Google Analytics vào tệp xây dựng dự án của bạn.

Nhanh

Thêm và cài đặt các nhóm sau trong podfile của bạn:

pod 'Google-Mobile-Ads-SDK'
pod 'Firebase/Analytics'
pod 'Firebase/RemoteConfig'

Objective-C

Thêm và cài đặt các nhóm sau trong podfile của bạn:

pod 'Google-Mobile-Ads-SDK'
pod 'Firebase/Analytics'
pod 'Firebase/RemoteConfig'

Java

Thêm các phụ thuộc thư viện sau vào tệp build.gradle của bạn:

implementation 'com.google.android.gms:play-services-ads:22.1.0'
implementation 'com.google.firebase:firebase-analytics:21.3.0'
implementation 'com.google.firebase:firebase-config:21.4.0'

Kotlin+KTX

Thêm các phụ thuộc thư viện sau vào tệp build.gradle của bạn:

implementation 'com.google.android.gms:play-services-ads:22.1.0'
implementation 'com.google.firebase:firebase-analytics-ktx:21.3.0'
implementation 'com.google.firebase:firebase-config-ktx:21.4.0'

Đoàn kết

Tải xuống và cài đặt SDK Firebase Unity, sau đó thêm các gói Unity sau vào dự án của bạn:

  • FirebaseAnalytics.unitypackage
  • FirebaseRemoteConfig.unitypackage

Định cấu hình phiên bản Cấu hình từ xa

Để sử dụng các giá trị tham số Cấu hình từ xa, hãy định cấu hình phiên bản Cấu hình từ xa để nó được thiết lập để tìm nạp các giá trị mới cho phiên bản ứng dụng khách.

Trong ví dụ này, Cấu hình từ xa được định cấu hình để kiểm tra các giá trị tham số mới mỗi giờ một lần.

Nhanh

remoteConfig = RemoteConfig.remoteConfig()
let settings = RemoteConfigSettings()
settings.minimumFetchInterval = 3600
remoteConfig.configSettings = settings

Objective-C

self.remoteConfig = [FIRRemoteConfig remoteConfig];
FIRRemoteConfigSettings *remoteConfigSettings = [[FIRRemoteConfigSettings alloc] init];
remoteConfigSettings.minimumFetchInterval = 3600;
self.remoteConfig.configSettings = remoteConfigSettings;

Java

mFirebaseRemoteConfig = FirebaseRemoteConfig.getInstance();
FirebaseRemoteConfigSettings configSettings = new FirebaseRemoteConfigSettings.Builder()
        .setMinimumFetchIntervalInSeconds(3600)
        .build();
mFirebaseRemoteConfig.setConfigSettingsAsync(configSettings);

Kotlin+KTX

remoteConfig = Firebase.remoteConfig
val configSettings = remoteConfigSettings {
    minimumFetchIntervalInSeconds = 3600
}
remoteConfig.setConfigSettingsAsync(configSettings)

Đoàn kết

var remoteConfig = FirebaseRemoteConfig.DefaultInstance;
var configSettings = new ConfigSettings {
  MinimumFetchInternalInMilliseconds =
        (ulong)(new TimeSpan(1, 0, 0).TotalMilliseconds)
};
remoteConfig.SetConfigSettingsAsync(configSettings)
        .ContinueWithOnMainThread(task => {
          Debug.Log("Config settings confirmed");
}

Tìm nạp và kích hoạt Cấu hình từ xa

Tìm nạp và kích hoạt các tham số Cấu hình từ xa để nó có thể bắt đầu sử dụng các giá trị tham số mới.

Bạn sẽ muốn thực hiện lệnh gọi này sớm nhất có thể trong giai đoạn tải ứng dụng của mình vì lệnh gọi này không đồng bộ và bạn sẽ cần tìm nạp trước giá trị Cấu hình từ xa để ứng dụng của bạn biết quảng cáo nào sẽ hiển thị.

Nhanh

remoteConfig.fetch() { (status, error) -> Void in
  if status == .success {
    print("Config fetched!")
    self.remoteConfig.activate() { (changed, error) in
      // ...
    }
  } else {
    print("Config not fetched")
    print("Error: \(error?.localizedDescription ?? "No error available.")")
  }
  self.loadAdUnit()
}

Objective-C

[self.remoteConfig fetchWithCompletionHandler:^(FIRRemoteConfigFetchStatus status, NSError *error) {
    if (status == FIRRemoteConfigFetchStatusSuccess) {
        NSLog(@"Config fetched!");
      [self.remoteConfig activateWithCompletion:^(BOOL changed, NSError * _Nullable error) {
        // ...
      }];
    } else {
        NSLog(@"Config not fetched");
        NSLog(@"Error %@", error.localizedDescription);
    }
    [self loadAdUnit];
}];

Java

mFirebaseRemoteConfig.fetchAndActivate()
        .addOnCompleteListener(this, new OnCompleteListener<Boolean>() {
            @Override
            public void onComplete(@NonNull Task<Boolean> task) {
                if (task.isSuccessful()) {
                    boolean updated = task.getResult();
                    Log.d(TAG, "Config params updated: " + updated);
                } else {
                    Log.d(TAG, "Config params failed to update");
                }
                loadAdUnit();
            }
        });

Kotlin+KTX

remoteConfig.fetchAndActivate()
        .addOnCompleteListener(this) { task ->
            if (task.isSuccessful) {
                val updated = task.result
                Log.d(TAG, "Config params updated: $updated")
            } else {
                Log.d(TAG, "Config params failed to update")
            }
            loadAdUnit()
        }

Đoàn kết

remoteConfig.FetchAndActivateAsync().ContinueWithOnMainThread(task => {
  if (task.IsFaulted) {
    Debug.LogWarning("Config params failed to update");
  } else {
    Debug.Log("Config params updated: " + task.Result);
  }
  LoadAdUnit();
});

Ứng dụng của bạn hiện đã sẵn sàng để xử lý thông số Cấu hình từ xa mà bạn đã tạo trong quá trình kiểm tra A / B được thiết lập trước đó trong hướng dẫn này.

Sử dụng giá trị tham số Cấu hình từ xa

Sử dụng giá trị Cấu hình từ xa được tìm nạp trước trong hàm loadAdUnit() để xác định biến thể tần suất quảng cáo nào sẽ được hiển thị cho phiên bản ứng dụng này.

Nhanh

private func loadAdUnit() {
  let adUnitId = remoteConfig["INTERSTITIAL_AD_KEY"].stringValue;
  let request = GADRequest()
  GADInterstitialAd.load(withAdUnitID: adUnitId,
                               request: request,
                     completionHandler: { [self] ad, error in
                       if let error = error {
                         print("Failed to load: \(error.localizedDescription)")
                         return
                       }
                       interstitial = ad
                       // Register for callbacks.
                     }
  )
}

// Register for callbacks.

Objective-C

- (void)loadAdUnit {
    NSString *adUnitId =
      self.remoteConfig[@"INTERSTITIAL_AD_KEY"].stringValue;

  GADRequest *request = [GADRequest request];
  [GADInterstitialAd loadAdWithAdUnitId:adUnitId
                         request:request
                         completionHandler:^(GADInterstitialAd *ad,
                             NSError *error) {
    if (error) {
      NSLog(@"Failed to load interstitial ad with error: %@",
        [error localizedDescription]);
      return;
    }

    self.interstitial = ad;
  }];
}

Java

private void loadAdUnit() {
    String adUnitId =
      mFirebaseRemoteConfig.getString("INTERSTITIAL_AD_KEY");

    // Load Interstitial Ad (assume adUnitId not null)
    AdRequest adRequest = new AdRequest.Builder().build();

    InterstitialAd.load(this, adUnitId, adRequest, new
        InterstitialAdLoadCallback() {
          @Override
          public void onAdLoaded(@NonNull InterstitialAd intertitialAd) {
            mInterstitialAd = interstitialAd;
          }

          @Override
          public void onAdFailedToLoad(@NonNull LoadAdError loadAdError) {
            mInterstitialAd = null;
          }
    });
}

Kotlin+KTX

private fun loadAdUnit() {
  String adUnitId = remoteConfig.getString("INTERSTITIAL_AD_KEY")
  var adRequest = AdRequestBuilder.Builder().build()

  AdRequestBuilder.load(this, adUnitId, adRequest, object :
    InterstitialAdLoadCallback() {
      override fun onAdFailedToLoad(adError: LoadAdError) {
        mInterstitialAd = null
      }

      override fun onAdLoaded(interstitialAd: InterstitialAd) {
        mInterstitialAd = interstitialAd
      }
    })
}

Đoàn kết

void LoadAdUnit() {

  // Note that you may want to encode and parse two sets of ad unit IDs for
  // Android / iOS in the Unity implementation.
  String adUnitId = remoteConfig.GetValue("INTERSTITIAL_AD_KEY").StringValue;
  this.interstitial = new InterstitialAd(adUnitId);
}

Thêm các kiểm tra khác cho giá trị tham số

Có những khu vực khác trong mã ứng dụng của bạn, nơi bạn sẽ cần kiểm tra giá trị của thông số Cấu hình từ xa này để chỉ định trải nghiệm quảng cáo nào sẽ được tải. Ví dụ: bạn có thể quyết định có tải lại quảng cáo sau khi người dùng xem xong quảng cáo hiện tại hay không.

Các cuộc gọi tìm nạp và kích hoạt nên được thực hiện trước để nhận được bất kỳ thay đổi nào về giá trị thông số - ví dụ: nếu bạn quyết định kết thúc hoặc tạo một thử nghiệm mới.

Từ đó, bạn luôn có thể kiểm tra giá trị cho tham số bằng các lệnh gọi sau:

Nhanh

remoteConfig["INTERSTITIAL_AD_KEY"].stringValue

Objective-C

self.remoteConfig[@"INTERSTITIAL_AD_KEY"].stringValue;

Java

mFirebaseRemoteConfig.getString(INTERSTITIAL_AD_KEY)

Kotlin+KTX

remoteConfig.getString(INTERSTITIAL_AD_KEY)

Đoàn kết

remoteConfig.GetValue("INTERSTITIAL_AD_KEY").StringValue

Các lệnh gọi này sẽ luôn trả lại cùng một giá trị cho một phiên bản ứng dụng tùy thuộc vào việc nó được đặt trong nhóm kiểm soát hay một trong các nhóm biến thể quảng cáo mới, trừ khi bất kỳ thay đổi nào được thực hiện trong bảng điều khiển Firebase đã được tìm nạp và kích hoạt trong các lệnh gọi trước đó.




Bước 2 : Thiết lập kiểm tra A / B trong bảng điều khiển Firebase Bước 4 : Bắt đầu kiểm tra A / B và xem xét kết quả kiểm tra