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

3단계: 앱 코드에서 원격 구성 매개변수 값 처리


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

3단계: 앱 코드에서 원격 구성 매개변수 값 처리

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


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

필수 SDK 추가

애플리케이션 코드에서 원격 구성을 사용하려면 먼저 Google 애널리틱스에 대해 원격 구성 SDK 및 Firebase SDK를 모두 프로젝트 빌드 파일에 추가합니다.

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'

자바

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

원격 구성 인스턴스 구성

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

이 예시에서 원격 구성은 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;

자바

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

원격 구성 가져오기 및 활성화

새 매개변수 값 사용을 시작할 수 있도록 원격 구성 매개변수를 가져오고 활성화합니다.

이 호출이 비동기적이고 앱이 광고 표시 여부를 알 수 있도록 원격 구성 값을 미리 가져와야 하므로, 앱의 로딩 단계에서 가능하면 빨리 이 호출을 수행해야 합니다.

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

자바

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 테스트를 설정할 때 생성된 원격 구성 매개변수를 앱에서 처리할 준비가 되었습니다.

원격 구성 매개변수 값 사용

loadAdUnit() 함수에서 미리 가져온 원격 구성 값을 사용하여 앱 인스턴스에서 새 보상형 전면 광고 단위를 표시할지(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.
    }
}

자바

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

매개변수 값에 다른 확인 추가

애플리케이션 코드에는 로드할 광고 환경을 기술하는 이 원격 구성 매개변수의 값을 확인해야 하는 다른 영역이 있습니다. 예를 들어 사용자 현재 광고 보기를 마친 후 광고를 새로고침할지 여부를 결정할 수 있습니다.

실험을 종료하거나 새로 만들기로 결정하는 경우와 같이 매개변수 값 변화를 가져오기 위해서는 먼저 가져오기 및 활성화 호출을 수행해야 합니다.

이후 항상 다음 호출을 사용하여 매개변수의 값을 확인할 수 있습니다.

Swift

remoteConfig["showNewAdKey"].boolValue

Objective-C

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

자바

mFirebaseRemoteConfig.getBoolean(SHOW_NEW_AD_KEY)

Kotlin+KTX

remoteConfig.getBoolean(SHOW_NEW_AD_KEY)

Unity

remoteConfig.GetValue("SHOW_NEW_AD_KEY").BooleanValue

이전 호출에서 가져오고 활성화한 변경사항이 Firebase Console에서 수행되지 않은 한 이러한 호출은 통제 그룹에 있는지 아니면 새 광고 대안 그룹에 있는지에 관계없이 앱 인스턴스에 대해 항상 동일한 값을 반환합니다.




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