Руководство: как протестировать новые форматы объявлений AdMob

Шаг 3. Настройте в приложении значения параметров Remote Config


Введение: Протестируйте новые AdMob форматы объявлений с помощью Firebase
Шаг 1. Используйте инструмент "Создать вариант рекламного блока для тестирования" AdMob.
Шаг 2. Настройте A/B-тестирование в консоли Firebase

Шаг 3. Настройте в приложении значения параметров Remote Config

Шаг 4. Начните A/B-тестирование и просмотрите результаты в консоли Firebase
Шаг 5. Примите решение о том, стоит ли использовать новый формат объявлений


На последнем этапе вы создали Remote ConfigпараметрSHOW_NEW_AD_KEY. Теперь вам нужно добавить в код приложения логику, которая будет определять, что показывать в приложении в зависимости от значения этого параметра: true(показывать новое объявление) или false(не показывать новое объявление).

Добавьте все необходимые SDK.

Прежде чем использовать Remote Config в коде приложения, добавьте в файлы сборки проекта SDK Remote Config и Firebase SDK для Google Analytics.

Платформы Apple

Добавьте и установите в podfile следующие пакеты:

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

Android

Добавьте в файл build.gradle следующие зависимости библиотеки:

implementation 'com.google.android.gms:play-services-ads:25.5.0'
implementation 'com.google.firebase:firebase-analytics:23.2.0'
implementation 'com.google.firebase:firebase-config:23.1.0'

Unity

Скачайте и установите Firebase Unity SDK, а затем добавьте в проект следующие пакеты Unity:

  • FirebaseAnalytics.unitypackage
  • FirebaseRemoteConfig.unitypackage

Как настроить экземпляр Remote Config

Чтобы использовать значения параметров Remote Config, настройте экземпляр Remote Config так, чтобы новые значения синхронизировались с экземпляром клиентского приложения.

В этом примере параметр Remote Config настроен на проверку новых значений параметров каждый час.

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

Получите и активируйте Remote Config

Извлеките и активируйте параметры Remote Config, чтобы приложение использовало новые значения параметров.

Рекомендуем выполнить этот вызов как можно раньше на этапе загрузки приложения, потому что он асинхронный и необходимо заранее получить значения из Remote Config, чтобы приложение могло определить, показывать ли объявление.

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

Теперь ваше приложение готово к работе с параметром Remote Config, который вы настроили в рамках A/B-тестирования.

Используйте значение параметра Remote Config

Используйте предварительно полученное значение Remote Config в функции loadAdUnit(), чтобы определить, нужно ли показывать в экземпляре приложения (значение параметра true) или не показывать (значение параметра false) новый рекламный блок для межстраничных объявлений с вознаграждением.

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 

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

Добавьте другие вызовы, которые будут использовать значения параметров.

В коде вашего приложения могут быть и другие элементы, которые используют параметры Remote Config для выбора стратегии показа рекламы. Например, вы можете решить, следует ли перезагружать объявление после того, как пользователь завершил просмотр текущего.

Прежде всего вам необходимо выполнить вызовы fetch и activate, чтобы изменить значения параметров. Это поможет в том случае, если вы решите завершить текущий эксперимент или создать новый.

После этого вы всегда сможете использовать значения параметров с помощью следующих вызовов:

Swift 

remoteConfig["showNewAdKey"].boolValue

Objective-C 

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

Java 

mFirebaseRemoteConfig.getBoolean(SHOW_NEW_AD_KEY)

Kotlin 

remoteConfig.getBoolean(SHOW_NEW_AD_KEY)

Unity 

remoteConfig.GetValue("SHOW_NEW_AD_KEY").BooleanValue

Эти вызовы всегда возвращают одинаковые значения для экземпляра приложения в зависимости от того, для чего он предназначен: для контрольной группы или группы с новыми вариантами показа объявлений. Если вы внесли изменения в параметры через консоль Firebase, а затем внедрили и активировали их с помощью вызовов, то значения могут быть другими.



Шаг 2. Настройте A/B-тестирование в консоли Firebase. Шаг 4. Начните A/B-тестирование и просмотрите результаты.