Targeting Settings

curl --request POST \
  --url https://api-v2.adrop.io/property \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "uid": "<string>",
  "value": "<string>",
  "platform": "<string>",
  "adid": "<string>"
}
'

import requests

url = "https://api-v2.adrop.io/property"

payload = {
    "uid": "<string>",
    "value": "<string>",
    "platform": "<string>",
    "adid": "<string>"
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({uid: '<string>', value: '<string>', platform: '<string>', adid: '<string>'})
};

fetch('https://api-v2.adrop.io/property', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-v2.adrop.io/property",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'uid' => '<string>',
    'value' => '<string>',
    'platform' => '<string>',
    'adid' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: <content-type>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-v2.adrop.io/property"

	payload := strings.NewReader("{\n  \"uid\": \"<string>\",\n  \"value\": \"<string>\",\n  \"platform\": \"<string>\",\n  \"adid\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api-v2.adrop.io/property")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "<content-type>")
  .body("{\n  \"uid\": \"<string>\",\n  \"value\": \"<string>\",\n  \"platform\": \"<string>\",\n  \"adid\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-v2.adrop.io/property")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = '<content-type>'
request.body = "{\n  \"uid\": \"<string>\",\n  \"value\": \"<string>\",\n  \"platform\": \"<string>\",\n  \"adid\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
    "code": 0,
    "msg": "OK"
}

POST

property

Targeting Settings

curl --request POST \
  --url https://api-v2.adrop.io/property \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "uid": "<string>",
  "value": "<string>",
  "platform": "<string>",
  "adid": "<string>"
}
'

import requests

url = "https://api-v2.adrop.io/property"

payload = {
    "uid": "<string>",
    "value": "<string>",
    "platform": "<string>",
    "adid": "<string>"
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({uid: '<string>', value: '<string>', platform: '<string>', adid: '<string>'})
};

fetch('https://api-v2.adrop.io/property', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-v2.adrop.io/property",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'uid' => '<string>',
    'value' => '<string>',
    'platform' => '<string>',
    'adid' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: <content-type>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-v2.adrop.io/property"

	payload := strings.NewReader("{\n  \"uid\": \"<string>\",\n  \"value\": \"<string>\",\n  \"platform\": \"<string>\",\n  \"adid\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api-v2.adrop.io/property")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "<content-type>")
  .body("{\n  \"uid\": \"<string>\",\n  \"value\": \"<string>\",\n  \"platform\": \"<string>\",\n  \"adid\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-v2.adrop.io/property")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = '<content-type>'
request.body = "{\n  \"uid\": \"<string>\",\n  \"value\": \"<string>\",\n  \"platform\": \"<string>\",\n  \"adid\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
    "code": 0,
    "msg": "OK"
}

Targeting allows you to display ads to specific user groups or contexts. The REST API supports both audience targeting and context targeting.

Audience Targeting

Target ads based on user properties.

Request Parameters

string

required

App Key (found in adrop_service.json)

string

required

application/json

string

required

User unique identifier

string

required

Property data (JSON string). Includes preset and custom properties.

string

Platform. e.g., web, android, ios

string

Advertising identifier (ADID/IDFA)

Response

integer

Response code. 0 indicates success.

string

Response message

{
    "code": 0,
    "msg": "OK"
}

Preset Properties

Standard properties predefined by Adrop. The same format is used across all SDKs and REST API.

Birth Date (BIRTH)

Key	Example Value	Format
`BIRTH`	`2024`	yyyy (year only)
`BIRTH`	`202401`	yyyyMM (year and month)
`BIRTH`	`20240101`	yyyyMMdd (full date)

Gender (GDR)

Key	Value	Meaning
`GDR`	`M`	Male
`GDR`	`F`	Female
`GDR`	`U`	Unknown

Unknown Values

Key	Value	Description
`*`	`U`	Use to represent “unknown” for any property

Preset property keys use uppercase: BIRTH, GDR

Custom Properties

You can use custom properties defined in the console.

Setting Custom Properties

Navigate to the Targeting menu in the Adrop Console
Create custom properties in the Audience Targeting tab
Send the property key-value pairs via API

const properties = {
    // Preset properties
    BIRTH: '19931225',
    GDR: 'M',

    // Custom properties (defined in console)
    membership: 'premium',
    lastPurchaseDate: '2024-01-15',
    favoriteCategory: 'electronics'
};

All custom property values must be STRING type.

Context Targeting

Target ads based on page or content context. Add the contextId parameter to ad requests.

Setting Up Context Targeting

Navigate to the Targeting menu in the Adrop Console
Create a context in the Context Targeting tab
Use the contextId parameter when requesting ads

Applying Context to Ad Requests

GET https://api-v2.adrop.io/request?unit=YOUR_UNIT_ID&contextId=sport

const axios = require('axios');

const config = {
    method: 'get',
    baseURL: 'https://api-v2.adrop.io',
    url: '/request',
    params: {
        unit: 'YOUR_UNIT_ID',
        uid: 'USER_ID',
        pf: 'web',
        contextId: 'sport'  // Context ID created in console
    },
    headers: {
        'Authorization': 'YOUR_APP_KEY'
    }
};

axios.request(config)
    .then((response) => {
        console.log(JSON.stringify(response.data));
    })
    .catch((error) => {
        console.log(error);
    });

import requests

url = "https://api-v2.adrop.io/request"
params = {
    "unit": "YOUR_UNIT_ID",
    "uid": "USER_ID",
    "pf": "web",
    "contextId": "sport"
}
headers = {
    "Authorization": "YOUR_APP_KEY"
}

response = requests.get(url, params=params, headers=headers)
print(response.json())

curl -X GET "https://api-v2.adrop.io/request?unit=YOUR_UNIT_ID&uid=USER_ID&pf=web&contextId=sport" \
  -H "Authorization: YOUR_APP_KEY"

Best Practices

Consistent User ID

Always use the same uid for the same user. Consistent IDs are key to accurate targeting.

Update Properties

Call the /property endpoint immediately when user information changes.

Follow Preset Formats

Use the exact specified formats for BIRTH and GDR properties.

Leverage Context

Use context targeting for page types like news, sports, shopping, etc.

Audience Targeting

Configure audience targeting in the console

Context Targeting

Configure context targeting in the console

Native Ads

Event Tracking

SDK Guide

AI

Android

iOS

React Native

Flutter

Web

REST API

Targeting Settings

Audience Targeting

Request Parameters

Response

Preset Properties

Birth Date (BIRTH)

Gender (GDR)

Unknown Values

Custom Properties

Setting Custom Properties

Context Targeting

Setting Up Context Targeting

Applying Context to Ad Requests

Best Practices

Consistent User ID

Update Properties

Follow Preset Formats

Leverage Context

Audience Targeting

Context Targeting

​Audience Targeting

​Request Parameters

​Response

​Preset Properties

​Birth Date (BIRTH)

​Gender (GDR)

​Unknown Values

​Custom Properties

​Setting Custom Properties

​Context Targeting

​Setting Up Context Targeting

​Applying Context to Ad Requests

​Best Practices

Consistent User ID

Update Properties

Follow Preset Formats

Leverage Context

​Related Documentation

Audience Targeting

Context Targeting

Audience Targeting

Request Parameters

Response

Preset Properties

Birth Date (BIRTH)

Gender (GDR)

Unknown Values

Custom Properties

Setting Custom Properties

Context Targeting

Setting Up Context Targeting

Applying Context to Ad Requests

Best Practices

Related Documentation