단일 SDK 통합하기: 계획 및 전제 조건

문서

다음은 모든 Singular SDK 연동을 위해 필요한 사전 단계입니다.

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

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

SDK 연동 계획 세우기

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

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

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

앱이 딥링크를 처리하나요?

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

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

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

표준 이벤트

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

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

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

중요: 앱에 Singular SDK를 연동할 때 개발자 팀은 개발 플랫폼에 따라 약간 다른 버전의 이벤트/속성 이름 (대문자, 밑줄 없음 등)을 사용해야 할 수 있습니다. iOS, Android, Unity, React Flutter용 이벤트 및 어트리뷰트 이름 목록을 참조하세요.

사용자 지정 이벤트

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

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

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

(iOS) 앱에 SKAdNetwork가 구현되나요?

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

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

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

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

2

개발/테스트 앱 등록

앱 번들 식별자

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

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

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

앱을 등록하는 단계

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

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

3

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

Singular 링크(Singular 추적 링크)는 다음과 같은 구조를 가지며, 여기서 [SUBDOMAIN]은 사용자가 선택합니다:

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

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

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

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

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

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

applinks:[DOMAIN].sng.link

참조: Singular 링크 전제 조건 참조.

4

연동 테스트 방법 알아보기

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

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

구현 중 테스트:

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

구현 후 테스트:

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