Integración de SDK de AppsFlyer - Android

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

Para configurar tu ID de usuario de cliente:

public void setCustomerUserId(String id);

Ejemplo de Uso:

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

Cómo obtener un ID de usuario de cliente:

Para no tener que volver a establecer el valor de ID de usuario de cliente después del primer ejecución, puedes verificar si su valor está vacío o no empleando lo siguiente: 

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

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

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.

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

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

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

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");

El SDK de AppsFlyer proporciona verificación de servidor para las compras in-app. Para activar la 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);
    }
  }
} 

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

Puedes cancelar la anonimización  llamando a deviceTrackingDisabled de nuevo, configurado como falso.

AppsFlyerLib.setMinTimeBetweenSessions(int seconds);

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

Para registrar las instalaciones fuera de Google Play, configura el canal/tienda en AndroidManifest.xml de la aplicación con un canal único o cualquier nombre de 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" />

Coloca la etiqueta de metadatos dentro de la etiqueta <application>.

Para conocer más detalles sobre cómo registrar las instalaciones para aplicaciones fuera de la tienda, lee esto.

En algunos casos extremos, tal vez quiera desactivar el rastreo del SDK para cumplimiento con disposiciones reglamentarias o asociadas a la privacidad. Puede hacerlo con 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);

Existen varias situaciones diferentes para que un usuario opte por la exclusión. Es muy recomendable que sigas las instrucciones exactas para la situación correspondiente a tu aplicación.

En cualquier evento, se puede reactivar el SDK llamando a la misma API y pasando un valor falso.

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

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 registre el customerUserID.

Para indicar que el SDK debe retrasar la inicialización del ID de usuario de cliente, llama a

AppsFlyerLib.getInstance().waitForCustomerUserId(true);

inmediatamente antes del método init(). El resto de la inicialización del SDK debe mantenerse sin cambios.

Una vez proporcionado el customerUserID, llama a

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

Para proporcionar al SDK el ID de usuario de cliente correspondiente e iniciar el SDK.

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);
    // Do your magic to get the customerUserID
    // ...
    // any AppsFlyer SDK code invoked here will be discarded
   //Call the following API once the customerUserID is available:
 AppsFlyerLib.getInstance().setCustomerIdAndTrack("customer_id", this);
  }
}

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

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

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

Si quieres recibir una confirmación de que los servidores de AppsFlyer recibieron la solicitud de rastreo correctamente, es posible implementar el agente de escucha AppsFlyerTrackingRequestListener.

El método de devolución de llamada onTrackingRequestSuccess() se invoca para cada respuesta 200 a una solicitud de atribución por parte del SDK.

El método de devolución de llamada onTrackingRequestFailure(String error) se invoca para cualquier otra respuesta y devuelve la respuesta como la cadena de error.

Ejemplo de implementación

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); 
      }  
    }; 
  }

Si usas OneLink que sean compatibles con enlaces de aplicaciones de Android y los encapsulas con un enlace universal de terceros, puedes usar la API setResolveDeepLinkURLs para notificar al SDK de AppsFlyer qué dominios click que invocan la aplicación debe resolver el SDK y obtener el OneLink resultante extraído de ellos. Esto te permitirá mantener las conexiones profundas y la atribución mientras encapsula el OneLink con un enlace universal de terceros. Asegúrate de llamar a esta API antes de la inicialización de SDK.

AppsFlyerLib.getInstance().setResolveDeepLinkURLs("example.com", "click.example.com");