iOS SDK - 광고 구매 추적

문서

광고 구매 어트리뷰션

미디에이션 플랫폼의 광고 구매을 추적하고 사용자를 확보한 마케팅 캠페인에 어트리뷰션하여 캠페인 비용, 인앱 구매, 광고 구매화 전반에 걸쳐 완벽한 ROI 가시성을 제공하세요.

개요

광고 구매 어트리뷰션이란?

광고 구매 어트리뷰션은 모바일 앱 광고 구매을 앱 설치를 유도한 사용자 확보 캠페인에 연결하여 광고 구매화를 포함한 진정한 캠페인 구매성을 측정할 수 있도록 해줍니다.

주요 이점

  • 연동 ROI 보기: Singular 대시보드에서 캠페인 비용, 인앱 구매, 광고 구매을 확인할 수 있습니다.
  • 캠페인 최적화: 광고 구매 데이터를 광고 네트워크에 다시 전송하여 비딩 및 타겟팅 개선
  • LTV 측정: 광고 구매화를 포함한 전체 사용자 생애 가치 계산

데이터 소스: 광고 구매 데이터는 일반적으로 사용자 수준 또는 노출 수준에서 미디에이션 플랫폼(예: 애드몹, 앱러빈 MAX, 아이언소스)에서 가져옵니다. Singular는 이 데이터를 수신하기 위한 다양한 연동 방법을 지원합니다.

자세히 알아보기: 설정, 보고 및 문제 해결에 대한 자세한 내용은 광고 구매 어트리뷰션 FAQ를참조하세요.


구현 요구 사항

중요 가이드라인

데이터 정확성이 중요합니다:

  1. 통화 코드: 세 글자로 구성된 ISO 4217 통화 코드(예: USD, EUR, INR)를 사용하세요. 많은 중개 플랫폼이 USD로 보고하므로 구현하기 전에 플랫폼의 통화를 확인하세요.
  2. 전송 전에 유효성을 검사하세요: Singular.adRevenue() 으로 전화하기 전에 항상 구매 및 통화 데이터를 검증하세요. 잘못된 데이터는 제출 후 수정할 수 없습니다.
  3. 플랫폼별 차이점: iOS는 마이크로를 사용하는 Android와 달리 표준 통화 단위(예: $0.005)로 구매을 직접 수령합니다. 항상 플랫폼의 설명서에서 올바른 형식을 확인하세요.

설정 단계

광고 구매 어트리뷰션을 구현하려면 다음 단계를 따르세요:

  1. SDK를 업데이트합니다: 최신 Singular SDK 버전을 사용하고 있는지 확인합니다.
  2. 연동을 선택합니다: 아래에서 설정과 일치하는 미디에이션 플랫폼 연동을 선택합니다.
  3. 콜백을 구현합니다: 플랫폼별 유료 이벤트 리스너를 추가하여 구매 데이터를 캡처합니다.
  4. 데이터 검증: 구매 보고를 테스트하고 데이터가 Singular 대시보드에 표시되는지 확인합니다.

플랫폼 연동

애드몹 연동

노출 수준 구매 보고를 위해 유료 이벤트 리스너를 사용하여 구글 애드몹에서 광고 구매을 추적하세요.

요구 사항:

  • 애드몹 계정에서 유료 이벤트 추적을 활성화합니다( 애드몹 지원 참조).
  • iOS용 Google 모바일 광고 SDK 구현( 시작 가이드 참조)

플랫폼 구매 보고: 애드몹은 플랫폼별로 구매을 다르게 보고합니다. iOS는 표준 통화 단위(예: $0.005 = 0.005)로 구매을 반환합니다. 이 값을 변환하지 않고 Singular로 직접 전송합니다.

구현

광고를 로드할 때 유료 이벤트 핸들러를 설정하여 구매 데이터를 캡처하고 이를 Singular로 전송합니다.

SwiftObjective-C
import Singular
import GoogleMobileAds

