Para agregar Singular a tu aplicación de Cordova, sigue estos pasos:

1. Navega a la carpeta raíz de tu aplicación y ejecuta el siguiente comando:

   bash

   cordova plugin add rudder-integration-singular-cordova
   

2. Agrega el siguiente código en la función onDeviceReady() de la página de inicio de tu aplicación para inicializar el SDK:

   javascript

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

   Importante: Asegúrate de usar la palabra clave `await` con la llamada `initialize` .

Para agregar Singular a tu aplicación de iOS, sigue estos pasos:

1. En tu Podfile , agrega las siguientes dependencias:

   ruby

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

2. Después de agregar las dependencias, seguido del comando pod install , agrega los siguientes imports a tu archivo AppDelegate.m :

   Obj-C

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

3. Inicializa tu 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]];
   

Sigue estos pasos para agregar Singular a tu proyecto de iOS:

1. Instala RudderSingular (disponible a través de CocoaPods ) agregando la siguiente línea a tu Podfile :

   pod 'RudderSingular', '~> 1.0.0'

2. Después de agregar las dependencias, seguido del comando pod install , agrega los imports a tu archivo AppDelegate según la plataforma que prefieras:

   Swift

   import RudderSingular

   Obj-C

   @import RudderSingular;

3. En tu archivo AppDelegate, actualiza el método didFinishLaunchingWithOptions:

   Importante:

   • Establecer manualSkanConversionManagement = true requerirá que actualices manualmente tus propios Conversion Values. Esto NO permitirá que el modelo SKAN de Singular actualice los valores de CV en tu nombre. Establécelo en "false" para habilitar el modo "administrado".
   • Establecer waitForTrackingAuthorizationWithTimeoutInterval solo debe usarse si tu aplicación utiliza el prompt de iOS App Tracking Transparency (ATT). Si vas a mostrar ATT, entonces debe establecerse en un valor de 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]];
   

Para agregar Singular a tu aplicación de Android, sigue estos pasos:

1. Abre tu archivo app/build.gradle (Module: app ) y agrega lo siguiente en la sección 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. Agrega el plugin de Singular Maven a tu script de compilación. Para hacerlo, agrega el siguiente fragmento en la sección Gradle Scripts de tu build.gradle raíz:

   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. Agrega los siguientes permisos (si aún no están presentes) a tu AndroidManifest.xml :

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

4. Por último, inicializa el SDK de RudderStack en el método onCreate() de la clase Application :

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