Integración de SDK de AppsFlyer - Android

  • Los anunciantes
  • Desarrolladores

Android.pngSDK Version:  4.8.18 (Release Notes)

1. Resumen

El SDK de AppsFlyer proporciona la instalación de aplicaciones y la funcionalidad de rastreo de eventos. Hemos desarrollado un SDK que es altamente robusto (más de 7,000 millones de instalaciones SDK hasta la fecha), seguro, liviano y muy fácil de integrar.

Puedes realizar un rastreo de instalaciones, actualizaciones y sesiones, y también rastrear eventos in-app adicionales más allá de las instalaciones de aplicaciones (incluidas las compras in-app, niveles de juegos, etc.) para evaluar el ROI y los niveles de engagement del usuario.

El SDK de Android de AppsFlyer es compatible con la version 2.3 Android OS en adelante.

Si estás migrando desde la versión V.3.3.x del SDK de AppsFlyer para Android Haz clic aquí.

 Consejo

  • Los capítulos 2 y 3 es  OBLIGATORIO implementar la integración BÁSICA DEL SDK , por ejemplo la instalación de atribución únicamente.
  • El capítulo de Tracking de in-app events RECOMENDAMOS implementarlo.
  • El resto de las características descriptas son OPCIONALES implementarlas, sin embargo algunas de ellas puede que sean necesarias para usted, dependiendo de la lógica de negocios en su app. Por ejemplo, tracking revenueobteniendo la data de conversion en el primer lanzamiento, pueden ser vitales para el flujo de su app.

2. Inicio rápido

2.1 SDK Download

Para descargar el último SDK jar Android de AppsFlyer, haz click aquí.

Para verificar la integridad de la descarga del SDK, haz click aquí.

Para obtener más información sobre la aplicación de muestra de AppsFlyer, haz clic aquí.

2.2 Incorporar el SDK en la aplicación

Puedes integrar el SDK de AppsFlyer automáticamente usando Dependency Management de Gradle o manualmente como SDK.jar.

2.3 Agregar el SDK a tu proyecto

La forma más sencilla de integrar el SDK en tu proyecto es mediante el uso de Dependency Management de Gradle. La información de la versión la puedes encontrar aquí.

Si no estás utilizando Gradle, descárgalo y agrega AF-Android-SDK.jar a la ruta de clase del proyecto.

Agregando la Dependencia del SDK de AppsFlyer para Android:

  1.  Abre tu proyecto (o crea un nuevo proyecto), y luego abre your_app | build.gradle
  2.  Add this to Module-level /app/build.gradle before dependencies:
repositorios { 
    mavenCentral()
}
  1. Agrega la implementación de dependencias con el último SDK de AppsFlyer.
  2. Agrega el siguiente Module-level /app/build.gradle luego del repositorio:
dependencias

 ¡Importante!

  • La dependencia 'com.android.installreferrer:installreferrer:1.0' es necesaria para darle soporte a la API de referencia de Instalación de Google Play. El uso de esta API mejora la precisión de atribución, protege contra las instalaciones fraudulentas y más.
  • La API es compatible con el SDK de AppsFlyer para Android versión 4.8.6 en adelante. Si estás actualizando con una versión anterior del SDK completa la integración de esta nueva dependencia actualizando el método de inicio del SDK.
  • Developers que estén utilizando ProGuard y quieran usar la nueva referrer API Google's deben configurar la siguiente regla ProGuard: -dontwarn com.android.installreferrer
  • Developers que no estén utilizando gradle build o aar y quieran usar la nueva referrer API de Google's deben agregarlo manualmente com.android.installreferrer jar como archivo, y asegurar que los siguientes permisos sean agregados: com.google.android.finsky.permission.BIND_GET_INSTALL_REFERRER_SERVICE

2.4 Configuración de los permisos requeridos

El AndroidManifest.xml debería incluir los siguientes permisos:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- Optional : -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

2.5 Configuración de BroadcastReceiver en AndroidManifest.xml

Las siguientes dos opciones están disponibles para implementar el receptor de transmisión de referencia de instalación:

Uso de un Solo Receptor de Transmisión Uso de un Receptor de Transmisión Múltiple

