광고 수익 측정

수익원을 측정하면 사용자의 평생 가치를 파악하고 앱 비즈니스를 성장시키는 데 도움이 됩니다. 이 가이드에서는 플랫폼의 광고 수익 측정을 설정하는 방법을 설명합니다.

광고 수익 측정을 설정하고 나면 다음 작업을 수행할 수 있습니다.

• 앱에서 창출된 광고 수익에 기여한 사용자 행동을 분석합니다.

• Firebase A/B Testing를 사용하여 실험을 실행하여 앱 광고 수익을 개선하는 기능을 찾거나 Remote Config 맞춤설정을 사용하여 광고 환경을 맞춤설정합니다.

• 만들기 사용자 잠재고객 및 맞춤 사용자 환경을 Firebase Remote Config(광고 수익 수준에 따라 다름)

시작하기 전에

아직 완료하지 않았다면 다음 작업을 완료해야 합니다.

1. 다음에 설명된 대로 프로젝트와 앱을 설정합니다. Analytics 시작하기

2. Firebase 프로젝트를 Google Analytics 계정

3. 앱에 Android SDK v17.6.0 이상 또는 Apple 플랫폼 SDK v6.34.0 이상이 포함되어 있는지 확인합니다.

구현

Google Analytics를 사용하여 AdMob, AppLovin, ironSource와 같은 수익 창출 플랫폼에 광고를 게재해 발생한 광고 수익을 측정할 수 있습니다. 광고 수익을 측정하려면 ad_impression 이벤트 사용자가 앱에서 광고를 볼 때마다 이러한 이벤트에는 광고 플랫폼, 소스, 통화, 가치 등의 세부정보

AdMob

AdMob 플랫폼을 사용하는 경우 AdMob 앱을 Firebase 및 Analytics에 연결 광고 수익의 자동 측정을 사용 설정합니다. Firebase SDK는 Google Analytics는 ad_impression 이벤트를 자동으로 로깅할 때마다 사용자가 노출된 광고를 볼 수 있습니다.

기타 광고 수익 창출 플랫폼

AppLovin 및 ironSource와 같은 플랫폼은 노출 수준의 수익 데이터를 제공합니다. Google Analytics 로깅에 사용할 수 있음 ad_impression 이벤트를 수신합니다.

다음 섹션에서는 몇 가지 광고 수익 창출 플랫폼의 구현 예를 설명합니다.

AppLovin

Swift

참고: 이 Firebase 제품은 macOS 대상에서 사용할 수 없습니다.

func didPayRevenue(_ impressionData: MAAd?) {
  if let impressionData = impressionData {
    Analytics.logEvent(
      AnalyticsEventAdImpression,
      parameters: [
        AnalyticsParameterAdPlatform: "AppLovin",
        AnalyticsParameterAdUnitName: impressionData.adUnitIdentifier,
        AnalyticsParameterAdFormat: impressionData.format,
        AnalyticsParameterValue: impressionData.revenue,
        AnalyticsParameterCurrency: "USD",  // All Applovin revenue is sent in USD
        AnalyticsParameterAdSource: impressionData.networkName,
      ])
  }
}
ViewController.swift

Objective-C

참고: 이 Firebase 제품은 macOS 대상에서 사용할 수 없습니다.

- (void)didPayRevenueForAd:(MAAd *)impressionData {
    [FIRAnalytics logEventWithName:kFIREventAdImpression
                    parameters: @{
                        kFIRParameterAdPlatform: @"AppLovin",
                        kFIRParameterAdSource: impressionData.networkName,
                        kFIRParameterAdFormat: impressionData.format,
                        kFIRParameterAdUnitName: impressionData.adUnitIdentifier,
                        kFIRParameterCurrency: @"USD", // All Applovin revenue is sent in USD
                        kFIRParameterValue: impressionData.revenue
                    }];
}
AnalyticsHelper.m

Kotlin+KTX

override fun onAdRevenuePaid(impressionData: MaxAd?) {
    impressionData?.let {
        firebaseAnalytics = Firebase.analytics
        firebaseAnalytics.logEvent(FirebaseAnalytics.Event.AD_IMPRESSION) {
            param(FirebaseAnalytics.Param.AD_PLATFORM, "appLovin")
            param(FirebaseAnalytics.Param.AD_UNIT_NAME, impressionData.adUnitId)
            param(FirebaseAnalytics.Param.AD_FORMAT, impressionData.format.label)
            param(FirebaseAnalytics.Param.AD_SOURCE, impressionData.networkName)
            param(FirebaseAnalytics.Param.VALUE, impressionData.revenue)
            param(FirebaseAnalytics.Param.CURRENCY, "USD") // All Applovin revenue is sent in USD
        }
    }
}
MainActivity.kt

