Ver el código de «SDKs:Referrer:Android:index»

#CÓMO AGREGAR LA LIBRERÍA REFERRER EN ANDROID


== INTRODUCCIÓN. ==


La librería <b>ReferrerLib</b> 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 <b>SpsLib</b>.

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

== VERSIONES DE ANDROID SOPORTADAS. ==


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

== FUNCIONAMIENTO DE LA LIBRERÍA. ==


La librería <b>ReferrerLib</b> 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 <b>SpsLib</b>, o bien a través de una URL creada en la sección  [http://panel.mobeleader.com/index.php?sec=45 Link Management] del Panel de Mobeleader.


Una vez descargada y abierta por primera vez la aplicación, se envía el <i>intent</i> <b>com.android.vending.INSTALL_REFERRER</b> 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 <b><i>maven</i></b> para que sus librerías puedan ser utilizadas en <b><i>Android Studio</i></b>. Para poder usar la librería <b>ReferrerLib</b> es necesario realizar varios cambios, tanto en el archivo <b><i>build.gradle</i></b> como en el <b><i>AndroidManifest.xml</i></b> de su aplicación.

=== Cambios en el archivo <i>build.gradle</i>. ===


En el apartado <b><i>repositories</i></b> deberá añadir:

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

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

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

=== Cambios en el archivo <i>AndroidManifest.xml</i>. ===


Es necesario añadir el siguiente permiso:

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

Añada el siguiente código dentro de la etiqueta <b>application</b>:

    <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 <b>android:value</b> de la etiqueta <b>meta-data</b>, sustituya la cadena <b>"apphash"</b> por el <b>código hash</b> de su aplicación, generado al registrar su aplicación en nuestro panel. Lo puede obtener en la sección [http://panel.mobeleader.com/index.php?sec=6 Mis Aplicaciones], pulsando el icono de la columna <b>"Hash"</b> de su aplicación.
https://panel.mobeleader.com/ficheros_subidos/librerias/imagenes/sps/app_hash.png


En caso de que exista más de un <b><i>receiver</i></b> para el <b><i>intent</i></b> <b>com.android.vending.INSTALL_REFERRER</b> 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>