사전 준비사항
App Key 설정
Adrop 서비스를 이용하기 위해서는, 설정 파일을 앱 내부에 추가해 주셔야 합니다.
설정 파일 (adrop_service.json)은 애드컨트롤 콘솔 > 관리 탭 > 앱 에서 플랫폼 별로 다운로드하실 수 있습니다.
다운로드 받은 adrop_service.json 받은 설정 파일을 assets 디렉토리 아래에 추가해주세요.
- android/app/src/main/assets/adrop_service.json
다운로드 받은 adrop_service.json 설정 파일을 Xcode 프로젝트의 루트로 이동시켜주세요. 프롬프트가 완료되면 모든 대상에 설정 파일을 추가하도록 선택합니다.
Flutter 사용자일 경우
설정 파일을 Xcode 프로젝트의 Runner 디렉토리 루트로 이동시켜 주세요.
프로젝트를 빌드 해 주세요.
테마 설정(다크 모드)
소재의 다크 모드가 정상적으로 표시되기 위해서는 테마 설정이 필요합니다.
광고 유닛의 설정에 "다크 모드 소재 받기" 옵션이 활성화 되어있는지 확인해주세요.
앱/웹 환경에서 다크 모드가 적용된 소재를 확인하시려면 해당 테마 설정을 반드시 진행해주셔야 합니다.
함수 정의
Adrop.setTheme(theme: AdropTheme)
사용 가능한 테마 옵션
AdropTheme enum은 3가지 값을 제공합니다:
AdropTheme.LIGHT - 라이트 모드 (밝은 테마)
AdropTheme.DARK - 다크 모드 (어두운 테마)
AdropTheme.AUTO - 시스템 설정 자동 감지
사용 예시
import io.adrop.ads.Adrop import io.adrop.ads.model.AdropTheme
// 라이트 모드 설정
Adrop.setTheme(AdropTheme.LIGHT)
// 다크 모드 설정
Adrop.setTheme(AdropTheme.DARK)
// 시스템 설정에 따라 자동으로 변경
Adrop.setTheme(AdropTheme.AUTO)주요 특징
AUTO 모드: 시스템의 다크모드 설정을 자동으로 감지해서 적용됩니다.
캐시 초기화: 테마 변경 시 스플래시 광고 캐시가 자동으로 클리어됩니다.
초기화 필수: Adrop.initialize() 호출 후에 사용해야 합니다
함수 정의
Adrop.setTheme(_ theme: AdropTheme)
사용 가능한 테마 옵션
.light
라이트 모드 고정
.dark
다크 모드 고정
.auto
시스템 설정을 따름 (iOS 13+)
사용 예시
주의사항
초기화 필수: Adrop.initialize() 호출 후에만 사용 가능
캐시 클리어: 테마 변경 시 스플래시 광고 캐시가 자동으로 삭제됨
자동 모드: .auto는 iOS 13 이상에서만 정상 작동하며, 그 이하 버전에서는 라이트 모드로 폴백됨
함수 정의
Adrop.setTheme(AdropTheme theme)
사용 가능한 테마 옵션
AdropTheme.dark - 다크 모드
AdropTheme.light - 라이트 모드
AdropTheme.auto - 시스템 설정 자동 적용
사용 예시
주요 특징
AUTO 모드: 시스템의 다크모드 설정을 자동으로 감지
초기화 필수: Adrop.initialize() 호출 후 사용
함수 정의
Adrop.setTheme(AdropTheme theme)
사용 가능한 테마 옵션
AdropTheme enum은 3가지 값을 제공합니다:
사용 예시
주요 특징
AUTO 모드: 시스템의 다크모드 설정을 자동으로 감지
캐시 초기화: 테마 변경 시 스플래시 광고 캐시가 자동으로 클리어됨
초기화 필수: Adrop.initialize() 호출 후 사용
오디언스 타겟팅 설정하기
Adrop에 앱 등록을 완료하셨나요?
애드컨트롤 콘솔에서 오디언스 타겟팅을 생성하셨나요?
플랫폼 별 사용자 속성 설정하기
사용자 속성은 사용자층의 세그먼트를 설명하기 위해 정의하는 속성입니다.
이는 앱의 잠재고객을 정의하는데 사용될 수 있습니다.
사용자 속성 설정하기(setPropety)는 타겟팅 광고를 위해 사용자의 개별 속성 설정을 의미합니다.
함수 정의
setProperty(key, value) key : 애드컨트롤 콘솔에서 생성한 프로퍼티 (예 : 아래 이미지의 "adrop")
value: 애드컨트롤 콘솔에서 생성한 오디언스 타겟팅 카테고리 value(예 : 아래 이미지의 "value")
Last updated