Targeting Settings - Ad Control Help Center

Overview

Through targeting settings, you can display customized ads to specific user groups. The Adrop SDK provides two targeting methods:

Audience Targeting: Display ads based on user properties.
Contextual Targeting: Display ads based on content context (category, topic, etc.).

To collect targeting data, UID and properties must be set before loading ads.

UID Setting

Set a user identifier (UID) to distinguish users. UID is the foundation for targeted advertising.

Usage

import io.adrop.ads.Adrop

// After user login
Adrop.setUID("user_123")

import io.adrop.ads.Adrop;

// After user login
Adrop.INSTANCE.setUID("user_123");

Parameters

Parameter	Type	Description
`uid`	`String`	User unique identifier (e.g., service member ID)

UID is hashed with SHA-256 before transmission. Do not pass personal information (email, phone number, etc.) directly.

Audience Targeting

Collect user property information to display ads to specific user groups.

Setting Properties

Use the AdropMetrics.setProperty() method to collect user property information.

import io.adrop.ads.metrics.AdropMetrics

// String property
AdropMetrics.setProperty("membership_level", "premium")

// Numeric property
AdropMetrics.setProperty("booking_count", 15)

// Boolean property
AdropMetrics.setProperty("is_subscriber", true)

// Pass null (remove property)
AdropMetrics.setProperty("membership_level", null)

import io.adrop.ads.metrics.AdropMetrics;

// String property
AdropMetrics.setProperty("membership_level", "premium");

// Numeric property
AdropMetrics.setProperty("booking_count", 15);

// Boolean property
AdropMetrics.setProperty("is_subscriber", true);

// Pass null (remove property)
AdropMetrics.setProperty("membership_level", null);

Parameters

Parameter	Type	Description
`key`	`String`	Property key (max 64 characters)
`value`	`Any?`	Property value (String, Int, Double, Long, Boolean, null)

Property key is limited to 64 characters maximum.
String values are limited to 256 characters maximum.
Numeric values are limited to 9007199254740991 maximum.
Up to 256 properties can be set.

Default Properties

The Adrop SDK provides default properties for targeting. Use the AdropKey and AdropValue classes to set values.

Age (Birthday)

When birthday information is provided, age is automatically calculated.

import io.adrop.ads.metrics.AdropMetrics
import io.adrop.ads.model.AdropKey
import io.adrop.ads.model.AdropValue

// Year only (yyyy)
AdropMetrics.setProperty(AdropKey.BIRTH, "1990")

// Year and month (yyyyMM)
AdropMetrics.setProperty(AdropKey.BIRTH, "199003")

// Year, month, and day (yyyyMMdd)
AdropMetrics.setProperty(AdropKey.BIRTH, "19900315")

import io.adrop.ads.metrics.AdropMetrics;
import io.adrop.ads.model.AdropKey;
import io.adrop.ads.model.AdropValue;

// Year only (yyyy)
AdropMetrics.setProperty(AdropKey.BIRTH, "1990");

// Year and month (yyyyMM)
AdropMetrics.setProperty(AdropKey.BIRTH, "199003");

// Year, month, and day (yyyyMMdd)
AdropMetrics.setProperty(AdropKey.BIRTH, "19900315");

Date Format Constants

Constant	Value	Description
`AdropValue.AdropBirth.formatYear`	`"yyyy"`	Year only (e.g., “1990”)
`AdropValue.AdropBirth.formatYearMonth`	`"yyyyMM"`	Year and month (e.g., “199003”)
`AdropValue.AdropBirth.formatYearMonthDay`	`"yyyyMMdd"`	Year, month, and day (e.g., “19900315”)

Gender

import io.adrop.ads.metrics.AdropMetrics
import io.adrop.ads.model.AdropKey
import io.adrop.ads.model.AdropValue

// Male
AdropMetrics.setProperty(AdropKey.GENDER, AdropValue.AdropGender.MALE)

// Female
AdropMetrics.setProperty(AdropKey.GENDER, AdropValue.AdropGender.FEMALE)

// Other
AdropMetrics.setProperty(AdropKey.GENDER, AdropValue.AdropGender.OTHER)

