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

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

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", ….);

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, debes leer 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 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);
       }
   }
} 

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.

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

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

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.

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

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

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

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