Catch up on everthing we announced at this year's Firebase Summit. Learn more

Tutorial: Otimize a frequência de anúncios da AdMob

Etapa 3: manipular valores de parâmetro do Configuração remota no código do seu aplicativo


Introdução: Optimize AdMob frequência anúncio usando Firebase
Passo 1: Use AdMob para criar um novo bloco de anúncios variantes para testes
Passo 2: Preparar um teste A / B na consola Firebase

Etapa 3: manipular valores de parâmetro do Configuração remota no código do seu aplicativo

Passo 4: Iniciar o teste A / B e rever os resultados dos testes no console Firebase
Passo 5: Decida se pretende lançar o novo formato de anúncio


No final da última etapa, você criou um parâmetro de configuração remota ( INTERSTITIAL_AD_KEY ). Nesta etapa, você adicionará a lógica ao código do seu aplicativo para o que seu aplicativo deve exibir com base no valor desse parâmetro.

Adicione os SDKs necessários

Antes de usar o Remote config no código do aplicativo, adicione o Remote Config SDK e o Firebase SDK para Google Analytics aos arquivos de compilação do projeto.

Rápido

Adicione e instale os seguintes pods em seu podfile:

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

Objective-C

Adicione e instale os seguintes pods em seu podfile:

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

Java

Adicionar as seguintes dependências da biblioteca para o seu build.gradle arquivo:

implementation 'com.google.android.gms:play-services-ads:20.5.0'
implementation 'com.google.firebase:firebase-analytics:20.0.0'
implementation 'com.google.firebase:firebase-config:21.0.1'

Kotlin + KTX

Adicionar as seguintes dependências da biblioteca para o seu build.gradle arquivo:

implementation 'com.google.android.gms:play-services-ads:20.5.0'
implementation 'com.google.firebase:firebase-analytics-ktx:20.0.0'
implementation 'com.google.firebase:firebase-config-ktx:21.0.1'

Unidade

Baixe e instale o Firebase Unity SDK e, em seguida, adicione os seguintes pacotes do Unity ao seu projeto:

  • FirebaseAnalytics.unitypackage
  • FirebaseRemoteConfig.unitypackage

Configurar instância do Remote config

Para usar os valores do parâmetro do Remote config, configure a instância do Remote config para que ela busque novos valores para a instância do aplicativo cliente.

Neste exemplo, o Remote config está configurado para verificar novos valores de parâmetro uma vez a cada hora.

Rápido

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

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

Unidade

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

Buscar e ativar o Configuração Remota

Busque e ative os parâmetros do Configuração remota para que possa começar a usar os novos valores de parâmetro.

Você vai querer fazer essa chamada o mais cedo possível na fase de carregamento do seu aplicativo porque ela é assíncrona e você precisará do valor do Configuração remota pré-buscado para que seu aplicativo saiba qual anúncio exibir.

Rápido

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

Unidade

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

Seu aplicativo agora está pronto para lidar com o parâmetro do Configuração remota que você criou durante o teste A / B configurado anteriormente neste tutorial.

Use o valor do parâmetro do Configuração remota

Usar o valor pré-buscada remoto configuração no loadAdUnit() função para determinar qual variante frequência anúncio deve ser indicado, para este exemplo app.

Rápido

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

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

Unidade

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

Adicione outras verificações para o valor do parâmetro

Existem outras áreas no código do seu aplicativo em que você precisará verificar o valor desse parâmetro do Configuração remota para ditar qual experiência de anúncio será carregada. Por exemplo, você pode decidir se deseja recarregar um anúncio depois que o usuário terminar de ver o atual.

As chamadas de busca e ativação devem ser feitas primeiro para obter quaisquer alterações de valor de parâmetro - por exemplo, se você decidir encerrar ou criar um novo experimento.

A partir daí, você sempre pode verificar o valor do parâmetro usando as seguintes chamadas:

Rápido

remoteConfig["INTERSTITIAL_AD_KEY"].stringValue

Objective-C

self.remoteConfig[@"INTERSTITIAL_AD_KEY"].stringValue;

Java

mFirebaseRemoteConfig.getString(INTERSTITIAL_AD_KEY)

Kotlin + KTX

remoteConfig.getString(INTERSTITIAL_AD_KEY)

Unidade

remoteConfig.GetValue("INTERSTITIAL_AD_KEY").StringValue

Essas chamadas sempre retornarão o mesmo valor para uma instância do aplicativo, dependendo se ela foi colocada no grupo de controle ou em um dos novos grupos de variantes de anúncio, a menos que quaisquer alterações tenham sido feitas no Firebase console que foram buscadas e ativadas nas chamadas anteriores.




Passo 2: Configurar um teste A / B no Firebase consola Passo 4: Iniciar a / B teste e revisão de teste resultados