Si no tienes un receptor escuchando en el INSTALL_REFERRER, en el AndroidManifest.xml, agrega el siguiente receptor dentro de la etiqueta de la aplicación:

<application
...
...

	<receiver android:name="com.appsflyer.SingleInstallBroadcastReceiver" android:exported="true">
		<intent-filter>
			 <action android:name="com.android.vending.INSTALL_REFERRER" />
		 </intent-filter>
	</receiver>

...
...
</application>

 Consejo

If you get the error "Unresolved class SingleInstallBroadcastReceiver" after adding the receiver to AndroidManifest.xml, make sure to build the app first.

3. SDK Initialization

Initialization of the SDK is completed in two stages. In the first stage the DevKey is supplied along with an optional conversionDataListener. In the second stage the call to startTracking indicates that all relevant preparations are complete (e.g. call setCustomerUserId) and the SDK can start tracking all events.

Para inicializar el SDK, agrega el siguiente código en tu función ApplicationonCreate() :

import com.appsflyer.AppsFlyerLib;
import com.appsflyer.AppsFlyerConversionListener;

public class AFApplication extends Application {
   private static final String AF_DEV_KEY = "";
   @Override
   public void onCreate() {
       super.onCreate();
       AppsFlyerConversionListener conversionDataListener = 
       new AppsFlyerConversionListener() {
           ...
       };
       AppsFlyerLib.getInstance().init(AF_DEV_KEY, conversionDataListener, getApplicationContext());
       AppsFlyerLib.getInstance().startTracking(this);   }
}

 Nota

Como alternativa, puedes retrasar la llamada a startTracking y colocarla dentro de cualquier función relevante de Activity OnCreate ().

 Consejo

La siguiente dependencia: compile 'com.android.installreferrer:installreferrer:1.0' Y el getApplicationContext() que se pasa en el siguiente método: AppsFlyerLib.getInstance().init(AF_DEV_KEY, getConversionListener(), getApplicationContext()); son los requisitos previos para reportar la Nueva API de referencia de Google a AppsFlyer.

Puedes acceder a tu clave de desarrollo desde el Panel de control de AppsFlyer en la sección de Configuración dentro de Configuración de la aplicación:

Esta API permite que AppsFlyer detecte instalaciones, sesiones y actualizaciones.

4. Rastreando Eventos In-App

In-App Events provide insight on what is happening in your app. It is recommended to take the time and define the events you would like to measure to allow you to track ROI (Return on Investment) and LTV (Lifetime Value).

Tracking in-app events is performed by calling trackEvent with event name and value parameters. See In-App Events documentation for more details.

 Nota

El nombre para el evento In-App no debe tener más de 45 caracteres. Los nombres de eventos con más de 45 caracteres no aparecerán en el panel de control, sino solo en las API de pull y push y de raw data.

//context - use getApplicationContext()
//eventName is any string to define the event name.
//eventValues is a map of event parameters that comprise a rich event.  
public static void trackEvent(Context context, String eventName, Map eventValues);


Ejemplo
: Level Achieved In-App Event

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.LEVEL,9);
eventValue.put(AFInAppEventParameterName.SCORE,100);
AppsFlyerLib.getInstance().trackEvent(context,AFInAppEventType.LEVEL_ACHIEVED,eventValue);

Esto genera un evento de tipo af_level_achieved con los siguientes valores de evento:
{af_level: 9, af_score: 100}

 Nota

  • AppsFlyer admite caracteres no ingleses con eventos in-app o con cualquier otra API de SDK a partir de la versión 4.8.1 del SDK de Android.
  • No agregues símbolos de divisas ni comas a las cifras, ya que estos no se podrán reconocer.

 Ejemplo de Uso

Map<String,Object> eventValues = new HashMap<>();
eventValues.put(AFInAppEventParameterName.REVENUE, 1200);
eventValues.put(AFInAppEventParameterName.CURRENCY, "JPY");
AppsFlyerLib.getInstance().trackEvent(this, AFInAppEventType.PURCHASE, eventValues);

5. Rastreo de Conexiones Profundas

 Consejo

