查看 2022 年 Google I/O 大会上介绍的 Firebase 新动态。了解详情

教程：测试新的 AdMob 广告格式的采用情况

第 3 步：处理应用代码中的 Remote Config 参数值

简介：使用 Firebase 测试新的 AdMob 广告格式采用情况

第 1 步：使用 AdMob 创建新的广告单元变体以进行测试

第 2 步：在 Firebase 控制台中设置 A/B 测试

第 3 步：处理应用代码中的 Remote Config 参数值

第 4 步：在 Firebase 控制台中启动 A/B 测试并查看测试结果

第 5 步：决定是否发布新广告格式

在最后一步结束时，您创建了一个 Remote Config 参数 (SHOW_NEW_AD_KEY)。在本步骤中，您将向应用代码添加逻辑，以便应用根据该参数的值显示相应的内容。如果值为 true，则显示新广告；如果值为 false，则不显示新广告。

添加所需的 SDK

在应用代码中使用 Remote Config 之前，请将 Remote Config SDK 和 Firebase SDK for Google Analytics 添加到项目构建文件中。

Swift

在 podfile 中添加并安装以下 pod：

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

Objective-C

在 podfile 中添加并安装以下 pod：

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

Java

将以下库依赖项添加到 build.gradle 文件中：

implementation 'com.google.android.gms:play-services-ads:20.6.0'
implementation 'com.google.firebase:firebase-analytics:21.0.0'
implementation 'com.google.firebase:firebase-config:21.1.0'

Kotlin+KTX

将以下库依赖项添加到 build.gradle 文件中：

implementation 'com.google.android.gms:play-services-ads:20.6.0'
implementation 'com.google.firebase:firebase-analytics-ktx:21.0.0'
implementation 'com.google.firebase:firebase-config-ktx:21.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+KTX

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

Unity

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

现在，您的应用可以处理您在本教程前面的 A/B 测试设置期间创建的 Remote Config 参数了。

使用 Remote Config 参数值

在 loadAdUnit() 函数中使用预取的 Remote Config 值，以确定应用实例应该显示（参数值为 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+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.
    }
}

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 参数的值，以确定要加载的广告体验。例如，您可以决定在用户看完某个广告后是否重新加载当前广告。

您应首先发出提取和激活调用以获取任何参数值更改（例如，如果您决定结束实验或创建新的实验）。

之后，您可以使用以下调用随时检查参数的值：

Swift

remoteConfig["showNewAdKey"].boolValue

Objective-C

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

Java

mFirebaseRemoteConfig.getBoolean(SHOW_NEW_AD_KEY)

Kotlin+KTX

remoteConfig.getBoolean(SHOW_NEW_AD_KEY)

Unity

remoteConfig.GetValue("SHOW_NEW_AD_KEY").BooleanValue

这些调用将始终为应用实例返回相同的值，具体取决于它是置于对照组还是新的广告变体组中，除非您在 Firebase 控制台中对之前调用中提取并激活的参数值进行了任何更改。

第 2 步：在 Firebase 控制台中设置 A/B 测试 第 4 步：启动 A/B 测试并查看测试结果