Samouczek: Testowanie wdrożenia nowych formatów reklam AdMob

Krok 3: Obsługuj wartości parametrów Remote Config w kodzie aplikacji


Wprowadzenie: przetestuj przyjęcie nowego formatu reklam AdMob za pomocą Firebase
Krok 1: Użyj AdMob, aby utworzyć nowy wariant jednostki reklamowej do testów
Krok 2: Skonfiguruj test A/B w konsoli Firebase

Krok 3: Obsługuj wartości parametrów Remote Config w kodzie aplikacji

Krok 4: Rozpocznij test A/B i przejrzyj wyniki testu w konsoli Firebase
Krok 5: Zdecyduj, czy wdrożyć nowy format reklamy


Na końcu ostatniego kroku utworzyłeś parametr Remote Config ( SHOW_NEW_AD_KEY ). W tym kroku dodasz do kodu aplikacji logikę określającą, co aplikacja powinna wyświetlać na podstawie wartości tego parametru — true (pokaż nową reklamę) lub false ( nie pokazuj nowej reklamy).

Dodaj wymagane zestawy SDK

Przed użyciem Remote Config w kodzie aplikacji dodaj zarówno pakiet SDK Remote Config, jak i pakiet SDK Firebase dla Google Analytics do plików kompilacji projektu.

Platformy Apple

Dodaj i zainstaluj następujące pody w swoim pliku podfile:

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

Android

Dodaj następujące zależności bibliotek do pliku build.gradle :

implementation 'com.google.android.gms:play-services-ads:23.0.0'
implementation 'com.google.firebase:firebase-analytics:21.6.1'
implementation 'com.google.firebase:firebase-config:21.6.3'

Jedność

Pobierz i zainstaluj pakiet SDK Firebase Unity, a następnie dodaj do swojego projektu następujące pakiety Unity:

  • FirebaseAnalytics.unitypackage
  • FirebaseRemoteConfig.unitypackage

Skonfiguruj instancję Remote Config

Aby użyć wartości parametrów Remote Config, skonfiguruj instancję Remote Config tak, aby była skonfigurowana do pobierania nowych wartości dla instancji aplikacji klienckiej.

W tym przykładzie usługa Remote Config jest skonfigurowana tak, aby co godzinę sprawdzała nowe wartości parametrów.

Szybki

remoteConfig = RemoteConfig.remoteConfig()
let settings = RemoteConfigSettings()
settings.minimumFetchInterval = 3600
remoteConfig.configSettings = settings

Cel 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+KTX

remoteConfig = Firebase.remoteConfig
val configSettings = remoteConfigSettings {
    minimumFetchIntervalInSeconds = 3600
}
remoteConfig.setConfigSettingsAsync(configSettings)

Jedność

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

Pobierz i aktywuj zdalną konfigurację

Pobierz i aktywuj parametry Zdalnej konfiguracji, aby mogło zacząć korzystać z nowych wartości parametrów.

Warto wykonać to wywołanie jak najwcześniej w fazie ładowania aplikacji, ponieważ jest ono asynchroniczne i konieczne będzie wcześniejsze pobranie wartości Zdalnej konfiguracji, aby aplikacja wiedziała, czy wyświetlić reklamę.

Szybki

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

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

Jedność

remoteConfig.FetchAndActivateAsync().ContinueWithOnMainThread(task => {
  if (task.IsFaulted) {
    Debug.LogWarning("Config params failed to update");
  } else {
    Debug.Log("Config params updated: " + task.Result);
  }
  LoadAdUnit();
});

Twoja aplikacja jest teraz gotowa do obsługi parametru zdalnej konfiguracji utworzonego podczas testu A/B skonfigurowanego wcześniej w tym samouczku.

Użyj wartości parametru Zdalna konfiguracja

Użyj wstępnie pobranej wartości Remote Config w funkcji loadAdUnit() , aby określić, czy instancja aplikacji powinna wyświetlać (wartość parametru true ), czy nie (wartość parametru false ) nową jednostkę reklamy pełnoekranowej z nagrodą.

Szybki

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

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

Jedność

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

Dodaj inne kontrole wartości parametru

Istnieją inne obszary w kodzie aplikacji, w których należy sprawdzić wartość tego parametru Zdalnej konfiguracji, aby określić, która reklama zostanie załadowana. Możesz na przykład zdecydować, czy załadować ponownie reklamę, gdy użytkownik zakończy przeglądanie bieżącej.

Wywołania fetch i activate należy wykonać w pierwszej kolejności, aby uzyskać zmiany wartości parametrów — na przykład, jeśli zdecydujesz się zakończyć lub utworzyć nowy eksperyment.

Stamtąd zawsze możesz sprawdzić wartość parametru za pomocą następujących wywołań:

Szybki

remoteConfig["showNewAdKey"].boolValue

Cel C

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

Java

mFirebaseRemoteConfig.getBoolean(SHOW_NEW_AD_KEY)

Kotlin+KTX

remoteConfig.getBoolean(SHOW_NEW_AD_KEY)

Jedność

remoteConfig.GetValue("SHOW_NEW_AD_KEY").BooleanValue

Wywołania te zawsze będą zwracać tę samą wartość dla instancji aplikacji, w zależności od tego, czy została ona umieszczona w grupie kontrolnej, czy w nowej grupie wariantów reklamy, chyba że w konsoli Firebase wprowadzono zmiany, które zostały pobrane i aktywowane w poprzednich wywołaniach.




Krok 2 : Skonfiguruj test A/B w konsoli Firebase Krok 4 : Rozpocznij test A/B i przejrzyj wyniki testu