// Unknown
AdropMetrics.setProperty(AdropKey.GENDER, AdropValue.UNKNOWN)

import io.adrop.ads.metrics.AdropMetrics;
import io.adrop.ads.model.AdropKey;
import io.adrop.ads.model.AdropValue;

// Male
AdropMetrics.setProperty(AdropKey.GENDER, AdropValue.AdropGender.MALE);

// Female
AdropMetrics.setProperty(AdropKey.GENDER, AdropValue.AdropGender.FEMALE);

// Other
AdropMetrics.setProperty(AdropKey.GENDER, AdropValue.AdropGender.OTHER);

// Unknown
AdropMetrics.setProperty(AdropKey.GENDER, AdropValue.UNKNOWN);

Gender Value Constants

Constant	Value	Description
`AdropValue.AdropGender.MALE`	`"M"`	Male
`AdropValue.AdropGender.FEMALE`	`"F"`	Female
`AdropValue.AdropGender.OTHER`	`"O"`	Other
`AdropValue.UNKNOWN`	`"U"`	Unknown

Setting Age Directly

You can also set age directly instead of birthday.

import io.adrop.ads.metrics.AdropMetrics
import io.adrop.ads.model.AdropKey

AdropMetrics.setProperty(AdropKey.AGE, 30)

import io.adrop.ads.metrics.AdropMetrics;
import io.adrop.ads.model.AdropKey;

AdropMetrics.setProperty(AdropKey.AGE, 30);

You only need to set either BIRTH or AGE. If both are set, BIRTH takes precedence.

Custom Properties

You can set custom properties for your service. Custom properties must first be defined in the Targeting menu of the Adrop console.

import io.adrop.ads.metrics.AdropMetrics

// Local activity app example
AdropMetrics.setProperty("region", "Seoul")
AdropMetrics.setProperty("booking_count", 5)

// Shopping mall app example
AdropMetrics.setProperty("membership_tier", "gold")
AdropMetrics.setProperty("total_purchase_amount", 1500000)

// Media app example
// Note: Array values are not supported. Use JSON string instead.
AdropMetrics.setProperty("favorite_genres", """["drama","action"]""")
AdropMetrics.setProperty("is_premium_subscriber", true)

import io.adrop.ads.metrics.AdropMetrics;

// Local activity app example
AdropMetrics.setProperty("region", "Seoul");
AdropMetrics.setProperty("booking_count", 5);

// Shopping mall app example
AdropMetrics.setProperty("membership_tier", "gold");
AdropMetrics.setProperty("total_purchase_amount", 1500000);

// Media app example
// Note: Array values are not supported. Use JSON string instead.
AdropMetrics.setProperty("favorite_genres", "[\"drama\",\"action\"]");
AdropMetrics.setProperty("is_premium_subscriber", true);

Custom property names must exactly match the names defined in the console. Case-sensitive.

Property Usage Example

Example of updating properties when a user enters a specific screen in the app.

import io.adrop.ads.Adrop
import io.adrop.ads.metrics.AdropMetrics
import io.adrop.ads.model.AdropKey
import io.adrop.ads.model.AdropValue

class ProfileActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_profile)

        // Get user info
        val user = getUserInfo()

        // Set UID
        Adrop.setUID(user.id)

        // Set default properties
        AdropMetrics.setProperty(AdropKey.BIRTH, user.birthDate)
        AdropMetrics.setProperty(AdropKey.GENDER, user.gender)

        // Set custom properties
        AdropMetrics.setProperty("membership_level", user.membershipLevel)
        AdropMetrics.setProperty("total_booking_count", user.bookingCount)
    }
}

import io.adrop.ads.Adrop;
import io.adrop.ads.metrics.AdropMetrics;
import io.adrop.ads.model.AdropKey;
import io.adrop.ads.model.AdropValue;

public class ProfileActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_profile);

        // Get user info
        User user = getUserInfo();

        // Set UID
        Adrop.INSTANCE.setUID(user.getId());

        // Set default properties
        AdropMetrics.setProperty(AdropKey.BIRTH, user.getBirthDate());
        AdropMetrics.setProperty(AdropKey.GENDER, user.getGender());

        // Set custom properties
        AdropMetrics.setProperty("membership_level", user.getMembershipLevel());
        AdropMetrics.setProperty("total_booking_count", user.getBookingCount());
    }
}

