러더스택은 기업이 고객 데이터를 수집, 연동, 다양한 목적지로 라우팅할 수 있도록 지원하는오픈소스 고객 데이터 플랫폼(CDP)입니다. 고객 데이터 파이프라인을 관리할 수 있는 중앙 집중식 플랫폼을 제공하여 웹사이트, 모바일 앱, 서버, 클라우드 서비스 등 다양한 소스에서 데이터를 쉽게 수집할 수 있습니다.
Singular SDK는 표준 '디바이스 모드 ' 또는 '클라우드 모드' 연동 옵션을 통해서는 사용할 수 없는 많은 기능을 제공합니다.
Singular의 모든 기능을 활용하려면 하이브리드 방법론을 통한 연동을 권장하며, Rudderstack과 Singular를 함께 사용할 때는 하이브리드 방식을 사용하는 것이 좋습니다.
하이브리드 접근 방식은 다음과 같이 구성됩니다:
- Rudderstack과 독립적으로Singular SDK를 구현하여 Singular SDK가 세션 추적, SDK 프레임워크(React Native, Unity 등), SkAdNetwork, 딥링크 및 디퍼드 딥링크, 고급 기능을 추가로 지원할 수 있도록 합니다.
- Singular 대상에 대해 러더스택에서 '클라우드 모드' 옵션을 활성화합니다. 이렇게 하면 모든 러더스택 모바일 트랙 이벤트가 Singular의 데스티네이션으로 전송될 수 있습니다.
아래 지침은 러더스택으로 Singular 하이브리드 구현을 구성하는 방법을 설명합니다.
| 대상 가이드 | 엔지니어링 팀 |
| 전제 조건 | 이 문서에서는 앱에이미 Rudderstack Mobile SDK가 연동되어있다고 가정합니다. |
이 연동을 사용하려면 Rudderstack의 모바일 SDK를 사용 중이어야 합니다.
Singular SDK는 다음을 지원합니다:
- 인스톨 어트리뷰션
- SkAdNetwork 지원
- 구글 인스톨 리퍼러 지원
- 메타 인스톨 리퍼러 지원
- 애플 검색 광고 어트리뷰션
- 맞춤형 인앱 이벤트 추적
- 구매 추적
- 맞춤 사용자 ID
- 글로벌 속성 지원
- 개인정보 보호 옵션
러더스택 "클라우드 모드" 연동은 다음을 지원합니다:
- 커스텀 인앱 이벤트 추적
- 구매 추적
- 사용자 지정 사용자 ID
하이브리드 구성
-
싱귤러 SDK 연동
러더스택과 독립적으로 Singular SDK를 구현하세요. SDK 옵션 및 프레임워크는 여기를 참조하세요.
-
러더스택 - Singular 대상 활성화(클라우드 모드)
여기에서 가이드를 따르세요.
권장 추가 설정
하이브리드 방법론을 사용하는 경우, Rudderstack 익명 아이디와 Rudderstack 사용자 아이디를 Singular의 SDK에 전달하는 것이 좋습니다.
SDK 문서에서 이러한 선택적 기능을 구현할 때 특별히 주의하고 주의를 기울이세요. 사용 중인 프레임워크에 따라 단계가 약간 다를 수 있습니다.
글로벌 속성 구현
러더스택 익명아이디를 Singular 글로벌 프로퍼티에 전달합니다. 이렇게 하면 러더스택 익명아이디가 SDK의 디바이스 수준 데이터에 연결됩니다.
글로벌 프로퍼티는 Singular SDK를 초기화할 때 rudderstack_anonymous_id 키와 러더스택 SDK에서 검색한 러더스택 익명아이디 값으로 구성해야 합니다. 러더스택 익명ID는 다음 메서드 [iOS][Android]를 사용하여 러더스택 SDK에서 가져올 수 있습니다.
[RSClient getInstance].anonymousId;Singular SDK 구성 예시
- (SingularConfig *)getConfig {
// Get the 3rd-party identifiers to set in Global Properties:
// If 3rd-party SDKs are providing any identifiers to Singular, the
// respective SDK must be initialized before Singular.
NSString* thirdPartyKey = @"rudderstack_anonymous_id";
NSString* thirdPartyValue = [RSClient getInstance].anonymousId;
// Singular Config Options
SingularConfig* config = [[SingularConfig alloc]
initWithApiKey:APIKEY andSecret:SECRET];
...
// Using Singular Global Properties feature to capture 3rd-party identifiers
[config setGlobalProperty:thirdPartyKey
withValue:thirdPartyValue overrideExisting:YES];
...
return config;}// (Optional) Get 3rd-party identifiers to set in Global Properties:
// If 3rd-party SDKs are providing any identifiers to Singular, the
// respective SDK must be initialized before Singular.
String thirdPartyKey = new String("rudderstack_anonymous_id");
String thirdPartyValue = new String(RudderClient.getInstance()?.anonymousId);
// Singular Config Options
SingularConfig config = new SingularConfig("SDK KEY", "SDK SECRET")
.withGlobalProperty(thirdPartyKey, thirdPartyValue, true);사용자 지정 사용자 ID 구현
Singular 커스텀 사용자 ID 메서드에 러더스택 사용자 아이디를 전달합니다. 이렇게 하면 러더스택 사용자 아이디가 SDK의 디바이스 수준 데이터에 연결됩니다. Singular SDK 초기화 시 Singular Config 객체에서 이 값을 Singular에 제공하면 Singular가 설치 포스트백에서 UserId를 Rudderstack에 전송할 수도 있습니다. Singular 연동에 사용 중인 SDK 프레임워크 설명서를 자세히 읽어보세요.iOS][Android] 예시
또한 사용자 아이디는 Singular SDK에서 기본적으로 트리거되는 모든 인앱 이벤트와 연결됩니다.
수신된 "클라우드 모드" 이벤트의 경우, Singular는 사용자 지정 사용자 ID를 러더스택 사용자 ID 값에 매핑했습니다.