Implementación de AAM para Android

Implementación de AAM para Android

Buscar
Guía del usuario

某些 Creative Cloud 应用程序、服务和功能在中国不可用。

Introducción

AAM para móviles se puede utilizar para ingerir, organizar y segmentar los primeros datos de audiencia móvil y de escritorio de un anunciante y de terceros. Asistir a un comercializador en la creación de audiencias, análisis y ejecución de campañas de marketing. Audience manager puede integrarse con múltiples plataformas y sistemas operativos móviles.

Este artículo se centra en la implementación de Adobe Audience Manager en aplicaciones móviles de Android.  Este artículo es de naturaleza técnica, ya que el público al que va dirigido es el de los desarrolladores de Android que implementan la solución y la validan.

La guía de implementación es específica para la implementación de Audience Manager cuando tanto el servicio de Experience Cloud como los servicios centrales se implementan para el cliente. En caso de que el servicio de Experience Cloud sea implementado para el cliente y los servicios centrales no sean implementados, entonces revise la implementación específica de Tech con el servicio de Experience Cloud. Si el servicio Experience Cloud (servicio de identificación de visitantes) no está habilitado, consulte la guía de implementación de la parte de cliente.

Requisitos previos

Debería haber descargado los archivos de Adobe SDK para comenzar la implementación de Audience Manager. Si tiene acceso como administrador de Analytics, puede configurar la aplicación en Adobe Mobile Services y descargar el SDK para su aplicación. Si no tiene acceso a Adobe Mobile Services, puede descargar el SDK desde este enlace: https://github.com/Adobe-Marketing-Cloud/mobile-services/releases?

Busque el último SDK de Android y descargue AdobeMobileLibrary-4.*-Archivo Android.zip. Usted debe tener los siguientes componentes de software dentro de él:

  • adobeMobileLibrary.jar: Biblioteca diseñada para su uso con dispositivos Android y simuladores.
  • ADBMobileConfig.json: Archivo de configuración SDK personalizado para su aplicación.

Añada el archivo adobeMobileLibrary.jar como una dependencia de archivos en Dependencias dentro de la estructura de su proyecto como se muestra en la siguiente captura de pantalla:

image1

Si su aplicación ya está configurada para Adobe Analytics, los pasos anteriores ya se han realizado junto con la implementación principal y la implementación de métricas Life cycle y puede proceder directamente a la sección de configuración de Audience Manager.

Implementación básica y Lifecycle

El SDK descargado requiere Android 2.2 o posterior para que la implementación funcione.

1. Añada el archivo ADBMobileConfig.json a la carpeta assets de su proyecto.

2. Agregue permisos de aplicación para que la biblioteca de AppMeasurement pueda enviar y grabar llamadas de seguimiento fuera de línea. Para añadir estos permisos, añada las siguientes líneas a su archivo AndroidManifest.xml (en el directorio del proyecto de la aplicación):

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

3. Implementar métricas del ciclo vital (En cada actividad dentro de su aplicación):

a. Importe la siguiente biblioteca:

 import com.adobe.mobile.*;

b. Dentro de la función onResume, comience a recopilar datos lifecycle: 

@Override
public voidonResume() {
Config.collectLifecycleData(this);
// -or- Config.collectLifecycleData(this, contextData);
}

 c.  Dentro de la función onPause, detenga la recopilación de datos lifecycle

@Override
public voidonPause() {
Config.pauseCollectingLifecycleData();
}

4. Para incluir datos adicionales en las llamadas métricas lifecycle, pasar un parámetro adicional a collectLifecycleData que contiene datos de contexto:

@Override
public voidonResume() {
HashMap<String, Object> contextData = new HashMap<String, Object>();
contextData.put("myapp.category", "Game");
Config.collectLifecycleData(this, contextData);
}

Puede ver esta documentación para ver algunos pasos que es necesario realizar si está utilizando IntelliJ IDEA o Eclipse en lugar de Android Studio para configurar las aplicaciones: https://marketing.adobe.com/resources/help/es_ES/mobile/android/dev_qs.html

Configuración de Audience Manager

1. Cuando configuramos la aplicación en Mobile Services User Intetrface: https://mobilemarketing.adobe.com tenemos opciones para habilitar Server Side Forwarding (SSF) en la sección de configuración del SDK de Audience Manager.  

Desde allí podemos comprobar Analytics Forwarding y entrar en el subdominio para Audience Manager. Por lo tanto, después de descargar el archivo ADBMobileConfig.json tendrá todos los campos requeridos.

 

image2
image2_1 
"marketingCloud" : {
  "org": "YOUR-MCORG-ID"
}
"audienceManager": {
    "server": "",
    "analyticsForwardingEnabled": "true",
  },

Los siguientes son los pasos para introducir manualmente estos valores en el archivo ADBMobileConfig.json. Dentro del archivo ADBMobileConfig.json en la sección de audienceManager y marketingCloud proporciona los siguientes detalles de configuración

 

"marketingCloud" : {
  "org": "YOUR-MCORG-ID"
}
"audienceManager": {
    "server": "",
    "analyticsForwardingEnabled": "true",
  },

Nota:

  • Un requisito previo para utilizar el reenvío de datos analíticos por parte del servidor es que el cliente esté provisto de Experience Cloud ID Service (https://marketing.adobe.com/resources/help/es_ES/mcvid/).
  • Los ID de organización de Experience Cloud identifican de forma única a cada empresa cliente en Adobe Experience Cloud, y son similares al siguiente valor: 016D5C175213CCA80A490D05@AdobeOrg.       

Cuando se configura la configuración anterior, todas las métricas del ciclo vital se capturan dentro de la llamada analítica y se reenvían directamente a través del lado del servidor:

image3

2. Dentro del método onCreate en la actividad principal, permita que el SDK acceda al contexto de su aplicación utilizando Config.setContext:

@Override
public voidonCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
// Allow the SDK access to the application context
Config.setContext(this.getApplicationContext());
}

Si ya agregó esta llamada de método cuando implementó Analytics o Target, no necesita volver a agregarlo.

Verificar la implementación

A continuación se presentan algunos de los puntos de control de los registros de llamadas para verificar la implementación del lado del servidor:

Si se produce una sincronización de ID de cliente, ésta se muestra en: d_cid_ic en la llamada de red dpm.demdex.net. Cuando la implementación del lado del servidor se realiza, no se realiza ninguna llamada adicional a la red de Audience Manager. Los datos de Analytics se envían a Audience Manager a través del servidor.

image4

Tenga en cuenta que d_uuid no estará disponible en la llamada de petición si el reenvío del lado del servidor se realiza junto con la implementación de la identificación de visitante (a diferencia de la implementación del lado del cliente). Debería poder ver los valores d_mid y d_orgid que están asociados con el servicio Visitor ID en la llamada dpm.demdex.net. Sin embargo, el valor uuid aparecerá en la respuesta que se vería algo así (esto aparece en la llamada de red de Analytics):

image5