Guía de integración del plugin de Unity V6: integración básica del SDK

Descarga el último plugin de Unity de GitHub.

Usa uno de los siguientes métodos de instalación.

Para configurar los permisos necesarios para Android:

Configura los siguientes permisos a AndroidManifest.xml:

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

Las aplicaciones dirigidas al nivel 31 de la API (Android 12) deben agregar el siguiente permiso a AndroidManifest.xml para acceder al Identificador de publicidad de Android:

<uses-permission android:name="com.google.android.gms.permission.AD_ID" />

• La clave es única e identifica la cuenta. En algunos casos hay una clave a nivel de aplicación. 
• La clave de desarrollador es obligatoria.

Para obtener la clave de desarrollador:

1. En AppsFlyer, ve a Configuración > Configuración de la aplicación. 
2. Obtener la clave de desarrollador. 

Para enviar eventos:

• Especifica el nombre y los parámetros del evento.
• Ver listas relacionadas: 
  • Lista de estructuras y nombres de eventos recomendados.
  • Lista encontrada en la clase AFInAppEvents.

[Práctica recomendada] Usa nombres y parámetros de eventos por los siguientes motivos:

• Nomenclatura estándar: AppsFlyer puede asignar automáticamente eventos a redes de autorreporte (SRN) como Facebook, Google y Twitter.
• Compatibilidad con versiones anteriores: no tendrás problemas si AppsFlyer decide cambiar el nombre o parámetro del evento. La implementación es compatible con versiones anteriores.

Reporta ingresos agregando el parámetro af_revenue a los eventos in-app.

• Completa af_revenue con valores numéricos. Se permiten valores negativos. 
• El parámetro af_revenue completa los contadores de ingresos y los campos de raw data de AppsFlyer. Esto permite a los marketers ver los ingresos en el panel de control.
• Los ingresos pueden enviarse usando otros parámetros, pero la plataforma de AppsFlyer no los reconocerá como ingresos. Haz clic aquí para obtener más detalles. 
• Los valores de los ingresos no pueden contener comas para separar, signos de divisas ni texto.
  Ejemplo de evento de ingresos: 1234.56

Práctica recomendada: Obtén información sobre la configuración, visualización y conversión de divisas.

 Requisitos de código de divisa al enviar eventos generadores de ingresos

• Divisa predeterminada: USD
• Usa un código ISO 4217 de 3 caracteres (a continuación se muestra un ejemplo).
• Configura el código de divisa llamando a esta API:
  

  AppsFlyer.setCurrencyCode("ZZZ")

Ejemplo: evento de compra in-app con ingresos

Este evento de compra es por 200.12 euros. Para que los ingresos se reflejen en el panel de control, usa lo siguiente. 

System.Collections.Generic.Dictionary<string, string> purchaseEvent = new 
System.Collections.Generic.Dictionary<string, string> ();
purchaseEvent.Add(AFInAppEvents.CURRENCY, "EUR");
purchaseEvent.Add(AFInAppEvents.REVENUE, "200.12");
purchaseEvent.Add(AFInAppEvents.QUANTITY, "1");
purchaseEvent.Add(AFInAppEvents.CONTENT_TYPE, "category_a",);
AppsFlyer.sendEvent ("af_purchase", purchaseEvent);

Registro de ingresos negativos

Registra los ingresos negativos usando el signo menos.

• El valor de ingresos está precedido por un signo menos.
• El nombre del evento tiene un valor único, "cancel_purchase". Esto te permite identificar los eventos con ingresos negativos en los reportes de raw data y en el panel de control.

Ejemplo: un usuario de la aplicación recibe un reembolso o cancela una suscripción.

System.Collections.Generic.Dictionary<string, string> purchaseEvent = new 
System.Collections.Generic.Dictionary<string, string> ();
purchaseEvent.Add(AFInAppEvents.CURRENCY, "USD");
purchaseEvent.Add(AFInAppEvents.REVENUE, "-200");
purchaseEvent.Add(AFInAppEvents.QUANTITY, "1");
purchaseEvent.Add(AFInAppEvents.CONTENT_TYPE, "category_a");
AppsFlyer.sendEvent ("cancel_purchase", purchaseEvent);

El plugin proporciona verificación de servidor para las compras in-app.

Para validar una compra, instrucciones específicas del sistema operativo:

#if UNITY_ANDROID && !UNITY_EDITOR
 AppsFlyerAndroid.validateAndSendInAppPurchase(
 "publicKey", 
 "signature", 
 "purchaseData", 
 "price", 
 "currency", 
 null, 
 this);
#endif

#if UNITY_IOS && !UNITY_EDITOR
 AppsFlyeriOS.validateAndSendInAppPurchase(
 "productIdentifier", 
 "price", 
 "currency", 
 "tranactionId", 
 null, 
 this);
#endif

Parámetros de método

• Nombre del evento: máximo de 45 caracteres.
• El Valor del evento: no debe superar los 1000 caracteres; si es más largo, puede que lo trunquemos.
• Admite caracteres no ingleses para eventos in-app (y otras API)
• Precios e ingresos:
  • Solo usa números y decimales como 5 o 5.2.
  • Se permiten hasta 5 números después del decimal. Por ejemplo, 5.12345

Puedes atribuir eventos in-app al llamar a sendEvent e incluir los parámetros de valor y nombre del evento.
Para más detalles, consulta Eventos in-app.

Ejemplo: cómo atribuir un evento de compra in-app.

Para ver una lista completa de fragmentos de código listos por segmento vertical, consulta nuestras guías de eventos in-app enriquecidos por segmento vertical.

