Integración del SDK

Configurar proyecto

Para integrar nuestro SDK para React Native, es necesario ejecutar el siguiente comando en la raíz del proyecto:
1
npm install @wortise/react-native-sdk --save
Copied!
La última versión del SDK para React Native es la 1.2.1
A continuación, hay que añadir el repositorio Maven en el bloque allprojects > repositories del fichero android/build.gradle:
1
allprojects {
2
repositories {
3
...
4
maven { url 'https://maven.wortise.com/artifactory/public' }
5
}
6
}
Copied!
Por último, si aún no se ha realizado, se debe activar el soporte para MultiDex añadiendo la siguiente línea en el bloque android > defaultConfig del fichero android/app/build.gradle:
1
android {
2
...
3
defaultConfig {
4
...
5
multiDexEnabled true
6
}
7
}
Copied!

Solicitar permisos

El paso siguiente es solicitar los permisos en el lugar que creas mas conveniente. Estos permisos son necesarios para recopilar datos del usuario, y así poder mostrar los mejores anuncios en base a su localización real y atributos varios. Puedes omitir este paso, pero es probable que no se llegue a conseguir el CPM Premium.
En primer lugar, añade los siguientes permisos en el archivo AndroidManifest.xml:
1
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
2
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
3
<uses-permission android:name="android.permission.GET_ACCOUNTS" />
4
<uses-permission android:name="android.permission.READ_CONTACTS" />
5
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
Copied!
Además, si tu aplicación está dirigida a Android 10 o superior (por ejemplo, el valor de targetSdkVersion es 29 o mayor), es necesario añadir el siguiente permiso adicional:
1
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
Copied!
Al añadir el permiso ACCESS_BACKGROUND_LOCATION, Google Play obliga a rellenar la declaración de permisos de ubicación para publicar la app.
La opción más recomendable es obtener la aprobación de Google para poder utilizar dicho permiso.
En caso de no poder obtenerla, puedes declarar temporalmente que la app no cumple actualmente con las políticas de Google Play, para poder utilizar el permiso hasta el próximo 29 de Marzo. Una vez alcanzada esta fecha, deberás publicar una actualización de la app sin el permiso, para cumplir con las políticas de Google Play y evitar cualquier tipo de inconveniente.
Y, por último, realiza la solicitud de los permisos para que los usuarios puedan otorgar su autorización, tal y como se indica en la documentación oficial de React Native.

Ejemplo

Ejemplo de solicitud de permisos en React Native.
1
import { PermissionsAndroid } from 'react-native';
2
3
await PermissionsAndroid.requestMultiple([
4
PermissionsAndroid.PERMISSIONS.ACCESS_FINE_LOCATION,
5
PermissionsAndroid.PERMISSIONS.ACCESS_COARSE_LOCATION,
6
PermissionsAndroid.PERMISSIONS.ACCESS_BACKGROUND_LOCATION,
7
PermissionsAndroid.PERMISSIONS.GET_ACCOUNTS,
8
PermissionsAndroid.PERMISSIONS.READ_CONTACTS,
9
PermissionsAndroid.PERMISSIONS.READ_PHONE_STATE
10
]);
Copied!

Inicializar SDK

Existen dos opciones para realizar la inicialización del SDK:

Opción 1 (recomendado)

La opción más recomendada es realizar la inicialización desde la clase Application de la app. Para ello, hay que integrar el siguiente código en el método onCreate() del fichero MainApplication.java:
1
WortiseSdk.initialize(this, "tu app key");
Copied!

Opción 2

En esta opción, la inicialización del SDK se realizaría directamente desde el código JavaScript del proyecto. Para ello, hay que añadir las siguientes líneas de código en un lugar apropiado:
1
import { RNWortiseSdk } from '@wortise/react-native-sdk';
2
3
await RNWortiseSdk.initialize('tu app key');
Copied!

Detener SDK

En caso de querer detener por completo el SDK (para evitar mostrar anuncios, por ejemplo, a los usuarios que han pagado para no recibirlos), además de no realizar la inicialización, es necesario ejecutar la siguiente línea de código en cualquier momento:
1
RNWortiseSdk.stop();
Copied!
Con ello, el SDK detendrá y cancelará todo proceso pendiente que pudiera acabar resultando en el mostrado de un anuncio.

Compartir datos de los usuarios

Si la aplicación conoce algunos datos de los usuarios (edad, género, etc.), dicha información puede ser compartida con el SDK para que podamos mostrar anuncios de mayor interés, y así poder obtener un eCPM superior.
Para compartir esta información, es necesario hacer uso de los métodos que proporciona la clase RNWortiseDataManager, tal y como se muestra a continuación:
1
import {
2
RNWortiseDataManager,
3
RNWortiseUserGender
4
} from '@wortise/react-native-sdk';
5
6
// Compartir la edad
7
RNWortiseDataManager.setAge(20);
8
9
// Compartir el género
10
RNWortiseDataManager.setGender(RNWortiseUserGender.MALE);
11
12
// Compartir direcciones de email
13
RNWortiseDataManager.setEmails(["[email protected]", "[email protected]"]);
14
15
RNWortiseDataManager.addEmail("[email protected]");
Copied!
Igualmente, se puede hacer uso del método RNWortiseDataManager.requestAccount() para solicitar al usuario que comparta su dirección de email con el SDK.
Última actualización 1mo ago