Te recomendamos encarecidamente integrar las Conexiones Profundas en tu aplicación. Las Conexiones Profundas son una parte crucial de las campañas de retargeting y son altamente recomendables al realizar dichas campañas.

Para cada actividad que se pueda usar para conexiones profundas (incluyendo la actividad principal de ser necesario) agrega la siguiente línea a onCreate():

AppsFlyerLib.getInstance().sendDeepLinkData(this);

Las actividades pensadas para ser abiertas por conexiones profundas deberían tener el siguiente filtro de intención en las definiciones de actividad en el archivo de manifiesto. 

<intent-filter>
   <action android:name="android.intent.action.VIEW" />
   <category android:name="android.intent.category.DEFAULT" />
   <category android:name="android.intent.category.BROWSABLE" />
   <data android:scheme="yourUniquescheme" />
</intent-filter>


El 
Esquema configurado se correlaciona con el valor de af_dp que incluyes en tu enlace de rastreo.

Para recibir tus datos de conexiones profundas, debes implementar el callback onAppOpenAttribution invocado por el SDK de AppsFlyer.  Este devuelve los parámetros de Onelink/enlace de rastreo usados para activar el inicio de la aplicación. Luego podrás procesar los valores y aplicar la lógica para abrir la página de la aplicación relevante.

void onAppOpenAttribution(Map<String,String> attributionData);

Para más información, haz clic aquí o vuelve a leer la sección de Obtener datos de conversión de este artículo.

6. Rastreando los Ingresos

Utiliza el parámetro de evento af_revenue (AFInAppEventParameterName.REVENUE) para contar los ingresos como parte de un evento in-app. Puedes llenarlo con cualquier valor numérico, positivo o negativo.

 Nota

af_revenue es el ÚNICO parámetro de evento que se cuenta en AppsFlyer como ingreso real en los raw data y en el panel de control. Para conocer más detalles, haz clic aquí.

Ejemplo: evento in-app con ingresos

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.REVENUE,200);
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"category_a");
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"1234567");
eventValue.put(AFInAppEventParameterName.CURRENCY,"USD");
AppsFlyerLib.getInstance().trackEvent(getApplicationContext() , AFInAppEventType.PURCHASE , eventValue);

Esto genera un evento de tipo af_purchase con los siguientes valores de evento:

{af_content_id: “1234567”, af_content_type: “category_a”, af_revenue: 200, af_currency: “USD”}

El anterior evento de compra contiene un ingreso de $200 que aparece como ingreso en el panel de control. 

 Nota

Setting user local currency code for in-app purchases - the currency code should be a 3 character ISO 4217 code. (default is USD). 

Puedes establecer el código de moneda para todos los eventos llamando al siguiente método: AppsFlyer.setCurrencyCode("GBP");

 ¡Importante!

Do NOT format the revenue value in any way. It should not contain comma separators, currency sign, or text. A revenue event should be similar to 1234.56, for example.

7. Obtener datos de conversión

AppsFlyer te permite acceder a los datos de atribución del usuario en tiempo actual por cada nueva instalación, directamente desde el nivel del SDK. Al hacer esto, puedes ofrecer a los usuarios contenido personalizado o enviarlos a actividades específicas dentro de la aplicación, lo que puede mejorar enormemente su engagement con tu aplicación.

Para acceder a los datos de conversión de AppsFlyer desde el SDK de Android, implementa el ConversionDataListener:

public interface AppsFlyerConversionListener {
       void onInstallConversionDataLoaded(Map<String,String> conversionData);
        void onInstallConversionFailure(String errorMessage);
}


Ejemplo:

AppsFlyerLib.getInstance().registerConversionListener(this, new AppsFlyerConversionListener() {
  @Override
  public void onInstallConversionDataLoaded(Map<String, String> conversionData) {
      for (String attrName : conversionData.keySet()) {
          Log.d(AppsFlyerLib.LOG_TAG, "attribute: " + attrName + " = " + conversionData.get(attrName));
      }
  }
  @Override
  public void onInstallConversionFailure(String errorMessage) {
      Log.d(AppsFlyerLib.LOG_TAG, "error getting conversion data: " + errorMessage);
  }
  @Override
  public void onAppOpenAttribution(Map<String, String> conversionData) {
  }
  @Override
  public void onAttributionFailure(String errorMessage) {
      Log.d(AppsFlyerLib.LOG_TAG, "error onAttributionFailure : " + errorMessage);
  }
});

