Integración de SDK de AppsFlyer - Unity

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 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" />
<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 allows you to track and attribute installs originating from a cross promotion of one of your apps from within the current app the user has. Cross promoting apps can be a major growth factor in driving additional installs for your apps.

For details, see the Cross Promotion Tracking article, here.

AppsFlyer allows you to track and attribute installs originating from user invites within your app. Allowing your existing users to invite their friends and contacts as new users to your app can be a key growth factor for your app.

For details, see the User Invite Tracking article, here.

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

setMinTimeBetweenSessions(int seconds)

Usage Example:

AppsFlyer.setMinTimeBetweenSessions(10);

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

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.

Examples:

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

In some extreme cases you might want to shut down all SDK tracking due to legal and privacy compliance. This can be achieved with the isStopTracking API. Once this API is invoked, our SDK no longer communicates with our servers and stops functioning.

AppsFlyer.stopTracking(true);

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

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.

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

Android Only

You can programatically set a pre-installed media source, from Unity, using the following API:

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

For details on native implementations, click here.