Tutorial: Menguji adopsi format iklan AdMob baru

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

Pengantar: Menguji adopsi format iklan AdMob baru menggunakan Firebase

Langkah 1: Gunakan AdMob untuk membuat varian unit iklan baru yang akan digunakan untuk pengujian

Langkah 2: Siapkan pengujian A/B di Firebase console

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

Langkah 4: Mulai pengujian A/B dan tinjau hasil pengujiannya di Firebase console

Langkah 5: Putuskan apakah akan meluncurkan format iklan baru atau tidak

Di ujung langkah terakhir, Anda membuat parameter Remote Config (SHOW_NEW_AD_KEY). Pada langkah ini, Anda akan menambahkan logika ke kode aplikasi untuk hal yang harus ditampilkan aplikasi Anda berdasarkan nilai parameter tersebut — true (tampilkan iklan baru) versus false (jangan tampilkan iklan baru).

Menambahkan SDK yang diperlukan

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

Swift

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 library berikut ke file build.gradle Anda:

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

Kotlin+KTX

Tambahkan dependensi library berikut ke file build.gradle Anda:

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

Unity

Download dan instal Firebase Unity SDK, lalu tambahkan paket Unity berikut ke project Anda:

• FirebaseAnalytics.unitypackage
• FirebaseRemoteConfig.unitypackage

Mengonfigurasi instance Remote Config

Untuk menggunakan parameter value Remote Config, konfigurasikan instance Remote Config agar dapat segera mengambil nilai baru untuk instance aplikasi klien.

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

Swift

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)

Unity

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

Mengambil dan mengaktifkan Remote Config

Ambil dan aktifkan parameter Remote Config agar dapat mulai menggunakan parameter value baru.

Sebaiknya lakukan hal ini sedini mungkin dalam fase pemuatan aplikasi Anda karena panggilan ini bersifat asinkron dan Anda akan memerlukan nilai Remote Config yang diambil sebelumnya agar aplikasi dapat mengetahui apakah akan menampilkan iklan atau tidak.

Swift

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

Unity

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 menangani parameter Remote Config yang Anda buat selama pengujian A/B yang disiapkan sebelumnya dalam tutorial ini.

Menggunakan parameter value Remote Config

Gunakan nilai Remote Config yang diambil sebelumnya dalam fungsi loadAdUnit() untuk menentukan apakah instance aplikasi harus menampilkan (parameter value true) atau tidak menampilkan (parameter value false) unit iklan interstisial reward baru.

Swift

private func loadAdUnit() {
  let showNewAdFormat = remoteConfig["users"].boolValue
  if showNewAdFormat {
      // Load Rewarded Interstitial Ad.
      // This should load your new implemented ad unit
      // as per AdMob instructions (the first step of this tutorial).
  } else {
    // Show the existing ad unit.
  }
}

Objective-C

- (void)loadAdUnit {
    BOOL showAds = self.remoteConfig[@"SHOW_NEW_AD_KEY"].boolValue;
    if (showAds) {
      // Load Rewarded Interstitial Ad.
      // This should load your new implemented ad unit
      // per AdMob instructions (the first step of this tutorial).
    } else {
      // Show the existing ad unit.
    }
}

Java

private void loadAdUnit() {
    boolean showNewAdFormat =
      mFirebaseRemoteConfig.getBoolean(SHOW_NEW_AD_KEY);

    if (showNewAdFormat) {
      // Load Rewarded Interstitial Ad.
      // This should load your new implemented ad unit
      // per AdMob instructions (the first step of this tutorial).
    } else {
      // Show the existing ad unit.
    }
}

Kotlin+KTX

private fun loadAdUnit() {
  var showNewAdFormat = remoteConfig.getBoolean(SHOW_NEW_AD_KEY)

  if (showNewAdFormat) {
      // Load Rewarded Interstitial Ad.
      // This should load your new implemented ad unit
      // per AdMob instructions (the first step of this tutorial).
    } else {
      // Show the existing ad unit.
    }
}

Unity

void LoadAdUnit() {
  bool showNewAdFormat =
      remoteConfig.GetValue("SHOW_NEW_AD_KEY").BooleanValue;

  if (showNewAdFormat) {
    // Load Rewarded Interstitial Ad (new implemented ad unit)
    // per AdMob instructions (the first step of this tutorial).
  } else {
    // Show the existing ad unit.
  }
}

Catatan: Dalam kode produksi, Anda juga harus menambahkan jenis dan pemeriksaan null pada parameter value Remote Config yang diambil.

Menambahkan pemeriksaan lain untuk parameter value

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

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

Selanjutnya, Anda selalu dapat memeriksa nilai untuk parameter tersebut menggunakan panggilan berikut:

Swift

remoteConfig["showNewAdKey"].boolValue

Objective-C

self.remoteConfig[@"SHOW_NEW_AD_KEY"].boolValue;

Java

mFirebaseRemoteConfig.getBoolean(SHOW_NEW_AD_KEY)

Kotlin+KTX

remoteConfig.getBoolean(SHOW_NEW_AD_KEY)

Unity

remoteConfig.GetValue("SHOW_NEW_AD_KEY").BooleanValue

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

---

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

---