Java

@Override
public void onAdRevenuePaid(MaxAd impressionData) {

    double revenue = impressionData.getRevenue(); // In USD

    mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
    Bundle params = new Bundle();
    params.putString(FirebaseAnalytics.Param.AD_PLATFORM, "appLovin");
    params.putString(FirebaseAnalytics.Param.AD_SOURCE, impressionData.getNetworkName());
    params.putString(FirebaseAnalytics.Param.AD_FORMAT, impressionData.getFormat().getLabel());
    params.putString(FirebaseAnalytics.Param.AD_UNIT_NAME, impressionData.getAdUnitId());
    params.putDouble(FirebaseAnalytics.Param.VALUE, revenue);
    params.putString(FirebaseAnalytics.Param.CURRENCY, "USD"); // All Applovin revenue is sent in USD
    mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.AD_IMPRESSION, params);
}
MainActivity.java

Unity

// Attach callbacks based on the ad format(s) you are using
MaxSdkCallbacks.Interstitial.OnAdRevenuePaidEvent += OnAdRevenuePaidEvent;
MaxSdkCallbacks.Rewarded.OnAdRevenuePaidEvent += OnAdRevenuePaidEvent;
MaxSdkCallbacks.Banner.OnAdRevenuePaidEvent += OnAdRevenuePaidEvent;
MaxSdkCallbacks.MRec.OnAdRevenuePaidEvent += OnAdRevenuePaidEvent;
private void OnAdRevenuePaidEvent(string adUnitId, MaxSdkBase.AdInfo impressionData)
{
double revenue = impressionData.Revenue;
var impressionParameters = new[] {
  new Firebase.Analytics.Parameter("ad_platform", "AppLovin"),
  new Firebase.Analytics.Parameter("ad_source", impressionData.NetworkName),
  new Firebase.Analytics.Parameter("ad_unit_name", impressionData.AdUnitIdentifier),
  new Firebase.Analytics.Parameter("ad_format", impressionData.AdFormat),
  new Firebase.Analytics.Parameter("value", revenue),
  new Firebase.Analytics.Parameter("currency", "USD"), // All AppLovin revenue is sent in USD
};
Firebase.Analytics.FirebaseAnalytics.LogEvent("ad_impression", impressionParameters);
}

ironSource

Swift

참고: 이 Firebase 제품은 macOS 대상에서 사용할 수 없습니다.

func impressionDataDidSucceed(_ impressionData: ISImpressionData!) {
  Analytics.logEvent(
    AnalyticsEventAdImpression,
    parameters: [
      AnalyticsParameterAdPlatform: "ironSource",
      AnalyticsParameterAdSource: impressionData.ad_network ?? "No ad_network",
      AnalyticsParameterAdFormat: impressionData.ad_unit ?? "No ad_unit",
      AnalyticsParameterAdUnitName: impressionData.instance_name ?? "No instance_name",
      AnalyticsParameterCurrency: "USD",
      AnalyticsParameterValue: impressionData.revenue ?? 0,
    ])
}
ViewController.swift

Objective-C

참고: 이 Firebase 제품은 macOS 대상에서 사용할 수 없습니다.

- (void)impressionDataDidSucceed:(ISImpressionData *)impressionData {
  [FIRAnalytics logEventWithName:kFIREventAdImpression
                      parameters:@{
                        kFIRParameterAdPlatform: @"ironSource",
                        kFIRParameterAdSource: impressionData.ad_network,
                        kFIRParameterAdFormat: impressionData.ad_unit,
                        kFIRParameterAdUnitName: impressionData.instance_name,
                        kFIRParameterCurrency: @"USD",
                        kFIRParameterValue: impressionData.revenue
                      }];
}
AnalyticsHelper.m

Kotlin+KTX

override fun onImpressionSuccess(impressionData: ImpressionData) {
    // The onImpressionSuccess will be reported when the rewarded video and interstitial ad is
    // opened.
    // For banners, the impression is reported on load success. Log.d(TAG, "onImpressionSuccess" +
    // impressionData)
    firebaseAnalytics = Firebase.analytics
    firebaseAnalytics.logEvent(FirebaseAnalytics.Event.AD_IMPRESSION) {
        param(FirebaseAnalytics.Param.AD_PLATFORM, "ironSource")
        param(FirebaseAnalytics.Param.AD_SOURCE, impressionData.adNetwork)
        param(FirebaseAnalytics.Param.AD_FORMAT, impressionData.adUnit)
        param(FirebaseAnalytics.Param.AD_UNIT_NAME, impressionData.instanceName)
        param(FirebaseAnalytics.Param.CURRENCY, "USD")
        param(FirebaseAnalytics.Param.VALUE, impressionData.revenue)
    }
}
MainActivity.kt

