Integración con el SDK de Unity para desarrolladores

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

<!-- receiver should be inside the <application> tag -->
<receiver android:name="com.appsflyer.MultipleInstallBroadcastReceiver" android:exported="true">
    <intent-filter>
        <action android:name="com.android.vending.INSTALL_REFERRER" />
    </intent-filter>
</receiver>
<!-- Mandatory permission: -->
<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 atribuir instalaciones a 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 la atribución 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.15.1 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 inferiores de 4.15.1.

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 medir las desinstalaciones, siga las instrucciones según su 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" />
<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"
   }
  }
}

AppsFlyer te permite registrar y atribuir instalaciones originadas en una promoción cruzada de una de tus aplicaciones dentro de la aplicación actual que tiene el usuario. Las aplicaciones de promoción cruzada pueden ser un importante factor de crecimiento para impulsar instalaciones adicionales para tus aplicaciones.

Para obtener detalles, consulta el artículo de atribución de promoción cruzada, aquí.

AppsFlyer te permite atribuir y registrar instalaciones originadas en las invitaciones de los usuarios dentro de tu aplicación. Permitir que tus usuarios actuales inviten a sus amigos y contactos como nuevos usuarios a tu aplicación puede ser un factor de crecimiento clave para tu aplicación.

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

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

if (Debug.isDebugBuild) {
  AppsFlyer.setIsSandbox(true);
}
AppsFlyer.validateReceipt(string productIdentifier, string price, string currency, string transactionId, Dictionary additionalParametes);

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

setMinTimeBetweenSessions(int seconds)

Ejemplo de uso:

AppsFlyer.setMinTimeBetweenSessions(10);

Ten en cuenta que si estableces un valor alto para el tiempo personalizado entre inicios, esto puede afectar mucho a las API que dependen de los datos de sesión, como los enlaces profundos.

Actualmente no disponible en Unity.

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

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

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.

AppsFlyer.stopTracking(true);

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

Existen varios casos 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.

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

Solo para Android

Puedes establecer de manera programática una fuente de medios preinstalada, desde Unity, empleando la siguiente API:

setPreinstallAttribution(string MediaSource, string Campaign, string Site_Id);

Para conocer detalles sobre las implementaciones nativas, haz clic aquí.

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.

AppsFlyer.setResolveDeepLinkURLs("example.com", "click.example.com");