Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출을 기록할 수 있습니다.
광고 매출을 측정하려면 Adjust 대시보드에서 몇 가지 추가 설정 단계를 거쳐야 합니다. 자세한 정보는 담당 테크니컬 어카운트 매니저나 support@adjust.com으로 연락주시기 바랍니다.
ADJAdRevenue 객체 인스턴스화
- (nullable id)initWithSource:(nonnull NSString *)source;Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 ADJAdRevenue 객체를 인스턴스화해야 합니다. 이 객체에는 광고 매출이 앱에 기록될 때 Adjust로 전송되는 변수가 포함됩니다.
광고 매출 객체를 인스턴스화하려면 새로운 ADJAdRevenue 인스턴스를 생성하고 다음 인수를 전달합니다.
source(NSString): 광고 매출 소스. 아래 표에서 이용 가능한 소스를 참조하세요.
| 인수 (Arguments) | 광고 매출 소스 |
|---|---|
"applovin_max_sdk" | AppLovin MAX |
"admob_sdk" | Admob |
"ironsource_sdk" | ironSource |
"admost_sdk" | Admost |
"unity_sdk" | Unity |
"helium_chartboost_sdk" | Helium Chartboost |
"adx_sdk" | Ad(X) |
"publisher_sdk" | 일반적인 소스 |
"tradplus_sdk" | TradPlus |
"topon_sdk" | TopOn |
"mopub" | MoPub |
let adRevenue = ADJAdRevenue(source: "applovin_max_sdk")//...Adjust.trackAdRevenue(adRevenue)ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:@"applovin_max_sdk"];//...[Adjust trackAdRevenue:adRevenue];광고 매출 전송
+ (void)trackAdRevenue:(nonnull NSString *)source payload:(nonnull NSData *)payload;Adjust로 광고 매출을 전송하려면 광고 매출 인스턴스를 인수로 사용하여 trackAdRevenue 메서드를 호출합니다.
let adRevenue = ADJAdRevenue(source: "applovin_max_sdk")Adjust.trackAdRevenue(adRevenue)ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:@"applovin_max_sdk"];///...[Adjust trackAdRevenue:adRevenue];광고 매출 금액 기록
- (void)setRevenue:(double)amount currency:(nonnull NSString *)currency;광고 매출 금액을 전송하려면 setRevenue 메서드를 호출하고 다음 인수를 전달합니다.
revenue(double): 매출 금액currency(NSString): 리포팅에 사용하는 통화의 3글자 ISO 4217 코드
자세한 정보는 Adjust의 여러 통화로 구매 기록 가이드를 참조하시기 바랍니다.
let adRevenue = ADJAdRevenue(source: "applovin_max_sdk")adRevenue.setRevenue(1.6, currency: "USD")Adjust.trackAdRevenue(adRevenue)ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:@"applovin_max_sdk"];[adRevenue setRevenue:1.6 currency:@"USD"];[Adjust trackAdRevenue:adRevenue];광고 캠페인 세부 항목 기록
ADJAdRevenue 클래스에 광고 캠페인 리포트에 사용할 수 있는 속성이 포함됩니다.
광고 노출
- (void)setAdImpressionsCount:(int)adImpressionsCount;기록된 광고 노출 횟수를 전송하려면 setAdImpressionsCount 메서드를 호출하고 다음 인수를 전달합니다.
adImpressionsCount(int): 광고 노출 횟수
let adRevenue = ADJAdRevenue(source: "applovin_max_sdk")adRevenue?.adImpressionsCount = 1Adjust.trackAdRevenue(adRevenue)ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:@"applovin_max_sdk"];[adRevenue setAdImpressionsCount:1];[Adjust trackAdRevenue:adRevenue];광고 매출 네트워크
- (void)setAdRevenueNetwork:(nonnull NSString *)adRevenueNetwork;광고 매출 네트워크를 전송하려면 setAdRevenueNetwork 메서드를 호출하고 다음 인수를 전달합니다.
adRevenueNetwork(NSString): 네트워크 이름
let adRevenue = ADJAdRevenue(source: "applovin_max_sdk")adRevenue?.adRevenueNetwork = "network1"Adjust.trackAdRevenue(adRevenue)ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:@"applovin_max_sdk"];[adRevenue setAdRevenueNetwork:@"network1"];[Adjust trackAdRevenue:adRevenue];광고 매출 단위
- (void)setAdRevenueUnit:(nonnull NSString *)adRevenueUnit;광고 매출 단위를 전송하려면 setAdRevenueUnit 메서드를 호출하고 다음 인수를 전달합니다.
adRevenueUnit(NSString): 광고 단위
let adRevenue = ADJAdRevenue(source: "applovin_max_sdk")adRevenue?.adRevenueUnit = "unit1"Adjust.trackAdRevenue(adRevenue)ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:@"applovin_max_sdk"];[adRevenue setAdRevenueUnit:@"unit1"];[Adjust trackAdRevenue:adRevenue];광고 매출 게재 위치
- (void)setAdRevenuePlacement:(nonnull NSString *)adRevenuePlacement;광고 매출 게재 위치를 전송하려면 setAdRevenuePlacement 메서드를 호출하고 다음 인수를 전달합니다.
adRevenuePlacement(NSString): 광고 게재 위치
let adRevenue = ADJAdRevenue(source: "applovin_max_sdk")adRevenue?.adRevenuePlacement = "banner"Adjust.trackAdRevenue(adRevenue)ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:@"applovin_max_sdk"];[adRevenue setAdRevenuePlacement:@"banner"];[Adjust trackAdRevenue:adRevenue];콜백 파라미터 추가
- (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value;Adjust 대시보드에 콜백 URL을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다.
콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 콜백 URL에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다.
NSString 키-값 인수와 함께 addCallbackParameter 메서드를 호출하여 이벤트에 콜백 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다.
Adjust SDK는 이벤트를 측정하고 콜백 파라미터가 추가된 URL로 요청을 전송합니다. 예를 들어 URL https://www.mydomain.com/callback을 등록한 경우 콜백은 다음과 같습니다.
https://www.mydomain.com/callback?key=value&foo=barAdjust는 사용자의 커스텀 콜백 파라미터를 보관하지 않습니다. 커스텀 파라미터는 콜백 URL에만 추가됩니다.
CSV 업로드를 사용하는 경우, 반드시 CSV 정의에 파라미터를 추가하시기 바랍니다.
Adjust는 SDK에서 URL로 정보를 전송하는 데 사용할 수 있는 다양한 플레이스홀더를 지원합니다. 예를 들어, iOS의 경우 {idfa} 플레이스홀더, Android의 경우 {gps_adid} 플레이스홀더입니다. {publisher_parameter} 플레이스홀더는 단일 문자열의 모든 콜백 파라미터를 나타냅니다.
Adjust 콜백 가이드에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다.
let adRevenue = ADJAdRevenue(source: "applovin_max_sdk")adRevenue.addCallbackParameter(key, value: value)Adjust.trackAdRevenue(adRevenue)ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:@"applovin_max_sdk"];[adRevenue addCallbackParameter:key value:value];[Adjust trackAdRevenue:adRevenue];파트너 파라미터 추가
- (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value;파트너 파라미터를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다.
Adjust는 설정한 외부 파트너에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다.
파트너 파라미터는 기본 설정에 따라 로 데이터에 나타나지 않습니다. {partner_parameters} 플레이스홀더를 추가하여 단일 문자열로 수신할 수 있습니다.
NSString 키-값 인수와 함께 addPartnerParameter 메서드를 호출하여 이벤트에 파트너 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다.
let adRevenue = ADJAdRevenue(source: "applovin_max_sdk")adRevenue.addPartnerParameter(key, value: value)Adjust.trackAdRevenue(adRevenue)ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:@"applovin_max_sdk"];[adRevenue addPartnerParameter:key value:value];[Adjust trackAdRevenue:adRevenue];예시
이 예시는 다음 속성을 사용하여 광고 매출 객체를 설정하고 기록하는 방법을 보여줍니다.
- 매출 소스: AppLovin MAX
- 매출액: 1유로(Euro)
- 광고 노출: 10
- 광고 매출 네트워크:
"network1" - 광고 매출 단위:
"unit1" - 광고 매출 게재 위치:
"banner" - 콜백 파라미터:
"key1" = "value1" - 파트너 파라미터:
"key2" = "value2"
let adRevenue = ADJAdRevenue(source: "applovin_max_sdk")adRevenue.setRevenue(1, currency: "EUR")adRevenue.setAdImpressionsCount(10)adRevenue?.adRevenueNetwork = "network1"adRevenue?.adRevenueUnit = "unit1"adRevenue?.adRevenuePlacement = "banner"adRevenue.addCallbackParameter("key1", value: "value1")adRevenue.addPartnerParameter("key2", value: "value2")Adjust.trackAdRevenue(adRevenue)ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:@"applovin_max_sdk"];[adRevenue setRevenue:1 currency:@"EUR"];[adRevenue setAdImpressionsCount:10];[adRevenue setAdRevenueNetwork:@"network1"];[adRevenue setAdRevenueUnit:@"unit1"];[adRevenue setAdRevenuePlacement:@"banner"];[adRevenue addCallbackParameter:key1 value:@"value1"];[adRevenue addPartnerParameter:key2 value:"@value2"];[Adjust trackAdRevenue:adRevenue];Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출을 기록할 수 있습니다.
광고 매출을 측정하려면 Adjust 대시보드에서 몇 가지 추가 설정 단계를 거쳐야 합니다. 자세한 정보는 담당 테크니컬 어카운트 매니저나 support@adjust.com으로 연락주시기 바랍니다.
ADJAdRevenue 객체 인스턴스화
- (nullable id)initWithSource:(nonnull NSString *)source;Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 ADJAdRevenue 객체를 인스턴스화해야 합니다. 이 객체에는 광고 매출이 앱에 기록될 때 Adjust로 전송되는 변수가 포함됩니다.
광고 매출 객체를 인스턴스화하려면 새로운 ADJAdRevenue 인스턴스를 생성하고 다음 파라미터를 전달합니다.
source(NSString): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조
| 파라미터 | 소스 |
|---|---|
ADJAdRevenueSourceAppLovinMAX | AppLovin MAX |
ADJAdRevenueSourceMopub | MoPub |
ADJAdRevenueSourceAdMob | Admob |
ADJAdRevenueSourceIronSource | ironSource |
ADJAdRevenueSourceAdmost | Admost |
ADJAdRevenueSourceUnity | Unity |
ADJAdRevenueSourceHeliumChartboost | Helium Chartboost |
ADJAdRevenueSourceADX | Ad(X) |
ADJAdRevenueSourceTradplus | TradPlus |
ADJAdRevenueSourceTopon | TopOn |
ADJAdRevenueSourcePublisher | 일반적인 소스 |
let adRevenue = ADJAdRevenue(source: source);//...Adjust.trackAdRevenue(adRevenue);ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source];//...[Adjust trackAdRevenue:adRevenue];광고 매출 전송
+ (void)trackAdRevenue:(nonnull NSString *)source payload:(nonnull NSData *)payload;Adjust로 광고 매출을 전송하려면 광고 매출 인스턴스를 인수로 사용하여 trackAdRevenue 메서드를 호출합니다.
let adRevenue = ADJAdRevenue(source: source);Adjust.trackAdRevenue(adRevenue);ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source];///...[Adjust trackAdRevenue:adRevenue];광고 매출 금액 기록
- (void)setRevenue:(double)amount currency:(nonnull NSString *)currency;광고 매출 금액을 전송하려면 setRevenue 메서드를 호출하고 다음 인수를 전달합니다.
revenue(double): 매출 금액currency(NSString): 리포팅에 사용하는 통화의 3글자 ISO 4217 코드
자세한 정보는 Adjust의 여러 통화로 구매 기록 가이드를 참조하시기 바랍니다.
let adRevenue = ADJAdRevenue(source: source);adRevenue.setRevenue(1.6, currency: "USD");Adjust.trackAdRevenue(adRevenue);ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source];[adRevenue setRevenue:1.6 currency:@"USD"];[Adjust trackAdRevenue:adRevenue];광고 캠페인 세부 항목 기록
ADJAdRevenue 클래스에 광고 캠페인 리포트에 사용할 수 있는 속성이 포함됩니다.
광고 노출
- (void)setAdImpressionsCount:(int)adImpressionsCount;기록된 광고 노출 횟수를 전송하려면 setAdImpressionsCount 메서드를 호출하고 다음 인수를 전달합니다.
adImpressionsCount(int): 광고 노출 횟수
let adRevenue = ADJAdRevenue(source: source);adRevenue?.adImpressionsCount = 1;Adjust.trackAdRevenue(adRevenue);ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source];[adRevenue setAdImpressionsCount:1];[Adjust trackAdRevenue:adRevenue];광고 매출 네트워크
- (void)setAdRevenueNetwork:(nonnull NSString *)adRevenueNetwork;광고 매출 네트워크를 전송하려면 setAdRevenueNetwork 메서드를 호출하고 다음 인수를 전달합니다.
adRevenueNetwork(NSString): 네트워크 이름
let adRevenue = ADJAdRevenue(source: source);adRevenue?.adRevenueNetwork = "network1";Adjust.trackAdRevenue(adRevenue);ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source];[adRevenue setAdRevenueNetwork:@"network1"];[Adjust trackAdRevenue:adRevenue];광고 매출 단위
- (void)setAdRevenueUnit:(nonnull NSString *)adRevenueUnit;광고 매출 단위를 전송하려면 setAdRevenueUnit 메서드를 호출하고 다음 인수를 전달합니다.
adRevenueUnit(NSString): 광고 단위
let adRevenue = ADJAdRevenue(source: source);adRevenue?.adRevenueUnit = "unit1";Adjust.trackAdRevenue(adRevenue);ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source];[adRevenue setAdRevenueUnit:@"unit1"];[Adjust trackAdRevenue:adRevenue];광고 매출 게재 위치
- (void)setAdRevenuePlacement:(nonnull NSString *)adRevenuePlacement;광고 매출 게재 위치를 전송하려면 setAdRevenuePlacement 메서드를 호출하고 다음 인수를 전달합니다.
adRevenuePlacement(NSString): 광고 게재 위치
let adRevenue = ADJAdRevenue(source: source);adRevenue?.adRevenuePlacement = "banner";Adjust.trackAdRevenue(adRevenue);ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source];[adRevenue setAdRevenuePlacement:@"banner"];[Adjust trackAdRevenue:adRevenue];콜백 파라미터 추가
- (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value;Adjust 대시보드에 콜백 URL을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다.
콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 콜백 URL에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다.
NSString 키-값 인수와 함께 addCallbackParameter 메서드를 호출하여 이벤트에 콜백 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다.
Adjust SDK는 이벤트를 측정하고 콜백 파라미터가 추가된 URL로 요청을 전송합니다. 예를 들어 URL https://www.mydomain.com/callback을 등록한 경우 콜백은 다음과 같습니다.
https://www.mydomain.com/callback?key=value&foo=barAdjust는 사용자의 커스텀 콜백 파라미터를 보관하지 않습니다. 커스텀 파라미터는 콜백 URL에만 추가됩니다.
CSV 업로드를 사용하는 경우, 반드시 CSV 정의에 파라미터를 추가하시기 바랍니다.
Adjust는 SDK에서 URL로 정보를 전송하는 데 사용할 수 있는 다양한 플레이스홀더를 지원합니다. 예를 들어, iOS의 경우 {idfa} 플레이스홀더, Android의 경우 {gps_adid} 플레이스홀더입니다. {publisher_parameter} 플레이스홀더는 단일 문자열의 모든 콜백 파라미터를 나타냅니다.
Adjust 콜백 가이드에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다.
let adRevenue = ADJAdRevenue(source: source);adRevenue.addCallbackParameter(key, value: value);Adjust.trackAdRevenue(adRevenue);ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source];[adRevenue addCallbackParameter:key value:value];[Adjust trackAdRevenue:adRevenue];파트너 파라미터 추가
- (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value;파트너 파라미터를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다.
Adjust는 설정한 외부 파트너에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다.
파트너 파라미터는 기본 설정에 따라 로 데이터에 나타나지 않습니다. {partner_parameters} 플레이스홀더를 추가하여 단일 문자열로 수신할 수 있습니다.
NSString 키-값 인수와 함께 addPartnerParameter 메서드를 호출하여 이벤트에 파트너 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다.
let adRevenue = ADJAdRevenue(source: source);adRevenue.addPartnerParameter(key, value: value);Adjust.trackAdRevenue(adRevenue);ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source];[adRevenue addPartnerParameter:key value:value];[Adjust trackAdRevenue:adRevenue];예시
이 예시는 다음 속성을 사용하여 광고 매출 객체를 설정하고 기록하는 방법을 보여줍니다.
- 매출 소스: AppLovin MAX
- 매출액: 1유로(Euro)
- 광고 노출: 10
- 광고 매출 네트워크:
"network1" - 광고 매출 단위:
"unit1" - 광고 매출 게재 위치:
"banner" - 콜백 파라미터:
"key1" = "value1" - 파트너 파라미터:
"key2" = "value2"
let adRevenue = ADJAdRevenue(source: ADJAdRevenueSourceAppLovinMAX);adRevenue.setRevenue(1, currency: "EUR");adRevenue.setAdImpressionsCount(10);adRevenue?.adRevenueNetwork = "network1"adRevenue?.adRevenueUnit = "unit1"adRevenue?.adRevenuePlacement = "banner"adRevenue.addCallbackParameter("key1", value: "value1")adRevenue.addPartnerParameter("key2", value: "value2")Adjust.trackAdRevenue(adRevenue);ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:ADJAdRevenueSourceAppLovinMAX];[adRevenue setRevenue:1 currency:@"EUR"];[adRevenue setAdImpressionsCount:10];[adRevenue setAdRevenueNetwork:@"network1"];[adRevenue setAdRevenueUnit:@"unit1"];[adRevenue setAdRevenuePlacement:@"banner"];[adRevenue addCallbackParameter:key1 value:@"value1"];[adRevenue addPartnerParameter:key2 value:"@value2"];[Adjust trackAdRevenue:adRevenue];