Pasos de configuración para Android

Una vez que el paquete esté instalado, puede definir la configuración de la aplicación de Android en Adobe Campaign Classic.

NOTA

Para obtener información sobre cómo configurar la aplicación para iOS y cómo crear un envío para iOS, consulte esta sección.

Los pasos clave son:

  1. Configuración de la cuenta externa de Android
  2. Configuración del servicio de Android
  3. Creación de la aplicación móvil en Campaign
  4. Ampliación del esquema de la aplicación con datos adicionales

Podrá crear una notificación enriquecida de Android.

Configuración de la cuenta externa de Android

Para Android, hay dos conectores disponibles:

  • Conector V1, que permite una conexión por elemento secundario de MTA.
  • Conector V2, que permite conexiones simultáneas con el servidor FCM para mejorar el rendimiento.

Para elegir el conector que desea utilizar, siga estos pasos:

  1. Vaya a Administration > Platform > External accounts.

  2. Seleccione la cuenta externa Android routing.

  3. En la pestaña Connector, rellene el campo JavaScript used in the connector:

    Para Android V2: https://localhost:8080/nms/jsp/androidPushConnectorV2.js

    NOTA

    También puede configurarlo de la siguiente manera: https://localhost:8080/nms/jsp/androidPushConnector.js, pero se recomienda utilizar la versión 2 del conector.

  4. Para Android V2, hay un parámetro adicional disponible en el archivo de configuración de Adobe Server (serverConf.xml):

    • maxGCMConnectPerChild: Límite máximo de solicitudes HTTP paralelas al FCM iniciado por cada servidor secundario (8 por defecto).

Configuración del servicio Android

Obtenga información sobre cómo configurar un servicio de Android en vídeo

  1. Vaya al nodo Profiles and Targets > Services and subscriptions y seleccione New.

  2. Defina un Label y un Internal name.

  3. Vaya al campo Type y seleccione Mobile application.

    NOTA

    La asignación de destino predeterminada Subscriber applications (nms:appSubscriptionRcp) está relacionada con la tabla de destinatarios. Si desea utilizar una asignación de destino diferente, debe crear una nueva asignación de destino e introducirla en el campo Target mapping del servicio. Para obtener más información sobre la creación de asignación de destino, consulte la guía de configuración.

  4. A continuación, haga clic en el botón Add para seleccionar el tipo de aplicación.

  5. Cree la aplicación de Android. Para obtener más información, consulte esta sección.

Creación de una aplicación móvil de Android

Después de crear el servicio, debe crear la aplicación de Android:

  1. En el servicio recién creado, haga clic en el botón Add para seleccionar el tipo de aplicación.

  2. Seleccione Create an Android application y escriba un Label.

  3. Asegúrese de que se ha definido la misma Integration key en Adobe Campaign y en el código de la aplicación a través del SDK. Para obtener más información, consulte: Integración del SDK de Campaign en la aplicación móvil.

    NOTA

    Integration key es totalmente personalizable con un valor de cadena, pero debe ser exactamente igual al especificado en el SDK.

  4. Seleccione la API version: HTTP v1 o HTTP (heredada). Estas configuraciones se detallan en esta sección

  5. Rellene los campos Firebase Cloud Messaging the Android connection settings.

  6. Haga clic en Finish, luego en Save. La aplicación de Android ya está lista para su uso en Campaign Classic.

De forma predeterminada, Adobe Campaign guarda una clave en el campo User identifier (@userKey) de la tabla Subscriber applications (nms:appSubscriptionRcp). Esta clave permite vincular una suscripción a un destinatario. Para recopilar datos adicionales (como una clave de acceso compleja), es necesario aplicar la siguiente configuración:

Seleccione la versión de la API

Después de crear el servicio y una nueva aplicación móvil, debe configurar la aplicación móvil según la versión de API elegida.

  • La configuración de HTTP v1 se detalla en esta sección.
  • La configuración de HTTP (heredada) se detalla en esta sección.

Configuración de la API HTTP v1

