개요
Adrop SDK는 두 가지 타입의 타겟팅을 지원합니다:- 오디언스 타겟팅: 사용자 속성(성별, 연령, 관심사 등)을 기반으로 광고를 타겟팅
- 문맥 타겟팅: 콘텐츠나 화면의 문맥에 따라 광고를 타겟팅
오디언스 타겟팅
사용자 속성을 기반으로 광고를 타겟팅할 수 있습니다.1. 타겟팅 생성
먼저 애드컨트롤 콘솔에서 오디언스 타겟팅을 생성하세요.타겟팅 생성하기
콘솔에서 오디언스 타겟팅 생성 방법 확인
2. 사용자 ID 설정
광고 렌더링 전에 사용자 식별자를 설정해야 합니다.타겟팅 광고가 정상 동작하려면 광고 지면 진입 전에 UID를 설정하세요.
3. 사용자 프로퍼티 설정
사용자 속성을 설정하면 더 정교한 타겟팅이 가능합니다.setProperty() 메서드는 Encodable 파라미터 타입으로 인해 Objective-C에서 제한적으로 사용될 수 있습니다. 가능하면 Swift에서 속성을 설정하세요.기본 제공 속성
SDK는 일반적으로 사용되는 속성에 대한 사전 정의된 키를 제공합니다.AdropKey
AdropValue
성별에 대한 사전 정의된 값:커스텀 속성
콘솔에서 추가 등록한 속성을 설정할 수 있습니다. 모든 커스텀 속성의 키는 문자열이며, 값은 String, Int, Double, Bool 타입을 지원합니다.제약 사항
프로퍼티 설정 시 다음 제약 사항에 유의하세요:- 단일 값만 지원: 배열(
[String],[Int])이나 딕셔너리([String: Any])는 지원하지 않습니다. - 지원 타입: String, Int, Double, Bool만 사용 가능합니다.
- 키 길이: 최대 64자.
- 값 길이: 문자열 값 최대 256자.
- 최대 프로퍼티 수: 사용자당 최대 256개.
- 사전 등록 필요: 커스텀 속성은 콘솔에서 먼저 등록해야 합니다.
이벤트 트래킹
사용자 행동 이벤트를 추적하여 사용자 활동 기반의 오디언스를 구축할 수 있습니다.AdropMetrics.sendEvent()를 사용하여 이벤트를 전송합니다.
logEvent()는 더 이상 사용되지 않습니다(deprecated). 대신 sendEvent()를 사용하세요.이벤트 전송
다중 아이템 이벤트
여러 아이템이 포함된 이벤트(예: purchase, begin_checkout)의 경우,"items" 키 아래에 딕셔너리 배열을 전달합니다.
지원되는 이벤트 예시
- 이벤트 이름은 1~64자여야 합니다.
- 파라미터 키는 1~64자여야 합니다.
- 문자열 파라미터 값은 최대 1024자까지 가능합니다.
- 동일한 이름과 파라미터를 가진 중복 이벤트는 500ms 이내 전송이 제한됩니다.
사용자 데이터 동의
userDataConsent를 통해 사용자 데이터의 서버 전송 여부를 제어할 수 있습니다. false로 설정하면 속성 데이터는 로컬에만 저장되고, 이벤트는 전송되지 않습니다.
문맥 타겟팅
콘텐츠나 화면의 문맥에 따라 광고를 타겟팅할 수 있습니다.1. 타겟팅 생성
먼저 애드컨트롤 콘솔에서 문맥 타겟팅을 생성하세요.문맥 타겟팅 생성하기
콘솔에서 문맥 타겟팅 생성 방법 확인
2. 광고 지면에 값 설정
콘솔에서 설정한 Context ID를 광고 로드 시 전달합니다.배너 광고
네이티브 광고
기타 광고 포맷
문맥 타겟팅은 Context ID를 함께 전달하는 배너·네이티브 광고 요청에만 적용됩니다(Android·iOS SDK의 배너·네이티브 광고, Web SDK, REST API). 전면·보상형·팝업·스플래시 광고와 Flutter·React Native SDK는 Context ID를 전달하지 않습니다. 이런 지면이 포함된 광고 상품에 문맥 타겟팅을 연결하면 해당 지면에서는 문맥 포함 조건을 만족할 수 없어 캠페인이 노출되지 않고, 문맥 제외 조건도 적용되지 않습니다.
동적 문맥 설정
화면이나 콘텐츠에 따라 동적으로 문맥을 설정할 수 있습니다.SwiftUI에서 문맥 설정
전체 예제
오디언스 타겟팅 전체 예제
문맥 타겟팅 전체 예제
모범 사례
1. UID 설정 타이밍
사용자가 로그인하는 즉시 UID를 설정하세요.2. 프로퍼티 일관성 유지
사용자 프로퍼티는 앱 실행 시 또는 값이 변경될 때마다 설정하세요.3. 의미 있는 이벤트 전송
중요한 사용자 행동만 이벤트로 전송하세요.4. 문맥 ID 일관성
문맥 ID는 콘솔에 등록한 값과 정확히 일치해야 합니다.- 문맥 ID에는 쉼표(,)를 넣지 마세요. 콘솔에서도, 광고 요청에서도 쉼표는 여러 값을 구분하는 데 쓰입니다. 광고를 요청할 때는 앞뒤 공백 없이 콘솔에 입력한 값과 똑같이 전달하세요.
- 한 번의 요청으로 여러 문맥에 매칭하려면
hiking,outdoor처럼 쉼표로 구분해 전달합니다. 앞에서부터 5개까지 사용되며, 포함보다 제외가 우선합니다. 자세한 규칙은 여러 컨텍스트 ID 전달을 참고하세요. - 문맥 ID를 전달하지 않거나 콘솔에 등록되지 않은 값을 전달해도 오류는 발생하지 않습니다. 이 경우 문맥 타겟팅 캠페인만 노출 대상에서 빠지고, 다른 광고는 그대로 노출될 수 있습니다.
다음 단계
배너 광고
배너 광고에 타겟팅 적용하기
네이티브 광고
네이티브 광고에 타겟팅 적용하기
오디언스 타겟팅 생성
콘솔에서 오디언스 타겟팅 생성하기
문맥 타겟팅 생성
콘솔에서 문맥 타겟팅 생성하기