Extensión del SDK de Adobe Launch

De un vistazo: Envía datos al SDK de Adobe Launch y al SDK de AppsFlyer con la implementación única de la extensión del SDK de Adobe Launch de AppsFlyer.

Resumen general

El SDK de Adobe Launch es una parte integral de Adobe Experience Platform. Adobe Experience Platform permite a las empresas recopilar, consolidar y analizar datos de varias aplicaciones y plataformas. Permite a los propietarios y desarrolladores de negocios comprender mejor el comportamiento de los clientes para optimizar la experiencia y la entrega de contenido. Si tu aplicación implementa tanto el SDK de Adobe Launch como el SDK de AppsFlyer, puedes enviar datos a ambos con una sola implementación de la extensión del SDK de Adobe Launch de AppsFlyer. Reduce la complejidad general de tu proceso de desarrollo y hace que la base de código sea más limpia y fácil de mantener.

 Nota

Si utilizas la extensión de Adobe Launch, no es necesaria la integración estándar de Adobe Analytics.

Requisitos previos

Se requieren algunas cosas antes de integrar la extensión del SDK de Adobe de AppsFlyer.

Obtén tu clave de desarrollador de AppsFlyer

dev_key.png

  1. En el panel de control de la aplicación, haz clic en Configuración de la aplicación en Configuración en el menú de la izquierda.
  2. En Instalación del SDK, copia la Clave de desarrollador.

Obtén tu ID de aplicación

  • Para Android: el ID de la aplicación es el nombre del paquete, por ejemplo, example.com.app.
  • Para iOS: el ID de la aplicación es el ID de iTunes de la aplicación sin el prefijo id, por ejemplo, 123456748.

Paso 1: Configuración de Adobe Launch

Sigue las instrucciones que se indican aquí para configurar Adobe Launch.

1.1 Creación de una nueva propiedad en Adobe Launch

  1. Inicia sesión en Adobe Experience Cloud.
  2. Selecciona Launch (Iniciar).
  3. Haz clic en Go to Launch (Ir al inicio).
  4. Haz clic en New Property (Nueva propiedad).
  5. Asigna un nombre a la propiedad y selecciona Mobile (Móvil).
  6. Haz clic en Save (Guardar).

1.2 Instalación de las extensiones necesarias de Adobe Launch

Instala las siguientes extensiones en Adobe Launch:

adboe_extensions.png

  • Adobe Analytics: conecta los datos registrados del SDK al módulo de Adobe Analytics.
  • Extensión del SDK de AppsFlyer: envía datos y eventos tanto a Adobe como a AppsFlyer mediante el SDK de Adobe Launch.
  • Adobe Profile: permite que el SDK almacene datos en un perfil del lado del cliente.
  • Adobe Mobile Core: permite la configuración del SDK móvil y proporciona acceso a los eventos y condiciones predeterminados del ciclo de vida.

Instalación de la extensión de Adobe Analytics

  1. Inicia sesión en Adobe Analytics.
  2. Crea un grupo de reportes.
  3. Vuelve a iniciar sesión en Adobe Launch.
  4. En la lista de propiedades, haz clic en la propiedad que creaste anteriormente.
  5. Haz clic en Extensions (Extensiones).
  6. Busca e instala Adobe Analytics.
  7. En Report Suites (Grupos de reportes), especifica el grupo de reportes que creaste en el paso 2.
  8. Haz clic en Save (Guardar).

Instalación de la extensión del SDK de AppsFlyer

  1. Vuelve a seleccionar Extensions (Extensiones).
  2. Busca e instala la extensión del SDK de AppsFlyer.
  3. En AppsFlyer iOS App ID (ID de la aplicación de iOS de AppsFlyer), especifica el ID de la aplicación de iOS que obtuviste en el paso de requisitos previos.
  4. En AppsFlyer Dev Key (Clave de desarrollador de AppsFlyer), especifica la clave de desarrollador que obtuviste en el paso de requisitos previos.
  5. Habilita Send attribution data to Adobe Analytics (Enviar datos de atribución a Adobe Analytics). Ten en cuenta que existen algunas restricciones para compartir datos a nivel de usuario con plataformas de análisis de terceros.
  6. Haz clic en Save (Guardar).

Instalación de la extensión de Profile y Mobile Core

  1. Vuelve a seleccionar Extensions (Extensiones).
  2. Busca e instala Profile.
  3. Busca e instala Mobile Core.
    • Al instalar Mobile Core, simplemente guarda la extensión tal como está. No es necesario especificar el servidor de Experience Cloud.

Paso 2: Implementación de la extensión del SDK de Adobe de AppsFlyer

