Data and Keyword Passing

Developers must not include any personal data, including demographic or interest-based targeting data, in any fields intended for contextual targeting (i.e. keywords or based on the content of the app). Additionally, developers must not send AppLovin any sensitive personal data or custom data values that are against the AppLovin Terms of Use or AppLovin Privacy Policy.

Starting with React Native Plugin 3.1.0, AppLovin provides an option for developers to send additional data. Developers should send any demographic or interest-based targeting data in the fields designated for such data, as described below.

Data Fields

Set values for the following fields to pass personal data (for demographic or interest-based targeting):

Field Description
This data is limited to use by publishers for the publishers’ own direct ad serving. AppLovin does not retain this data or pass it downstream to advertising partners.
email The user’s email address. AppLovin hashes this value before it reaches its ad server.
gender The user’s gender
interests A list of the user’s interests
maximumAdContentRating The maximum ad content rating shown to the user. The levels are based on IQG Media Ratings: 1 = All Audiences, 2 = Everyone Over 12, 3 = Mature Audiences
phoneNumber The user’s phone number. AppLovin hashes this value before it reaches its ad server.
yearOfBirth The user’s year of birth

Set values for the following fields to pass impersonal data (for contextual targeting):

Field Description
keywords A list of keywords related to your application

Here is an example of how to set the user’s email address and the keywords that describe your application:

import { TargetingData } from 'react-native-applovin-max';
⋮
TargetingData.email = 'user@email.com';
TargetingData.keywords = ['fruit:apple', 'fruit:banana', 'fruit:orange'];

Once you set any of these fields, the SDK includes them each time you request an AppLovin ad. You can clear these fields at any time, and the SDK then removes them before the next time you request an AppLovin ad. You can clear most fields by setting their values to null. To clear the yearOfBirth value, set it to 0. To clear the gender value, set it to AppLovinMAX.UserGender.Unknown. To clear the maximumAdContentRating value, set it to AppLovinMAX.AdContentRating.None. Also, you can clear all fields with the following snippet:

TargetingData.clearAll();

Location Passing

Only if your application already has the relevant end-user permissions, the SDK will automatically collect from the device the latitude and longitude coordinates truncated to the hundredths decimal place.

The truncation occurs on the device, which means that the full coordinates do not leave the device.

The following code snippet shows how you disable the SDK from automatically collecting location when your application has the relevant end-user permissions:

import AppLovinMAX from 'react-native-applovin-max';
⋮
AppLovinMAX.setLocationCollectionEnabled(false);

Content URL Passing

AppLovin recommends that you pass your App content URL when you make ad requests. The App content URL is passed in the bid request for buy-side contextualization or review and may be required for spend from some DSP buyers.