타겟팅 설정

타겟팅 설정

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

타겟팅 설정

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"
}

타겟팅을 사용하면 특정 사용자 그룹이나 문맥에 맞는 광고를 노출할 수 있습니다. REST API에서는 오디언스 타겟팅과 문맥 타겟팅을 모두 지원합니다.

오디언스 타겟팅

사용자 속성을 기반으로 광고를 타겟팅합니다.

요청 파라미터

string

필수

App Key (adrop_service.json에서 확인)

string

필수

application/json

string

필수

사용자 고유 식별자

string

필수

속성 데이터 (JSON 문자열). 프리셋 및 커스텀 속성 포함

string

플랫폼. 예: web, android, ios

string

광고 식별자 (ADID/IDFA)

응답

integer

응답 코드. 0은 성공

string

응답 메시지

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

프리셋 속성

Adrop에서 미리 정의한 표준 속성입니다. 모든 SDK와 REST API에서 동일한 형식을 사용합니다.

생년월일 (BIRTH)

키	값 예시	형식
`BIRTH`	`2024`	yyyy (연도만)
`BIRTH`	`202401`	yyyyMM (연월)
`BIRTH`	`20240101`	yyyyMMdd (전체 날짜)

성별 (GDR)

키	값	의미
`GDR`	`M`	남성 (Male)
`GDR`	`F`	여성 (Female)
`GDR`	`U`	알 수 없음 (Unknown)

알 수 없음 값

키	값	설명
`*`	`U`	모든 속성에서 “알 수 없음”을 나타낼 때 사용

프리셋 속성 키는 대문자를 사용합니다: BIRTH, GDR

커스텀 속성

콘솔에서 정의한 커스텀 속성을 사용할 수 있습니다.

커스텀 속성 설정

Adrop 콘솔 좌측 메뉴에서 프로퍼티로 이동
프로퍼티 상세 버튼을 클릭하고 + 프로퍼티 추가로 커스텀 속성을 추가한 뒤 변경사항 저장 클릭 (프로퍼티 이름 규칙 참고)
API에서 해당 키-값으로 속성 전송

const properties = {
    // 프리셋 속성
    BIRTH: '19931225',
    GDR: 'M',

    // 커스텀 속성 (콘솔에서 정의)
    membership: 'premium',
    last_purchase_date: '2024-01-15',
    favorite_category: 'electronics'
};

커스텀 속성의 모든 값은 문자열(STRING) 타입입니다.

문맥 타겟팅

페이지나 콘텐츠의 문맥에 따라 광고를 타겟팅합니다. 광고 요청 시 contextId 파라미터를 추가합니다.

문맥 타겟팅 설정

Adrop 콘솔의 타겟팅 → 문맥에서 문맥 타겟팅 생성 (문맥 타겟팅 참고)
타겟팅 옵션 조건에 광고 요청 시 전달할 Context ID 입력
광고 요청 시 같은 값을 contextId 파라미터로 전달

Context ID는 대소문자를 구분하며, 콘솔의 문맥 타겟팅 옵션 조건에 입력한 값과 정확히 일치해야 합니다. Context ID에는 쉼표(,)를 넣지 마세요. 콘솔에서도, 광고 요청에서도 쉼표는 여러 값을 구분하는 데 쓰입니다. 광고를 요청할 때는 앞뒤 공백 없이 콘솔에 입력한 값과 똑같이 전달하세요.Context ID를 전달하지 않거나 콘솔에 등록되지 않은 값을 전달해도 오류는 발생하지 않습니다. 이 경우 문맥 타겟팅 캠페인만 노출 대상에서 빠지고, 다른 광고는 그대로 노출될 수 있습니다.

광고 요청 시 문맥 적용

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

한 번의 요청으로 여러 문맥에 매칭하려면 컨텍스트 ID를 쉼표로 구분해 전달합니다. 앞에서부터 5개까지 사용되며, 포함보다 제외가 우선합니다.

GET https://api-v2.adrop.io/request?unit=YOUR_UNIT_ID&contextId=hiking,outdoor,camping

?contextId=hiking&contextId=outdoor처럼 파라미터를 반복해도 같게 처리됩니다. 전체 규칙은 여러 컨텍스트 ID 전달을 참고하세요.

Context ID에 한글 등 ASCII가 아닌 문자나 &, #, %, +, 공백이 들어 있으면 URL 인코딩해서 전달하세요. axios와 Python requests의 params 옵션은 값을 자동으로 인코딩합니다.

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
    },
    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"

모범 사례

사용자 ID 일관성

동일한 사용자에게는 항상 같은 uid를 사용하세요. 일관된 ID는 정확한 타겟팅의 핵심입니다.

속성 업데이트

사용자 정보가 변경되면 즉시 /property 엔드포인트를 호출하여 업데이트하세요.

프리셋 형식 준수

BIRTH와 GDR 속성은 정해진 형식을 정확히 사용해야 합니다.

문맥 활용

뉴스, 스포츠, 쇼핑 등 페이지 성격에 맞는 문맥 타겟팅을 활용하세요.

오디언스 타겟팅

콘솔에서 오디언스 타겟팅 설정

문맥 타겟팅

콘솔에서 문맥 타겟팅 설정

SDK 가이드

AI

Android

iOS

React Native

Flutter

Web

REST API

오디언스 타겟팅

요청 파라미터

응답

프리셋 속성

생년월일 (BIRTH)

성별 (GDR)

알 수 없음 값

커스텀 속성

커스텀 속성 설정

문맥 타겟팅

문맥 타겟팅 설정

광고 요청 시 문맥 적용

모범 사례

사용자 ID 일관성

속성 업데이트

프리셋 형식 준수

문맥 활용

관련 문서

오디언스 타겟팅

문맥 타겟팅

​오디언스 타겟팅

​요청 파라미터

​응답

​프리셋 속성

​생년월일 (BIRTH)

​성별 (GDR)

​알 수 없음 값

​커스텀 속성

​커스텀 속성 설정

​문맥 타겟팅

​문맥 타겟팅 설정

​광고 요청 시 문맥 적용

​모범 사례

사용자 ID 일관성

속성 업데이트

프리셋 형식 준수

문맥 활용

​관련 문서

오디언스 타겟팅

문맥 타겟팅

오디언스 타겟팅

요청 파라미터

응답

프리셋 속성

생년월일 (BIRTH)

성별 (GDR)

알 수 없음 값

커스텀 속성

커스텀 속성 설정

문맥 타겟팅

문맥 타겟팅 설정

광고 요청 시 문맥 적용

모범 사례

관련 문서