System.Collections.Generic.Dictionary<string, string> purchaseEvent = new 
System.Collections.Generic.Dictionary<string, string> ();
purchaseEvent.Add(AFInAppEvents.CURRENCY, "USD");
purchaseEvent.Add(AFInAppEvents.REVENUE, "200");
purchaseEvent.Add(AFInAppEvents.QUANTITY, "2");
purchaseEvent.Add(AFInAppEvents.CONTENT_TYPE, "category_a");
purchaseEvent.Add(AFInAppEvents.CONTENT_ID, "092");
AppsFlyer.sendEvent (AFInAppEvents.PURCHASE, purchaseEvent);

En ocasiones, los usuarios generan eventos in-app cuando no están conectados a Internet. AppsFlyer almacena en caché el evento y lo reporta cuando es posible. 

• El plugin envía los eventos a los servidores de AppsFlyer y espera una respuesta.
• Si el plugin no recibe una respuesta 200, el evento se almacena en el caché.
• Una vez recibida la respuesta 200, el evento almacenado en el caché se vuelve a enviar al servidor.
• Si hay múltiples eventos en el caché, se envían al servidor uno tras otro.

OneLink:

• Detecta el tipo de dispositivo (iOS y Android, escritorio, etc.) cuando un usuario hace clic.
• Redirige al usuario al destino correspondiente: Google Play, tienda de aplicaciones de iOS, mercados fuera de la tienda o páginas web.

Para implementar enlaces de atribución multiplataforma y revisar los conceptos básicos de deep linking, consulta la guía de redireccionamiento de OneLink.

Usa enlaces profundos para dirigir a los usuarios existentes a actividades específicas y contenido personalizado. 

El propietario y desarrollador de una aplicación deben trabajar juntos para configurar enlaces profundos con OneLink:

• El propietario de la aplicación debe acceder al panel de control de AppsFlyer.
• El desarrollador debe acceder a la aplicación.

Consulta nuestra guía sobre configuración de enlaces profundos con OneLink.

Los enlaces profundos diferidos te permiten establecer enlaces profundos con usuarios nuevos y ofrecerles actividades específicas y contenido personalizado después del primer inicio de una instalación de la aplicación. 

Los enlaces profundos estándar también dirigen a los usuarios a actividades específicas y contenido personalizado, pero una aplicación ya debe estar instalada en el dispositivo del usuario.

Para configurar los enlaces profundos diferidos con OneLink:

• El desarrollador debe acceder a la plataforma de AppsFlyer.
• La configuración de la plataforma de AppsFlyer para enlaces profundos diferidos y estándar es la misma.
• Se necesita implementar una lógica adicional en la aplicación a fin de establecer enlaces profundos con los usuarios y ofrecerles contenido personalizado después de que instalen e inicien la aplicación.

Consulta enlaces profundos diferidos para obtener más información.

El plugin proporciona los datos de conversión o engagement después de cada evento de enlaces profundos o instalación. Puedes usar estos datos para personalizar el contenido o el comportamiento de la aplicación de manera programática.

Para recibir datos de enlaces profundos:

• Implementa el callback onAppOpenAttribution (que aparece en la claseIAppsFlyerConversionData), solicitado por el plugin de AppsFlyer.
• Los parámetros en el enlace de atribución/Onelink devueltos activan la apertura de la aplicación.
• Analiza los valores y aplica la lógica para abrir la página de la aplicación pertinente.

public void onAppOpenAttribution(string attributionData)
 {
 AppsFlyer.AFLog("onAppOpenAttribution", attributionData);
 Dictionary<string, object> attributionDataDictionary = AppsFlyer.CallbackStringToDictionary(attributionData);
 // add direct deeplink logic here
 }

Consulta datos de enlaces profundos para obtener más información.

Para obtener datos de conversión de AppsFlyer:

1. Implementa IAppsFlyerConversionDatabase.
2. Llama al método initSDK con esto como el último parámetro.
3. Usa el método onConversionDataSuccess para redirigir al usuario. 

Consulta la referencia de API para onConversionDataSuccess.

using AppsFlyerSDK;

public class AppsFlyerObjectScript : MonoBehaviour , IAppsFlyerConversionData
{
    void Start()
    {
        /* AppsFlyer.setDebugLog(true); */
        AppsFlyer.initSDK("devkey", "appID", this);
        AppsFlyer.startSDK();
    }

    public void onConversionDataSuccess(string conversionData)
    {
        AppsFlyer.AFLog("onConversionDataSuccess", conversionData);
        Dictionary<string, object> conversionDataDictionary = AppsFlyer.CallbackStringToDictionary(conversionData);
        // add deferred deeplink logic here
    }

    public void onConversionDataFail(string error)
    {
        AppsFlyer.AFLog("onConversionDataFail", error);
    }

    public void onAppOpenAttribution(string attributionData)
    {
        AppsFlyer.AFLog("onAppOpenAttribution", attributionData);
        Dictionary<string, object> attributionDataDictionary = AppsFlyer.CallbackStringToDictionary(attributionData);
        // add direct deeplink logic here
    }

    public void onAppOpenAttributionFailure(string error)
    {
        AppsFlyer.AFLog("onAppOpenAttributionFailure", error);
    }
}

Agrega a la lista de permitidos el dispositivo de prueba.

Simula instalaciones orgánicas y no orgánicas.

Simular una instalación orgánica

Las instalaciones orgánicas son instalaciones sin atribuir que, por lo general, son instalaciones que se hacen directamente desde las tiendas de aplicaciones. Para simular una instalación orgánica, sigue estas instrucciones.

Simular una instalación no orgánica

Las instalaciones no orgánicas son instalaciones atribuidas que, por lo general, son el resultado del engagement de un anuncio. Para simular una instalación no orgánica, sigue estas instrucciones.