private let adUnitID = "AD_UNIT_ID"
var rewardedAd: GADRewardedAd?

func loadRewardedAd() {
    let request = GADRequest()
    
    GADRewardedAd.load(withAdUnitID: adUnitID, request: request) { [weak self] ad, error in
        guard let self = self else { return }
        
        if let error = error {
            print("Rewarded ad failed to load: \(error.localizedDescription)")
            return
        }
        
        self.rewardedAd = ad
        
        // Set paid event handler for revenue tracking
        self.rewardedAd?.paidEventHandler = { adValue in
            // Extract revenue and currency from AdValue
            let revenue = adValue.value.doubleValue
            let currency = adValue.currencyCode
            
            // Validate revenue and currency before sending
            guard revenue > 0, let currency = currency, !currency.isEmpty else {
                print("Invalid ad revenue data: revenue = \(revenue), currency = \(String(describing: currency))")
                return
            }
            
            // Create ad revenue data object
            let data = SingularAdData(
                adPlatform: "AdMob",
                currency: currency,
                revenue: revenue
            )
            
            // Send to Singular
            Singular.adRevenue(data)
            print("Ad revenue sent: \(revenue) \(currency)")
        }
    }
}

앱러빈 MAX 연동

앱러빈 노출 수준 사용자 구매 API를 사용하여 노출 수준 광고 구매을 공유하세요.

요구 사항:

구현

앱러빈 커뮤니케이터 콜백을 통해 구매 메시지를 처리합니다.

SwiftObjective-C
import Singular
import AppLovinSDK

func didReceive(_ message: ALCMessage) {
    // Check for revenue events topic
    if message.topic == "max_revenue_events" {
        // Extract and validate revenue value
        guard let revenueValue = message.data["revenue"] as? Double,
              revenueValue > 0 else {
            print("Failed to parse valid revenue value or revenue is not greater than 0")
            return
        }
        
        // Create ad revenue data object
        let data = SingularAdData(
            adPlatform: "AppLovin",
            currency: "USD",  // AppLovin typically reports in USD
            revenue: revenueValue
        )
        
        // Send to Singular
        Singular.adRevenue(data)
        print("Ad revenue sent: \(revenueValue) USD")
    }
}

유니티 레벨플레이(아이언소스) 연동

IronSource SDK를 사용하여 IronSource 및 미디에이티드 네트워크의 노출 수준 구매을 추적합니다.

요구 사항

  • ironSource SDK 구현( 시작 가이드 참조)
  • 아이언소스 대시보드에서 ARM SDK 포스트백 플래그를 활성화합니다.
  • 구매 콜백을 수신하도록 노출 데이터 리스너 설정

자세히 알아보기: 전체 설정에 대한 자세한 내용은 아이언소스 광고 구매 문서를참조하세요.

구현

노출 데이터 성공 콜백을 구현하여 구매을 캡처하고 전송합니다.

SwiftObjective-C
import Singular
import IronSource

func impressionDataDidSucceed(_ impressionData: ISImpressionData?) {
    // Validate impression data
    guard let impressionData = impressionData else {
        print("No impression data available")
        return
    }
    
    // Extract and validate revenue
    let revenue = impressionData.revenue
    guard revenue > 0 else {
        print("Invalid revenue value: \(revenue)")
        return
    }
    
    // Create ad revenue data object
    let data = SingularAdData(
        adPlatform: "IronSource",
        currency: "USD",  // IronSource typically reports in USD
        revenue: revenue
    )
    
    // Send to Singular
    Singular.adRevenue(data)
    print("Ad revenue sent: \(revenue) USD")
}

트레이드플러스 연동

노출 델리게이트를 사용하여 트레이드플러스 중개에서 광고 구매을 캡처하세요.

