Show Menu
TEMAS×

Mensajería en la aplicación

Puede enviar mensajes en las aplicaciones que se activen mediante cualquier dato o evento de Analytics. Tras la implementación, los mensajes se envían de forma dinámica a la aplicación y no requieren una actualización de código.

Nueva versión del SDK de Adobe Experience Cloud

¿Busca información y documentación relacionada con el SDK móvil de Adobe Experience Platform? Haga clic aquí para consultar los documentos más recientes.
En septiembre de 2018, publicamos una nueva versión principal del SDK. Estos nuevos SDK móviles de la Adobe Experience Platform se pueden configurar a través de Experience Platform Launch .
Si utiliza los SDK móviles de la Adobe Experience Platform con Adobe Launch, también debe instalar la extensión de Adobe Analytics Mobile Services para utilizar funciones como, por ejemplo, mensajería en la aplicación y notificaciones push. Para obtener más información, consulte Adobe Analytics: Mobile Services . Para obtener información sobre el uso de la mensajería push y la mensajería en la aplicación con los SDK de Experience Cloud, consulte Configuración de mensajería push y Configuración de mensajería en la aplicación .
Para utilizar la mensajería en la aplicación necesita la versión 4.2 o posterior del SDK.
Puede crear mensajes, así como las reglas de Adobe Mobile Services que definen cuándo se muestran. Para obtener más información, consulte Crear un mensaje en la aplicación . Para mostrar mensajes en la aplicación es preciso actualizar el SDK. Puede completar estos pasos aunque aún no haya definido ningún mensaje. Tras definir los mensajes, se enviarán de forma dinámica a su aplicación y se mostrarán sin necesidad de actualizar la aplicación en la tienda de aplicaciones.

Activación de la mensajería en la aplicación

  1. Agregue la biblioteca al proyecto e implemente el ciclo vital.
    Para obtener más información, consulte Agregar el SDK y el archivo de configuración a su proyecto IntelliJ IDEA o Eclipse en Implementación principal y ciclo de vida .
  2. Actualice el archivo AndroidManifest.xml para declarar la actividad de pantalla completa y habilitar el controlador de notificación de mensajes:
    <activity  
    android:name="com.adobe.mobile.MessageFullScreenActivity"  
    android:theme="@android:style/Theme.Translucent.NoTitleBar" /> 
    <receiver android:name="com.adobe.mobile.MessageNotificationHandler" />
    
    
    Si seleccionó un diseño modal, elija un de los siguientes temas para el mensaje:
    • Theme.Translucent.NoTitleBar.Fullscreen
    • Theme.Translucent.NoTitleBar
    • Theme.Translucent Por ejemplo:
    <activity 
    android:name="com.adobe.mobile.MessageFullScreenActivity" 
    android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen" 
    android:windowSoftInputMode="adjustUnspecified|stateHidden" /> 
    <receiver android:name="com.adobe.mobile.MessageNotificationHandler" />
    
    
  3. Importe la biblioteca:
    import com.adobe.mobile.*;
    
    
  4. En cada llamada a collectLifecycleData , pase this para proporcionar una referencia para su actividad actual:
    @Override 
    public void onResume() { 
        Config.collectLifecycleData(this); 
    }
    
    
  5. Compruebe que el archivo ADBMobileConfig.json contiene la configuración necesaria para la mensajería en la aplicación.
    messages o remotes es obligatorio.
    Para que los mensajes en la aplicación se actualicen de forma dinámica en el inicio, el objeto remotes debe estar presente y adecuadamente configurado:
    “messages”: [ 
        { 
            “messageId”: “de45c43c-37bf-441f-8cbd-cc3ba3469ebe”, 
            “template”: “fullscreen”, 
            “showOffline”: false, 
            “showRule”: “always”, 
            “endDate”: 2524730400, 
            “startDate”: 0, 
            “audiences”: [], 
            “triggers”: [], 
            “payload”: { // contents change depending on template 
                “html”: “<html>html code goes here</html>” 
            }, 
        }, 
        … 
    ] 
    “remotes” : { 
        “analytics.poi”: “https://assets.adobedtm.com/…/yourfile.json”, 
        “messages”: “https://assets.adobedtm.com/…/yourfile.json” 
    }
    
    
    Si este objeto no está configurado, descargue un archivo ADBMobileConfig.json actualizado desde Adobe Mobile Services. Para obtener más información, consulte Antes de comenzar .

Seguimiento de mensajes dentro de la aplicación

El SDK de Mobile para Android realiza un seguimiento de las siguientes métricas para sus mensajes dentro de la aplicación:
  • Para los mensajes dentro de la aplicación en pantalla completa y de estilo de alerta:
    • Impresiones : cuando el usuario activa un mensaje dentro de la aplicación.
    • Pulsaciones : cuando el usuario presiona el botón Pulsación .
    • Cancelaciones : cuando el usuario pulsa Cancelar .
  • Para los mensajes personalizados en pantalla completa, el contenido HTML del mensaje debe incluir el código adecuado para notificar al sistema de seguimiento del SDK el uso de los botones siguientes:
    • Seguimiento de ejemplo de pulsaciones (redirecciones):
      adbinapp://confirm/?url=https://www.yoursite.com
    • Ejemplo de seguimiento de Cancelación (cierre):
      adbinapp://cancel

Imagen de reserva local

Al crear un mensaje de pantalla completa, tiene la opción de especificar una imagen de reserva. Si su mensaje no puede recuperar su imagen pretendida desde la web, el SDK intenta cargar la imagen con el mismo nombre desde la carpeta de recursos de su aplicación. Esto le permite mostrar el mensaje en su forma original, aunque el usuario esté sin conexión o la imagen predeterminada no esté disponible.
El nombre del recurso de imagen de reserva se especifica al configurar el mensaje en Adobe Mobile Services, y es necesario asegurarse de que el recurso especificado esté disponible.

Configuración de los iconos de notificación

Los siguientes métodos le permiten configurar los iconos pequeños y grandes que aparecen en el área de notificaciones, así como el icono grande que se muestra cuando aparecen nuevas notificaciones en la bandeja.
  • Config.setSmallIconResourceId(int resourceId)
    Establece el icono pequeño que se utiliza para las notificaciones creadas por el SDK. Este icono aparece en la barra de estado y es la imagen secundaria que se muestra cuando el usuario ve la notificación completa en el centro de notificaciones.
    • Esta es la sintaxis para este método:
      public static void setSmallIconResourceId(final int resourceId); 
      
      
    • Este es un ejemplo de código para este método:
      Config.setSmallIconResourceId(R.drawable.appIcon);
      
      
  • Config.setLargeIconResourceId(int resourceId)
    Establece el icono grande que se utiliza para las notificaciones creadas por el SDK. Este icono es la imagen principal que se muestra cuando el usuario ve la notificación completa en el centro de notificaciones.
    • Esta es la sintaxis para este método:
      public static void setLargeIconResourceId(final int resourceId); 
      
      
    • Este es un ejemplo de código para este método:
      Config.setLargeIconResourceId(R.drawable.appIcon);