SDKs:Referrer:Android:index

1. CÓMO AGREGAR LA LIBRERÍA REFERRER EN ANDROID

INTRODUCCIÓN.

La librería ReferrerLib se encarga de registrar las referencias de descarga de la aplicación. Estas referencias llagan a través de una URL, siempre y cuando esa URL provenga de un anuncio lanzado desde la librería SpsLib.

Se registrarán: el terminal de descarga, el anuncio a través del cual se haya realizado la descarga y la aplicación desde la que se haya visualizado el anuncio.

VERSIONES DE ANDROID SOPORTADAS.

Esta librería soporta todas las versiones de Android superiores a la version 4.0 (API level 14 y nombre en código Ice Cream Sandwich).

FUNCIONAMIENTO DE LA LIBRERÍA.

La librería ReferrerLib actúa solo la primera vez que se abre la aplicación en la que ha sido integrada.

Para que actúe la librería ha de cumplirse lo siguiente:

• Google Play Store, ya sea la web o la aplicación, ha de haber sido abierta a través de una URL.

• La URL de descarga debe provenir, o bien de un anuncio lanzado a través de la librería SpsLib, o bien a través de una URL creada en la sección Link Management del Panel de Mobeleader.

Una vez descargada y abierta por primera vez la aplicación, se envía el intent com.android.vending.INSTALL_REFERRER y la librería recoge y registra los datos de la URL a través de la cual se haya realizado la descarga.

INSTALACION DE LA LIBRERIA.

Disponemos de un repositorio maven para que sus librerías puedan ser utilizadas en Android Studio. Para poder usar la librería ReferrerLib es necesario realizar varios cambios, tanto en el archivo build.gradle como en el AndroidManifest.xml de su aplicación.

Cambios en el archivo build.gradle.

En el apartado repositories deberá añadir:

   repositories {
       mavenCentral()
       maven { url 'https://maven.mobeleader.com' }
   }

La librería ReferrerLib utiliza la librería auxiliar UtilsLib. Por tanto, para utilizar la librería ReferrerLib en su aplicación, en el apartado dependencies deberá añadir:

   //noinspection GradleDynamicVersion
   implementation 'com.mobeleader.utils:UtilsLib:+'
   //noinspection GradleDynamicVersion
   implementation 'com.mobeleader.referrer:ReferrerLib:+'

Cambios en el archivo AndroidManifest.xml.

Es necesario añadir el siguiente permiso:

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

Añada el siguiente código dentro de la etiqueta application:

   <meta-data android:name="app_hash" android:value="appHash" />

   <receiver
   	android:name="com.mobeleader.referrer.ReferrerLib"
   	android:exported="true"
   	android:permission="android.permission.INTERNET">
   	<intent-filter>
   		<action android:name="com.android.vending.INSTALL_REFERRER" />
   	</intent-filter>
   </receiver>

En el android:value de la etiqueta meta-data, sustituya la cadena "apphash" por el código hash de su aplicación, generado al registrar su aplicación en nuestro panel. Lo puede obtener en la sección Mis Aplicaciones, pulsando el icono de la columna "Hash" de su aplicación.

En caso de que exista más de un receiver para el intent com.android.vending.INSTALL_REFERRER añádalo de la siguiente manera:

   <receiver
   	android:name="com.mobeleader.referrer.ReferrerLib"
   	android:exported="true"
   	android:permission="android.permission.INTERNET">
   	<intent-filter>
   		<action android:name="com.android.vending.INSTALL_REFERRER" />
   	</intent-filter>
   </receiver>
   <receiver
   	android:name="com.google.android.apps.analytics.AnalyticsReceiver"
   	android:exported="true"
   	android:permission="android.permission.INTERNET">
   	<intent-filter>
   		<action android:name="com.android.vanding.INSTALL_REFERRER" />
   	</intent-filter>
   </receiver>