SDK 연동 사전 준비 사항
Singular SDK 연동 전에 필요한 필수 사전 단계로, 계획 수립, 앱 등록, 도메인 구성 및 테스트 준비를 다룹니다.
필수 사전 단계: 다음 단계는 모든 Singular SDK 연동에 필요합니다.
SDK 연동 계획 수립, 개발용 앱 등록, 추적 링크용 도메인 생성, 구현 중 및 후의 테스트 워크플로 준비 방법을 알아보세요.
| 대상 독자 | 비즈니스 팀, 마케팅 팀, 개발 팀 |
| 사전 요구사항 | Singular 계정 액세스, 앱 Bundle ID, 마케팅 KPI 정의 |
연동 개요
부서 간 협업
성공적인 Singular SDK 연동을 위해서는 마케팅, 비즈니스, 개발 팀 간의 협업이 필요하여 요구사항을 정의하고, 추적을 구성하며, 구현을 검증해야 합니다.
팀 역할:
| 팀 | 역할 |
|---|---|
| 마케팅/비즈니스 |
|
| 개발 |
|
1단계: SDK 연동 계획
SDK 연동을 시작하기 전에 마케팅 및 비즈니스 팀은 개발 팀이 적절한 SDK 기능을 구현할 수 있도록 핵심 질문에 답해야 합니다.
아동 개인정보 보호 규정 준수
아동 대상 앱
질문: 이 앱은 명시적으로 아동을 대상으로 하나요?
아동을 대상으로 하는 앱은 아동 개인정보를 보호하는 Play Store 및 App Store 정책을 준수해야 합니다. Singular는 규정 준수를 위한 전문 SDK를 제공합니다.
권장 솔루션: 기기 식별자를 수집하지 않아 개인정보 보호 정책 준수에 도움이 되는 Singular Kids Apps SDK를 사용하세요.
딥 링킹 구성
딥 링크 처리
질문: 앱이 딥 링크를 처리하나요?
딥 링킹은 마케팅 캠페인, 푸시 알림, 웹 페이지 등 외부 소스에서 앱 내 특정 콘텐츠로 사용자를 유도할 수 있게 합니다.
구현 요구사항:
- 사전 요구사항: 도메인 및 플랫폼 구성을 위해 Singular Links 사전 요구사항을 따르세요.
- 딥 링크 핸들러: 관련 SDK 가이드(iOS, Android, React Native 등)에 설명된 대로 코드에 핸들러를 구현하세요.
- 테스트: Testing Console 및 수동 테스트 절차를 사용하여 딥 링크 기능을 검증하세요.
이벤트 추적 전략
인앱 이벤트 계획
질문: 앱이 사용자 이벤트를 추적하나요?
Singular는 캠페인 성과를 분석하고 KPI를 측정하기 위해 인앱 이벤트 데이터를 수집합니다. 이벤트 전략은 마케팅 목표 및 사용자 가치 측정과 일치해야 합니다.
표준 이벤트 장점
Singular는 다양한 업종에서 일반적으로 사용되며 보고 및 최적화를 위해 광고 네트워크에서 지원하는 다양한 표준 이벤트를 지원합니다.
장점:
- 자동 인식: Singular는 표준 이벤트를 자동으로 인식하여 수동 정의 없이 이벤트 목록에 추가합니다.
- 파트너 지원: 광고 네트워크는 캠페인 최적화 및 보고를 위해 표준 이벤트를 지원합니다.
- 업계 표준: 플랫폼 및 파트너 간 일관된 명칭
- 모범 사례: 이벤트가 표준 정의와 일치할 때마다 권장되는 접근 방식
표준 이벤트 속성
각 표준 이벤트에 대해 완전한 데이터 수집 및 파트너 호환성을 위한 권장 표준 속성을 전달하세요.
예시: sng_content_view 이벤트(사용자가 제품 조회)에는 다음이 포함되어야 합니다:
-
sng_attr_content_type- 조회한 콘텐츠 유형 -
sng_attr_content_id- 고유 콘텐츠 식별자 -
sng_attr_content- 콘텐츠 설명 또는 이름
이벤트 전략 리소스
UA/마케팅/비즈니스 팀은 다음 리소스를 사용하여 마케팅 KPI를 기반으로 이벤트 목록을 작성해야 합니다:
- 인앱 이벤트 추적 방법 - 이벤트 계획 및 구현 가이드
- Singular 표준 이벤트: 전체 목록 및 업종별 권장 이벤트 - 완전한 표준 이벤트 참조
플랫폼별 이벤트 이름
개발자 참고: SDK 연동 시 개발 플랫폼에 따라 약간 다른 이벤트/속성 이름 형식(모두 대문자, 밑줄 없음 등)이 필요할 수 있습니다.
플랫폼별 목록:
커스텀 이벤트 정의
이벤트가 Singular 표준 이벤트와 일치하지 않으면 특정 추적 요구사항에 맞게 커스텀 이름으로 커스텀 이벤트를 정의하세요.
커스텀 이벤트 가이드라인:
- 문자 제한: 최대 32자
- 언어: Singular로부터 이벤트를 받는 광고 네트워크 파트너와의 호환성을 위해 영어 이름을 권장합니다.
- 명명 규칙: 명확성 및 유지 관리를 위해 설명적이고 일관된 명칭을 사용하세요.
- 문서화: 커스텀 이벤트 이름 및 목적을 문서화하는 이벤트 카탈로그를 유지하세요.
이벤트 추적 범위
모범 사례: 마케팅 관련 목적에 필요한 경우에만 Singular에 이벤트를 전송하세요. 이벤트가 캠페인 성과 KPI 또는 사용자 가치 지표로 중요하지 않다면 Singular에서 추적하지 않아야 합니다.
이벤트 선택 기준:
- 마케팅 관련성: 이벤트가 캠페인 최적화를 위한 인사이트를 제공합니다.
- KPI 측정: 이벤트가 핵심 성과 지표에 기여합니다.
- 사용자 가치: 이벤트가 사용자 참여 또는 구매화를 나타냅니다.
- 파트너 최적화: 이벤트가 캠페인 타겟팅을 위해 광고 네트워크에서 사용됩니다.
iOS 전용 구성
SKAdNetwork 구현
질문 (iOS): 앱이 SKAdNetwork를 구현하나요?
SKAdNetwork는 유저 레벨 추적 권한 없이 iOS에서 개인정보 보호 어트리뷰션을 가능하게 합니다. Singular는 두 가지 구현 모드를 지원합니다.
SKAdNetwork 모드:
- 관리 모드: Singular가 미리 정의된 규칙에 따라 전환 값을 자동으로 업데이트합니다.
- 수동 모드: 앱이 SDK 메서드를 사용하여 직접 전환 값을 업데이트합니다.
앱 추적 투명성 (ATT)
질문 (iOS): 앱이 추적 정보 공유에 대한 사용자 권한을 요청하나요(ATT)?
Singular는 ATT 프롬프트를 표시할 것을 권장합니다. 사용자가 동의하면 기기 ID(IDFA)를 공유할 수 있어 설치 어트리뷰션 정확도가 향상됩니다.
구성 요구사항: ATT 프롬프트를 표시하는 경우 사용자가 프롬프트에 응답할 때까지 Singular 초기화를 지연하도록 SDK를 구성하세요. 이를 통해 어트리뷰션이 올바른 추적 권한 상태를 캡처합니다.
ATT 구현:
- 프롬프트 타이밍: Singular SDK를 초기화하기 전에 ATT 프롬프트를 표시하세요.
- SDK 구성: ATT 응답을 기다리기 위해 SDK 구성 옵션을 사용하세요.
- IDFA 수집: 사용자가 권한을 부여하면 결정론적 어트리뷰션을 위해 IDFA가 수집됩니다.
- 대체 어트리뷰션: 사용자가 권한을 거부하면 어트리뷰션은 핑거프린팅 및 IDFV를 사용합니다.
2단계: 개발 앱 등록
테스트 중 데이터 분리를 유지하기 위해 프로덕션 앱과 별도의 Bundle ID를 사용하여 Singular 플랫폼에 개발/테스트 앱을 등록하세요.
Bundle ID 전략
개발 vs 프로덕션
프로덕션 앱과 테스트 앱 모두 동일한 SDK Key 및 Secret Key를 사용합니다. Singular에 저장된 데이터는 삭제할 수 없습니다.
권장 접근 방식: 테스트 앱에 다른 Bundle Identifier를 사용하여 프로덕션 앱과 데이터를 분리하세요. 앱을 스토어에 출시하기 전에 Bundle ID를 프로덕션 버전으로 변경하세요.
Bundle ID 예시:
| 환경 | Bundle ID |
|---|---|
| 프로덕션 | com.myapp |
| 개발/테스트 | com.myapp.dev |
앱 등록 단계
플랫폼 구성
등록 절차
- 앱으로 이동: Singular 플랫폼에서 Settings → Apps로 이동하여 Add New App을 클릭하세요.
- 앱 이름 입력: 개발 앱의 앱 이름을 입력하세요(명확성을 위해 Bundle ID 사용을 권장합니다).
- 플랫폼 선택: 앱 플랫폼에 해당하는 OS를 선택하세요(iOS 또는 Android).
- Bundle ID 구성: Bundle ID 옵션을 선택하고 Bundle Identifier의 개발 버전을 입력한 다음 앱을 저장하세요.
-
iOS 전용 - 고급 설정: 앱을 저장한 후 앱 이름 옆의 화살표를 클릭하여 세부 정보를 확인하세요.
- Show Advanced Settings 옵션을 토글하세요.
- Team ID 추가(Universal Links에 필요)
- Scheme 추가(딥 링킹에 필요)
개발 후 업데이트
개발 및 테스트 완료 후:
- Bundle ID 업데이트: 앱 구성에서 Bundle ID를 프로덕션 버전으로 변경하세요.
- 프로덕션 앱 설정: 마케팅 팀이 App Configuration FAQ 지침에 따라 프로덕션 앱을 추가합니다.
중요: App Store 또는 Play Store에 앱을 출시하기 전에 Bundle ID가 프로덕션 값으로 업데이트되었는지 확인하세요. Bundle ID가 일치하지 않으면 올바른 어트리뷰션 및 추적이 방지됩니다.
3단계: 링크 도메인 생성
브랜드 캠페인 URL 및 딥 링크 기능을 위한 Singular 추적 링크의 커스텀 도메인을 구축하세요.
링크 도메인 구조
Singular 링크 형식
Singular Links(Singular 추적 링크)는 커스텀 서브도메인을 사용하는 표준화된 구조를 따릅니다:
https://[SUBDOMAIN].sng.link/[PARAMETERS]예시: "Jewel Rush"라는 앱의 경우 jewelrush.sng.link 도메인을 생성하여 다음 구조의 추적 링크를 사용할 수 있습니다:
https://jewelrush.sng.link/[PARAMETERS]도메인 전략
Singular 도메인 vs 다중 도메인
조직은 모든 링크에 Singular 도메인을 사용하거나 다른 목적(앱, 브랜드, 캠페인 등)에 맞게 여러 도메인을 생성할 수 있습니다.
요구사항: Singular 추적 링크를 사용하기 전에 하나 이상의 도메인이 필요합니다. 마케팅 팀은 도메인 선택에 참여해야 합니다. 도메인은 마케팅 캠페인 및 사용자 대면 자료에 표시됩니다.
도메인 사용 사례:
- Singular 도메인: 앱 및 캠페인 전반에 걸쳐 모든 추적 링크에 하나의 도메인 사용
- 앱별: 브랜드 명확성을 위해 앱별 별도 도메인
- 캠페인별: 다양한 캠페인 유형에 대한 다른 도메인
- 지역별: 지역화된 캠페인을 위한 지역 도메인
iOS 도메인 구성
연결 도메인 설정
iOS 앱에서 Singular SDK를 연동할 때 Universal Links 지원을 위해 Xcode 연결 도메인 설정에 링크 도메인을 추가하세요.
연결 도메인 형식:
applinks:[DOMAIN].sng.link예시:
applinks:jewelrush.sng.link추가 리소스: 완전한 도메인 설정 및 구성 지침은 Singular Links 사전 요구사항을 참조하세요.
4단계: 연동 테스트 계획
Singular의 테스트 도구 및 검증 절차를 사용하여 앱을 출시하기 전에 SDK/S2S 연동 기능을 검증하세요.
테스트 전략
테스트 단계
포괄적인 테스트는 두 단계에서 수행됩니다: 실시간 검증을 위한 구현 중과 완전한 연동 검증을 위한 구현 후.
실시간 검증 도구
즉각적인 피드백을 제공하는 실시간 검증 도구를 사용하여 구현된 기능을 테스트하세요.
Testing Console
Testing Console을 사용하여 구현 중에 다양한 SDK 기능을 실시간으로 수동 테스트하세요.
Testing Console 장점:
- 실시간 피드백: SDK 호출 및 데이터 전송의 즉각적인 검증
- 기능별: 개발 중에 개별 기능을 단계적으로 테스트
- 디버그 지원: 구성 문제 및 데이터 문제를 즉시 식별
- 세션 추적: 세션 초기화 및 이벤트 추적 확인
타사 디버깅 도구
트래픽 검사 및 검증을 위한 프록시 도구를 사용한 대체 테스트 방식.
Charles Proxy 설정:
- Charles Proxy 또는 유사한 네트워크 검사 도구를 설치하세요.
- HTTPS 트래픽 검사를 위해 SSL 프록시를 활성화하세요.
- 올바른 시간에 올바른 파라미터로 Singular 데이터가 트리거되는지 확인하세요.
- API 엔드포인트 호출 및 응답 코드를 검증하세요.
종합 검증 도구
구현을 완료한 후 완전한 연동 검증을 위해 자동화 및 수동 도구를 사용하세요.
SDK 감사 보고서
SDK 감사 보고서를 실행하여 연동 문제를 자동으로 식별하고 권장 솔루션을 받으세요.
감사 보고서 기능:
- 자동 감지: 누락되거나 잘못 구성된 SDK 기능을 식별합니다.
- 모범 사례 검증: Singular 권장 사항에 따라 구현을 검증합니다.
- 실행 가능한 권장 사항: 식별된 문제에 대한 구체적인 솔루션을 제공합니다.
- 포괄적인 범위: 모든 SDK 기능 및 구성을 확인합니다.
Export Logs 검증
Export Logs 페이지를 사용하여 유저 레벨 데이터를 다운로드하고 앱에서 Singular로 성공적으로 전송된 모든 데이터를 검토하세요.
Export Logs 세부 사항:
- 데이터 형식: 완전한 유저 레벨 데이터가 포함된 CSV 파일
- 타이밍: 데이터 사용 가능까지 약 30분 소요
- 검증: 이벤트, 세션 및 어트리뷰션 데이터를 확인하세요.
- 디버깅: 누락된 이벤트 또는 잘못된 데이터를 식별하세요.
딥 링크 테스트
Singular SDK 연동 테스트 방법의 지침에 따라 딥 링크를 테스트하세요.
딥 링크 테스트 케이스:
- Universal Links: iOS Universal Links 및 Android App Links 테스트
- 커스텀 스킴: 커스텀 URL 스킴 처리 확인
- 지연 딥 링크: 앱 설치 전에 클릭한 링크 테스트
- 캠페인 파라미터: 파라미터 전달 및 어트리뷰션 검증
어트리뷰션 검증
테스트 후 Attribution Details API를 사용하여 기기 어트리뷰션 세부 사항을 쿼리하세요. 어트리뷰션 데이터는 이벤트 후 약 4~6분 후에 사용 가능합니다.
Attribution Details Endpoint를 사용한 어트리뷰션 검증 방법을 알아보세요.
어트리뷰션 검증 단계:
- 테스트 실행: 앱을 설치하고 테스트 사용자 여정을 완료하세요.
- 처리 대기: 어트리뷰션 처리를 위해 4~6분 기다리세요.
- API 쿼리: 기기 식별자로 Attribution Details API를 사용하세요.
- 결과 확인: 올바른 캠페인 및 소스로의 어트리뷰션을 확인하세요.
추가 테스트 리소스
완전한 테스트 가이드
포괄적인 테스트 절차, 모범 사례 및 문제 해결은 Singular SDK 연동 테스트 방법을 참조하세요.
테스트 체크리스트:
- Testing Console이 실시간 SDK 호출을 검증합니다.
- SDK 감사 보고서가 완전한 연동을 확인합니다.
- Export Logs가 데이터 전송을 확인합니다.
- 딥 링크가 모든 시나리오에서 올바르게 작동합니다.
- 어트리뷰션이 예상 캠페인 소스와 일치합니다.
- 이벤트가 올바른 이름 및 속성으로 추적됩니다.
- 구매 이벤트가 금액 및 통화를 수집합니다.
다음 단계
사전 준비 사항을 완료한 후 플랫폼별 SDK 연동 또는 S2S 구현을 진행하세요.
SDK 연동 가이드
추가 리소스
- App Configuration FAQ - 프로덕션 앱 설정 및 구성
- Singular Links 사전 요구사항 - 링크 도메인 및 딥 링킹 설정
- 표준 이벤트 참조 - 완전한 표준 이벤트 및 속성 목록
- SDK 연동 테스트 - 완전한 테스트 절차 및 검증