오디언스 타겟팅
사용자 속성을 기반으로 광고를 타겟팅할 수 있습니다.
1. 타겟팅 생성
먼저 애드컨트롤 콘솔에서 오디언스 타겟팅을 생성하세요.
타겟팅 생성하기
콘솔에서 오디언스 타겟팅 생성 방법 확인
2. 사용자 ID 설정
광고 렌더링 전에 appKey와 uid를 설정해야 합니다.
Adrop.instance().setConfig({
appKey: 'YOUR_APP_KEY',
uid: 'USER_ID'
});
타겟팅 광고가 정상 동작하려면 광고 지면 렌더링 전에 설정을 완료하세요.
3. 사용자 프로퍼티 설정
사용자 속성을 설정하면 더 정교한 타겟팅이 가능합니다.
const adrop = Adrop.instance();
adrop.metrics
.setUserProperties({
// 기본 제공 속성
adid: 'ADVERTISING_ID',
birth: '19931225', // YYYY, YYYYMM, YYYYMMDD
gender: 'M', // M, F, U
locale: 'ko_KR', // ISO 639
timeZone: 'Asia/Seoul', // ISO 8601
// 커스텀 속성 (콘솔에서 등록 필요)
membership: 'premium',
interests: 'tech,gaming'
})
.setAppProperties({
appName: 'com.example.app',
appVersion: '1.0.0',
appBundleVersion: 100
})
.commit();
commit()을 호출해야 속성이 서버에 저장됩니다. 기존 데이터와 병합되지 않고 덮어씌워지므로, 업데이트 시 모든 속성을 함께 전송하세요.
기본 제공 속성
| 필드 | 설명 | 형식 |
|---|
adid | 광고 ID | 문자열 |
birth | 생년월일 | YYYY, YYYYMM, YYYYMMDD |
gender | 성별 | M, F, U |
locale | 로케일 | ISO 639 (ko_KR) |
timeZone | 타임존 | ISO 8601 (Asia/Seoul) |
앱 속성
| 필드 | 설명 |
|---|
appName | 앱 패키지 ID |
appVersion | 앱 버전 (1.0.0) |
appBundleVersion | 앱 빌드 번호 |
커스텀 속성
콘솔에서 추가 등록한 속성을 설정할 수 있습니다. 값은 애드컨트롤 콘솔에서 정의한 타입에 맞게 전달해야 합니다.
adrop.metrics
.setUserProperties({
membership: 'premium',
lastPurchaseDate: '2024-01-15',
favoriteCategory: 'electronics'
})
.commit();
문맥 타겟팅
페이지나 콘텐츠의 문맥에 따라 광고를 타겟팅할 수 있습니다.
1. 타겟팅 생성
먼저 애드컨트롤 콘솔에서 문맥 타겟팅을 생성하세요.
문맥 타겟팅 생성하기
콘솔에서 문맥 타겟팅 생성 방법 확인
2. 광고 지면에 값 설정
콘솔에서 설정한 Context Value를 광고 요청 시 전달합니다.
Data Attributes 방식
<div
data-adrop-unit="YOUR_UNIT_ID"
data-adrop-context-id="sport">
</div>
renderAd 방식
const container = document.getElementById('ad-container');
const adrop = Adrop.instance();
adrop.renderAd(container, {
unit: 'YOUR_UNIT_ID',
contextId: 'sport'
});
동적 문맥 설정
페이지나 콘텐츠에 따라 동적으로 문맥을 설정할 수 있습니다.
<div id="news-ad" data-adrop-unit="NEWS_BANNER"></div>
<script>
// 페이지 카테고리에 따라 문맥 설정
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>
관련 문서
