Учебное пособие. Тестирование внедрения новых форматов объявлений 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 , так и SDK Firebase для 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.2.0'
implementation 'com.google.firebase:firebase-analytics:23.2.0'
implementation 'com.google.firebase:firebase-config:23.1.0'

Единство

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

  • FirebaseAnalytics.unitypackage
  • FirebaseRemoteConfig.unitypackage

Настройка экземпляра Remote Config

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

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

Быстрый 

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)

Единство 

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 чтобы приложение знало, следует ли показывать рекламу.

Быстрый 

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

Единство 

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 ) новый рекламный блок межстраничной рекламы с вознаграждением.

Быстрый 

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

Единство 

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

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

Быстрый 

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)

Единство 

remoteConfig.GetValue("SHOW_NEW_AD_KEY").BooleanValue

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



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