Contextual Targeting

Display ads based on content context (category, topic, etc.). Use the contextId property in banner ads and native ads.

Setting in XML

<io.adrop.ads.banner.AdropBanner
    android:id="@+id/adropBanner"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:adrop_unit_id="PUBLIC_TEST_UNIT_ID_320_50"
    app:adrop_context_id="article_sports" />

Setting in Code

import io.adrop.ads.banner.AdropBanner

val adropBanner = AdropBanner(this, "PUBLIC_TEST_UNIT_ID_320_50", "article_sports")

// Or set on existing instance
val existingBanner = findViewById<AdropBanner>(R.id.adropBanner)
// contextId can only be set in the constructor

import io.adrop.ads.banner.AdropBanner;

AdropBanner adropBanner = new AdropBanner(this, "PUBLIC_TEST_UNIT_ID_320_50", "article_sports");

// Or set on existing instance
AdropBanner existingBanner = findViewById(R.id.adropBanner);
// contextId can only be set in the constructor

Native Ads

Native ads can set contextId in the constructor.

import io.adrop.ads.nativeAd.AdropNativeAd
import io.adrop.ads.nativeAd.AdropNativeAdListener

val nativeAd = AdropNativeAd(this, "PUBLIC_TEST_UNIT_ID_NATIVE")
nativeAd.listener = object : AdropNativeAdListener {
    override fun onAdReceived(ad: AdropNativeAd) {
        // Ad received successfully
    }

    override fun onAdFailedToReceive(ad: AdropNativeAd, errorCode: AdropErrorCode) {
        // Ad failed to receive
    }
}

// contextId is set via constructor, load() takes no parameters
nativeAd.load()

import io.adrop.ads.nativeAd.AdropNativeAd;
import io.adrop.ads.nativeAd.AdropNativeAdListener;

// contextId is set via constructor
AdropNativeAd nativeAd = new AdropNativeAd(this, "PUBLIC_TEST_UNIT_ID_NATIVE", "article_technology");
nativeAd.setListener(new AdropNativeAdListener() {
    @Override
    public void onAdReceived(@NonNull AdropNativeAd ad) {
        // Ad received successfully
    }

    @Override
    public void onAdFailedToReceive(@NonNull AdropNativeAd ad, AdropErrorCode errorCode) {
        // Ad failed to receive
    }
});

// load() takes no parameters
nativeAd.load();

Context ID Usage Example

Example of displaying ads based on article category in a news app.

import io.adrop.ads.banner.AdropBanner

class ArticleActivity : AppCompatActivity() {
    private lateinit var adropBanner: AdropBanner

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_article)

        // Get article category
        val articleCategory = getArticleCategory() // "sports", "technology", "entertainment", etc.

        // Create banner with Context ID matching category
        val contextId = "article_$articleCategory"
        adropBanner = AdropBanner(this, "YOUR_UNIT_ID", contextId)

        // Add to layout
        val container = findViewById<ViewGroup>(R.id.ad_container)
        container.addView(adropBanner)

        // Load ad
        adropBanner.load()
    }
}

import io.adrop.ads.banner.AdropBanner;

public class ArticleActivity extends AppCompatActivity {
    private AdropBanner adropBanner;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_article);

        // Get article category
        String articleCategory = getArticleCategory(); // "sports", "technology", "entertainment", etc.

        // Create banner with Context ID matching category
        String contextId = "article_" + articleCategory;
        adropBanner = new AdropBanner(this, "YOUR_UNIT_ID", contextId);

        // Add to layout
        ViewGroup container = findViewById(R.id.ad_container);
        container.addView(adropBanner);

        // Load ad
        adropBanner.load();
    }
}

Context ID must match the context targeting category defined in the console.

Event Tracking

Track user behavior events to build audiences based on user actions. Use AdropMetrics.sendEvent() to send events.

logEvent() is deprecated. Use sendEvent() instead.

