광고 구매 어트리뷰션
미디에이션 플랫폼의 광고 구매을 추적하고 사용자를 확보한 마케팅 캠페인에 어트리뷰션하여 캠페인 비용, 인앱 구매, 광고 구매화 전반에 걸쳐 완벽한 ROI 가시성을 제공하세요.
개요
광고 구매 어트리뷰션이란?
광고 구매 어트리뷰션은 모바일 앱 광고 구매을 앱 설치를 유도한 사용자 확보 캠페인에 연결하여 광고 구매화를 포함한 진정한 캠페인 구매성을 측정할 수 있도록 해줍니다.
주요 이점
- 연동 ROI 보기: Singular 대시보드에서 캠페인 비용, 인앱 구매, 광고 구매을 확인할 수 있습니다.
- 캠페인 최적화: 광고 구매 데이터를 광고 네트워크에 다시 전송하여 비딩 및 타겟팅 개선
- LTV 측정: 광고 구매화를 포함한 전체 사용자 생애 가치 계산
데이터 소스: 광고 구매 데이터는 일반적으로 사용자 수준 또는 노출 수준에서 미디에이션 플랫폼(예: 애드몹, 앱러빈 MAX, 아이언소스)에서 가져옵니다. Singular는 이 데이터를 수신하기 위한 다양한 연동 방법을 지원합니다.
자세히 알아보기: 설정, 보고 및 문제 해결에 대한 자세한 내용은 광고 구매 어트리뷰션 FAQ를참조하세요.
구현 요구 사항
중요 가이드라인
데이터 정확성이 중요합니다:
- 통화 코드: 세 글자로 구성된 ISO 4217 통화 코드(예: USD, EUR, INR)를 사용하세요. 많은 중개 플랫폼이 USD로 보고하므로 구현하기 전에 플랫폼의 통화를 확인하세요.
-
전송 전에 유효성을 검사하세요:
Singular.adRevenue()으로 전화하기 전에 항상 구매 및 통화 데이터를 검증하세요. 잘못된 데이터는 제출 후 수정할 수 없습니다. - 플랫폼별 차이점: iOS는 마이크로를 사용하는 Android와 달리 표준 통화 단위(예: $0.005)로 구매을 직접 수령합니다. 항상 플랫폼의 설명서에서 올바른 형식을 확인하세요.
설정 단계
광고 구매 어트리뷰션을 구현하려면 다음 단계를 따르세요:
- SDK를 업데이트합니다: 최신 Singular SDK 버전을 사용하고 있는지 확인합니다.
- 연동을 선택합니다: 아래에서 설정과 일치하는 미디에이션 플랫폼 연동을 선택합니다.
- 콜백을 구현합니다: 플랫폼별 유료 이벤트 리스너를 추가하여 구매 데이터를 캡처합니다.
- 데이터 검증: 구매 보고를 테스트하고 데이터가 Singular 대시보드에 표시되는지 확인합니다.
플랫폼 연동
애드몹 연동
노출 수준 구매 보고를 위해 유료 이벤트 리스너를 사용하여 구글 애드몹에서 광고 구매을 추적하세요.
요구 사항:
플랫폼 구매 보고: 애드몹은 플랫폼별로 구매을 다르게 보고합니다. iOS는 표준 통화 단위(예: $0.005 = 0.005)로 구매을 반환합니다. 이 값을 변환하지 않고 Singular로 직접 전송합니다.
구현
광고를 로드할 때 유료 이벤트 핸들러를 설정하여 구매 데이터를 캡처하고 이를 Singular로 전송합니다.
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)")
}
}
}
#import <Singular/Singular.h>
#import <GoogleMobileAds/GoogleMobileAds.h>
static NSString *const adUnitID = @"AD_UNIT_ID";
@interface AdManager ()
@property(nonatomic, strong) GADRewardedAd *rewardedAd;
@end
@implementation AdManager
- (void)loadRewardedAd {
GADRequest *request = [[GADRequest alloc] init];
[GADRewardedAd loadWithAdUnitID:adUnitID
request:request
completionHandler:^(GADRewardedAd *ad, NSError *error) {
if (error) {
NSLog(@"Rewarded ad failed to load: %@", error.localizedDescription);
return;
}
self.rewardedAd = ad;
// Set paid event handler for revenue tracking
self.rewardedAd.paidEventHandler = ^(GADAdValue *adValue) {
// Extract revenue and currency from AdValue
double revenue = adValue.value.doubleValue;
NSString *currency = adValue.currencyCode;
// Validate revenue and currency before sending
if (revenue > 0 && currency.length > 0) {
// Create ad revenue data object
SingularAdData *data = [[SingularAdData alloc]
initWithAdPlatfrom:@"AdMob"
currency:currency
revenue:revenue];
// Send to Singular
[Singular adRevenue:data];
NSLog(@"Ad revenue sent: %f %@", revenue, currency);
} else {
NSLog(@"Invalid ad revenue data: revenue = %f, currency = %@",
revenue, currency);
}
};
}];
}
@end
앱러빈 MAX 연동
앱러빈 노출 수준 사용자 구매 API를 사용하여 노출 수준 광고 구매을 공유하세요.
요구 사항:
- 앱러빈 MAX SDK를 구현합니다( 노출 수준 구매 API 가이드 참조).
-
AppLovin 커뮤니케이터를 통해
max_revenue_events주제를 구독합니다.
구현
앱러빈 커뮤니케이터 콜백을 통해 구매 메시지를 처리합니다.
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")
}
}
#import <Singular/Singular.h>
#import <AppLovinSDK/AppLovinSDK.h>
- (void)didReceive:(ALCMessage *)message {
// Check for revenue events topic
if ([@"max_revenue_events" isEqualToString:message.topic]) {
NSDictionary *data = message.data;
// Extract and validate revenue value
NSNumber *revenueNumber = data[@"revenue"];
double revenueValue = [revenueNumber doubleValue];
if (revenueValue > 0) {
// Create ad revenue data object
SingularAdData *adData = [[SingularAdData alloc]
initWithAdPlatfrom:@"AppLovin"
currency:@"USD"
revenue:revenueValue];
// Send to Singular
[Singular adRevenue:adData];
NSLog(@"Ad revenue sent: %f USD", revenueValue);
} else {
NSLog(@"Failed to parse valid revenue value or revenue is not greater than 0");
}
}
}
유니티 레벨플레이(아이언소스) 연동
IronSource SDK를 사용하여 IronSource 및 미디에이티드 네트워크의 노출 수준 구매을 추적합니다.
요구 사항
- ironSource SDK 구현( 시작 가이드 참조)
- 아이언소스 대시보드에서 ARM SDK 포스트백 플래그를 활성화합니다.
- 구매 콜백을 수신하도록 노출 데이터 리스너 설정
자세히 알아보기: 전체 설정에 대한 자세한 내용은 아이언소스 광고 구매 문서를참조하세요.
구현
노출 데이터 성공 콜백을 구현하여 구매을 캡처하고 전송합니다.
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")
}
#import <Singular/Singular.h>
#import <IronSource/IronSource.h>
- (void)impressionDataDidSucceed:(ISImpressionData *)impressionData {
// Validate impression data
if (!impressionData) {
NSLog(@"No impression data available");
return;
}
// Extract and validate revenue
double revenue = impressionData.revenue;
if (revenue <= 0) {
NSLog(@"Invalid revenue value: %f", revenue);
return;
}
// Create ad revenue data object
SingularAdData *data = [[SingularAdData alloc]
initWithAdPlatfrom:@"IronSource"
currency:@"USD"
revenue:revenue];
// Send to Singular
[Singular adRevenue:data];
NSLog(@"Ad revenue sent: %f USD", revenue);
}
트레이드플러스 연동
노출 델리게이트를 사용하여 트레이드플러스 중개에서 광고 구매을 캡처하세요.
요구 사항:
-
TradPlus.sharedInstance().impressionDelegate을 통해 노출 델리게이트를 설정합니다. -
tradPlusAdImpression콜백을 처리하여 구매 데이터를 수신합니다. - eCPM을 밀리 단위에서 표준 통화로 변환(1000으로 나누기)
구현
모든 광고 노출 및 구매을 추적하려면 노출 위임자를 등록하세요.
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)")
}
#import <Singular/Singular.h>
#import <TradPlusSDK/TradPlusSDK.h>
// Set up the delegate
TradPlus.sharedInstance.impressionDelegate = self;
// Delegate method for handling ad impressions
- (void)tradPlusAdImpression:(NSDictionary<NSString *, id> *)adInfo {
NSString *currency = @"USD";
// Extract and validate eCPM value
NSNumber *ecpmValue = adInfo[@"ecpm"];
if (!ecpmValue) {
NSLog(@"No eCPM data available in adInfo");
return;
}
// Convert eCPM from milli-units to dollars
double revenue = [ecpmValue doubleValue] / 1000.0;
// Validate revenue
if (revenue <= 0) {
NSLog(@"Ad Revenue value out of expected range: %f", revenue);
return;
}
// Create ad revenue data object
SingularAdData *data = [[SingularAdData alloc]
initWithAdPlatfrom:@"TradPlus"
currency:currency
revenue:revenue];
// Send to Singular
[Singular adRevenue:data];
NSLog(@"Ad revenue sent: %f %@", revenue, currency);
}
일반 연동(기타 플랫폼)
일반 SingularAdData 인터페이스를 사용하여 모든 미디에이션 플랫폼을 연동하세요.
요구 사항:
- 미디에이션 플랫폼에서 노출 수준 구매 데이터에 액세스할 수 있어야 합니다.
- 표준 통화 단위의 구매 금액
- ISO 4217 통화 코드(예: USD, EUR, INR)
데이터 정확도: Singular로 전송하기 전에 구매 및 통화 데이터의 유효성을 검사하세요. 잘못된 데이터는 제출 후에는 수정할 수 없습니다.
구현
플랫폼 이름, 통화, 구매이 포함된 SingularAdData 개체를 생성한 다음 Singular.adRevenue() 으로 호출합니다.
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)
#import <Singular/Singular.h>
- (void)reportAdRevenueWithPlatform:(NSString *)adPlatform
currency:(NSString *)currency
revenue:(double)revenue {
// Validate revenue
if (revenue <= 0) {
NSLog(@"Invalid revenue value: %f", revenue);
return;
}
// Validate currency
if (!currency || currency.length == 0) {
NSLog(@"Invalid currency: %@", currency);
return;
}
// Create ad revenue data object
SingularAdData *data = [[SingularAdData alloc]
initWithAdPlatfrom:adPlatform
currency:currency
revenue:revenue];
// Send to Singular
[Singular adRevenue:data];
NSLog(@"Revenue sent: %f %@ from %@", revenue, currency, adPlatform);
}
// Example usage
[self reportAdRevenueWithPlatform:@"MyMediationPlatform"
currency:@"USD"
revenue:0.05];
테스트 및 유효성 검사
구매 보고 확인
광고 구매 구현을 테스트하여 데이터가 Singular에 올바르게 전달되는지 확인합니다.
- 로그를 확인합니다: 구매 콜백 로그가 올바른 값과 통화로 표시되는지 확인합니다.
- 광고 테스트: 테스트 광고: 구매 이벤트를 트리거하기 위해 테스트 광고를 로드하고 표시합니다.
- 대시보드 확인: 24시간 이내에 Singular 대시보드에 구매이 표시되는지 확인합니다.
- 데이터 정확성: 구매 금액이 미디에이션 플랫폼 리포트와 일치하는지 검증합니다.
문제 해결: Singular에 구매이 표시되지 않는 경우, 이를 확인하세요:
- Singular 계정에서 광고 구매 어트리뷰션이 활성화되어 있습니다.
- 구매 값이 0보다 큽니다.
- 통화 코드가 유효한 ISO 4217 코드입니다.
- 플랫폼 이름이 Singular의 예상 형식과 일치합니다.