Langkah 3: Tangani parameter value Remote Config dalam kode aplikasi Anda
| Pengantar: Mengoptimalkan frekuensi iklan AdMob menggunakan Firebase |
| Langkah 1: Gunakan AdMob untuk membuat varian unit iklan baru yang akan digunakan untuk pengujian |
| Langkah 2: Siapkan pengujian A/B di konsol Firebase |
|
Langkah 3: Tangani parameter value Remote Config dalam kode aplikasi Anda |
| Langkah 4: Mulai pengujian A/B dan tinjau hasil pengujiannya di konsol Firebase |
| Langkah 5: Putuskan apakah akan meluncurkan format iklan baru |
Di ujung langkah terakhir, Anda membuat parameter Remote Config (INTERSTITIAL_AD_KEY). Pada langkah ini, Anda akan menambahkan logika ke kode aplikasi untuk hal yang harus ditampilkan aplikasi Anda berdasarkan nilai parameter tersebut.
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'
Android
Tambahkan dependensi library berikut ke file build.gradle Anda:
implementation 'com.google.android.gms:play-services-ads:24.4.0'
implementation 'com.google.firebase:firebase-analytics:22.4.0'
implementation 'com.google.firebase:firebase-config:22.1.2'
Unity
Download dan instal Firebase Unity SDK, lalu tambahkan paket Unity berikut ke project Anda:
FirebaseAnalytics.unitypackageFirebaseRemoteConfig.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
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 Anda mengetahui iklan mana yang akan ditampilkan.
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
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 varian frekuensi iklan yang harus ditampilkan untuk instance aplikasi ini.
Swift
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
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
}
})
}
Unity
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);
}
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["INTERSTITIAL_AD_KEY"].stringValue
Objective-C
self.remoteConfig[@"INTERSTITIAL_AD_KEY"].stringValue;
Java
mFirebaseRemoteConfig.getString(INTERSTITIAL_AD_KEY)
Kotlin
remoteConfig.getString(INTERSTITIAL_AD_KEY)
Unity
remoteConfig.GetValue("INTERSTITIAL_AD_KEY").StringValue
Panggilan ini akan selalu menampilkan nilai yang sama untuk instance aplikasi, bergantung pada apakah nilai tersebut ditempatkan di grup kontrol atau salah satu grup varian iklan baru, kecuali jika ada perubahan yang dilakukan pada konsol Firebase yang diambil dan diaktifkan dalam panggilan sebelumnya.
Langkah 2: Siapkan pengujian A/B di konsol Firebase Langkah 4: Mulai pengujian A/B & tinjau hasil pengujiannya