Tutorial: Mengoptimalkan frekuensi iklan AdMob

Langkah 3: Tangani nilai parameter Remote Config dalam kode aplikasi Anda


Pendahuluan: Optimalkan frekuensi iklan AdMob menggunakan Firebase
Langkah 1: Gunakan AdMob untuk membuat varian unit iklan baru untuk pengujian
Langkah 2: Siapkan pengujian A/B di Firebase console

Langkah 3: Tangani nilai parameter Remote Config dalam kode aplikasi Anda

Langkah 4: Mulai pengujian A/B dan tinjau hasil pengujian di Firebase console
Langkah 5: Putuskan apakah akan meluncurkan format iklan baru


Di akhir langkah terakhir, Anda membuat parameter Remote Config ( INTERSTITIAL_AD_KEY ). Pada langkah ini, Anda akan menambahkan logika ke kode aplikasi untuk apa yang seharusnya ditampilkan oleh aplikasi Anda berdasarkan nilai parameter tersebut.

Tambahkan SDK yang diperlukan

Sebelum menggunakan Remote Config dalam kode aplikasi Anda, tambahkan Remote Config SDK dan Firebase SDK untuk Google Analytics ke file build proyek Anda.

Cepat

Tambahkan dan instal pod berikut di podfile Anda:

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

Objective-C

Tambahkan dan instal pod berikut di podfile Anda:

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

Java

Tambahkan dependensi perpustakaan berikut ke file build.gradle Anda:

implementation 'com.google.android.gms:play-services-ads:21.0.0'
implementation 'com.google.firebase:firebase-analytics:21.0.0'
implementation 'com.google.firebase:firebase-config:21.1.0'

Kotlin+KTX

Tambahkan dependensi perpustakaan berikut ke file build.gradle Anda:

implementation 'com.google.android.gms:play-services-ads:21.0.0'
implementation 'com.google.firebase:firebase-analytics-ktx:21.0.0'
implementation 'com.google.firebase:firebase-config-ktx:21.1.0'

Persatuan

Unduh dan instal Firebase Unity SDK, lalu tambahkan paket Unity berikut ke proyek Anda:

  • FirebaseAnalytics.unitypackage
  • FirebaseRemoteConfig.unitypackage

Konfigurasi instance Remote Config

Untuk menggunakan nilai parameter Remote Config, konfigurasikan instance Remote Config sehingga disiapkan untuk mengambil nilai baru untuk instance aplikasi klien.

Dalam contoh ini, Remote Config dikonfigurasi untuk memeriksa nilai parameter baru setiap jam.

Cepat

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)

Persatuan

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

Ambil dan aktifkan Remote Config

Ambil dan aktifkan parameter Remote Config sehingga dapat mulai menggunakan nilai parameter baru.

Anda sebaiknya melakukan panggilan ini sedini mungkin dalam fase pemuatan aplikasi karena panggilan ini tidak sinkron dan Anda memerlukan nilai Remote Config yang telah diambil sebelumnya agar aplikasi Anda mengetahui iklan mana yang akan ditampilkan.

Cepat

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

Persatuan

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

Aplikasi Anda sekarang siap untuk menangani parameter Remote Config yang Anda buat selama pengujian A/B yang disiapkan sebelumnya dalam tutorial ini.

Gunakan nilai parameter Remote Config

Gunakan nilai Remote Config yang telah diambil sebelumnya dalam fungsi loadAdUnit() untuk menentukan varian frekuensi iklan mana yang harus ditampilkan untuk instance aplikasi ini.

Cepat

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

Persatuan

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

Tambahkan pemeriksaan lain untuk nilai parameter

Ada area lain dalam kode aplikasi Anda di mana Anda harus memeriksa nilai parameter Remote Config ini untuk menentukan pengalaman iklan mana yang akan dimuat. Misalnya, Anda dapat memutuskan apakah akan memuat ulang iklan setelah pengguna selesai melihat iklan saat ini.

Panggilan ambil dan aktifkan harus dilakukan terlebih dahulu untuk mendapatkan perubahan nilai parameter — misalnya, jika Anda memutuskan untuk mengakhiri atau membuat eksperimen baru.

Dari sana, Anda selalu dapat memeriksa nilai parameter menggunakan panggilan berikut:

Cepat

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)

Persatuan

remoteConfig.GetValue("INTERSTITIAL_AD_KEY").StringValue

Panggilan ini akan selalu menampilkan nilai yang sama untuk instance aplikasi bergantung pada apakah itu ditempatkan di grup kontrol atau salah satu grup varian iklan baru, kecuali ada perubahan yang dibuat di Firebase console yang diambil dan diaktifkan di panggilan sebelumnya.



Langkah 2 : Siapkan pengujian A/B di Firebase console Langkah 4 : Mulai pengujian A/B & tinjau hasil pengujian