Sending Events

import io.adrop.ads.metrics.AdropMetrics
import io.adrop.ads.metrics.AdropEventParam

// Simple event (no parameters)
AdropMetrics.sendEvent("app_open")

// Event with parameters
val params = AdropEventParam.Builder()
    .putString("item_id", "SKU-123")
    .putString("item_name", "Widget")
    .putFloat("price", 29.99f)
    .build()
AdropMetrics.sendEvent("view_item", params)

import io.adrop.ads.metrics.AdropMetrics;
import io.adrop.ads.metrics.AdropEventParam;

// Simple event (no parameters)
AdropMetrics.sendEvent("app_open");

// Event with parameters
AdropEventParam params = new AdropEventParam.Builder()
    .putString("item_id", "SKU-123")
    .putString("item_name", "Widget")
    .putFloat("price", 29.99f)
    .build();
AdropMetrics.sendEvent("view_item", params);

Multi-Item Events

For events that involve multiple items (e.g., purchase, begin_checkout), use putItems() to attach an item list.

import io.adrop.ads.metrics.AdropMetrics
import io.adrop.ads.metrics.AdropEventParam

val item1 = AdropEventParam.Builder()
    .putString("item_id", "A")
    .putString("item_name", "Product A")
    .putInt("price", 100)
    .putInt("quantity", 1)
    .build()
val item2 = AdropEventParam.Builder()
    .putString("item_id", "B")
    .putString("item_name", "Product B")
    .putInt("price", 200)
    .putInt("quantity", 2)
    .build()
val params = AdropEventParam.Builder()
    .putString("tx_id", "tx_123")
    .putString("currency", "KRW")
    .putItems(listOf(item1, item2))
    .build()
AdropMetrics.sendEvent("purchase", params)

import io.adrop.ads.metrics.AdropMetrics;
import io.adrop.ads.metrics.AdropEventParam;

AdropEventParam item1 = new AdropEventParam.Builder()
    .putString("item_id", "A")
    .putString("item_name", "Product A")
    .putInt("price", 100)
    .putInt("quantity", 1)
    .build();
AdropEventParam item2 = new AdropEventParam.Builder()
    .putString("item_id", "B")
    .putString("item_name", "Product B")
    .putInt("price", 200)
    .putInt("quantity", 2)
    .build();
AdropEventParam params = new AdropEventParam.Builder()
    .putString("tx_id", "tx_123")
    .putString("currency", "KRW")
    .putItems(java.util.Arrays.asList(item1, item2))
    .build();
AdropMetrics.sendEvent("purchase", params);

Supported Event Examples

Event Name	Description	Common Parameters
`app_open`	App opened	—
`sign_up`	User signed up	`method`
`view_item`	Viewed item	`item_id`, `item_name`, `price`
`add_to_cart`	Added to cart	`item_id`, `item_name`, `price`, `quantity`
`add_to_wishlist`	Added to wishlist	`item_id`, `item_name`, `price`
`begin_checkout`	Began checkout	`currency`, `items`
`purchase`	Purchase completed	`tx_id`, `currency`, `items`
`page_view`	Page viewed	`page_id`, `page_category`
`click`	Element clicked	`element_id`, `element_type`

Event name must be 1–64 characters.
Parameter key must be 1–64 characters.
String parameter values are limited to 1024 characters.
Duplicate events with the same name and parameters are throttled within a 500ms window.

Best Practices

1. Set UID Before Loading Ads

// Correct example
Adrop.setUID("user_123")
adropBanner.load()

// Wrong example
adropBanner.load()
Adrop.setUID("user_123") // Targeting won't be applied if set after ad load

// Correct example
Adrop.INSTANCE.setUID("user_123");
adropBanner.load();

// Wrong example
adropBanner.load();
Adrop.INSTANCE.setUID("user_123"); // Targeting won't be applied if set after ad load

2. Use Meaningful Context IDs

// Correct example
val contextId = "article_${article.category}" // "article_sports", "article_tech"
val adropBanner = AdropBanner(this, unitId, contextId)

// Wrong example
val contextId = "page_${randomNumber}" // Meaningless random value
val adropBanner = AdropBanner(this, unitId, contextId)

