Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Tutorial: Uji adopsi format iklan AdMob baru

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


Pendahuluan: Uji adopsi format iklan AdMob baru menggunakan Firebase
Langkah 1: Gunakan AdMob untuk membuat varian unit iklan baru untuk pengujian
Langkah 2: Mengatur pengujian A / B di konsol Firebase

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

Langkah 4: Mulai A / test B dan meninjau hasil tes di konsol Firebase
Langkah 5: Tentukan apakah akan menggelar format iklan baru


Pada akhir langkah terakhir, Anda membuat Config parameter remote ( SHOW_NEW_AD_KEY ). Pada langkah ini, Anda akan menambahkan logika untuk kode aplikasi Anda untuk apa aplikasi Anda harus menampilkan berdasarkan nilai parameter yang - true (menampilkan iklan baru) vs false (tidak menampilkan iklan baru).

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'

Jawa

Tambahkan dependensi library berikut untuk Anda build.gradle berkas:

implementation 'com.google.android.gms:play-services-ads:20.4.0'
implementation 'com.google.firebase:firebase-analytics:19.0.2'
implementation 'com.google.firebase:firebase-config:21.0.1'

Kotlin+KTX

Tambahkan dependensi library berikut untuk Anda build.gradle berkas:

implementation 'com.google.android.gms:play-services-ads:20.4.0'
implementation 'com.google.firebase:firebase-analytics-ktx:19.0.2'
implementation 'com.google.firebase:firebase-config-ktx:21.0.1'

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 satu jam sekali.

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;

Jawa

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 sudah diambil sebelumnya sehingga aplikasi Anda tahu apakah akan menampilkan iklan atau tidak.

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

Jawa

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 pra mengada-ada remote nilai Config di loadAdUnit() fungsi untuk menentukan apakah contoh aplikasi harus menunjukkan (nilai parameter true ) atau tidak menunjukkan (nilai parameter false ) unit dihargai iklan pengantara baru.

Cepat

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

Jawa

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

Persatuan

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

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 pengambilan dan pengaktifan 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["showNewAdKey"].boolValue

Objective-C

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

Jawa

mFirebaseRemoteConfig.getBoolean(SHOW_NEW_AD_KEY)

Kotlin+KTX

remoteConfig.getBoolean(SHOW_NEW_AD_KEY)

Persatuan

remoteConfig.GetValue("SHOW_NEW_AD_KEY").BooleanValue

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




Langkah 2: Set up pengujian A / B di Firebase konsol Langkah 4: Mulai A / B uji & uji hasil review