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.
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:
-
Vaya a Administration > Platform > External accounts.
-
Seleccione la cuenta externa Android routing.
-
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. -
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.
-
Vaya al nodo Profiles and Targets > Services and subscriptions y seleccione New.
-
Defina un Label y un Internal name.
-
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. -
A continuación, haga clic en el botón Add para seleccionar el tipo de aplicación.
-
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:
-
En el servicio recién creado, haga clic en el botón Add para seleccionar el tipo de aplicación.
-
Seleccione Create an Android application y escriba un Label.
-
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. -
Seleccione la API version: HTTP v1 o HTTP (heredada). Estas configuraciones se detallan en esta sección
-
Rellene los campos Firebase Cloud Messaging the Android connection settings.
-
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
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:
-
En la ventana Mobile application creation wizard, seleccione HTTPV1 en la lista desplegable API version.
-
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
-
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. -
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.
-
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:
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:
-
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.
-
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.