요구 사항:

  • TradPlus.sharedInstance().impressionDelegate 을 통해 노출 델리게이트를 설정합니다.
  • tradPlusAdImpression 콜백을 처리하여 구매 데이터를 수신합니다.
  • eCPM을 밀리 단위에서 표준 통화로 변환(1000으로 나누기)

구현

모든 광고 노출 및 구매을 추적하려면 노출 위임자를 등록하세요.

SwiftObjective-C
import Singular
import TradPlusSDK

// Set up the delegate
TradPlus.sharedInstance().impressionDelegate = self

// Delegate method for handling ad impressions
func tradPlusAdImpression(_ adInfo: [String: Any]) {
    let currency = "USD"
    
    // Extract and validate eCPM value
    guard let ecpmValue = adInfo["ecpm"] as? NSNumber else {
        print("No eCPM data available in adInfo")
        return
    }
    
    // Convert eCPM from milli-units to dollars
    let revenue = ecpmValue.doubleValue / 1000.0
    
    // Validate revenue
    guard revenue > 0 else {
        print("Ad Revenue value out of expected range: \(revenue)")
        return
    }
    
    // Create ad revenue data object
    let data = SingularAdData(
        adPlatform: "TradPlus",
        currency: currency,
        revenue: revenue
    )
    
    // Send to Singular
    Singular.adRevenue(data)
    print("Ad revenue sent: \(revenue) \(currency)")
}

일반 연동(기타 플랫폼)

일반 SingularAdData 인터페이스를 사용하여 모든 미디에이션 플랫폼을 연동하세요.

요구 사항:

  • 미디에이션 플랫폼에서 노출 수준 구매 데이터에 액세스할 수 있어야 합니다.
  • 표준 통화 단위의 구매 금액
  • ISO 4217 통화 코드(예: USD, EUR, INR)

데이터 정확도: Singular로 전송하기 전에 구매 및 통화 데이터의 유효성을 검사하세요. 잘못된 데이터는 제출 후에는 수정할 수 없습니다.

구현

플랫폼 이름, 통화, 구매이 포함된 SingularAdData 개체를 생성한 다음 Singular.adRevenue() 으로 호출합니다.

SwiftObjective-C
import Singular

func reportAdRevenue(adPlatform: String, currency: String, revenue: Double) {
    // Validate revenue
    guard revenue > 0 else {
        print("Invalid revenue value: \(revenue)")
        return
    }
    
    // Validate currency
    guard !currency.isEmpty else {
        print("Invalid currency: \(currency)")
        return
    }
    
    // Create ad revenue data object
    let data = SingularAdData(
        adPlatform: adPlatform,
        currency: currency,
        revenue: revenue
    )
    
    // Send to Singular
    Singular.adRevenue(data)
    print("Revenue sent: \(revenue) \(currency) from \(adPlatform)")
}

// Example usage
reportAdRevenue(adPlatform: "MyMediationPlatform", currency: "USD", revenue: 0.05)

테스트 및 유효성 검사

구매 보고 확인

광고 구매 구현을 테스트하여 데이터가 Singular에 올바르게 전달되는지 확인합니다.

  1. 로그를 확인합니다: 구매 콜백 로그가 올바른 값과 통화로 표시되는지 확인합니다.
  2. 광고 테스트: 테스트 광고: 구매 이벤트를 트리거하기 위해 테스트 광고를 로드하고 표시합니다.
  3. 대시보드 확인: 24시간 이내에 Singular 대시보드에 구매이 표시되는지 확인합니다.
  4. 데이터 정확성: 구매 금액이 미디에이션 플랫폼 리포트와 일치하는지 검증합니다.

문제 해결: Singular에 구매이 표시되지 않는 경우, 이를 확인하세요:

  • Singular 계정에서 광고 구매 어트리뷰션이 활성화되어 있습니다.
  • 구매 값이 0보다 큽니다.
  • 통화 코드가 유효한 ISO 4217 코드입니다.
  • 플랫폼 이름이 Singular의 예상 형식과 일치합니다.