시작하기 전에: SDK 전제 조건

Singular SDK 연동의 단계를 따르세요 :계획 및 전제 조건의 단계를 따르세요.

이러한 단계는 모든 Singular SDK 연동의 전제 조건입니다.

SDK 설치

프로젝트에 Singular React SDK를 추가하려면:

1. 프로젝트의 루트 디렉토리에서 터미널을 엽니다.

2. 다음 명령을 사용하여 프로젝트에 SDK 패키지를 다운로드합니다:

   npm install singular-react-native --save

3. React Native 0.60 이상을 사용하는 경우 Singular 패키지가 프로젝트에 자동 링크됩니다.

   React Native 버전 0.59 이하를 사용하는 경우 다음을 실행하여 Singular 패키지의 네이티브 브리지 코드를 프로젝트에 링크하세요:

   react-native link singular-react-native

4. Expo를 사용하는 경우: 위에서 설명한 대로 Singular SDK를 설치한 후, app.json 또는 app.config.js의 플러그인 배열에 패키지를 추가합니다:

   "expo": {
     "plugins": ["singular-react-native"]
   }

   그런 다음 엑스포의 네이티브 코드 사용자 지정 가이드를 사용하여 앱을 다시 빌드합니다.

사전 요구 사항 설정

iOS 사전 요구 사항

프로젝트의 루트 디렉토리에서 다음 명령을 실행합니다:

cd ios; pod install

안드로이드 사전 요구 사항

모든 프로젝트 섹션의 build.gradle 파일 내의 모든 프로젝트 섹션에서 앱의 Maven 리포지토리에 다음을 추가합니다:

allprojects {
  repositories {
    maven { url 'https://maven.singular.net/' }
  }
}

앱의 파일에 다음 권한을 추가합니다. AndroidManifest.xml 파일에 다음 권한을 추가합니다:

<!-- Permission to access the internet -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- Permission to access network state -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- Permission needed to retrieve Google Play Referrer data -->
<uses-permission android:name="com.google.android.finsky.permission.BIND_GET_INSTALL_REFERRER_SERVICE" />
<!-- Permission needed to retrieve data from the Google licensing API -->
<uses-permission android:name="com.android.vending.CHECK_LICENSE" />
<!-- Permission to access the Google Advertising ID (for Android 12/API level 31 or higher) -->
<uses-permission android:name="com.google.android.gms.permission.AD_ID" />

Singular SDK에 대한 전이 종속성을 비활성화한 경우 앱의 build.gradle.

implementation 'com.android.installreferrer:installreferrer:2.2'
implementation 'com.google.android.gms:play-services-appset:16.0.0'

SDK 연동

앱을 열 때마다 SDK 초기화 코드를 호출해야 합니다. 이는 모든 Singular 어트리뷰션 기능의 전제 조건이며, 또한 새로운 사용자 세션을 Singular로 전송합니다. 세션은 사용자 리텐션을 계산하는 데 사용됩니다.

Singular 라이브러리 가져오기

App.js 파일에 다음 코드를 추가하여 Singular 및 Singular컨피그 클래스를 임포트합니다.

import {Singular, SingularConfig, Events, Attributes} from 'singular-react-native';

Singular SDK 초기화하기

1. Singular SDK를 초기화하기 전에 SingularConfig 객체를 만들어야 합니다. 이 객체에는 SDK 키와 SDK 비밀 번호가 포함되어 있습니다(Singular 계정에 로그인하고"개발자 도구 > SDK 연동 > SDK 키"로 이동하여 얻을 수 있습니다).
2. 선택적으로 다양한 SDK 기능을 활성화하는 설정을 추가할 수 있습니다.
3. 메타 인스톨 리퍼러 어트리뷰션 지원

   "메타 인스톨 리퍼러" 어트리뷰션을 활성화하는 데 필요한 SDK 구성입니다 :

   1. Singular 구성 개체에서 Facebook 앱 ID를 입력합니다.
      

      // To enable META Install Referrer
      
      config.withFacebookAppId('INSERT YOUR FACEBOOK APP ID HERE');

   앱의 Facebook 앱 ID는 어디에서 찾을 수 있나요?
4. 그런 다음 init 메서드를 사용하여 SDK를 초기화하여 SingularConfig 객체를 전달합니다.

예를 들어

const config = new SingularConfig('<SDK KEY>', '<SDK SECRET>');
  
// Optional settings:

// Set user ID if known at time of initialization

 config.withCustomUserId('274e9db5c836093499df921be5'); 
// To enable META Install Referrer

 config.withFacebookAppId('Insert your Facebook App ID here');
// Enables deep linking

 config.withSingularLink(callBackFunction); 
// iOS - Enable SKAdNetwork

 config.withSkAdNetworkEnabled(true);  
// iOS - Wait 5m for tracking authorization before sending any events

 config.withWaitForTrackingAuthorizationWithTimeoutInterval(300);
  
 Singular.init(config);

Singular.init(config);