싱귤러 SDK 연동: 계획 및 전제사항

다음은 모든 싱글 SDK 연동필요한 사전 단계입니다.

SDK 연동 계획, 개발용 앱 등록, 링크 추적용 도메인 만들기, 개발 중 및 개발 후 연동 테스트 방법 계획하기 등을 알아보세요.

다음 사용자를 위한 가이드 비즈니스/마케팅 팀
1

SDK 연동 계획 세우기

싱귤러 SDK 통합을 시작하기 전에 마케팅/비즈니스 팀은 다음 질문에 답해야 합니다.이를 통해 개발팀은 어떤 SDK 기능을 활성화할지 알 수있습니다.

이 앱이 명시적으로 어린이를 대상으로 하나요?

아동용 앱은 아동의 개인정보를 보호하기 위해 Play 스토어 및 앱 스토어 정책을 준수해야 합니다. 기기 식별자를 캡처하지 않음으로써 이러한 정책을 준수하는 데 도움이 되는 싱귤러의 키즈 앱 SDK를 사용하는 것이 좋습니다.

앱에서 딥링크를 처리하나요?

예. 싱귤러 링크 전제조건의 지침을 따르고 관련 SDK 가이드에 설명된 대로 코드에 딥링크 핸들러를 구현하세요.

앱이 사용자 이벤트를 추적하나요?

싱귤러는 인앱 이벤트에 대한 데이터를 수집하여 캠페인의 성과를 분석하고 KPI를 측정하는 데 도움을 줄 수 있습니다. 예를 들어, 게임 앱에서 사용자 로그인, 등록, 튜토리얼 완료 또는 레벨 업에 대한 데이터를 수집하고자 할 수 있습니다.

표준 이벤트

싱귤러는 다양한 표준 이벤트를 지원합니다. 일반적으로 사용되는 이러한 이벤트는 보고 및 최적화를 위해 애드 네트워크에서 지원하는 경우가 많습니다. 또 다른 장점은 표준 이벤트 이름을 사용하면 수동으로 정의할 필요 없이 Singular가 자동으로 인식하여 이벤트 목록에 추가한다는 것입니다. 가능하면 표준 이벤트를 사용하는 것이 좋습니다.

각 표준 이벤트에 대해 표준 권장 속성을 전달해야 합니다. 예를 들어, sng_content_view이벤트(고객이 제품을 조회)의 경우 sng_attr_content_type, sng_attr_content_idsng_attr_content 속성을 전달해야 합니다.

싱귤러로 전송되는 이벤트 목록(함께 제공되는 속성 포함)은 마케팅 KPI에 따라 UA/마케팅/비즈니스 팀에서컴파일해야 합니다. 다음 가이드는 이벤트 전략을 수립하는 데 도움이 됩니다:

중요: 앱에 싱글 SDK를 통합할 때 개발자 팀은 개발 플랫폼에 따라 약간 다른 버전의 이벤트/속성 이름(대문자, 밑줄 없음 등)을 사용해야 할 수 있습니다. iOS, 안드로이드, 유니티, 리액트, 플러터에 대한 이벤트 및 속성 이름 목록을 참조하세요.

사용자 지정 이벤트

Singular의 표준 이벤트와 일치하지 않는 이벤트를 측정하려는 경우, 사용자 지정 이름으로 사용자 지정 이벤트를 정의할 수 있습니다.

개발팀은 어떤 사용자 지정 이름이라도 사용할 수 있습니다(최대 32자). 최적화를 위해 싱귤러에서 이벤트를 수신할 수 있는 애드 네트워크 파트너와의 호환성을 위해 영어로 된 이름을 사용하는 것이 좋습니다.

팁: 마케팅 관련 목적으로 이벤트를 추적해야 하는 경우에만 Singular로 이벤트를 보내세요. 이벤트가 캠페인 성과 또는 사용자 가치에 대한 KPI로 중요하지 않은 경우, 해당 이벤트는 Singular에서 추적하지 않아야 합니다.

(iOS) 앱에서 SKAdNetwork를 구현할 예정인가요?

예. SDK 메소드를 사용하여 관리 모드 (싱귤러가 전환 값을 업데이트하는 경우) 또는 수동 모드 (사용자가 직접 전환 값을 업데이트하는 경우)에서 SKAN을 활성화할 수 있습니다.

