Singular SDK 연동

공식 문서를 참조하여 Singular SDK를 쉽게 고객사의 앱에 연동할 수 있습니다.

Settings > SDK Keys 메뉴에서 연동에 필요한 공식 문서를 확인하세요.

SDK Key

이 키는 Singular 서버에서 고객사 계정을 확인하는 데 사용됩니다.

image3.png

개발자 계정

개발자 계정을 사용하면 개발 중 혹은 QA 과정 중에 공식 계정의 데이터가 영향을 받지 않도록 할 수 있습니다. (주의: 기본으로 제공되는 기능이 아니므로 도입을 원하시는 경우 Singular 팀과 상의해주세요.) 개발자 계정이 활성화된 경우 SDK Keys 페이지에서 다음 스크린샷과 같은 형태로 정보를 확인할 수 있습니다.

image4.png

개발자 계정은 개발 중의 앱에 적용할 수 있도록 별도의 SDK key를 제공합니다.

image2.png

주의: App Store에 배포하기 전에 개발자 SDK Key를 반드시 공식 계정의 SDK Key로 전환해야 합니다.

플랫폼별 SDK

Singular 연동을 위해 현재 다음처럼 4가지 방법이 지원됩니다.

SDK Console

SDK Console은 Singular SDK 혹은 Singular의 S2S(서버 투 서버) API에서 보낸 세션 호출과 이벤트 데이터를 표시합니다. 앱에 탑재한 데이터와 세션이 Singular 플랫폼에 수신되었는지 확인할 수 있는 애플리케이션 개발자를 위한 도구입니다.

기기 추가

기기 추가를 위해서는 다음 단계가 필요합니다.

  1. 테스트를 원하는 기기의 플랫폼과 키스페이스를 선택합니다.
  2. ID를 입력하고 "Add"를 클릭합니다.

https___staging01_singular_net__user_rovio_dev_rovio_com__tracking_events.png

기기가 추가되면 이벤트 로그에서 데이터를 수집하기 시작합니다. 여러 기기에서 수집한 로그를 한번에 보기를 원하는 경우 Show와 Hide 버튼을 활용해 주세요. 눈 그림이 활성화된 경우가 Show, 회색으로 비활성화된 경우가 Hide 입니다.

SDK_Console_Preview_Mode_-_InVision.png

Note: 한 번에 20개 기기까지 추가할 수 있습니다.

기기 삭제 및 어트리뷰션 삭제

기기를 삭제하려면 기기 ID에 마우스를 올리고 Delete 버튼을 선택하세요. 이 버튼은 화면에서 전체 이벤트 로그를 삭제하지만, 어트리뷰션 데이터 자체를 삭제하지는 않습니다.

기기의 어트리뷰션 데이터를 삭제하려면 Forget 버튼을 선택하세요. 이 버튼은 해당 기기의 어트리뷰션 데이터를 재설정하므로 동일 기기에서 다시 테스트를 할 수 있습니다.

SDK_Console_Preview_Mode_-_InVision.png

콘솔 사용법

기기를 등록한 후 SDK에서 이벤트를 발생시키면 콘솔에 로그가 나타납니다. 특정 행 아이템의 세부 사항을 보고 싶으면 좌측 삼각형을 클릭해서 드릴 다운할 수 있습니다.

SDK_Console_History_Mode_-_InVision.png

자동 추적 이벤트

명시적으로 추적되는 세션과 이벤트와 함께, SDK에서 자동으로 추적되는 이벤트도 있습니다. 이 이벤트는 디버깅이나 특정 시나리오를 이해하는 데 유용합니다.

SDK 이벤트 이름 정의
__installReferrer__ Android 한정 - 이 이벤트는 가능시 Android install referrer의 페이로드를 포함합니다. Android install referrer가 구현된 경우 이 이벤트는 Android SDK 초기화가 일어난 다음 약간의 시간차를 두고 전송되며, Singular의 어트리뷰션 과정에서 사용됩니다.
__iAd_Attribution__ iOS 한정 - 이 이벤트는 가능시 Apple Search Ads API 응답의 페이로드를 포함합니다. iOS SDK 초기화가 일어난 다음 다음 약간의 시간차를 두고 전송되며, Singular의 어트리뷰션 과정에서 사용됩니다.

질문 사항이 있거나 추가 정보를 원하시는 경우 support@singular.net로 메일을 보내주세요.

도움이 되었습니까?
0명 중 0명이 도움이 되었다고 했습니다.