发送广告收入信息

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

实例化 AdjustAdRevenue 对象

public AdjustAdRevenue(final String source)

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

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

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

参数	来源
`AdjustConfig.AD_REVENUE_APPLOVIN_MAX`	AppLovin MAX
`AdjustConfig.AD_REVENUE_MOPUB`	mopub
`AdjustConfig.AD_REVENUE_ADMOB`	AdMob
`AdjustConfig.AD_REVENUE_IRONSOURCE`	IronSource
`AdjustConfig.AD_REVENUE_ADMOST`	Admost
`AdjustConfig.AD_REVENUE_UNITY`	Unity
`AdjustConfig.AD_REVENUE_HELIUM_CHARTBOOST`	Helium Chartboost
`AdjustConfig.AD_REVENUE_ADX`	Ad(X)
`AdjustConfig.AD_REVENUE_SOURCE_TOPON`	TopOn
`AdjustConfig.AD_REVENUE_SOURCE_TRADPLUS`	TradPlus
`AdjustConfig.AD_REVENUE_SOURCE_PUBLISHER`	通用来源

1
val adjustAdRevenue = AdjustAdRevenue("source")
2
Adjust.trackAdRevenue(adjustAdRevenue)

1
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source");
2
Adjust.trackAdRevenue(adjustAdRevenue);

1
let adjustAdRevenue = new AdjustAdRevenue("source");
2
Adjust.trackAdRevenue(adjustAdRevenue);

发送广告收入

public static void trackAdRevenue(AdjustAdRevenue adRevenue)

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

1
val adjustAdRevenue = AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX)
2
Adjust.trackAdRevenue(adjustAdRevenue)

1
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX);
2
Adjust.trackAdRevenue(adjustAdRevenue)

1
let adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX);
2
Adjust.trackAdRevenue(adjustAdRevenue);

记录广告收入额

public void setRevenue(final Double revenue, final String currency)

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

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

1
val adjustAdRevenue = AdjustAdRevenue("source")
2
adjustAdRevenue.setRevenue(1.00, "EUR")
3
Adjust.trackAdRevenue(adjustAdRevenue)

1
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source");
2
adjustAdRevenue.setRevenue(1.00, "EUR");
3
Adjust.trackAdRevenue(adjustAdRevenue);

1
let adjustAdRevenue = new AdjustAdRevenue("source");
2
adjustAdRevenue.setRevenue(1.0, "EUR");
3
Adjust.trackAdRevenue(adjustAdRevenue);

记录广告推广活动细节

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

广告展示

public void setAdImpressionsCount(final Integer adImpressionsCount)

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

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

1
val adjustAdRevenue = AdjustAdRevenue("source")
2
adjustAdRevenue.setAdImpressionsCount(10)
3
Adjust.trackAdRevenue(adjustAdRevenue)

1
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source");
2
adjustAdRevenue.setAdImpressionsCount(10);
3
Adjust.trackAdRevenue(adjustAdRevenue);

1
let adjustAdRevenue = new AdjustAdRevenue("source");
2
adjustAdRevenue.setAdImpressionsCount(10);
3
Adjust.trackAdRevenue(adjustAdRevenue);

广告收入渠道

public void setAdRevenueNetwork(final String adRevenueNetwork)

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

adRevenueNetwork (String)：渠道名称

1
val adjustAdRevenue = AdjustAdRevenue("source")
2
adjustAdRevenue.setAdRevenueNetwork("network1")
3
Adjust.trackAdRevenue(adjustAdRevenue)

1
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source");
2
adjustAdRevenue.setAdRevenueNetwork("network1");
3
Adjust.trackAdRevenue(adjustAdRevenue);

1
let adjustAdRevenue = new AdjustAdRevenue("source");
2
adjustAdRevenue.setAdRevenueNetwork("network1");
3
Adjust.trackAdRevenue(adjustAdRevenue);

广告收入单元

public void setAdRevenueUnit(final String adRevenueUnit)

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

adRevenueUnit (String)：广告单位

1
val adjustAdRevenue = AdjustAdRevenue("source")
2
adjustAdRevenue.setAdRevenueUnit("unit1")
3
Adjust.trackAdRevenue(adjustAdRevenue)

