SDKs:Referrer:Android:index

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

INTRODUCCIÓN.

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

Se guardará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 1.6 o DONUT.

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 de un anuncio lanzado a través de la librería SpsLib.

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 los datos de la URL a través de la cual se haya realizado la descarga.

INSTALACION DE LA LIBRERIA.

Mobeleader dispone 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 'http://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
   compile 'com.mobeleader.utils:UtilsLib:+'
   //noinspection GradleDynamicVersion
   compile 'com.mobeleader.referrer:ReferrerLib:+'

Cambios en el archivo AndroidManifest.xml.

Es necesario añadir los siguientes permisos:

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

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

A continuación añada el siguiente meta-data:

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

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 el Panel de Mobeleader. Lo puede obtener en la sección [Mis Aplicaciones](http://panel.mobeleader.com/index.php?sec=6), pulsando el icono de la columna "Hash" de su aplicación.

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

   <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 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>