Key-Value Targeting

Provide key-value targeting information to ad requests

General Information

Some networks support adding additional information to improve the ads for the current app context. Keywords can be passed to AATKit in the form of Map<String, List<String>>

Java

Map<String, List<String>> targeting = new HashMap<>();
targeting.put("interests", Arrays.asList("sports", "stocks"));
targeting.put("gender", Collections.singletonList("female"));

Kotlin

val targeting: MutableMap<String, List<String>> = HashMap()
targeting["interests"] = listOf("sports", "stocks")
targeting["gender"] = listOf("female")

If you are using the infeed banner placement or the banner cache, then all targeting settings have to be configured for the used ad request object. The global or placement-specific settings described below will not be applied there.

Please contact the support team for help when defining targeting information.

Setting the keyword targeting must be done after initializing AATKit.

Set Global Targeting Keywords

To set the keyword targeting globally for all placements, you have to pass them to AATKit by calling the following method:

setTargetingInfo(info: Map<String, List<String>>?)

Usage

Java

AATKit.setTargetingInfo(targeting);

Kotlin

AATKit.setTargetingInfo(targeting)

Set Placement specific Keywords

Enables usage of keywords for specific placement in your application. The general setting of the targeting info will be overwritten for this placement.

Usage

Java

placement.setTargetingInfo(targeting);

Kotlin

placement.targetingInfo = targeting

The specified keywords are used for all networks by default. If you want to restrict keyword usage to only specific networks, you need to continue reading.

Limit Ad Network specific Keywords

If you want to restrict keyword usage to specific ad networks, you have to use the following methods:

addAdNetworkForKeywordTargeting(network: AdNetwork)

Enables previously set keywords for a specific ad network only. When setting global and placement-specific keywords, the latter will take precedence.

Ad networks are specified using a value of the enumeration AdNetwork.

Usage

Java

AATKit.addAdNetworkForKeywordTargeting(AdNetwork.ADMOB);

Kotlin

AATKit.addAdNetworkForKeywordTargeting(AdNetwork.ADMOB)

You can also remove ad networks that were targeted before. The collection of ad network enumeration is a white list only. This means you cannot add networks to be excluded from keyword targeting.

removeAdNetworkForKeywordTargeting(network: AdNetwork)

Usage

Java

AATKit.removeAdNetworkForKeywordTargeting(AdNetwork.ADMOB);

Kotlin

AATKit.removeAdNetworkForKeywordTargeting(AdNetwork.ADMOB)