iOS 프로젝트에 Singular를 추가하려면 다음 단계를 따르세요:

1. 포드파일에 다음 줄을 추가하여 RudderSingular ( 코코아팟을 통해 제공)를 설치합니다:

   pod 'RudderSingular', '~ 1.0.0'

2. 종속성을 추가한 후 pod 설치 명령을 사용하여 원하는 플랫폼에 따라 임포트를 AppDelegate 파일에 추가합니다:

   Swift

   import RudderSingular

   Obj-C

   @import RudderSingular;

3. 앱디렉티브 파일에서 didFinishLaunchingWithOptions 메서드를 업데이트합니다:

   중요:

   • 수동칸컨버전관리 = true로 설정하면 자체 전환 값을 수동으로 업데이트해야 합니다. 이렇게 하면 싱귤러의 SKAN 모델이 사용자를 대신하여 CV 값을 업데이트할 수 없습니다. '관리' 모드를 활성화하려면 이를 'false'로 설정하세요.
   • 기다림 추적 권한 부여와 시간 초과 간격 설정은 앱이 iOS 앱 추적 투명성(ATT) 프롬프트를 사용하는 경우에만 사용해야 합니다. ATT를 표시하는 경우 이 값을 300으로 설정해야 합니다.

   Swift

   let config: RSConfig = RSConfig(writeKey: WRITE_KEY)
               .dataPlaneURL(DATA_PLANE_URL)
   
   RSClient.sharedInstance().configure(with: config)
   let rudderSingularConfig = RudderSingularConfig()
               .skAdNetworkEnabled(true)
               .manualSkanConversionManagement(true)
               .conversionValueUpdatedCallback({ value in
                   print("Your SKAN handler \(value)")
               })
               .waitForTrackingAuthorizationWithTimeoutInterval(300)
   RSClient.sharedInstance().addDestination(RudderSingularDestination(rudderSingularConfig: rudderSingularConfig))
   

   Obj-C

   RSConfig *config = [[RSConfig alloc] initWithWriteKey:WRITE_KEY];
   [config dataPlaneURL:DATA_PLANE_URL];
   
   [[RSClient sharedInstance] configureWith:config];
   RudderSingularConfig *rudderSingularConfig = [[RudderSingularConfig alloc] init];
   [rudderSingularConfig skAdNetworkEnabled:YES];
   [rudderSingularConfig manualSkanConversionManagement:YES];
   [rudderSingularConfig conversionValueUpdatedCallback:^(NSInteger value) {
       printf("Your SKAN handler %ld", value);
   }];
   [rudderSingularConfig waitForTrackingAuthorizationWithTimeoutInterval:300];
   [[RSClient sharedInstance] addDestination:[[RudderSingularDestination alloc] initWithRudderSingularConfig:rudderSingularConfig]];
   

Android 앱에 Singular를 추가하려면 다음 단계를 따르세요:

1. app/build.gradle (모듈: 앱) 파일을 열고 종속성 섹션 아래에 다음을 추가합니다:

   groovy

   implementation 'com.rudderstack.android.sdk:core:[1.0,2.0)'
   implementation 'com.rudderstack.android.integration:singular:1.0.0'
   implementation 'com.google.code.gson:gson:2.8.6'
   

2. 빌드 스크립트에 Singular Maven 플러그인을 추가합니다. 이렇게 하려면 루트 build.gradle의 Gradle 스크립트 섹션에 다음 스니펫을 추가합니다:

   groovy

   buildscript {
       repositories {
           google()
           mavenCentral()
           maven {
             url 'https://maven.singular.net/'
           }
       }
       dependencies {
           classpath 'com.android.tools.build:gradle:7.1.2'
           classpath 'org.jetbrains.kotlin:kotlin-gradle-plugin:1.6.10'
       }
   }
   allprojects {
       repositories {
           google()
           mavenCentral()
           maven {
             url 'https://maven.singular.net/'
           }
       }
   }
   

3. AndroidManifest.xml에 다음 권한(아직 없는 경우)을 추가합니다:

   <uses-permission android:name="android.permission.INTERNET"></uses-permission>
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>

4. 마지막으로 애플리케이션 클래스의 onCreate() 메서드에서 RudderStack SDK를 초기화합니다:

   // initialize Rudder SDK
   val rudderClient =
       RudderClient.getInstance(
           this,
           WRITE_KEY,
           RudderConfig.Builder()
               .withDataPlaneUrl(DATA_PLANE_URL)
               .withFactory(SingularIntegrationFactory.FACTORY)
               .build()
       )
   

React Native 앱에 Singular를 추가하려면 다음 단계를 따르세요:

1. 다음 명령을 실행하여 앱에 RudderStack-Singular 모듈을 추가합니다:

   bash

   npm install @rudderstack/rudder-integration-singular-react-native
   // OR //
   yarn add @rudderstack/rudder-integration-singular-react-native

2. 프로젝트 수준의 android/build.gradle 파일을 열고 다음 스니펫을 추가합니다:

   groovy

   repositories {
     maven {
       url "https://maven.singular.net/"
     }
   }
   

3. 위의 모듈을 가져와서 SDK 초기화에 추가합니다:

   typescript

   import rudderClient from "@rudderstack/rudder-sdk-react-native"
   import singular from "@rudderstack/rudder-integration-singular-react-native"
   const config = {
   	dataPlaneUrl: <data_plane_url>,
   	trackAppLifecycleEvents: true,
   	withFactories: [singular],
   }
   rudderClient.setup(<write_key>, config)

Cordova 앱에 Singular를 추가하려면 다음 단계를 따르세요:

1. 애플리케이션의 루트 폴더로 이동하여 다음 명령을 실행합니다:

   bash

   cordova plugin add rudder-integration-singular-cordova
   

2. 앱 홈 페이지의 onDeviceReady() 함수에 다음 코드를 추가하여 SDK를 초기화합니다:

   javascript

   RudderClient.initialize(<write_key>, {
     dataPlaneUrl: <data_plane_url>,
     factories: [RudderSingularFactory]
   })

   중요: `initialize` 호출과 함께 `await` 키워드를 사용해야 합니다.

RudderClient.getInstance()?.identify("1hKOmRA4el9Zt1WSfVJIVo4GRlm")

RudderClient.getInstance()
    ?.track(
        "Product Reviewed",
        RudderProperty()
            .putValue("product_id", "345676543")
            .putValue("review_id", "123454387")
    )

RudderClient.getInstance()
    ?.track(
        "Order Completed",
        RudderProperty().putValue("revenue", 1251).putValue("currency", "INR")
    )

RudderClient.getInstance()
    ?.screen(
        "Home",
        RudderProperty().putValue("category", "launcher")
    )

RudderClient.getInstance()?.reset();