광고 매출 정보 기록

Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출을 기록할 수 있습니다.

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`	일반적인 소스

Swift
Objective-C

1
let adRevenue = ADJAdRevenue(source: source);
2
//...
3
Adjust.trackAdRevenue(adRevenue);

1
ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source];
2
//...
3
[Adjust trackAdRevenue:adRevenue];

S2S 광고 매출 전송

+ (void)trackAdRevenue:(nonnull NSString *)source payload:(nonnull NSData *)payload;

Adjust로 광고 매출을 전송하려면 광고 매출 인스턴스를 인수로 사용하여 trackAdRevenue 메서드를 호출합니다.

Swift
Objective-C

1
let adRevenue = ADJAdRevenue(source: source);
2
Adjust.trackAdRevenue(adRevenue);

1
ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source];
2
///...
3
[Adjust trackAdRevenue:adRevenue];

광고 매출 금액 기록

- (void)setRevenue:(double)amount currency:(nonnull NSString *)currency;

광고 매출 금액을 전송하려면 setRevenue 메서드를 호출하고 다음 인수를 전달합니다.

revenue (double): 매출 금액
currency (NSString): 리포팅에 사용하는 통화의 3글자 ISO 4217 코드

Swift
Objective-C

1
let adRevenue = ADJAdRevenue(source: source);
2
adRevenue.setRevenue(1.6, currency: "USD");
3
Adjust.trackAdRevenue(adRevenue);

1
ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source];
2
[adRevenue setRevenue:1.6 currency:@"USD"];
3
[Adjust trackAdRevenue:adRevenue];

광고 캠페인 세부 사항 기록

ADJAdRevenue 클래스에 광고 캠페인 리포트에 사용할 수 있는 속성이 포함됩니다.

광고 노출

- (void)setAdImpressionsCount:(int)adImpressionsCount;

기록된 광고 노출 횟수를 전송하려면 setAdImpressionsCount 메서드를 호출하고 다음 인수를 전달합니다.

adImpressionsCount (int): 광고 노출 횟수

Swift
Objective-C

1
let adRevenue = ADJAdRevenue(source: source);
2
adRevenue?.adImpressionsCount = 1;
3
Adjust.trackAdRevenue(adRevenue);

1
ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source];
2
[adRevenue setAdImpressionsCount:1];
3
[Adjust trackAdRevenue:adRevenue];

광고 매출 네트워크

- (void)setAdRevenueNetwork:(nonnull NSString *)adRevenueNetwork;

광고 매출 네트워크를 전송하려면 setAdRevenueNetwork 메서드를 호출하고 다음 인수를 전달합니다.

adRevenueNetwork (NSString): 네트워크 이름

Swift
Objective-C

1
let adRevenue = ADJAdRevenue(source: source);
2
adRevenue?.adRevenueNetwork = "network1";
3
Adjust.trackAdRevenue(adRevenue);

1
ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source];
2
[adRevenue setAdRevenueNetwork:@"network1"];
3
[Adjust trackAdRevenue:adRevenue];

광고 매출 단위

- (void)setAdRevenueUnit:(nonnull NSString *)adRevenueUnit;

광고 매출 단위를 전송하려면 setAdRevenueUnit 메서드를 호출하고 다음 인수를 전달합니다.

adRevenueUnit (NSString): 광고 단위

Swift
Objective-C

1
let adRevenue = ADJAdRevenue(source: source);
2
adRevenue?.adRevenueUnit = "unit1";
3
Adjust.trackAdRevenue(adRevenue);

1
ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source];
2
[adRevenue setAdRevenueUnit:@"unit1"];
3
[Adjust trackAdRevenue:adRevenue];

광고 매출 게재 위치

- (void)setAdRevenuePlacement:(nonnull NSString *)adRevenuePlacement;

광고 매출 게재 위치를 전송하려면 setAdRevenuePlacement 메서드를 호출하고 다음 인수를 전달합니다.

adRevenuePlacement (NSString): 광고 게재 위치

Swift
Objective-C

1
let adRevenue = ADJAdRevenue(source: source);
2
adRevenue?.adRevenuePlacement = "banner";
3
Adjust.trackAdRevenue(adRevenue);

1
ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source];
2
[adRevenue setAdRevenuePlacement:@"banner"];
3
[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=bar

CSV 업로드를 사용하는 경우, 반드시 CSV 정의에 파라미터를 추가하시기 바랍니다.

Adjust는 SDK에서 URL로 정보를 전송하는 데 사용할 수 있는 다양한 플레이스홀더를 지원합니다. 예를 들어, iOS의 경우 {idfa} 플레이스홀더, Android의 경우 {gps_adid} 플레이스홀더입니다. {publisher_parameter} 플레이스홀더는 단일 문자열의 모든 콜백 파라미터를 나타냅니다.

Swift
Objective-C

1
let adRevenue = ADJAdRevenue(source: source);
2
adRevenue.addCallbackParameter(key, value: value);
3
Adjust.trackAdRevenue(adRevenue);

1
ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source];
2
[adRevenue addCallbackParameter:key value:value];
3
[Adjust trackAdRevenue:adRevenue];

파트너 파라미터 추가

- (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value;

파트너 파라미터를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다.

Adjust는 설정한 외부 파트너에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다.

NSString 키-값 인수와 함께 addPartnerParameter 메서드를 호출하여 이벤트에 파트너 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다.

Swift
Objective-C

1
let adRevenue = ADJAdRevenue(source: source);
2
adRevenue.addPartnerParameter(key, value: value);
3
Adjust.trackAdRevenue(adRevenue);

1
ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source];
2
[adRevenue addPartnerParameter:key value:value];
3
[Adjust trackAdRevenue:adRevenue];

예

이 예시는 다음 속성을 사용하여 광고 매출 객체를 설정하고 기록하는 방법을 보여줍니다.

매출 소스: AppLovin MAX
매출액: 1유로(Euro)
광고 노출: 10
광고 매출 네트워크: "network1"
광고 매출 단위: "unit1"
광고 매출 게재 위치: "banner"
콜백 파라미터: "key1" = "value1"
파트너 파라미터: "key2" = "value2"

Swift
Objective-C

1
let adRevenue = ADJAdRevenue(source: ADJAdRevenueSourceAppLovinMAX);
2
adRevenue.setRevenue(1, currency: "EUR");
3
adRevenue.setAdImpressionsCount(10);
4
adRevenue?.adRevenueNetwork = "network1"
5
adRevenue?.adRevenueUnit = "unit1"
6
adRevenue?.adRevenuePlacement = "banner"
7
adRevenue.addCallbackParameter("key1", value: "value1")
8
adRevenue.addPartnerParameter("key2", value: "value2")
9
Adjust.trackAdRevenue(adRevenue);

1
ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:ADJAdRevenueSourceAppLovinMAX];
2
[adRevenue setRevenue:1 currency:@"EUR"];
3
[adRevenue setAdImpressionsCount:10];
4
[adRevenue setAdRevenueNetwork:@"network1"];
5
[adRevenue setAdRevenueUnit:@"unit1"];
6
[adRevenue setAdRevenuePlacement:@"banner"];
7
[adRevenue addCallbackParameter:key1 value:@"value1"];
8
[adRevenue addPartnerParameter:key2 value:"@value2"];
9
[Adjust trackAdRevenue:adRevenue];