Java

@Override
public void onImpressionSuccess(ImpressionData impressionData) {
    // The onImpressionSuccess will be reported when the rewarded video and interstitial ad is opened.
    // For banners, the impression is reported on load success. Log.d(TAG, "onImpressionSuccess" + impressionData);
    mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
    if (impressionData != null) {
        Bundle bundle = new Bundle();
        bundle.putString(FirebaseAnalytics.Param.AD_PLATFORM, "ironSource");
        bundle.putString(FirebaseAnalytics.Param.AD_SOURCE, impressionData.getAdNetwork());
        bundle.putString(FirebaseAnalytics.Param.AD_FORMAT, impressionData.getAdUnit());
        bundle.putString(FirebaseAnalytics.Param.AD_UNIT_NAME, impressionData.getInstanceName());
        bundle.putString(FirebaseAnalytics.Param.CURRENCY, "USD");
        bundle.putDouble(FirebaseAnalytics.Param.VALUE, impressionData.getRevenue());
        mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.AD_IMPRESSION, bundle);
    }
}
MainActivity.java

Unity

private void ImpressionSuccessEvent(IronSourceImpressionData impressionData) {
  if (impressionData != null) {
      Firebase.Analytics.Parameter[] AdParameters = {
        new Firebase.Analytics.Parameter("ad_platform", "ironSource"),
        new Firebase.Analytics.Parameter("ad_source", impressionData.adNetwork),
        new Firebase.Analytics.Parameter("ad_unit_name", impressionData.getInstanceName),
        new Firebase.Analytics.Parameter("ad_format", impressionData.getAdUnit),
        new Firebase.Analytics.Parameter("currency","USD"),
        new Firebase.Analytics.Parameter("value", impressionData.getRevenue)
      };
      Firebase.Analytics.FirebaseAnalytics.LogEvent("ad_impression", AdParameters);
  }
}

구현 관련 고려사항

Google Ads에서 ad_impression, 필수 항목인 currency 및 value 매개변수 (아래 설명 참고)를 모두 지원합니다. 두 매개변수가 가능한 한 정확해야 사용자를 과대평가하거나 과소평가하지 않을 수 있습니다.

통화 매개변수

currency 매개변수(iOS+ | Android | Unity)는 세 글자의 ISO_4217 형식 문자열(예: "USD")로 전송되어야 합니다. 일부 광고 수익 창출 플랫폼에서는 통화가 생략되므로 매개변수를 하드코딩해야 할 수도 있습니다.

값 매개변수

value 매개변수(iOS+ | Android | Unity)는 소수점 구분 기호로 점을 사용하여 전송되어야 합니다. 일부 플랫폼에서 수신한 값은 위 필수 형식에 맞게 변환해야 할 수도 있습니다. 일부 플랫폼은 숫자 형식을 현지화하고 쉼표를 소수점 구분 기호로 사용합니다. 경우에 따라서는 플랫폼에서 값을 아예 전송하지 못할 수 있습니다.

또한 이 값은 double 또는 long과 같은 숫자 유형이어야 합니다. 예를 들어 1000.01, 0.001, 1.00은 모두 유효합니다.

검증

Google Analytics는 구현을 검증하는 다양한 기능을 제공합니다. 영향을 미칠 수 있습니다

1. DebugView
   구현을 처음 테스트할 때 DebugView를 사용하여 Console에서 테스트 ad_impression 데이터를 확인합니다. ad_impression 이벤트를 선택하면 화면 오른쪽에 있는 Parameters 패널에서 전송하는 매개변수를 검토할 수 있습니다. 이렇게 하면 올바른 정보가 처리되고 있는지 확인할 수 있습니다.

2. 실시간
   앱을 배포한 후 Google Analytics를 사용합니다. 실시간 보고서 구현이 올바르게 작동하는지 확인합니다 실시간 보고서에서는 이벤트 이름별 이벤트 수 카드를 보고 ad_impression을 선택하여 최근 30분 동안의 이벤트 및 매개변수 세부정보입니다.

3. 
   (BigQuery) BigQuery 내보내기를 사용하여 하나 이상의 ad_impression 이벤트의 샘플입니다. 이 추출된 샘플을 사용하여 0 또는 설정되지 않은 값과 같은 문제를 찾고 처리되지 않은 사용 사례에 맞게 코드에 수정사항을 적용하세요.

다음 단계

Firebase 콘솔 또는 연결된Analytics Analytics 속성을 Analytics 콘솔에서 설정합니다. 광고 수익은 사용자당 평균 수익(ARPU), 평생 가치(LTV) 등의 측정항목에 반영됩니다.