Siga estos pasos para añadir Singular a su proyecto iOS:

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

   pod 'RudderSingular', '~ 1.0.0'

2. Después de añadir las dependencias seguidas del comando pod install, añade las importaciones a tu archivo AppDelegate dependiendo de tu plataforma preferida:

   Swift

   import RudderSingular

   Obj-C

   @import RudderSingular;

3. En su archivo AppDelegate actualice el método didFinishLaunchingWithOptions:

   Importante:

   • Si establece manualSkanConversionManagement = true, deberá actualizar manualmente sus propios valores de conversión. Esto NO permitirá que el Modelo SKAN de Singular actualice los valores de CV en su nombre. Establezca este valor en "false" para activar el modo "gestionado".
   • La configuración de waitForTrackingAuthorizationWithTimeoutInterval sólo debe utilizarse si la aplicación utiliza el aviso de transparencia de seguimiento de aplicaciones de iOS (ATT). Si está mostrando ATT, entonces esto se debe establecer 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 añadir Singular a su aplicación Android, siga estos pasos:

1. Abra el archivo app/build.gradle (Módulo: app) y añada lo siguiente en la sección de dependencias:

   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. Añade el plugin Singular Maven a tu script de compilación. Para ello, añade 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. Añade los siguientes permisos (si no están ya 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, inicialice el SDK RudderStack en el método onCreate() de su clase Application:

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

Para añadir Singular a tu aplicación React Native, sigue estos pasos:

1. Añada el módulo RudderStack-Singular a su aplicación ejecutando el siguiente comando:

   bash

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

2. Abre tu archivo android/build.gradle a nivel de proyecto y añade el siguiente snippet:

   groovy

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

3. Importa el módulo anterior y añádelo a la inicialización de tu 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)

Para añadir Singular a su aplicación Cordova, siga estos pasos:

1. Vaya a la carpeta raíz de su aplicación y ejecute el siguiente comando:

   bash

   cordova plugin add rudder-integration-singular-cordova
   

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

   javascript

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

   Importante: Asegúrese de utilizar la palabra clave `await` con la llamada `initialize`.

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