FAQ (자주 묻는 질문)
SDK 사용 중 자주 묻는 질문들입니다.
기본 사용
SDK 설치와 초기화는 어떻게 하나요?
플랫폼별 가이드를 참고하세요:
appKey와 appSecret은 어디서 받나요?
[email protected]로 문의하시면 발급해드립니다. 회사명, 앱 이름, 플랫폼 정보를 보내주세요.
테스트용 키도 따로 있나요?
네, 개발용 키와 프로덕션용 키를 따로 발급해드립니다. 개발 중에는 environment를 STAGING으로 설정하세요.
기술적 질문
오퍼월을 여러 개 동시에 열 수 있나요?
안 됩니다. 한 번에 하나의 오퍼월만 열어야 합니다. 동시에 여러 개를 열면 WebView 충돌이 발생할 수 있습니다.
오프라인에서도 작동하나요?
일부 기능만 가능합니다:
✅ 이벤트 큐잉 (나중에 전송)
✅ 캐싱된 콘텐츠 보기
❌ 초기화, 로그인
❌ 오퍼월 첫 로딩
❌ 실시간 데이터 조회
자세한 내용은 오프라인 지원 문서를 참고하세요.
이벤트는 언제 서버로 전송되나요?
일반 이벤트는 배치로 모아서 전송됩니다:
10개 이상 쌓이면
또는 30초마다
또는
flushEvents()호출 시
DAU 이벤트(session_start, user_login)는 즉시 전송됩니다.
자세한 내용은 이벤트 배치 처리 다이어그램을 참고하세요.
ProGuard 설정이 필요한가요?
네, Android 릴리스 빌드에서 ProGuard/R8을 사용한다면 설정이 필요합니다. Android 시작하기 문서의 ProGuard 섹션을 참고하세요.
iOS 시뮬레이터에서 테스트할 수 있나요?
가능하지만 광고 ID를 가져올 수 없어서 일부 광고가 안 나올 수 있습니다. 완전한 테스트는 실제 기기를 사용하세요.
광고와 수익
예상 수익은 얼마나 되나요?
앱 유형과 사용자 참여도에 따라 다릅니다. 평균적으로:
DAU당 일평균 광고 매출: 약 200-400원
DAU당 일 캠페인 참여 횟수: 8-12회
정확한 시뮬레이션은 [email protected]로 문의하세요.
어떤 종류의 광고가 나오나요?
CPI: 앱 설치
CPA: 회원가입, 구매, 레벨 달성 등
CPV: 동영상 시청
CPC: 광고 클릭
CPQ: 퀴즈, 설문
CPS: 쇼핑 (쿠팡, G마켓 등)
자세한 내용은 상품 소개서를 참고하세요.
광고가 안 나오는 이유는?
몇 가지 가능성이 있습니다:
로그인 안 됨:
isLoggedIn확인광고 ID 권한 없음: AndroidManifest.xml 확인
지역 제한: 일부 광고는 한국에서만 노출
광고 재고 부족: 특정 시간대에 광고가 적을 수 있음
사용자 정보(성별, 나이)를 안 넣으면 어떻게 되나요?
SDK는 작동하지만:
광고 타겟팅이 덜 정확해짐
광고 노출 수가 줄어들 수 있음
결과적으로 매출이 20-30% 정도 낮아질 수 있음
가능하면 제공하는 게 좋습니다.
문제 해결
"SDK initialization failed" 에러가 나요
가능한 원인:
appKey나 appSecret이 틀림
인터넷 연결 안 됨
서버 점검 중
자세한 해결 방법은 문제 해결 문서를 참고하세요.
로그인이 안 됩니다
확인사항:
SDK가 초기화되었나요? (
isInitialized())인터넷이 연결되었나요?
userId에 특수문자가 있나요? (문자, 숫자,
-,_만 권장)
오퍼월이 흰 화면만 나와요
Android: AndroidManifest.xml에 인터넷 권한과 usesCleartextTraffic 확인 iOS: Info.plist에 App Transport Security 설정 확인
자세한 내용은 문제 해결 문서를 참고하세요.
빌드 에러가 나요
Android: ./gradlew clean 후 다시 빌드 iOS: pod deintegrate && pod install 후 다시 빌드 React Native: Metro 캐시 리셋 npm start -- --reset-cache
여전히 안 되면 문제 해결 문서를 참고하세요.
정책과 규정
GDPR/CCPA 준수하나요?
네, SDK는 GDPR과 CCPA를 준수합니다:
사용자 동의 없이 개인정보 수집 안 함
광고 ID는 사용자가 ATT 권한을 허용한 경우에만 수집
언제든지 데이터 삭제 요청 가능
개인정보는 어떻게 처리되나요?
SDK가 수집하는 정보:
필수: userId (앱에서 제공한 ID)
선택: 성별, 출생연도
자동: 기기 정보 (OS 버전, 기기 모델), 광고 ID (권한 있을 때)
이메일, 전화번호, 실명 등 민감한 개인정보는 수집하지 않습니다.
아동용 앱에서 사용할 수 있나요?
조건부로 가능합니다. 아동 보호법(COPPA 등)을 준수해야 하므로:
광고 ID 수집 비활성화
타겟팅 광고 비활성화
별도 설정 필요
자세한 내용은 [email protected]로 문의하세요.
비용과 계약
SDK 사용 비용이 있나요?
SDK 자체는 무료입니다. 광고 매출에서 수수료를 가져가는 레버뉴 쉐어 모델입니다.
최소 계약 기간이 있나요?
없습니다. 언제든지 SDK를 제거할 수 있습니다.
정산은 어떻게 되나요?
월 단위로 정산합니다. 자세한 정산 조건은 계약 시 논의합니다.
업데이트와 지원
SDK 업데이트는 어떻게 하나요?
플랫폼별로:
Android:
build.gradle에서 버전 번호 변경 후 Gradle SynciOS:
pod update AdChainSDKReact Native:
npm update @1selfworld/adchain-sdk-react-native
자세한 내용은 릴리스 노트를 참고하세요.
Breaking Change가 있나요?
현재까지는 없습니다. 모든 업데이트가 하위 호환됩니다. 만약 Breaking Change가 생기면 충분한 마이그레이션 기간을 드립니다.
기술 지원은 어떻게 받나요?
이메일: [email protected]
응답 시간: 보통 1-2 영업일 내
긴급 문의: 계약 시 별도 채널 제공
새 기능 요청을 할 수 있나요?
물론입니다! [email protected]로 제안해주세요. 많은 분들이 원하는 기능은 우선순위를 높여서 개발합니다.
기타
다른 오퍼월 SDK와 같이 쓸 수 있나요?
기술적으로는 가능하지만 권장하지 않습니다:
사용자 혼란
포인트 시스템 충돌 가능성
광고 중복 노출
꼭 필요하다면 별도로 상담해주세요.
커스텀 UI를 만들 수 있나요?
현재는 WebView 기반 오퍼월만 제공합니다. 네이티브 UI는 향후 업데이트에서 고려 중입니다.
소스 코드를 볼 수 있나요?
SDK는 오픈소스가 아닙니다. 하지만 샘플 앱 코드는 GitHub에 공개되어 있습니다:
여기 없는 질문이 있으신가요?
[email protected]로 문의해주시면 FAQ에 추가하겠습니다.
Last updated