Para configurar la versión de la API HTTP v1, siga los pasos a continuación:

  1. En la ventana Mobile application creation wizard, seleccione HTTPV1 en la lista desplegable API version.

  2. Haga clic en Load project json file to extract projet details… para cargar directamente el archivo con clave JSON. Para obtener más información sobre cómo extraer el archivo JSON, consulte esta página.

    También puede introducir manualmente los siguientes detalles:

    • Project Id
    • Private Key
    • Client Email

  3. Haga clic en Test the connection para comprobar que la configuración es correcta y que el servidor de marketing tiene acceso a FCM.

    ATENCIÓN

    Para la implementación intermediaria, el botón Test connection no comprueba si el servidor MID tiene acceso al servidor FCM.

  4. Como opción, puede enriquecer el contenido de un mensaje push con algunos Application variables si es necesario. Son totalmente personalizables y una parte de la carga útil de mensajes se envía al dispositivo móvil.

  5. Haga clic en Finish, luego en Save. La aplicación de Android ya está lista para su uso en Campaign Classic.

A continuación se muestran los nombres de carga útil de FCM para personalizar aún más la notificación push:

Tipo de mensaje Elemento de mensaje configurable (nombre de carga útil de FCM) Opciones configurables (nombre de carga útil de FCM)
mensaje de datos N/A validate_only
mensaje de notificación title, body, android_channel_id, icon, sound, tag, color, click_action, image, ticker, sticky, visibility, notification_priority, notification_count
validate_only


Configuración de la API HTTP (heredada)

Para configurar la versión de la API HTTP (heredada), siga los pasos a continuación:

  1. En la ventana Mobile application creation wizard, seleccione HTTP (legacy) en la lista desplegable API version.

  2. Introduzca el Project key que proporcionó el desarrollador de la aplicación móvil.

  3. Como opción, puede enriquecer el contenido de un mensaje push con algunos Application variables si es necesario. Son totalmente personalizables y una parte de la carga útil de mensajes se envía al dispositivo móvil.

    En el ejemplo siguiente, se añade title, imageURL e iconURL para crear notificaciones push enriquecidas y, a continuación, se proporciona a la aplicación la imagen, el título y el icono que se muestran en la notificación.

  4. Haga clic en Finish, luego en Save. La aplicación de Android ya está lista para su uso en Campaign Classic.

A continuación se muestran los nombres de carga útil de FCM para personalizar aún más la notificación push:

Tipo de mensaje Elemento de mensaje configurable (nombre de carga útil de FCM) Opciones configurables (nombre de carga útil de FCM)
mensaje de datos N/D dryRun
mensaje de notificación title, body, android_channel_id, icon, sound, tag, color, click_action
dryRun

Ampliación del esquema appsubscriptionRcp

Obtenga información sobre cómo ampliar el esquema appsubscriptionRcp con este vídeo

Debe ampliar appsubscriptionRcp para definir nuevos campos que almacenen parámetros de la aplicación en la base de datos de Campaign. Estos campos se utilizarán, por ejemplo, para la personalización. Para ello:

  1. Cree una extensión del esquema Subscriber applications (nms:appsubscriptionRcp) y defina los campos nuevos. Obtenga más información sobre la extensión de esquema en esta página.

  2. Defina la asignación en la pestaña Subscription parameters.

    ATENCIÓN

    Asegúrese de que los nombres de configuración en la pestaña Subscription parameters sean los mismos que los del código de la aplicación móvil. Consulte la sección Integración del SDK de campaña en la aplicación móvil.

Creación de una notificación enriquecida de Android

Con Firebase Cloud Messaging, puede elegir entre dos tipos de mensajes:

  • Data message, gestionado por la aplicación del cliente.

    Los mensajes se envían directamente a la aplicación móvil, que generará y mostrará la notificación de Android al dispositivo. Los mensajes de datos solo contienen las variables de aplicación personalizadas.

  • Notification message, gestionado automáticamente por el SDK de FCM.

    FCM muestra automáticamente el mensaje en los dispositivos de los usuarios en nombre de la aplicación del cliente. Los mensajes de notificación contienen un conjunto predefinido de parámetros y opciones, pero pueden personalizarse aún más con las variables de aplicación personalizadas.

Para obtener más información sobre los tipos de mensajes de Firebase Cloud Messaging, consulte la documentación de FCM.

