Singular SDK 연동: 계획과 전제조건

다음은 모든 Singular SDK 연동에 있어 필요한 과정들을 설명합니다. 

SDK 연동을 계획하는 방법에 대해 알아본 후, 앱을 development로 등록하고, 트래킹 링크에 대한 도메인을 생성하여, development와 그 이후의 단계에서 연동을 어떻게 테스트할지에 대해 계획해보세요.  

가이드 대상 비즈니스/마케팅 팀
1

SDK 연동 계획

Singular SDK 연동을 시작하기 전, 마케팅/비즈니스팀은 다음 사항들에 대한 질문에 먼저 답해보세요. 다음 사항들에 대해 답을 함으로써 개발팀이 어떤 SDK 특징과 기능을 활성화해야 할지 알 수 있습니다.  

앱이 아동을 위한 앱인가요? 

아동을 위한 앱이라면 Play Store와 App Store의 아동 프라이버시 보호 정책을 반드시 준수해야 합니다. 해당 정책을 준수하기 위해 Singular의 아동 앱 용 SDK 사용을 권장하며, 이를 통해 디바이스 식별자를 포획하지 않게 되어 해당 정책을 준수하는 데 도움이 됩니다.

앱이 딥링크를 다루나요?

Singular 링크 전제조건의 설명을 따른 후 관련 SDK 가이드에 설명된 대로 딥링크 핸들러를 코드에 구현하세요.  

앱이 유저 이벤트를 추적할까요?

Singular는 캠페인 성과 분석하고 KPI를 측정에 도움이 되는 인 앱 이벤트 데이터를 수집할 수 있습니다. 예를 들어, 유저 로그인, 회원가입, 튜토리얼 완료, 게임 앱의 경우 레벨 업등에 대한 데이터를 수집할 수 있습니다.  

표준 이벤트 

Singular에서는 여러 표준 이벤트들을 지원합니다. 이 표준 이벤트들은 광고 매체 리포팅과 최적화에 자주 지원되는 이벤트들입니다. 다른 이점으로는, 표준 이벤트를 사용하면 수동으로 이벤트를 추가하지 않더라도 Singular에서 이벤트를 자동으로 인지하여 이벤트 목록에 추가합니다. 그러므로 가능하다면 표준 이벤트 사용을 권장합니다.  

각 표준 이벤트에, 권장되는 표준 어트리뷰트들을 전달해야 합니다. 예를 들어, sng_content_view 이벤트(고객이 제품을 조회한 이벤트)의 경우, sng_attr_content_type, sng_attr_content_id, sng_attr_content 어트리뷰트들을 전달해야 합니다. 

Singular에 전달되는 이벤트 목록은 (수반하는 어트리뷰트들과 함께) UA/마케팅/비즈니스팀에 의해 마케팅 KPI에 기반하여 작성되어야 합니다. 이벤트 전략을 세우는 데 있어 유용한 다음 가이드를 참조하세요. 

중요: Singular SDK를 앱에 연동할 때, 개발팀은 개발 플랫폼에 따라 약간은 상이한 이벤트 버전/어트리뷰트 명 (모두 대문자, 밑줄 없게 하는 등)을 사용해야 할 수 있습니다. iOS, Android, Unity, React, Flutter의 이벤트 목록과 어트리뷰트 명을 확인하세요.

커스텀 이벤트

Singular의 표준 이벤트들과 일치하지 않는 다른 이벤트를 측정하고 싶은 경우, 고유 커스텀 이벤트를 커스텀 명으로 정의할 수 있습니다. 

개발팀은 최대 32자까지 커스텀 명을 지정할 수 있습니다. 커스텀 명은 최적화를 목적으로 Singular로부터 이벤트를 받는 모든 광고 매체들과의 호환성을 위해 영어로 지정하는 것을 권장합니다.  

팁: 마케팅 관련 목적으로 추적해야 하는 이벤트들인 경우에만 Singular에 보내세요. 특정 이벤트가 캠페인 성과 또는 유저 값만큼 중요하지 않은 이벤트라면 Singular를 통해 추적하지 마세요.  

(iOS) 앱이 반드시 SKAdNetwork를 구현해야 할까요? 

SDK 메서드를 사용하여 Managed Mode(Singular에 의해 컨버전 값을 업데이트) 또는 Manual Mode (직접 컨버전 값을 업데이트)를 통해 SKAN을 활성화할 수 있습니다.

(iOS) 앱은 반드시 유저에게 추적 정보에 대한 허락(ATT)을 구해야 할까요? 

ATT 프롬프트를 표시하는 것을 권장합니다. 왜냐하면, 유저가 옵트 인을 통해 디바이스 ID를 공유하게 되면, 디바이스 ID는 올바르게 인스톨을 어트리뷰션하는데에 도움이 되기 때문입니다. 

ATT 프롬프트를 표시하려면, 유저가 응답할 때까지 앱에서 SDK가 Singular가 초기화하는 과정을 지연시키도록 설정해야 합니다.  

2