8. Identificadores de Usuario

Obtén el ID del dispositivo de AppsFlyer

El ID de dispositivo único de AppsFlyer se crea por cada nueva instalación de una aplicación. Usa la siguiente API para obtener el ID único de AppsFlyer:

public String getAppsFlyerUID(Context context);


Ejemplo de uso:

String appsFlyerId = AppsFlyerLib.getInstance().getAppsFlyerUID(this);

Establece un ID de usuario de cliente

Establecer tu propio ID de cliente te permite hacer una referencia cruzada de tu propio ID único con el ID único de AppsFlyer y los ID de los otros dispositivos. Este ID está disponible en los reportes de CSV de AppsFlyer junto con las API de Postback para referencias cruzadas con tus ID internos.

Para configurar tu ID de usuario de cliente:

public void setCustomerUserId(String id);

 

Ejemplo de Uso:

AppsFlyerLib.getInstance().setCustomerUserId("myId");

 Nota

It is recommended to set your Customer User ID as soon as possible as it is only associated to events reported after its setup. If setCustomerUserId is called before calling startTracking, you will have the Customer User ID in the raw export for installs and for events. If it is set after, you will see the value only for events tracked after calling this method.

Customer User ID can also be used to complete integrations with Analytics platforms such as Mixpanel and Swrve.

 

Getting Customer User ID:

To avoid setting the customer user ID value again beyond the first launch you can check if its value is empty or not by using

AppsFlyerProperties.getInstance().getString(AppsFlyerProperties.APP_USER_ID)

Para obtener más información sobre el ID de usuario de cliente, haz clic aquí.

Configura el correo electrónico de usuario

AppsFlyer te permite reportar una o más de las direcciones de correo electrónico asociadas del dispositivo. Debes recolectar las direcciones de correo electrónico y reportarlas a AppsFlyer según tu método de encriptación requerido.

Están disponibles los siguientes métodos de encriptación: SHA1, MD5, SHA256 y sin encriptación.

Ejemplo:

public void setUserEmails(String... emails);


Ejemplo de uso:

AppsFlyerLib.getInstance().setUserEmails(AppsFlyerProperties.EmailsCryptType.MD5, "email1@domain.com","email2@domain.com", ….);

 Nota

AppsFlyer no retiene Información de Identificación Personal (PII) tal como las direcciones de correo electr´ónico, ni tampoco se presenta esta información en ningún reporte. El propósito de recopilar esta información es únicamente para propósitos de postbacks para la fuente de medios.

ID de publicidad de Google

Desde la versión 4.8.0 del SDK, AppsFlyer recopila automáticamente el google_advertising_id. El requisito para recopilar el ID de Publicidad de Google solo es relevante para versiones 4.7.X e inferiores del SDK.

IMEI y ID de Android

De manera predeterminada, el SDK no recopila el IMEI ni el ID de Android si la versión del sistema operativo es superior a KitKat (4.4) y el dispositivo contiene Google Play Services (en versiones del SDK 4.8.8 o anteriores, la aplicación específica requería GPS). 

Para enviar explícitamente estos ID a AppsFlyer, los desarrolladores pueden usar las siguientes API y colocarlos antes del código startTracking:

AppsFlyerLib.getInstance().setImeiData("IMEI_DATA_HERE");
AppsFlyerLib.getInstance().setAndroidIdData("ANDROID_ID_DATA_HERE");

Si la aplicación NO contiene Google Play Services, el SDK recopila el IMEI y el ID de Android. Sin embargo, las aplicaciones con Google Play Services deberían evitar la recopilación del IMEI, ya que esto viola la política de Google Play.

Los desarrolladores pueden optar por no recopilar el IMEI y el ID de Android mediante el uso de estas API:

AppsFlyerLib.getInstance().setCollectIMEI(false);
AppsFlyerLib.getInstance().setCollectAndroidID(false);

 Advertencia

