SDK 연동 전제 조건
계획, 앱 등록, 도메인 구성 및 테스트 준비를 포함하는 Singular SDK 연동 전에 필요한 필수 예비 단계입니다.
필수 예비 단계: 모든 Singular SDK 연동에는 다음 단계가 필요합니다.
SDK 연동 계획, 개발용 앱 등록, 링크 추적용 도메인 만들기, 구현 중 및 구현 후 테스트 워크플로우 준비 방법에 대해 알아보세요.
| 대상 고객 | 비즈니스 팀, 마케팅 팀, 개발 팀 |
| 전제 조건 | Singular 계정 액세스, 앱 번들 ID, 마케팅 KPI 정의 |
연동 개요
부서 간 협업
성공적인 Singular SDK 연동을 위해서는 마케팅, 비즈니스 및 개발 팀 간의 협업을 통해 요구 사항을 정의하고, 추적을 구성하고, 구현을 검증해야 합니다.
팀의 책임
| 팀 | 책임 |
|---|---|
| 마케팅/비즈니스 |
|
| 개발 |
|
1단계: SDK 연동 계획 수립
SDK 연동을 시작하기 전에 마케팅 및 비즈니스 팀은 개발팀이 적절한 SDK 기능을 구현할 수 있도록 주요 질문에 답해야 합니다.
아동 개인정보 보호 규정 준수
어린이 대상 앱
질문: 이 앱이 명시적으로 어린이를 대상으로 하나요?
아동을 대상으로 하는 앱은 아동의 개인정보를 보호하는 Play 스토어 및 앱스토어 정책을 준수해야 합니다. Singular는 규정 준수를 위한 특수 SDK를 제공합니다.
권장 솔루션: 기기 식별자를 캡처하지 않음으로써 개인정보 보호 정책을 준수하는 데 도움이 되는 Singular의 키즈 앱 SDK를 사용하세요.
딥링킹 구성
딥링크 처리
질문: 앱이 딥링크를 처리하나요?
딥링킹을 사용하면 마케팅 캠페인, 푸시 알림 또는 웹 페이지와 같은 외부 소스에서 앱 내의 특정 콘텐츠로 사용자를 안내할 수 있습니다.
구현 요구 사항:
- 전제 조건: 도메인 및 플랫폼 구성을 위한 Singular 링크팔로우 전제조건
- 딥링크 핸들러: 관련 SDK 가이드에 설명된 대로 코드에 핸들러를 구현합니다(iOS, 안드로이드, 리액트 네이티브 등).
- 테스트: 테스트 콘솔 및 수동 테스트 절차를 사용하여 딥링크 기능을 검증합니다.
이벤트 트래킹 전략
인앱 이벤트 계획
질문: 앱이 사용자 이벤트를 추적하나요?
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별 구성
SK애드네트워크 구현
질문(iOS): 앱이 SKAdNetwork를 구현하나요?
SKAdNetwork를 사용하면 사용자 수준의 추적 권한 없이도 iOS에서 개인정보 보호 어트리뷰션을 구현할 수 있습니다. Singular는 두 가지 구현 모드를 지원합니다.
SKAdNetwork 모드:
- 관리 모드: 미리 정의된 규칙에 따라 전환 값을 자동으로 업데이트합니다.
- 수동 모드: 앱이 SDK 메소드를 사용하여 직접 전환 값을 업데이트합니다.
앱 트래킹 투명성
질문 (iOS): 앱이 사용자에게 추적 정보 공유 권한(ATT)을 요청합니까?
사용자 옵트인을 통해 디바이스 ID(IDFA)를 공유할 수 있으므로 설치 어트리뷰션 정확도가 향상되므로, Singular는 ATT 프롬프트를 표시할 것을 권장합니다.
구성 요구 사항: ATT 프롬프트를 표시하는 경우, 사용자가 프롬프트에 응답할 때까지 Singular 초기화를 지연하도록 SDK를 구성하세요. 이렇게 하면 어트리뷰션이 정확한 추적 권한 상태를 캡처할 수 있습니다.
ATT 구현:
- 프롬프트 타이밍: Singular SDK를 초기화하기 전에 ATT 프롬프트 표시
- SDK 구성: SDK 구성 옵션을 사용하여 ATT 응답을 기다립니다.
- IDFA 캡처: 사용자가 권한을 부여한 경우, 결정적 어트리뷰션을 위해 IDFA를 수집합니다.
- 폴백 어트리뷰션: 사용자가 권한을 거부하는 경우, 어트리뷰션은 핑거프린팅과 IDFV를 사용합니다.
2단계: 개발 앱 등록
테스트 중 데이터 분리를 유지하기 위해 프로덕션 앱과 별도의 번들 ID를 사용하여 Singular 플랫폼에 개발/테스트 앱을 등록합니다.
번들 ID 전략
개발 대 프로덕션
프로덕션 앱과 테스트 앱 모두에 동일한 SDK 키와 비밀 키를 사용합니다. Singular에 저장된 데이터는 삭제할 수 없습니다.
권장 접근 방식: 테스트 앱에 다른 번들 식별자를 사용하여 데이터를 프로덕션 앱과 별도로 유지합니다. 스토어에 앱을 출시하기 전에 번들 ID를 프로덕션 버전으로 변경합니다.
번들 ID 예시:
| 환경 | 번들 ID |
|---|---|
| 프로덕션 |
com.myapp
|
| 개발/테스트 |
com.myapp.dev
|
앱 등록 단계
플랫폼 구성
등록 절차
- 앱으로 이동: Singular 플랫폼에서 설정 → 앱으로 이동하여 새 앱 추가를 클릭합니다.
- 앱 이름을 입력합니다: 개발 앱의 앱 이름을 입력합니다(명확성을 위해 번들 ID를 사용하는 것이 좋습니다).
- 플랫폼을 선택합니다: 플랫폼 선택: 앱 플랫폼에 해당하는 OS를 선택합니다(iOS 또는 Android).
- 번들 ID 구성: 번들 ID 옵션을 선택하고 번들 식별자의 개발 버전을 입력한 후 앱을 저장합니다.
-
iOS 전용 - 고급 설정: 앱 저장 후, 앱 이름 옆의 화살표를 클릭하여 세부 정보를 확인합니다.
- 고급 설정 표시 옵션 토글
- 팀 ID 추가(유니버설 링크에 필요)
- 스키마 추가(딥링킹에 필요)
개발 후 업데이트
개발 및 테스트를 마친 후
- 번들 ID 업데이트: 앱 구성에서 번들 ID를 프로덕션 버전으로 변경합니다.
- 프로덕션 앱 설정: 마케팅 팀이 앱 구성 FAQ지침에 따라 프로덕션 앱을 추가합니다.
중요: 앱을 앱 스토어 또는 Play 스토어에 출시하기 전에 번들 ID가 프로덕션 값으로 업데이트되었는지 확인하세요. 일치하지 않는 번들 ID는 적절한 어트리뷰션 및 추적을 방해합니다.
3단계: 링크 도메인 생성
브랜드 캠페인 URL과 딥링크 기능을 사용할 수 있는 Singular 추적 링크용 맞춤 도메인을 설정합니다.
링크 도메인 구조
Singular 링크 형식
Singular 링크(Singular 추적 링크)는 사용자 지정 하위 도메인과 함께 표준화된 구조를 따릅니다:
https://[SUBDOMAIN].sng.link/[PARAMETERS]
예시: "Jewel Rush"라는 앱의 경우, 구조가 있는 추적 링크를 활성화하는 jewelrush.sng.link도메인을 생성합니다:
https://jewelrush.sng.link/[PARAMETERS]도메인 전략
Singular 도메인과 다중 도메인
조직은 모든 링크에 Singular 도메인을 사용하거나 다양한 목적(앱, 브랜드, 캠페인 등)에 따라 여러 도메인을 만들 수 있습니다.
요구 사항: Singular 추적 링크를 사용하려면 도메인이 하나 이상 필요합니다. 마케팅 캠페인 및 사용자 대상 자료에 표시되는 도메인은 마케팅 팀이 도메인 선택에 참여해야 합니다.
도메인 사용 사례:
- Singular 도메인: 앱 및 캠페인 전반의 모든 추적 링크에 하나의 도메인 사용
- 앱별: 브랜드 명확성을 위해 앱별로 별도의 도메인 사용
- 캠페인별: 캠페인 유형에 따라 다른 도메인 사용
- 지리적: 지역: 지역화된 캠페인을 위한 지역 도메인
iOS 도메인 구성
연결된 도메인 설정
iOS 앱에 Singular SDK를 연동할 때 유니버설 링크 지원을 위해 Xcode 연관 도메인 설정에서 링크 도메인을 추가합니다.
연결된 도메인 형식:
applinks:[DOMAIN].sng.link예시:
applinks:jewelrush.sng.link추가 리소스: 전체 도메인 설정 및 구성 지침은 Singular 링크 사전 요구 사항을 참조하십시오.
4단계: 연동 테스트 계획
앱을 출시하기 전에 Singular의 테스트 도구 및 검증 절차를 사용하여 SDK/S2S 연동 기능을 검증하세요.
테스트 전략
테스트 단계
종합적인 테스트는 실시간 검증을 위한 구현 중 테스트와 완전한 연동 검증을 위한 구현 후 테스트의 두 단계로 진행됩니다.
실시간 검증 도구
실시간 유효성 검사 도구를 사용하여 구현된 기능을 테스트하고 즉각적인 피드백을 제공합니다.
테스트 콘솔
테스트 콘솔을 사용하여구현된 다양한 SDK 기능을 실시간으로 수동으로 테스트할 수 있습니다.
테스트 콘솔의 이점:
- 실시간 피드백: SDK 호출 및 데이터 전송의 즉각적인 유효성 검사
- 기능별 테스트: 개발 중에 개별 기능을 점진적으로 테스트
- 디버그 지원: 구성 문제 및 데이터 문제를 즉시 식별
- 세션 추적: 세션 초기화 및 이벤트 추적 확인
타사 디버깅 도구
트래픽 검사 및 검증을 위해 프록시 도구를 사용하는 대체 테스트 접근 방식.
Charles 프록시 설정:
- 찰스 프록시또는 유사한 네트워크 검사 도구 설치
- HTTPS 트래픽 검사를 위한 SSL 프록시 활성화
- 올바른 매개 변수를 사용하여 올바른 시간에 트리거된 Singular 데이터 확인
- API 엔드포인트 호출 및 응답 코드 유효성 검사
종합적인 검증 도구
구현 완료 후 자동 및 수동 도구를 사용하여 완벽한 연동 검증을 수행합니다.
SDK 감사 보고서
SDK 감사 보고서를 실행하여자동으로 연동 문제를 식별하고 권장 솔루션을 받아보세요.
감사 보고서 기능
- 자동 감지: 누락되거나 잘못 구성된 SDK 기능 식별
- 모범 사례 검증: Singular 권장 사항에 대한 구현 확인
- 실행 가능한 권장 사항: 식별된 문제에 대한 구체적인 솔루션 제공
- 포괄적인 범위: 모든 SDK 기능 및 구성을 확인합니다.
내보내기 로그 확인
내보내기 로그 페이지를 사용하여 사용자 수준 데이터를 다운로드하여앱에서 Singular로 성공적으로 전송된 모든 데이터를 검토하세요.
내보내기 로그 세부 정보:
- 데이터 형식: 전체 사용자 수준 데이터가 포함된 CSV 파일
- 타이밍: 시기: 데이터 사용 가능 약 30분 전
- 유효성 검사: 이벤트, 세션, 어트리뷰션 데이터 검증
- 디버깅: 누락된 이벤트 또는 잘못된 데이터 식별
딥링크 테스트
Singular SDK 연동 테스트 방법의 지침에 따라 딥링크를 테스트하세요.
딥링크 테스트 사례:
- 유니버설 링크: iOS 유니버설 링크 및 안드로이드 앱 링크 테스트
- 사용자 지정 스키마: 사용자 지정 URL 스키마 처리 확인
- 디퍼드 딥링크: 앱 설치 전에 클릭된 링크 테스트
- 캠페인 파라미터: 파라미터 전달 및 어트리뷰션 검증
어트리뷰션 검증
어트리뷰션 세부 정보 API를 사용하여 테스트 후 디바이스 어트리뷰션 세부 정보를 조회합니다. 어트리뷰션 데이터는 이벤트 발생 후 약 4~6분 후에 확인할 수 있습니다.
어트리뷰션 세부 정보 엔드포인트를 사용하여 어트리뷰션을 확인하는 방법을 알아보세요.
어트리뷰션 검증 단계:
- 테스트 실행: 앱을 설치하고 테스트 사용자 여정을 완료합니다.
- 처리 대기: 어트리뷰션 처리에 4~6분 정도 소요
- API 쿼리: 기기 식별자와 함께 어트리뷰션 세부 정보 API 사용
- 결과 확인: 올바른 캠페인 및 소스에 대한 어트리뷰션 확인
추가 테스트 리소스
전체 테스트 가이드
종합적인 테스트 절차, 모범 사례 및 문제 해결 방법은 Singular SDK 연동 테스트 방법을 참조하세요.
테스트 체크리스트:
- 테스트 콘솔에서 실시간 SDK 호출을 검증합니다.
- SDK 감사 보고서로 완전한 연동을 확인합니다.
- 내보내기 로그를 통해 데이터 전송 확인
- 딥링크가 모든 시나리오에서 올바르게 작동하는지 확인
- 어트리뷰션이 예상 캠페인 소스와 일치합니다.
- 정확한 이름과 속성으로 추적된 이벤트
- 구매 이벤트가 금액 및 통화를 캡처합니다.
다음 단계
전제 조건을 완료한 후 플랫폼별 SDK 연동 또는 S2S 구현을 진행합니다.
SDK 연동 가이드
추가 리소스
- 앱 구성 FAQ- 프로덕션 앱 설정 및 구성
- Singular 링크 전제 조건- 링크 도메인 및 딥링킹 설정
- 표준 이벤트 참조- 전체 표준 이벤트 및 속성 목록
- SDK 연동 테스트- 전체 테스트 절차 및 유효성 검사