메인 콘텐츠로 건너뛰기

개요

Adrop SDK는 두 가지 타입의 타겟팅을 지원합니다:
  • 오디언스 타겟팅: 사용자 속성(성별, 연령, 관심사 등)을 기반으로 광고를 타겟팅
  • 문맥 타겟팅: 콘텐츠나 화면의 문맥에 따라 광고를 타겟팅
타겟팅을 활용하면 사용자에게 더 관련성 높은 광고를 보여줄 수 있으며, 광고주는 원하는 대상에게 효과적으로 광고를 전달할 수 있습니다.

오디언스 타겟팅

사용자 속성을 기반으로 광고를 타겟팅할 수 있습니다.

1. 타겟팅 생성

먼저 애드컨트롤 콘솔에서 오디언스 타겟팅을 생성하세요.

타겟팅 생성하기

콘솔에서 오디언스 타겟팅 생성 방법 확인

2. 사용자 ID 설정

광고 렌더링 전에 사용자 식별자를 설정해야 합니다.
타겟팅 광고가 정상 동작하려면 광고 지면 진입 전에 UID를 설정하세요.

3. 사용자 프로퍼티 설정

사용자 속성을 설정하면 더 정교한 타겟팅이 가능합니다.
setProperty() 메서드는 Encodable 파라미터 타입으로 인해 Objective-C에서 제한적으로 사용될 수 있습니다. 가능하면 Swift에서 속성을 설정하세요.
프로퍼티 값은 단일 값(String, Int, Double, Bool)만 지원합니다. 배열이나 딕셔너리는 지원하지 않습니다.

기본 제공 속성

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로 설정하면 속성 데이터는 로컬에만 저장되고, 이벤트는 전송되지 않습니다.
userDataConsentfalse이면 타겟팅과 이벤트 추적이 동작하지 않습니다. setProperty()sendEvent()를 사용하기 전에 동의를 true로 설정하세요.

문맥 타겟팅

콘텐츠나 화면의 문맥에 따라 광고를 타겟팅할 수 있습니다.

1. 타겟팅 생성

먼저 애드컨트롤 콘솔에서 문맥 타겟팅을 생성하세요.

문맥 타겟팅 생성하기

콘솔에서 문맥 타겟팅 생성 방법 확인

2. 광고 지면에 값 설정

콘솔에서 설정한 Context ID를 광고 로드 시 전달합니다.

배너 광고

네이티브 광고

전면 광고

보상형 광고

동적 문맥 설정

화면이나 콘텐츠에 따라 동적으로 문맥을 설정할 수 있습니다.

SwiftUI에서 문맥 설정


전체 예제

오디언스 타겟팅 전체 예제

문맥 타겟팅 전체 예제


모범 사례

1. UID 설정 타이밍

사용자가 로그인하는 즉시 UID를 설정하세요.

2. 프로퍼티 일관성 유지

사용자 프로퍼티는 앱 실행 시 또는 값이 변경될 때마다 설정하세요.

3. 의미 있는 이벤트 전송

중요한 사용자 행동만 이벤트로 전송하세요.

4. 문맥 ID 일관성

문맥 ID는 콘솔에 등록한 값과 정확히 일치해야 합니다.

다음 단계

배너 광고

배너 광고에 타겟팅 적용하기

네이티브 광고

네이티브 광고에 타겟팅 적용하기

오디언스 타겟팅 생성

콘솔에서 오디언스 타겟팅 생성하기

문맥 타겟팅 생성

콘솔에서 문맥 타겟팅 생성하기