Руководство: оптимизация частоты показа рекламы AdMob

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


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

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

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


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

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

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

Swift

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

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

Objective-C

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

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

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

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

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

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

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

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



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