1
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source");
2
adjustAdRevenue.setAdRevenueUnit("unit1");
3
Adjust.trackAdRevenue(adjustAdRevenue);

1
let adjustAdRevenue = new AdjustAdRevenue("source");
2
adjustAdRevenue.setAdRevenueUnit("unit1");
3
Adjust.trackAdRevenue(adjustAdRevenue);

广告收入位置

public void setAdRevenuePlacement(final String adRevenuePlacement)

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

adRevenuePlacement (String)：广告位

1
val adjustAdRevenue = AdjustAdRevenue("source")
2
adjustAdRevenue.setAdRevenuePlacement("banner")
3
Adjust.trackAdRevenue(adjustAdRevenue)

1
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source");
2
adjustAdRevenue.setAdRevenuePlacement("banner");
3
Adjust.trackAdRevenue(adjustAdRevenue);

1
let adjustAdRevenue = new AdjustAdRevenue("source");
2
adjustAdRevenue.setAdRevenuePlacement("banner");
3
Adjust.trackAdRevenue(adjustAdRevenue);

添加回传参数

public void addCallbackParameter(final String key, final String value)

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

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

使用 String 键值对 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}占位符可在单一字符串中呈现所有回传参数。

1
val adjustAdRevenue = AdjustAdRevenue("source")
2
adjustAdRevenue.addCallbackParameter("key", "value")
3
Adjust.trackAdRevenue(adjustAdRevenue)

1
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source");
2
adjustAdRevenue.addCallbackParameter("key", "value");
3
Adjust.trackAdRevenue(adjustAdRevenue);

1
let adjustAdRevenue = new AdjustAdRevenue("source");
2
adjustAdRevenue.addCallbackParameter("key", "value");
3
Adjust.trackAdRevenue(adjustAdRevenue);

添加合作伙伴参数

public void addPartnerParameter(String key, String value)

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

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

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

1
val adjustAdRevenue = AdjustAdRevenue("source")
2
adjustAdRevenue.addPartnerParameter("key", "value")
3
Adjust.trackAdRevenue(adjustAdRevenue)

1
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source");
2
adjustAdRevenue.addPartnerParameter("key", "value");
3
Adjust.trackAdRevenue(adjustAdRevenue);

1
let adjustAdRevenue = new AdjustAdRevenue("source");
2
adjustAdRevenue.addPartnerParameter("key", "value");
3
Adjust.trackAdRevenue(adjustAdRevenue);

示例

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

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

1
val adjustAdRevenue = AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX)
2
adjustAdRevenue.setRevenue(1.00, "EUR")
3
adjustAdRevenue.setAdImpressionsCount(10)
4
adjustAdRevenue.setAdRevenueNetwork("network1")
5
adjustAdRevenue.setAdRevenueUnit("unit1")
6
adjustAdRevenue.setAdRevenuePlacement("banner")
7
adjustAdRevenue.addCallbackParameter("key1", "value1")
8
adjustAdRevenue.addPartnerParameter("key2", "value2")
9
Adjust.trackAdRevenue(adjustAdRevenue)

1
AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX);
2
adjustAdRevenue.setRevenue(1.00, "EUR");
3
adjustAdRevenue.setAdImpressionsCount(10);
4
adjustAdRevenue.setAdRevenueNetwork("network1");
5
adjustAdRevenue.setAdRevenueUnit("unit1");
6
adjustAdRevenue.setAdRevenuePlacement("banner");
7
adjustAdRevenue.addCallbackParameter("key1", "value1");
8
adjustAdRevenue.addPartnerParameter("key2", "value2");
9
Adjust.trackAdRevenue(adjustAdRevenue);

1
let adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX);
2
adjustAdRevenue.setRevenue(1.0, "EUR");
3
adjustAdRevenue.setAdImpressionsCount(10);
4
adjustAdRevenue.setAdRevenueNetwork("network1");
5
adjustAdRevenue.setAdRevenueUnit("unit1");
6
adjustAdRevenue.setAdRevenuePlacement("banner");
7
adjustAdRevenue.addCallbackParameter("key1", "value1");
8
adjustAdRevenue.addPartnerParameter("key2", "value2");
9
Adjust.trackAdRevenue(adjustAdRevenue);