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).

Configurar un servicio de 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 la asignación de destino, consulte esta secció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.

Crear la 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 esta sección.

    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.

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 esta sección.

En esta página