개발/테스트 앱 등록

앱 번들 ID

동일한 SDK 키와 시크릿 키가 프로덕션과 테스트 앱에 사용됩니다. 테스트/프로덕션 데이터가 Singular에 저장되면, 이는 삭제할 수 없습니다. 

이 점을 고려하여, 테스트 앱에는 최종 프로덕션 앱과는 다른 번들 ID를 사용하여 데이터를 보관하세요.  

예를 들어, 프로덕션 앱이 com.myapp 라는 번들 ID를 사용한다면, 개발 단계에서는 com.myapp.dev 라는 ID를 사용할 수 있습니다. 그 이후 앱을 앱 스토어에 출시하기 전 해당 번들 ID를 프로덕션 버전의 것으로 변경하세요. 

앱 등록 절차

  1. Singular 웹 앱에서, Settings > Apps > Add New App를 클릭하세요.
  2. 개발 앱의 앱 명을 입력하세요. 번들 ID 사용을 권장합니다.
  3. 해당 앱 플랫폼에 상응하는 OS를 선택하세요.
  4. 번들 ID 옵션을 사용하여 앱을 식별하고, 번들 ID의 개발 버전을 입력한 후, 앱을 저장하세요.  
  5. iOS 앱의 경우: 앱을 저장한 후, 앱 이름 옆의 화살표를 클릭하여 앱의 상세 내용을 확인하세요. 그리고, Show Advanced Settings 옵션을 토글 하세요. 여기서 Team ID Scheme를 추가하세요. 이는 유니버셜 링크와 딥링크에 반드시 필요한 작업입니다.

앱 개발과 테스트를 마친 후, 번들 ID를 프로덕션 버전으로 업데이트하고, 마케팅팀에게 앱 설정 FAQ의 설명을 기반으로 앱을 프로덕션 앱에 추가하도록 요청하세요.

3

링크 도메인 생성 (아직 생성하지 않은 경우)

Singular 링크 (Singular 트래킹 링크)는 다음과 같은 형식을 가지며, 이 형식에서 [SUBDOMAIN]은 고객이 설정합니다.

https://[SUBDOMAIN].sng.link/[PARAMETERS]

예를 들어, 캠페인 앱 명이 Jewel Rush인 앱을 출시한다면, 도메인을 "jewelrush.sng.link"와 같이 생성할 수 있습니다. 이후, 해당 도메인을 다음과 같은 형식의 트래킹 링크를 생성할 수 있습니다. 

https://jewelrush.sng.link/[PARAMETERS]

한 도메인을 모든 링크에 사용하거나, 여러 용도를 위해 다수의 도메인을 생성할 수도 있습니다. 어떤 경우든, Singular 트래킹 링크에는 적어도 한 개 이상의 도메인은 사용해야 합니다. 

링크 도메인이 마케팅 캠페인에 노출되는 만큼, 링크 도메인 결정은 마케팅팀과의 협의 하에 결정하세요. 

Singular SDK를 iOS 앱에 연동할 때, 링크 도메인을 다음과 같은 형식으로 Xcode Associated Domain Settings에 추가하세요.

applinks:[DOMAIN].sng.link

추가 참고: Singular 링크 전제조건

4

연동 테스트 방법

Singular SDK/S2S를 앱에 연동할 때, 앱의 신규 버전을 라이브 하기 전에 올바르게 작동하는지 반드시 확인하세요. 

연동 테스트를 위해 Singular 다양한 도구 모음을 제공합니다.  

구현 도중 테스트하는 경우:

  • Testing Console 사용을 통해 구현하려는 여러 기능을 수동으로 테스트할 수 있으며, 구현하는 동안 실시간으로 테스트할 수 있습니다. 
  • 또는 Charles Proxy와 같은 써드파티 툴을 통해 SSL 프록시를 활성화하여 Singular 데이터가 올바른 시각에 올바른 데이터 포인트를 발생시키는지 확인할 수 있습니다.  

구현 후 테스트하는 경우:

  • SDK audit 리포트를 실행하면, 이는 연동 시 발생하는 모든 문제를 파악하여 검증된 솔루션을 제공합니다.  
  • 로그 추출(Export Logs) 페이지를 통해 유저 레벨 데이터를 다운로드하세요. CSV 파일은 앱의 모든 데이터 파일을 표시하여 앱의 모든 데이터가 올바르게 Singular로 전송되었는지를 표시합니다. 데이터가 이 툴에 제공되기 전까지 약 30분 정도 걸릴 수 있습니다. 
  • 딥링크 테스트How to Test Your Singular SDK Integration(Singular SDK 연동 테스트 방법)의 설명을 따라 테스트하세요.
  • Attribution Details API(어트리뷰션 세부 사항 API)를 사용하여 테스트 이후 디바이스의 상세 내용을 쿼리하세요. 어트리뷰션 데이터가 제공되기 전까지 약 4~6분 정도 소요됩니다. 더 보기.

테스트에 관한 팁은, Singular SDK 연동 테스트 방법을 참고하세요.