노출 수준 광고 수익

노출이 발생하면 Google Mobile Ads SDK가 해당 노출과 연결된 광고 수익 데이터를 제공합니다. 이 데이터를 사용하여 사용자의 평생 가치를 계산하거나 데이터 다운스트림을 다른 관련 시스템으로 전달할 수 있습니다.

이 가이드에서는 iOS 앱에서 LTV 데이터 포착을 구현하는 방법에 대해 설명합니다.

사전 요구 사항

유료 이벤트 처리

각 광고 형식의 대리자 프로토콜에는 didRecordPaidEventWithAdValue: 메서드가 포함됩니다. 광고 수명 주기 동안 Google Mobile Ads SDK는 노출 이벤트를 모니터링하고 획득한 GADAdValue 객체로 이 대리자 메서드를 호출합니다.

다음 예에서는 보상형 광고의 유료 이벤트를 처리합니다.

Swift

func ad(_ ad: FullScreenPresentingAd, didRecordPaidEventWith adValue: AdValue) {
  // TODO: Send the impression-level ad revenue information to your preferred
  // analytics server directly within this callback.

  // Extract the impression-level ad revenue data.
  let value = adValue.value
  let currencyCode = adValue.currencyCode
  let precision = adValue.precision

  print(
    "Ad paid event. Value: \(value) \(currencyCode), with precision: \(precision)."
  )
}

Objective-C

- (void)ad:(id<GADFullScreenPresentingAd>)ad didRecordPaidEventWithAdValue:(GADAdValue *)adValue {
  // TODO: Send the impression-level ad revenue information to your preferred
  // analytics server directly within this callback.

  // Extract the impression-level ad revenue data.
  NSDecimalNumber *value = adValue.value;
  NSString *currencyCode = adValue.currencyCode;
  GADAdValuePrecision precision = adValue.precision;

  NSLog(@"Ad paid event. Value: %@ %@, with precision: %ld.", value, currencyCode, (long)precision);
}

맞춤 이벤트 광고 소스 이름 식별

맞춤 이벤트 광고 소스의 경우 adSourceName 속성이 광고 소스 이름 Custom event를 제공합니다. 맞춤 이벤트를 여러 개 사용하는 경우 광고 소스 이름이 여러 맞춤 이벤트를 구분할 만큼 세분화되지 않습니다. 특정 맞춤 이벤트를 찾으려면 다음 단계를 따르세요.

  1. adNetworkClassName 속성을 가져옵니다.
  2. 고유한 광고 소스 이름을 설정합니다.

다음 예에서는 맞춤 이벤트의 고유한 광고 소스 이름을 설정합니다.

Swift

func uniqueAdSourceName(for loadedAdNetworkResponseInfo: AdNetworkResponseInfo) -> String {
  var adSourceName: String = loadedAdNetworkResponseInfo.adSourceName ?? ""
  if adSourceName == "Custom Event" {
    if loadedAdNetworkResponseInfo.adNetworkClassName
      == "MediationExample.SampleCustomEventSwift"
    {
      adSourceName = "Sample Ad Network (Custom Event)"
    }
  }
  return adSourceName
}

Objective-C

- (NSString *)uniqueAdSourceNameForAdNetworkResponseInfo:
    (GADAdNetworkResponseInfo *)loadedAdNetworkResponseInfo {
  NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
  if ([adSourceName isEqualToString:@"Custom Event"]) {
    if ([loadedAdNetworkResponseInfo.adNetworkClassName isEqualToString:@"SampleCustomEvent"]) {
      adSourceName = @"Sample Ad Network (Custom Event)";
    }
  }
  return adSourceName;
}

낙찰된 광고 소스에 대한 자세한 내용은 광고 응답에 대한 정보 가져오기를 참고하세요.

구현 권장사항

  • 광고 객체를 만들거나 광고 객체에 액세스할 수 있게 되면 즉시 대리자를 설정하세요. 광고 게재 전에 설정해야 합니다. 이렇게 하면 유료 이벤트 콜백이 누락되지 않습니다.
  • didRecordPaidEventWithAdValue: 대리자 메서드가 호출되는 즉시 유료 이벤트 정보를 원하는 분석 서버로 즉시 전송하세요. 이렇게 하면 의도치 않은 콜백 누락이 발생하지 않으며 데이터 불일치를 방지할 수 있습니다.

GADAdValue

GADAdValue는 광고에서 확보하는 금전적 가치를 나타내는 클래스입니다(예: 값의 통화 코드, 아래와 같이 인코딩된 정밀도 유형).

GADAdValuePrecision 설명
GADAdValuePrecisionUnknown 광고 값을 알 수 없습니다. LTV 핑백이 사용 설정되었지만 사용 가능한 데이터가 충분하지 않은 경우 반환됩니다.
GADAdValuePrecisionEstimated 합산 데이터에서 예상되는 광고 값입니다.
GADAdValuePrecisionPublisherProvided 미디에이션 그룹의 수동 CPM처럼 게시자가 제공한 광고 값입니다.
GADAdValuePrecisionPrecise 광고에 지불된 정확한 값입니다.

공개 입찰의 노출 테스트

테스트 요청으로 공개 입찰 광고 소스에서 노출 수준 광고 수익 이벤트가 발생하면 다음 값만 수신됩니다.

  • GADAdValuePrecisionUnknown: 정밀도 유형을 나타냅니다.
  • 0: 광고 값을 나타냅니다.
이전에는 정밀도 유형이 GADAdValuePrecisionUnknown이 아닌 값으로 표시되고 광고 가치가 0보다 큰 값으로 표시되었을 수 있습니다.

테스트 광고 요청 전송에 관한 자세한 내용은 테스트 기기 사용 설정을 참고하세요.