Send ad revenue information

You can record ad revenue for supported network partners using the Adjust SDK.

Instantiate an AdjustAdRevenue object

public AdjustAdRevenue(final String source)

To send ad revenue information with the Adjust SDK, you need to instantiate an AdjustAdRevenue object. This object contains variables that are sent to Adjust when ad revenue is recorded in your app.

To instantiate an ad revenue object, create a new AdjustAdRevenue instance and pass the following parameters:

source (String): The source of the ad revenue. See the table below for available sources

Parameter	Source
`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`	Generic source

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);

Send ad revenue

public static void trackAdRevenue(AdjustAdRevenue adRevenue)

To send ad revenue to Adjust, call the trackAdRevenue method with your ad revenue instance as an argument.

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);

Record ad revenue amount

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

To send the ad revenue amount, call the setRevenue method and pass the following arguments:

revenue (Double): The amount of revenue
currency (String): The 3 character ISO 4217 code of your reporting currency

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);

Record ad campaign details

The AdjustAdRevenue class contains properties you can use to report on your ad campaigns.

Ad impressions

public void setAdImpressionsCount(final Integer adImpressionsCount)

To send the number of recorded ad impressions, call the setAdImpressionsCount method and pass the following arguments:

adImpressionsCount (Integer): The number of ad impressions.

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);

Ad revenue network

public void setAdRevenueNetwork(final String adRevenueNetwork)

To send the ad revenue network, call the setAdRevenueNetwork method and pass the following arguments:

adRevenueNetwork (String): The network name.

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);

Ad revenue unit

public void setAdRevenueUnit(final String adRevenueUnit)

To send the ad revenue unit, call the setAdRevenueUnit method and pass the following arguments:

adRevenueUnit (String): The ad unit.

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);

Ad revenue placement

public void setAdRevenuePlacement(final String adRevenuePlacement)

To send the ad revenue placement, call the setAdRevenuePlacement method and pass the following arguments:

adRevenuePlacement (String): The ad placement.

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);

Add callback parameters

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

If you register a callback URL in the Adjust dashboard, the SDK sends a GET request to your callback URL when it records an event.

You can configure callback parameters to your servers. Once you configure parameters on an event, the SDK appends them to your callback URL. You can use this information to analyze your users’ in-app behavior with your BI system.

Add callback parameters to your event by calling the addCallbackParameter method with String key-value arguments. You can add multiple parameters by calling this method multiple times.

The Adjust SDK measures the event and sends a request to your URL with the callback parameters. For example, if you register the URL https://www.mydomain.com/callback, your callback looks like this:

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

If you are using CSV uploads, make sure to add the parameters to your CSV definition.

Adjust supports many placeholders which you can use to pass information from the SDK to your URL. For example, the {idfa} placeholder for iOS and the {gps_adid} placeholder for Android. The {publisher_parameter} placeholder presents all callback parameters in a single string.

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);

Add partner parameters

public void addPartnerParameter(String key, String value)

You can send extra information to your network partners by adding partner parameters.

Adjust sends partner parameters to external partners you have set up. This information is useful for more granular analysis and retargeting purposes. Adjust’s servers forward these parameters once you have set them up and enabled them for a partner.

Add partner parameters to your event by calling the addPartnerParameter method with String key-value arguments. You can add multiple parameters by calling this method multiple times.

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);

Example

This example shows how to set up and record an ad revenue object with the following properties:

AppLovin MAX as the revenue source
1 Euro as the revenue amount
10 ad impressions
"network1" as the ad revenue network
"unit1" as the ad revenue unit
"banner" as the ad revenue placement
A callback parameter: "key1" = "value1"
A partner parameter: "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);