Targeting

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

Objective-C

AATKit.removeAdNetworkForKeywordTargeting(AdNetwork.ADMOB)

Set Global Content Targeting URL

Set the content targeting URL for all following ad requests, unless you have set a content targeting URL for a specific placement before.

setContentTargetingUrl(targetingUrl: String)

Setting the content targeting URL must be done after initializing AATKit.

Usage

Java

AATKit.setContentTargetingUrl("https://www.gravite.net");

Kotlin

AATKit.setContentTargetingUrl("https://www.addapptr.com");

Set Placement Specific Content Targeting URL

Set the content targeting URL for a specific placement for all following ad requests. The general setting of the content targeting URL will be overwritten for this placement.

Usage

Java

placement.setContentTargetingUrl("https://www.gravite.net");

Kotlin

placement.contentTargetingUrl = "https://www.addapptr.com";

Passing Multiple Values

In addition to single content targeting URL, AATKit supports passing a multi-content URL. Please note that if multi-content URL is used, the single content targeting URL will no longer be passed.

Usage

Java

placement.setMultiContentTargetingUrls(listOfUrls);

Kotlin

placement.multiContentTargetingUrls = listOfUrls

where listOfUrls is a List<String> type.