要将 Singular 添加到您的 Cordova 应用，请按照以下步骤操作：

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` 关键字。

要将 Singular 添加到您的 iOS 应用，请按照以下步骤操作：

1. 在您的 Podfile 中，添加以下依赖项：

   ruby

   pod 'Singular-SDK', '11.0.4'
   pod 'Rudder-Singular', '1.0.0'

2. 在添加依赖项并执行 pod install 命令后，将以下导入语句添加到您的 AppDelegate.m 文件中：

   Obj-C

   //Objective-C
   #import <rudder>
   #import <ruddersingularfactory.h>

3. 初始化您的 RSClient ：

   Obj-C

   //Objective-C
   RSConfigBuilder *configBuilder = [[RSConfigBuilder alloc] init];
   [configBuilder withDataPlaneUrl:<data_plane_url>];
   [configBuilder withFactory:[RudderSingularFactory instance]];
   RSClient *rudderClient = [RSClient getInstance:<write_key> config:[configBuilder build]];
   

按照以下步骤将 Singular 添加到您的 iOS 项目中：

1. 通过在您的 Podfile 中添加以下行来安装 RudderSingular （可通过 CocoaPods 获取）：

   pod 'RudderSingular', '~> 1.0.0'

2. 在添加依赖项并执行 pod install 命令后，根据您首选的平台，将导入语句添加到您的 AppDelegate 文件中：

   Swift

   import RudderSingular

   Obj-C

   @import RudderSingular;

3. 在您的 AppDelegate 文件中更新 didFinishLaunchingWithOptions 方法：

   重要提示：

   • 设置 manualSkanConversionManagement = true 将要求您手动更新自己的 Conversion Value。这将不允许 Singular 的 SKAN 模型代您更新 CV 值。将此项设置为 "false" 以启用"托管"模式。
   • 仅当您的应用使用 iOS App Tracking Transparency（ATT）提示时，才应设置 waitForTrackingAuthorizationWithTimeoutInterval 。如果您显示 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]];
   

要将 Singular 添加到您的 Android 应用，请按照以下步骤操作：

1. 打开您的 app/build.gradle （模块： app ）文件，并在 dependencies 部分下添加以下内容：

   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 Scripts 部分：

   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. 最后，在您的 Application 类的 onCreate() 方法中初始化 RudderStack SDK：

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

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();