(iOS) 앱에서 사용자에게 추적 정보 공유(ATT) 권한을 요청하나요?

사용자가 디바이스 ID 공유에 동의하면 인스톨을 올바르게 어트리뷰션하는 데 도움이 되므로 ATT 프롬프트를 표시하는 것이 좋습니다.

ATT 프롬프트를 표시하는 경우, 사용자가 응답할 때까지 앱에서 Singular의 초기화를 지연하도록 SDK를 구성해야 합니다.

2

개발/테스트 앱 등록

앱 번들 식별자

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

이를 염두에 두고 테스트 앱에 다른 번들 식별자를 사용하여 최종 프로덕션 앱과 데이터를 분리하여 보관하는 것이 좋습니다.

예를 들어 프로덕션 앱에서 번들 식별자 com.myapp을 사용하는 경우 개발 단계에서는 com.myapp.dev를 사용할 수 있습니다. 그런 다음 앱 스토어에 앱을 출시하기 전에 번들 ID를 프로덕션 버전으로 다시 변경할 수 있습니다.

앱 등록 단계

  1. 싱귤러 플랫폼에서 설정 > 앱으로이동하여 새 앱 추가를 클릭합니다.
  2. 개발 앱의 앱 이름을 입력합니다. 번들 ID를 사용하는 것이 좋습니다.
  3. 앱 플랫폼에 해당하는 OS를 선택합니다.
  4. 번들 ID 옵션을 사용하여 앱을 식별하고 번들 식별자의 개발 버전을 입력합니다. 앱을 저장합니다.
  5. iOS 앱의 경우: 앱을 저장한 후 앱 이름 옆의 화살표를 클릭하여 앱 세부 정보를 확인하고 고급 설정 표시 옵션을 토글합니다. 유니버설 링크 및 딥링킹에 필요한 TeamID 스키마를 추가합니다.

앱 개발 및 테스트를 완료한 후 번들 ID를 프로덕션 버전으로 업데이트하고, 마케팅 팀이 앱 구성 FAQ의 지침에 따라 프로덕션 앱을 추가하도록합니다.

3

링크 도메인 생성(아직 없는 경우)

단일 링크(단일 추적 링크)의 구조는 다음과 같으며, 여기서 [서브도메인]은 사용자가 선택합니다:

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

예를 들어, Jewel Rush라는 앱을 마케팅하는 캠페인의 경우 "jewelrush.sng.link" 도메인을 만들 수 있습니다. 그런 다음 이 도메인을 사용하여 다음 구조의 추적 링크를 만들 수 있습니다:

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

모든 링크에 하나의 도메인을 사용하거나 여러 개의 도메인을 생성하여 서로 다른 용도로 사용할 수 있습니다. 어떤 경우든 단일 추적 링크를 사용하려면 도메인이 하나 이상 필요합니다.

링크 도메인은 마케팅 캠페인에 노출되므로 조직의 마케팅 팀이 링크 도메인을 결정할 때 참여해야 합니다.

iOS 앱에 싱글 SDK를 통합할 때는 Xcode 연관 도메인 설정에서 링크 도메인을 다음과 같은 형식으로 추가해야 합니다:

applinks:[DOMAIN].sng.link

싱글 링크 전제 조건도 참조하세요.

4

연동 테스트 방법 알아보기

Singular SDK/S2S를 앱에 통합할 때는 새 버전의 앱을 출시하기 전에 앱이 올바르게 작동하는지 확인하는 것이 중요합니다.

싱귤러는 연동 테스트를 위한 다양한 도구를 제공합니다:

구현 중 테스트:

  • 구현하는 다양한 기능을 실시간으로 구현하면서 수동으로 테스트할 수 있는 테스트 콘솔을 사용하세요.
  • 또는 SSL 프록시가 활성화된 찰스프록시와 같은 타사 도구를 사용하여 싱귤러 데이터가 올바른 데이터 포인트와 함께 정확한 시간에 트리거되는지 확인할 수 있습니다.

구현 후 테스트:

더 많은 테스트 팁은 싱글 SDK 연동 테스트 방법을 참조하세요.