Sigue las instrucciones de esta sección para implementar la extensión del SDK de Adobe en tu aplicación.

2.1 Adición del SDK a la aplicación

adobe_sdk.png

  1. Dentro de la propiedad de Adobe, selecciona Environments (Entornos).
  2. Selecciona el entorno para el que deseas implementar el SDK.
  3. En el lado derecho, haz clic en el icono de cuadro.
  4. Copia los fragmentos de código de la ventana que se abre y sigue las instrucciones. Si eres el marketer que configura Adobe, envía estos fragmentos de código al desarrollador de la aplicación.

2.2 Publicación del entorno

Para completar la implementación del SDK, debes publicar el entorno en una biblioteca.

adobe_publishing.png

  1. Dentro de la propiedad de Adobe, selecciona Publishing (Publicación).
  2. Haz clic en Add New Library (Agregar nueva biblioteca).
  3. Asígnale un nombre y, en Environment (Entorno), selecciona Development (Desarrollo).
  4. Haz clic en Save & Build for Development (Guardar y compilar para desarrollo). 
  5. Una vez completada la compilación, en Development (Desarrollo) haz clic en los tres puntos situados junto a la biblioteca y selecciona Submit for Approval (Enviar para aprobación).
  6. En Submitted (Enviado), haz clic en los tres puntos situados junto a la biblioteca y selecciona Build for Staging (Crear para ensayo).
  7. Una vez completada la compilación, haz clic en los tres puntos situados junto a la biblioteca y selecciona Approve for Publishing (Aprobar para publicación).
  8. En Approve (Aprobar), haz clic en los tres puntos junto a la biblioteca y selecciona Build & Publish to Production (Crear y publicar en producción).

2.3 Adición del referente de instalación de Android a tu aplicación

El referente de instalación de Android mejora la precisión de la atribución, protege contra las instalaciones fraudulentas y mucho más. Es compatible con la versión 4.8.6 del SDK de AppsFlyer para Android.

 Nota

Google dejó de usar BroadcastReceiver en marzo de 2020. 

  • Este cambio no afecta a la aplicación.
  • Es posible que aún necesites BroadcastReceiver para la atribución fuera de la tienda. Verifica con la tienda donde aparece la aplicación para asegurarte de que así sea. 
  • La implementación del referente de instalación ahora es obligatoria. 

Existen dos maneras de agregar el referente de instalación a tu aplicación:

  • Mediante Gradle (opción recomendada)
  • Agregando manualmente el referente de instalación
Agregar el referente de instalación usando Gradle Agregar manualmente el referente de instalación

 Agrega el referente de instalación de Android como dependencia. Puedes encontrar la última versión aquí.

  1. dependencies {
    //make sure to use the latest SDK version: https://mvnrepository.com/artifact/com.appsflyer/af-android-sdk
    	implementation 'com.appsflyer:af-android-sdk:5.+'
    	implementation 'com.android.installreferrer:installreferrer:1.1'
    }
  2. Sincroniza el proyecto para recuperar las dependencias: consulta la siguiente captura de pantalla:

    android_af_sdk_sync_gradle.png

Si utilizas ProGuard y quieres utilizar la nueva API de referente de Google, establece la siguiente regla de ProGuard: -dontwarn com.android.installreferrer

2.4 Configuración de los permisos necesarios

Agregar permisos ayuda a aumentar la velocidad de la atribución de modelo probabilístico. Esto también permite que el SDK envíe más datos como los datos de redes de proveedores y WiFi. Puedes encontrar estos datos en los reportes de raw data y usarlos para analizar y optimizar las campañas.

Agregar los permisos necesarios

  1. Agrega 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" />
    <!-- Optional : -->
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    

Uso de la extensión del SDK de Adobe

Ahora puedes empezar a utilizar la extensión del SDK de Adobe para enviar datos a Adobe y AppsFlyer.

 Nota

Actualmente, la extensión del SDK de Adobe Launch solo admite la obtención de datos de conversión y el envío de eventos. Sin embargo, cuando agregas la extensión del SDK de Adobe Launch a tu aplicación, también se agrega el SDK de AppsFlyer. Por lo tanto, cualquier funcionalidad que falte actualmente en la extensión del SDK de Adobe se puede implementar utilizando el SDK de AppsFlyer.

Envío de eventos

Los eventos in-app brindan información sobre lo que está sucediendo en tu aplicación. Te recomendamos que te tomes un tiempo para definir los eventos que deseas registrar. El registro de eventos in-app te ayuda a medir los KPI como el retorno de la inversión (ROI) y el valor de vida útil (LTV).

