Targeting Settings

Audience Targeting

You can target ads based on user properties.

1. Create Targeting

First, create audience targeting in Ad Control Console.

Create Targeting

Check how to create audience targeting in the console

2. Set User ID

You must set appKey and uid before rendering ads.

Adrop.instance().setConfig({
  appKey: 'YOUR_APP_KEY',
  uid: 'USER_ID'
});

Complete the setup before rendering the ad placement for targeted ads to work properly.

3. Set User Properties

Setting user properties enables more sophisticated targeting.

const adrop = Adrop.instance();

await adrop.metrics
  .setUserProperties({
    // Built-in properties
    adid: 'ADVERTISING_ID',
    birth: '19931225',        // YYYY, YYYYMM, YYYYMMDD
    gender: 'M',              // M, F, U
    locale: 'ko_KR',          // ISO 639
    timeZone: 'Asia/Seoul',   // ISO 8601

    // Custom properties (must be registered in console)
    membership: 'premium',
    interests: 'tech,gaming'
  })
  .setAppProperties({
    appName: 'com.example.app',
    appVersion: '1.0.0',
    appBundleVersion: 100
  })
  .commit();

You must call commit() to save properties to the server. It overwrites rather than merges with existing data, so send all properties together when updating.

Built-in Properties

Field	Description	Format
`adid`	Advertising ID	String
`birth`	Birth date	YYYY, YYYYMM, YYYYMMDD
`gender`	Gender	M, F, U
`locale`	Locale	ISO 639 (ko_KR)
`timeZone`	Time zone	ISO 8601 (Asia/Seoul)

App Properties

Field	Description
`appName`	App package ID
`appVersion`	App version (1.0.0)
`appBundleVersion`	App build number

Device Properties (Auto-collected)

The SDK automatically collects the following device properties. You do not need to set these manually.

Field	Description
`sdkv`	SDK version
`deviceWidth`	Device screen width
`deviceHeight`	Device screen height
`osVersion`	OS version
`webViewUserAgent`	Browser user agent
`platform`	Platform (web)

Custom Properties

You can set additional properties registered in the console. Values must match the type defined in Ad Control Console.

await adrop.metrics
  .setUserProperties({
    membership: 'premium',
    lastPurchaseDate: '2024-01-15',
    favoriteCategory: 'electronics'
  })
  .commit();

Contextual Targeting

You can target ads based on page or content context.

1. Create Targeting

First, create contextual targeting in Ad Control Console.

Create Contextual Targeting

Check how to create contextual targeting in the console

2. Set Value on Ad Placement

Pass the Context Value configured in the console when requesting ads.

Data Attributes Method

<div
  data-adrop-unit="YOUR_UNIT_ID"
  data-adrop-context-id="sport">
</div>

renderAd Method

const container = document.getElementById('ad-container');
const adrop = Adrop.instance();

adrop.renderAd(container, {
  unit: 'YOUR_UNIT_ID',
  contextId: 'sport'
});

Dynamic Context Setting

You can set context dynamically based on page or content.

<div id="news-ad" data-adrop-unit="NEWS_BANNER"></div>

<script>
  // Set context based on page category
  const category = document.body.getAttribute('data-category'); // 'sport', 'tech', etc.
  const container = document.getElementById('news-ad');

  Adrop.instance().renderAd(container, {
    unit: 'NEWS_BANNER',
    contextId: category
  });
</script>

Reference > AdropConfig

Initialization option definitions

Reference > AdropAdRequest

Ad request parameter definitions

SDK Guide

AI

Android

iOS

React Native

Flutter

Web

REST API

Audience Targeting

1. Create Targeting

Create Targeting

2. Set User ID

3. Set User Properties

Built-in Properties

App Properties

Device Properties (Auto-collected)

Custom Properties

Contextual Targeting

1. Create Targeting

Create Contextual Targeting

2. Set Value on Ad Placement

Data Attributes Method

renderAd Method

Dynamic Context Setting

Reference > AdropConfig

Reference > AdropAdRequest

​Audience Targeting

​1. Create Targeting

Create Targeting

​2. Set User ID

​3. Set User Properties

​Built-in Properties

​App Properties

​Device Properties (Auto-collected)

​Custom Properties

​Contextual Targeting

​1. Create Targeting

Create Contextual Targeting

​2. Set Value on Ad Placement

​Data Attributes Method

​renderAd Method

​Dynamic Context Setting

​Related Documentation

Reference > AdropConfig

Reference > AdropAdRequest

Audience Targeting

1. Create Targeting

2. Set User ID

3. Set User Properties

Built-in Properties

App Properties

Device Properties (Auto-collected)

Custom Properties

Contextual Targeting

1. Create Targeting

2. Set Value on Ad Placement

Data Attributes Method

renderAd Method

Dynamic Context Setting

Related Documentation