记录广告收入信息

您可以使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入。

实例化 ADJAdRevenue 对象

- (nullable id)initWithSource:(nonnull NSString *)source;

要使用 Adjust SDK 发送广告收入信息，请实例化一个 ADJAdRevenue 对象。该对象中包含的变量会在应用中记录到广告收入时被发送给 Adjust。

要实例化广告收入对象，请创建新的 ADJAdRevenue 实例，并传送下列参数：

source (NSString)：广告收入来源。请查看下表，了解可用来源。

参数	广告收入来源
`"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

Swift
Objective-C

1
guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return }
2
//...
3
Adjust.trackAdRevenue(adRevenue)

1
ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc]
2
                              initWithSource:@"applovin_max_sdk"];
3
//...
4
[Adjust trackAdRevenue:adRevenue];

发送广告收入

+ (void)trackAdRevenue:(nonnull ADJAdRevenue *)adRevenue;

要向 Adjust 发送广告收入数据，请以广告收入实例作为参数，调用 trackAdRevenue 方法。

Swift
Objective-C

1
guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return }
2
Adjust.trackAdRevenue(adRevenue)

1
ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc]
2
                              initWithSource:@"applovin_max_sdk"];
3
///...
4
[Adjust trackAdRevenue:adRevenue];

记录广告收入额

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

要发送广告收入额，请调用 setRevenue 方法，并传送下列参数：

revenue (double)：收入额
currency (NSString)：您报告币种的 ISO 4217 代码，由 3 个字符组成

Swift
Objective-C

1
guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return }
2
adRevenue.setRevenue(1.6, currency: "USD")
3
Adjust.trackAdRevenue(adRevenue)

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

记录广告推广活动细节

ADJAdRevenue 类包含多种属性，您可以通过这些属性来报告广告推广活动信息。

广告展示

- (void)setAdImpressionsCount:(int)adImpressionsCount;

要发送广告展示量记录，请调用 setAdImpressionsCount 方法，并传送下列参数：

adImpressionsCount (int)：广告展示数量。

Swift
Objective-C

1
guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return }
2
adRevenue.setAdImpressionsCount(1)
3
Adjust.trackAdRevenue(adRevenue)

1
ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc]
2
                              initWithSource:@"applovin_max_sdk"];
3
[adRevenue setAdImpressionsCount:1];
4
[Adjust trackAdRevenue:adRevenue];

广告收入渠道

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

要发送广告收入渠道，请调用 setAdRevenueNetwork 方法，并传送下列参数：

adRevenueNetwork (NSString)：渠道名称

Swift
Objective-C

1
guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return }
2
adRevenue.setAdRevenueNetwork("network1")
3
Adjust.trackAdRevenue(adRevenue)

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

广告收入单元

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

要发送广告收入单位，请调用 setAdRevenueUnit 方法，并传送下列参数：

adRevenueUnit (NSString)：广告单位

Swift
Objective-C

1
guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return }
2
adRevenue.setAdRevenueUnit("unit1")
3
Adjust.trackAdRevenue(adRevenue)

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

广告收入位置

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

要发送广告收入位置，请调用 setAdRevenuePlacement 方法，并传送下列参数：

adRevenuePlacement (NSString)：广告位

Swift
Objective-C

1
guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return }
2
adRevenue.setAdRevenuePlacement("banner")
3
Adjust.trackAdRevenue(adRevenue)

1
ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc]
2
                              initWithSource:@"applovin_max_sdk"];
3
[adRevenue setAdRevenuePlacement:@"banner"];
4
[Adjust trackAdRevenue:adRevenue];

添加回传参数

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

您在 Adjust 控制面板中注册回传 URL，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。

您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至您的回传 URL。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。

使用 NSString 键值对 argument 调用addCallbackParameter方法，以此向事件添加回传参数。多次调用该方法可添加多个参数。

Adjust SDK 监测事件，并向附加回传参数的 URL 发送请求。例如，如果您注册了 URLhttps://www.mydomain.com/callback，则回传为：

https://www.mydomain.com/callback?key=value&foo=bar

如果您使用的是 CSV 上传，请务必在 CSV 定义中添加参数。

Adjust 支持许多占位符，这些占位符可用来将信息从 SDK 发送至您的 URL。例如，iOS 的{idfa}占位符和安卓的{gps_adid}占位符。{publisher_parameter}占位符可在单一字符串中呈现所有回传参数。

Swift
Objective-C

1
guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return }
2
adRevenue.addCallbackParameter(key, value: value)
3
Adjust.trackAdRevenue(adRevenue)

1
ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc]
2
                              initWithSource:@"applovin_max_sdk"];
3
[adRevenue addCallbackParameter:key value:value];
4
[Adjust trackAdRevenue:adRevenue];

添加合作伙伴参数

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

您可以添加合作伙伴参数，向渠道合作伙伴发送额外的信息。

Adjust 可向您设置的外部合作伙伴发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。

使用 NSString 键值对 argument 调用addPartnerParameter方法，以此向事件添加合作伙伴参数。多次调用该方法可添加多个参数。

Swift
Objective-C

1
guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return }
2
adRevenue.addPartnerParameter(key, value: value)
3
Adjust.trackAdRevenue(adRevenue)

1
ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc]
2
                              initWithSource:@"applovin_max_sdk"];
3
[adRevenue addPartnerParameter:key value:value];
4
[Adjust trackAdRevenue:adRevenue];

示例

该示例展示了如何设置并记录一个广告收入对象，其属性如下：

AppLovin MAX 作为收入来源
收入金额为 1 欧元
10 次广告展示
"network1" 为广告收入渠道
"unit1" 为广告收入单位
"banner" 为广告收入位置
回传参数： "key1" = "value1"
合作伙伴参数： "key2" = "value2"

Swift
Objective-C

1
guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return }
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)

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