Al menos un identificador de dispositivo, GAID, ID de Android o IMEI, DEBE recopilarse para permitir la atribución adecuada.

9. Funciones opcionales

Medición de Desinstalaciones

AppsFlyer te permite Medición de Desinstalaciones de la aplicación.

Para completar este proceso de forma total y correcta, debes leer aquí.

Tracking Push Notifications

AppsFlyer te permite medir notificaciones push como parte de una campaña de retargeting.

Para activar esta función, llama al siguiente método dentro del método onCreate de cada actividad que se lanzará tras hacer clic en la notificación:

AppsFlyerLib.getInstance().sendPushNotificationData(this);

La carga de datos debe incluir un objeto: af con la cadena clave-valor relevante:

Ejemplo:

{  
   "data":{  
      "score":"5x1",
      "time":"15:10",
      "af":{  
         "c":"test_campaign",
         "is_retargeting":"true",
         "pid":"push_provider_int"
      }
   }
}
{

{  
   "data":{  
      "score":"5x1",
      "time":"15:10",
      "click_action":"com.example.someAction",
      "af":{  
         "c":"test_campaign",
         "is_retargeting":"true",
         "pid":"push_provider_int"
      }
   }
}

 Nota

Para obtener más información sobre la medición de notificaciones push, lee aquí.

Cross Promotion Tracking

AppsFlyer te permite rastrear y atribuir las instalaciones que se originan en una promoción cruzada de una de tus aplicaciones desde dentro de la aplicación actual que el usuario está usando. La promoción cruzada de aplicaciones puede ser un importante factor de crecimiento para generar instalaciones de tus aplicaciones.

Para conocer más detalles, lee el artículo sobre Rastreo de promociones cruzadas aquí.

Rastreo de Invitación de Usuario

AppsFlyer te permite rastrear y atribuir instalaciones que se originan en invitaciones de usuarios dentro de tu aplicación. Permitir a tus usuarios existentes invitar a sus amigos y contactos a ser nuevos usuarios de tu aplicación puede ser un factor clave para el crecimiento de tu aplicación.

Para conocer más detalles, lee el artículo sobre Rastreo de invitaciones de usuarios aquí.

Set Currency Code

Puedes usar la siguiente API para establecer un código de moneda global, además de códigos de moneda específicos que se pueden usar como parte de cada evento in-app enviado a AppsFlyer. El código de moneda global se usa cuando af_currency

AFInAppEventParameterName.CURRENCY

no es enviado como parte de un evento in-app.

USD es el valor predeterminado. Puedes encontrar códigos de moneda ISO aceptables aquí .

Usa la siguiente API para configurar el código de moneda:

public void setCurrencyCode(String currencyCode);

Ejemplo de Uso:

AppsFlyerLib.getInstance().setCurrencyCode("GBP");

Validación de compras in-app

El SDK de AppsFlyer brinda verificación de servidor para las compras in-app. Para configurar el rastreo de validación de compras, llama al método validateAndTrackInAppPurchase dentro de la función onActivityResult .

Esta llamada genera automáticamente un evento in-app de tipo af_purchase.

public static void validateAndTrackInAppPurchase(Context context, 
String publicKey, String signature, String purchaseData, 
String price, String currency, HashMap<String, String> additionalParameters);

Esta llamada tiene dos bloques de callback: uno para "Éxito" y otro para "Falla" (por cualquier motivo, incluyendo falla de validación).

AppsFlyerLib.getInstance().registerValidatorListener(this,new
     AppsFlyerInAppPurchaseValidatorListener() {
          public void onValidateInApp() {
              Log.d(TAG, "Purchase validated successfully");
          }
          public void onValidateInAppFailure(String error) {
              Log.d(TAG, "onValidateInAppFailure called: " + error);
          }
});


Ejemplo de uso:

protected void onActivityResult(int requestCode, int resultCode, Intent data) {
   if (requestCode == 1001) {
       String purchaseData = data.getStringExtra("INAPP_PURCHASE_DATA");
       String dataSignature = data.getStringExtra("INAPP_DATA_SIGNATURE");
       if (resultCode == RESULT_OK) {
           HashMap<String,String> event = new HashMap<>();
           event.put(AFInAppEventParameterName.PRICE,"9");
           AppsFlyerLib.getInstance().validateAndTrackInAppPurchase(getApplicationContext(),publicKey, dataSignature, purchaseData, "3.00", "ILS", event);
       }
   }
} 

 Nota

Calling validateAndTrackInAppPurchase automatically generates an af_purchase in-app event. There is no need to send this event yourself.

Anonimizar Datos de Usuarios

AppsFlyer te ofrece un método para anonimizar identificadores de usuarios específicos en las analíticas de AppsFlyer. Este método cumple con los últimos requisitos de privacidad y con las políticas de datos y privacidad de Facebook. El valor predeterminado es NO, lo que significa que no se efectuará la anonimización de forma predeterminada.

Usa esta API durante la Inicialización del SDK para anonimizar explícitamente las instalaciones, los eventos y las sesiones de un usuario:

public void setDeviceTrackingDisabled(boolean isDisabled);


Ejemplo de Uso:

AppsFlyerLib.getInstance().setDeviceTrackingDisabled(true);

El rastreo se puede reiniciar llamando deviceTrackingDisabled nuevamente configurado como falso.

 Advertencia

Anonimizar a los usuarios afecta SEVERAMENTE tu información de atribución.
Usa esta opción SOLO para regiones donde la ley te impida recopilar información de tus usuarios.

Tiempo Personalizado Entre Sesiones

By default, at least 5 seconds must lapse between 2 app launches to count as separate 2 sessions (more about counting sessions).
However, you can use the following API to set your custom value for the minimum required time between sessions:
AppsFlyerLib.setMinTimeBetweenSessions(int seconds);

Note that setting a high value to the custom time between launches may badly impact APIs relying on sessions data, such as deep linking.

Sesiones de segundo plano para aplicaciones de utilidad

Si tu aplicación es una aplicación de utilidad que se ejecuta en segundo plano, puedes usar esta API en el onCreate () de tu actividad -

public void reportTrackSession (Context context);


Ejemplo de uso:

AppsFlyerLib.getInstance (). ReportTrackSession (context);

Track Out-of-Store Apps

 Nota

Google Play es la tienda predeterminada. Si publicas tu aplicación solo en Google Play, omite esta sección.

Para rastrear las instalaciones fuera de Google Play, configura el canal / tienda en AndroidManifest.xml de la aplicación con un canal único o el nombre de cualquier tienda para cada APK. El valor CANAL distingue entre mayúsculas y minúsculas.

Ejemplos:

<meta-data android:name="CHANNEL" android:value="Amazon" />
<meta-data android:name="CHANNEL" android:value="Standalone"/>
<meta-data android:name="CHANNEL" android:value="Verizon" />

 Nota

Debes configurar el valor CANAL en el panel de control de AppsFlyer al configurar la aplicación.

Coloca la etiqueta de metadatos antes de la etiqueta </application>.

Para obtener más detalles sobre cómo rastrear las instalaciones para aplicaciones fuera de la tienda, lee aquí.

Opt-Out

En algunos casos extremos, tal vez necesites desactivar todo el rastreo del SDK para cumplir con la ley y las políticas de privacidad. Para hacerlo, puedes utilizar la API isStopTracking. Una vez invocada esta API, nuestro SDK ya no se comunicará con nuestros servidores y dejará de funcionar.

AppsFlyerLib.getInstance().stopTracking(true, context);

There are several different scenarios for user opt-out. We highly recommend following the exact instructions for the scenario, that is relevant for your app.

In any event, the SDK can be reactivated by calling the same API, by passing false.

 Important

Do not call trackAppLaunch if isStopTracking is set to true

To start tracking again once stopTracking is set to false, use the following SDK API:

AppsFlyerLib.getInstance().trackAppLaunch(getApplicationContext(), AF_DEV_KEY);

 Advertencia

Use the stopTracking API only in cases where you want to fully ignore this user from any and all tracking. Using this API SEVERELY impacts your reporting and attribution..

Retrasar la inicialización del SDK para customerUserID

Es posible retrasar la inicialización del SDK hasta que se configure el customerUserID. Esta función garantiza que el SDK no comience a funcionar hasta que se haya provisto el customerUserID. Si se utiliza esta API, todos los eventos in-app y cualquier otra llamada API del SDK se descartarán hasta que se suministre y se rastree el customerUserID.

To indicate that the SDK should delay initialization for the customer user id call

AppsFlyerLib.getInstance().waitForCustomerUserId(true);

immediately before the init() method. The rest of the SDK initialization should remain unchanged.

Once the customerUserID has been provided, call

AppsFlyerLib.getInstance().setCustomerIdAndTrack("customer_id", this);

to provide the SDK with the relevant customer user id and trigger the SDK to begin its normal tracking.

El código debería verse como se muestra a continuación:
public class AFApplication extends Application {
   private static final String AF_DEV_KEY = ;
   @Override
   public void onCreate() {
       super.onCreate();
       AppsFlyerConversionListener conversionDataListener = 
       new AppsFlyerConversionListener() {
           ...
       };
       AppsFlyerLib.getInstance().waitForCustomerUserId(true); 
       AppsFlyerLib.getInstance().init(AF_DEV_KEY, getConversionListener(), getApplicationContext());
       AppsFlyerLib.getInstance().startTracking(this);
       // Haz tu magia para obtener el customerUserID
       // ...
       // Todo código del SDK de AppsFlyer invocado en este punto se descartará
      //Una vez que cuentes con el customerUserID, llama a la siguiente API:
 AppsFlyerLib.getInstance().setCustomerIdAndTrack("customer_id", this);
   }
}

 Advertencia

Utiliza esta API solo cuando sea adecuado para tu lógica de negocios. El uso de esta API aumenta las probabilidades de discrepancias y podría hacer que la aplicación quede más expuesta a fraudes.

Setting Additional Custom Data

La API setAdditionalData es necesaria para la integración a nivel del SDK con varias plataformas de partners externos, incluidas Segment, Adobe y Urban Airship. Usa esta API solo si el artículo de integración de la plataforma indica específicamente que es necesaria la API setAdditionalData.
A continuación, se muestra un ejemplo de código para implementar setAdditionalData en Android:

HashMap<String,Object> CustomDataMap = new HashMap<>();
CustomDataMap.put("custom_param_1","value_of_param_1");
AppsFlyerLib.getInstance().setAdditionalData(CustomDataMap);

Atribución de Aplicaciones Preinstaladas

Hay varios métodos disponibles para la atribución de aplicaciones preinstaladas en Android.

Para conocer más detalles, haz clic aquí.

Setting a Tracking Request Listener

If you want to receive a confirmation that the tracking request was successfully received by the AppsFlyer servers, it is possible to implement the AppsFlyerTrackingRequestListener listener.

The onTrackingRequestSuccess() callback method is invoked for every 200 response to an attribution request made by the SDK.

The onTrackingRequestFailure(String error) callback method is invoked for any other response and returns the response as the error string.

Implementation Example

AppsFlyerLib.getInstance().startTracking(this.getApplication(),"devKey", myListener());
private AppsFlyerTrackingRequestListener myListener() {   
    return new AppsFlyerTrackingRequestListener() {  
        @Override public void onTrackingRequestSuccess() { 
            Log.d("Debug", "Got 200 response from server");    
        }   @Override public void onTrackingRequestFailure(String error) { 
            Log.d("Debug", error); 
            }   
        }; 
    }

10. Probar la integración de SDK

Para probar la integración del SDK antes y después de enviarlo a la Tienda de Google Play, haz clic aquí.

Now you can start tracking the media sources you work with.

11. Problemas Conocidos

Si estás utilizando ProGuard y encuentras  una advertencia sobre nuestra clase AFKeystoreWrapper, agrega el siguiente código a tu archivo de reglas de ProGuard:

-keep class com.appsflyer.** { *; }
¿Fue útil este artículo?
Usuarios a los que les pareció útil: 17 de 20

Comentarios

0 comentarios

Inicie sesión para dejar un comentario.