La extensión del SDK de Adobe Launch te permite enviar datos de eventos in-app tanto a Adobe como a AppsFlyer. A continuación, puedes utilizar Adobe Analytics para analizar el comportamiento de los usuarios y AppsFlyer para analizar el ROI y el LTV.

Android iOS
final Map<String,String> eventMap = new HashMap<>();  
eventMap.put("currency", "USD");  
eventMap.put("revenue", "200");  
eventMap.put("freehand", "param");

MobileCore.trackAction("af_purchase", eventMap);

Al enviar los eventos como se especifica en el código anterior, se crea un evento en el panel de control de AppsFlyer llamado af_purchase con unos ingresos de 200 USD. Este evento también se envía a Adobe Analytics y aparece en él.

Todos los datos de conversión que se envían con eventos tienen el prefijo appsflyer. Consulta la siguiente tabla para ver algunos ejemplos:

Variables de datos de conversión con prefijo
appsflyer.af_click_lookback
appsflyer.install_time
appsflyer.cost_cents_USD
appsflyer.media_source
appsflyer.af_adset
appsflyer.click_time
appsflyer.orig_cost
appsflyer.campaign

Los datos de conversión se utilizan en la aplicación que se crea en Adobe Mobile Services. Hay otros parámetros que pueden aparecer en los datos de conversión. Para aprender más, haz clic aquí.

Obtención de datos para enlaces profundos y enlaces profundos diferidos

Los enlaces profundos y los enlaces profundos diferidos te permiten mejorar tu experiencia de usuario. Permiten abrir la aplicación en actividades específicas y personalizar el contenido según los datos de la campaña.

Para obtener datos de enlaces profundos, implementa la extensión de devolución de llamada.

Android iOS

En la clase de aplicación global, implementa el siguiente código:

AppsFlyerAdobeExtension.registerAppsFlyerExtensionCallbacks(new AppsFlyerExtensionCallbacksListener() {
		@Override
		public void onCallbackReceived(Map<String, String> callback) {
			Log.d(AppsFlyerLibCore.LOG_TAG, callback.toString());
			if(callback.get("callback_type").equals("onConversionDataReceived")){
				// conversion data returned 
				if(callback.get("is_first_launch").equals("true")){
					String af_status = callback.get("af_status");
					if(af_status.equals("Non-organic")){
						Log.d(AppsFlyerLibCore.LOG_TAG, "this is first launch and a non organic install!");
					}
				}
			} else if(callback.get("callback_type").equals("onAppOpenAttribution")){
				// direct deeplink - redirect user
				Log.d(AppsFlyerLibCore.LOG_TAG, callback.toString());
			}
		}
		@Override
		public void onCallbackError(String errorMessage) {
			Log.d("TAG", errorMessage);
		}
	});

Conexión de datos de conversión de AppsFlyer

Los datos de conversión se envían con eventos a la plataforma de Adobe. Estas variables te permiten aplicar lógica y reglas a las dimensiones, métricas o filtros de los reportes.

adobe_analytics.png

  1. Inicia sesión en Adobe Mobile Services.
  2. Selecciona la aplicación correspondiente e ingresa a la página Manage Variables & Metrics (Administrar variables y métricas).
  3. Selecciona la pestaña Custom Variables (Variables personalizadas) y configura las variables para asignar los datos del SDK de AppsFlyer al sistema de Adobe.
  4. Para cada variable personalizada, escribe un nombre descriptivo.
  5. Selecciona o escribe los datos de conversión de AppsFlyer asignados y elige el alcance de Persistence (Persistencia) que prefieras.

Consulta la siguiente tabla para asignar las variables de contexto de AppsFlyer:

Nombre recomendado para asignar

Datos de conversión

Ventana retrospectiva de AppsFlyer

appsflyer.af_click_lookback

Hora de instalación de AppsFlyer

appsflyer.install_time

Costo de AppsFlyer en centavos de dólar

appsflyer.cost_cents_USD

Fuente de medios de AppsFlyer

appsflyer.media_source

Conjunto de anuncios de AppsFlyer

appsflyer.af_adset

Hora de clic de AppsFlyer

appsflyer.click_time

Costo original de AppsFlyer

appsflyer.orig_cost

Campaña de AppsFlyer

appsflyer.campaign

Uso de datos de conversión asignados de AppsFlyer para Analytics y Análisis

Todos los datos procedentes del SDK están disponibles en el grupo de reportes de Adobe Analytics que está conectado a la aplicación.

Puedes utilizar los datos y sus dimensiones y métricas relacionadas en los reportes y paneles de Adobe Analytics generados. Estos datos también están disponibles en el panel de control de AppsFlyer para la atribución y el análisis de eventos in-app.