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.

Los pasos clave son los siguientes:

Podrá crear una notificación enriquecida de Android.

IMPORTANT
Algunos cambios importantes en el servicio Android Firebase Cloud Messaging (FCM) se lanzarán en 2024 y pueden afectar a la implementación de Adobe Campaign. Es posible que sea necesario actualizar la configuración de los servicios de suscripción para los mensajes push de Android a fin de que admitan este cambio. Ya puede comprobar y realizar acciones. Obtenga más información en esta nota técnica de Adobe Campaign versión 8.

Configuración de la cuenta externa de Android configuring-external-account-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

    note note
    NOTE
    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 de Android configuring-android-service

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.

    note note
    NOTE
    La asignación de destino predeterminada Subscriber applications (nms:appSubscriptionRcp) está relacionada con la tabla de destinatarios. Si desea utilizar una asignación de destinatario 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 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.

Creación de la aplicación móvil de Android creating-android-app

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 aplicación a través del SDK.

    note note
    NOTE
    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 reconciliación compleja), es necesario aplicar la siguiente configuración:

Configure la versión de la API select-api-version

IMPORTANT
Algunos cambios importantes en el servicio Android Firebase Cloud Messaging (FCM) se lanzarán en 2024 y pueden afectar a la implementación de Adobe Campaign. Como parte del esfuerzo continuo de Google por mejorar sus servicios, las API de FCM existentes dejarán de usarse el 20 de junio de 2024. Obtenga más información en esta nota técnica de Adobe Campaign versión 8.

Después de crear el servicio y una nueva aplicación móvil, deberá configurar la aplicación móvil. La API de HTTP (existente) no debe seleccionarse, ya que ha quedado obsoleta en Google.

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

    note caution
    CAUTION
    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

Ampliación del esquema appsubscriptionRcp extend-subscription-schema

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

Deberá ampliar appsubscriptionRcp para definir nuevos campos adicionales que almacenen parámetros de la aplicación en la base de datos de Campaign. Estos campos se utilizan, 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.

    note caution
    CAUTION
    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.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1