Singular React Native SDK | |
---|---|
다운로드 | Singular React Native SDK 1.1.6 버전 |
호환성 | React Native 0.46.4+ |
연동 가이드 |
소개
딥링크란 앱 내의 특정 컨텐츠로 연결하는 링크를 의미합니다. 유저가 앱이 설치된 디바이스에서 딥링크를 클릭하면 앱의 특정 컨텐츠가 열리면서 유저를 특정 프로덕트로 인도하거나 유저에게 특정 경험을 제공할 수 있습니다.
Singular 트래킹 링크에는 이러한 딥링크와 디퍼드 딥링크를 포함할 수 있습니다. 자세한 내용은 딥링크 FAQ나 Singular 링크 FAQ를 참조하세요.
본 가이드는 다음 내용을 안내합니다.
- 앱이 열렸을 때 이를 유발한 트래킹 링크에 접근합니다.
- 딥링크 목적지를 읽습니다.
- 의도한 컨텐츠를 보여 줍니다.
주의: 본 문서는 2019년 도입된 Singular의 새로운 트래킹 링크 기술인 Singular 링크를 사용하는 고객사 기준으로 기술되었습니다.
이전 고객사는 Singular 링크 대신 이전 트래킹 링크(레가시 링크)를 사용하고 있을 수 있습니다. 이 경우 레가시 링크로 딥링크 처리 항목을 참조하세요.
Singular 링크 활성화
Android와 iOS에서 딥링크를 활성화하려면 Singular 링크 필수 조건 문서의 지시 사항을 따르세요.
Singular 링크 처리
Singular SDK는 핸들러 동작 원리를 사용해서 앱을 열리게 한 트래킹 링크의 세부 사항을 확인합니다.
핸들러는 다음 단계를 통해 사용할 수 있습니다.
- 다음 예제처럼 SingularConfig 오브젝트 생성시 withSingularLinks를 호출합니다. 이 오브젝트는 Singular 링크 핸들러를 등록합니다.
- 다음 예제처럼 핸들러 내에서 SingularLinksParams 오브젝트를 받는 콜백 함수를 호출하거나 정의합니다. SingularLinksParams에는 다음 필드가 포함됩니다.
- deeplink - 딥링크 어드레스, 파싱해서 유저에게 의도한 프로덕트나 유저 경험을 제공
- passthrough - 딥링크에 패스스루 파라미터가 추가된 경우
- iisDeferred - 디퍼드 딥링크인 경우 true
const config = new SingularConfig('<API_KEY>', '<SECRET>');
config.withSingularLink(singularLinksParams => {
const deeplink = singularLinksParams.deeplink;
const passthrough = singularLinksParams.passthrough;
const isDeferred = singularLinksParams.isDeferred;
// Add your code here to handle the deep link
});
Singular.init(config);
연동 가이드 |