Custom Parameters for Android

The ironSource SDK supports the ability for you to pass Custom Parameters on the initialization of your chosen Ad Units and to receive this data upon user’s completion event.

Note:

  1. Custom parameters work only in conjunction with server-to-server completion callbacks. You will receive the parameter as part of the callback string.
  2. You may insert more than one custom parameter to the Init request.

Implementation Example

If you’d like to receive the IP of the user as an additional parameter in the Completion callback for users who engaged with the Offerwall Ad Unit, you should use:

Map<String, String> owParams = new HashMap<String,String>();
owParams.put("ip", "123.4.56.78");
ISConfig.getConfigObj().setOfferwallCustomParams(owParams);

You will then receive a corresponding callback as such:

http://www.mydomain.com/rewardsCallback?appUserId=[USER_ID]&rewards=[REWARDS]&eventId=[EVENT_ID]&itemName=[ITEM_NAME]&custom_ip=1.0.0.9

Implementation Code

Rewarded Video

Note:

  • Custom Parameters can be added once per session for Rewarded Video.
  • Custom Parameters should be called before initiating the Rewarded Video.
Map<String, String> rvParams = new HashMap<String,String>();
rvParams.put("ip", "123.4.56.78");
ISConfig.getConfigObj().setRewardedVideoCustomParams(rvParams);

 Offerwall

Note:

  • Custom Parameters should be called before calling showOfferwall.
Map<String, String> owParams = new HashMap<String,String>();
owParams.put("ip", "123.4.56.78");
ISConfig.getConfigObj().setOfferwallCustomParams(owParams);