Integración de SDK de AppsFlyer - Unity

Configuración del receptor AF y permisos en AndroidManifest.xml:

// el receptor debe estar dentro de la etiqueta <application>
        <receiver android:name="com.appsflyer.MultipleInstallBroadcastReceiver" android:exported="true">
        <intent-filter>
                <action android:name="com.android.vending.INSTALL_REFERRER" />
        </intent-filter>
</receiver>
//Permiso obligatorio:
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.INTERNET" />

Configuración de los permisos requeridos

El AndroidManifest.xml incluye el siguiente permiso:

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

Configuración del BroadcastReceiver en AndroidManifest.xml

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

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

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

Tras crear el proyecto en Unity para xCode, deberás agregar Security.Framework a los Marcos y librerías enlazados de xCode si antes no se agregó ya el marco.

Apple Search Ads de iOS

Agrega lo siguiente:

AdSupport.framework

AppsFlyer recopila el IDFA solo si incluyes este marco. Si no agregas este marco, no podrás rastrear Facebook, Twitter ni la mayoría de las demás redes de publicidad.

iAd.framework

Se recomienda encarecidamente agregar este marco a tu proyecto de aplicación, ya que es obligatorio para el rastreo de anuncios de búsqueda de Apple.

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

public String getAppsFlyerId();

Ejemplo de uso:

string AppsFlyerUID = AppsFlyer.getAppsFlyerId();

Establece el ID del usuario tal como lo usa la aplicación. 

Para configurar el ID del usuario, llama al siguiente método:

AppsFlyer.setCustomerUserID("someId");

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 de recopilar el ID de Publicidad de Google solo es relevante para SDK versiones 4.7.X e inferiores.

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 de Unity 4.16.4 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:

AppsFlyer.setAndroidIdData(string)
AppsFlyer.setImeiData(string)

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:

AppsFlyer.setCollectAndroidID(bool) 
AppsFlyer.setCollectIMEI(bool)

AppsFlyer recopila automáticamente el IDFA (ID para los Anunciantes) y el IDFV (ID para los Vendedores) si se incluye AdSupport.framework en la aplicación.

Para la desinstalación, sigue las instrucciones de acuerdo con tu sistema operativo.

utilizando Firebase.Messaging;
usando Firebase.Unity;

Firebase.Messaging.FirebaseMessaging.TokenReceived += OnTokenReceived;

public void OnTokenReceived
    (object sender, Firebase.Messaging.TokenReceivedEventArgs token) { 
        AppsFlyer.updateServerUninstallToken (token.Token);
    }

<uses-permission android:name="android.permission.WAKE_LOCK" />
<permission android:name="android.appsflyer.sampleapp.permission.C2D_MESSAGE"
       android:protectionLevel="signature" />
<uses-permission android:name="android.appsflyer.sampleapp.permission.C2D_MESSAGE" />
<uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />

<receiver
        android:name="com.google.android.gms.gcm.GcmReceiver"
        android:exported="true">
        <intent-filter>
                <action android:name="com.google.android.c2dm.intent.RECEIVE" />
        </intent-filter>
</receiver>

AppsFlyer.setGCMProjectNumber("Your_GCM_Project_Number");

void Start () {
   // register to push notifications
       UnityEngine.iOS.NotificationServices.RegisterForNotifications(UnityEngine.iOS.NotificationType.Alert | 
	   UnityEngine.iOS.NotificationType.Badge | 
	   UnityEngine.iOS.NotificationType.Sound);
       Screen.orientation = ScreenOrientation.Portrait;
}   void Update () {
       if (!tokenSent) { // tokenSent needs to be defined somewhere (bool tokenSent = false)
           byte[] token = UnityEngine.iOS.NotificationServices.deviceToken;           
           if (token != null) {     
               AppsFlyer.registerUninstall (token);
               tokenSent = true;
           }
       }    
} 

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

handlePushNotification(Dictionary<string, string> payload)

La carga de datos debería 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"
      }
   }
}

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

Para realizar el rastreo entre promociones con el SDK de Unity (o con cualquier otra plataforma no nativa) implementa esto.

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

setCurrencyCode(string currencyCode)

Para la validación de recibo de compra in-app, sigue las instrucciones de acuerdo con tu sistema operativo.

//Para obtener los callbacks
//AppsFlyer.createValidateInAppListener ("AppsFlyerTrackerCallbacks", 
"onInAppBillingSuccess", "onInAppBillingFailure");
AppsFlyer.validateReceipt(string publicKey, string purchaseData,
string signature, string price, string currency, Dictionary additionalParametes);

AppsFlyer.createValidateInAppListener ("AppsFlyerTrackerCallbacks", "onInAppBillingSuccess", "onInAppBillingFailure");

AppsFlyer.setIsSandbox(true);
AppsFlyer.validateReceipt(string productIdentifier, string price, string currency,
string transactionId, Dictionary additionalParametes);

La respuesta de validación de compra se activa en la clase AppsFlyerTrackerCallbacks.cs

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:

AppsFlyer.setDeviceTrackingDisabled(true);

Actualmente no disponible en Unity.

Para rastrear 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 antes de la etiqueta</application>.

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

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

AppsFlyer.stopTracking(true);

En cualquier evento, se puede reactivar el SDK llamando a la misma API, pero para pasar un valor falso.

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

Dictionary<string, string> CustomDataMap = new Dictionary<string, string>();
CustomDataMap.Add("custom_param_1", "value_of_param_1");

AppsFlyer.setAdditionalData(CustomDataMap);