메인 콘텐츠로 건너뛰기
POST
https://api-v2.adrop.io
/
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>"
}
'
{
    "code": 0,
    "msg": "OK"
}
타겟팅을 사용하면 특정 사용자 그룹이나 컨텍스트에 맞는 광고를 노출할 수 있습니다. REST API에서는 오디언스 타겟팅과 컨텍스트 타겟팅을 모두 지원합니다.

​
오디언스 타겟팅

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

​
요청 파라미터

​
Authorization
string
required
App Key (adrop_service.json에서 확인)
​
Content-Type
string
required
application/json
​
uid
string
required
사용자 고유 식별자
​
value
string
required
속성 데이터 (JSON 문자열). 프리셋 및 커스텀 속성 포함
​
platform
string
플랫폼. 예: web, android, ios
​
adid
string
광고 식별자 (ADID/IDFA)

​
응답

​
code
integer
응답 코드. 0은 성공
​
msg
string
응답 메시지
{
    "code": 0,
    "msg": "OK"
}

​
프리셋 속성

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

​
생년월일 (BIRTH)

키값 예시형식
BIRTH2024yyyy (연도만)
BIRTH202401yyyyMM (연월)
BIRTH20240101yyyyMMdd (전체 날짜)

​
성별 (GDR)

키값의미
GDRM남성 (Male)
GDRF여성 (Female)
GDRO기타 (Other)

​
알 수 없음 값

키값설명
*U모든 속성에서 “알 수 없음”을 나타낼 때 사용
프리셋 속성 키는 대문자를 사용합니다: BIRTH, GDR

​
커스텀 속성

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

​
커스텀 속성 설정

  1. Adrop 콘솔에서 타겟팅 메뉴로 이동
  2. 오디언스 타겟팅 탭에서 커스텀 속성 생성
  3. API에서 해당 키-값으로 속성 전송
const properties = {
    // 프리셋 속성
    BIRTH: '19931225',
    GDR: 'M',

    // 커스텀 속성 (콘솔에서 정의)
    membership: 'premium',
    lastPurchaseDate: '2024-01-15',
    favoriteCategory: 'electronics'
};
커스텀 속성의 모든 값은 문자열(STRING) 타입입니다.

​
컨텍스트 타겟팅

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

​
컨텍스트 타겟팅 설정

  1. Adrop 콘솔에서 타겟팅 메뉴로 이동
  2. 컨텍스트 타겟팅 탭에서 컨텍스트 생성
  3. 광고 요청 시 contextId 파라미터 사용

​
광고 요청 시 컨텍스트 적용

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'  // 콘솔에서 생성한 컨텍스트 ID
    },
    headers: {
        'Authorization': 'YOUR_APP_KEY'
    }
};

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

​
모범 사례

사용자 ID 일관성

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

속성 업데이트

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

프리셋 형식 준수

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

컨텍스트 활용

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

​
관련 문서

오디언스 타겟팅

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

컨텍스트 타겟팅

콘솔에서 컨텍스트 타겟팅 설정