// Correct example
String contextId = "article_" + article.getCategory(); // "article_sports", "article_tech"
AdropBanner adropBanner = new AdropBanner(this, unitId, contextId);

// Wrong example
String contextId = "page_" + randomNumber; // Meaningless random value
AdropBanner adropBanner = new AdropBanner(this, unitId, contextId);

3. Update Properties Whenever They Change

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // Set initial properties on app start
        updateUserProperties()
    }

    fun onUserPurchaseComplete(purchaseAmount: Int) {
        // Update properties on purchase completion
        val currentTotal = getCurrentTotalPurchase()
        AdropMetrics.setProperty("total_purchase_amount", currentTotal + purchaseAmount)
    }

    fun onMembershipUpgrade(newTier: String) {
        // Update properties on membership upgrade
        AdropMetrics.setProperty("membership_tier", newTier)
    }
}

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        // Set initial properties on app start
        updateUserProperties();
    }

    public void onUserPurchaseComplete(int purchaseAmount) {
        // Update properties on purchase completion
        int currentTotal = getCurrentTotalPurchase();
        AdropMetrics.setProperty("total_purchase_amount", currentTotal + purchaseAmount);
    }

    public void onMembershipUpgrade(String newTier) {
        // Update properties on membership upgrade
        AdropMetrics.setProperty("membership_tier", newTier);
    }
}

Create Audience Targeting

Create audience targeting in console

Create Context Targeting

Create context targeting in console

Sell Targeting

Set up targeting category sales

Banner Ads

Implement banner ads

Native Ads

Implement native ads

Reference

Classes, listeners, error codes

FAQ

Will targeted ads not be displayed if UID is not set?

Ads will still be displayed even without setting UID, but audience targeting won’t be applied. Only basic targeting (country, language, etc.) will be used. Setting UID is essential for sophisticated targeting.

I set properties but don't see data in the console.

Property data is reflected in the console within up to 24 hours after collection. If data is not displayed:

Verify that properties are correctly defined in the console.
Verify that property keys passed from SDK exactly match the console (case-sensitive).
Verify that AdropMetrics.setProperty() is called before loading ads.

What format should Context ID be in?

Context ID should be a meaningful string representing the content context. For example:

News app: "article_sports", "article_tech", "article_entertainment"
Shopping app: "category_fashion", "category_electronics"
Video app: "video_drama", "video_comedy"

Set it to match the context targeting category defined in the console.

Can I set array type properties?

No, array values are not directly supported. setProperty accepts String, Int, Double, Long, Boolean, and null values only. To store multiple values, use a JSON string:

AdropMetrics.setProperty("favorite_genres", """["drama","action","comedy"]""")

How do I delete a property value?

Pass null to the property value to delete that property:

AdropMetrics.setProperty("membership_level", null)

​Overview

​UID Setting

​Usage

​Parameters

​Audience Targeting

​Setting Properties

​Parameters

​Default Properties

​Age (Birthday)

​Gender

​Setting Age Directly

​Custom Properties

​Property Usage Example

​Contextual Targeting

​Banner Ads

​Setting in XML

​Setting in Code

​Native Ads

​Context ID Usage Example

​Event Tracking

​Sending Events

​Multi-Item Events

​Supported Event Examples

​Best Practices

​1. Set UID Before Loading Ads

​2. Use Meaningful Context IDs

​3. Update Properties Whenever They Change

​Related Documentation

Create Audience Targeting

Create Context Targeting

Sell Targeting

Banner Ads

Native Ads

Reference

​FAQ

Overview

UID Setting

Usage

Parameters

Audience Targeting

Setting Properties

Parameters

Default Properties

Age (Birthday)

Gender

Setting Age Directly

Custom Properties

Property Usage Example

Contextual Targeting

Banner Ads

Setting in XML

Setting in Code

Native Ads

Context ID Usage Example

Event Tracking

Sending Events

Multi-Item Events

Supported Event Examples

Best Practices

1. Set UID Before Loading Ads

2. Use Meaningful Context IDs

3. Update Properties Whenever They Change

Related Documentation

FAQ