Creación de un mensaje de datos

  1. Vaya a Campaign management > Deliveries.

  2. Haga clic New.

  3. Seleccione Deliver on Android (android) en la lista desplegable Delivery template. Añada un Label al envío.

  4. Haga clic en To para definir la población en destinatario. De forma predeterminada, se aplica la asignación de destino Subscriber application. Haga clic en Add para seleccionar el servicio.

  5. En la ventana Target type, seleccione Subscribers of an Android mobile application y haga clic en Next.

  6. En la lista desplegable Service, seleccione el servicio creado anteriormente y, a continuación, la aplicación, y haga clic en Finish.
    Las Application variables se añaden automáticamente en función de lo que se añadió durante los pasos de configuración.

  7. Seleccione data message como Message Type.

  8. Edite la notificación enriquecida.

  9. Puede agregar información en la configuración Application variables si es necesario. Application variables debe configurarse en el servicio Android y formar parte de la carga de mensajes que se envía al dispositivo móvil.

  10. Haga clic en Save y realice la entrega.

La imagen y la página web deberían aparecer en la notificación push cuando se reciban en los dispositivos móviles Android de los suscriptores.

Creación de mensajes de notificación

NOTA

Las opciones adicionales para los mensajes de notificación solo están disponibles con la configuración de la API HTTP v1. Para obtener más información, consulte esta sección.

Obtenga información sobre cómo crear una notificación push de Android con este vídeo

  1. Vaya a Campaign management > Deliveries.

  2. Haga clic New.

  3. Seleccione Deliver on Android (android) en la lista desplegable Delivery template. Añada un Label al envío.

  4. Haga clic en To para definir la población en destinatario. De forma predeterminada, se aplica la asignación de destino Subscriber application. Haga clic en Add para seleccionar el servicio.

  5. En la ventana Target type, seleccione Subscribers of an Android mobile application y haga clic en Next.

  6. En la lista desplegable Service, seleccione el servicio creado anteriormente y, a continuación, la aplicación, y haga clic en Finish.

  7. Seleccione notification message como Message Type.

  8. Añada un título y edite el mensaje. Personalice la notificación push con Notification options:

    • Channel ID: configure el ID de canal de la notificación. La aplicación debe crear un canal con este ID de canal antes de recibir cualquier notificación.
    • Sound: configure el sonido para que se reproduzca cuando el dispositivo reciba la notificación.
    • Color: configure el color del icono de la notificación.
    • Icon: configure el icono de la notificación para que se muestre en los dispositivos de sus perfiles.
    • Tag: establezca el identificador utilizado para reemplazar las notificaciones existentes en el cajón de notificaciones.
    • Click action: configure en la notificación la acción asociada con el clic del usuario.

    Para obtener más información sobre Notification options y cómo rellenar estos campos, consulte la documentación de FCM.

  9. Si la aplicación está configurada con el protocolo de API HTTP v1, puede personalizar aún más la notificación push con el siguiente HTTPV1 additional options:

    • Ticker: configure el texto del valor de la notificación. Solo está disponible para dispositivos configurados con Android 5.0 Lollipop.
    • Image: configure la dirección URL de la imagen para que se muestre en la notificación.
    • Notification Count: configure el número de información nueva sin leer para que se muestre directamente en el icono de la aplicación.
    • Sticky: establezca en true o false. Si se establece en false, la notificación se descarta automáticamente cuando el usuario hace clic en ella. Si se establece en true, la notificación se seguirá mostrando incluso cuando el usuario haga clic en ella.
    • Notification Priority: establezca los niveles de prioridad de la notificación en predeterminados, mínimos, bajos o altos. Para más información, consulte la documentación de FCM.
    • Visibility: establezca los niveles de visibilidad de la notificación en pública, privada o secreta. Para más información, consulte la documentación de FCM.

    Para obtener más información sobre HTTP v1 additional options y cómo rellenar estos campos, consulte la documentación de FCM.

  10. Puede agregar información en la configuración Application variables si es necesario. Application variables debe configurarse en el servicio Android y formar parte de la carga de mensajes que se envía al dispositivo móvil.

  11. Haga clic en Save y realice la entrega.

La imagen y la página web deberían aparecer en la notificación push cuando se reciban en los dispositivos móviles Android de los suscriptores.

En esta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now