튜토리얼: 새 AdMob 광고 형식 채택 테스트

3단계: 앱 코드에서 Remote Config 매개변수 값 처리


소개: Firebase를 사용하여 새 AdMob 광고 형식 채택 테스트
1단계: AdMob를 사용하여 테스트할 새 광고 단위 대안 만들기
2단계: Firebase Console에서 A/B 테스트 설정

3단계: 앱 코드에서 Remote Config 매개변수 값 처리

4단계: Firebase Console에서 A/B 테스트 시작 및 테스트 결과 검토
5단계: 새 광고 형식 출시 여부 결정


마지막 단계가 끝나면 Remote Config 매개변수(SHOW_NEW_AD_KEY)가 생성됩니다. 이 단계에서는 true(새 광고 표시) 또는 false (새 광고 표시 안 함)에 해당하는 이 매개변수 값을 기준으로 앱에 표시할 항목에 대한 논리를 앱 코드에 추가합니다.

필수 SDK 추가

애플리케이션 코드에서 Remote Config를 사용하려면 먼저 Remote Config SDK와 Google Analytics용 Firebase SDK를 모두 프로젝트 빌드 파일에 추가합니다.

Apple 플랫폼

Podfile에서 다음 포드를 추가하고 설치합니다.

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

Android

build.gradle 파일에 다음 라이브러리 종속 항목을 추가합니다.

implementation 'com.google.android.gms:play-services-ads:24.2.0'
implementation 'com.google.firebase:firebase-analytics:22.4.0'
implementation 'com.google.firebase:firebase-config:22.1.0'

Unity

Firebase Unity SDK를 다운로드하고 설치한 후 다음 Unity 패키지를 프로젝트에 추가합니다.

  • FirebaseAnalytics.unitypackage
  • FirebaseRemoteConfig.unitypackage

Remote Config 인스턴스 구성

Remote Config 매개변수 값을 사용하려면 클라이언트 앱 인스턴스에 대해 새 값을 가져오도록 Remote Config 인스턴스를 구성합니다.

이 예에서 Remote Config는 1시간마다 새 매개변수 값을 확인하도록 구성되어 있습니다.

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

이제 이 튜토리얼의 앞부분에서 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 

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 

remoteConfig.getBoolean(SHOW_NEW_AD_KEY)

Unity 

remoteConfig.GetValue("SHOW_NEW_AD_KEY").BooleanValue

이전 호출에서 가져오고 활성화한 변경사항이 Firebase Console에서 적용되지 않은 경우를 제외하고 이러한 호출은 통제 그룹에 속했거나 새 광고 대안 그룹 중 하나에 속했든지에 관계없이 앱 인스턴스에 대해 항상 동일한 값을 반환합니다.



2단계: Firebase Console에서 A/B 테스트 설정 4단계: A/B 테스트 시작 및 테스트 결과 검토