Configuración de canal de notificaciones push push-notification-configuration

Para enviar notificaciones push con Adobe Campaign, primero debe configurar el entorno y la aplicación como se detalla en esta página. En Adobe Campaign, el canal para enviar notificaciones push es el canal de aplicaciones móviles.

CAUTION
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. Más información.

Antes de empezar a enviar notificaciones push con Adobe Campaign, debe asegurarse de que las configuraciones e integraciones estén implementadas en la aplicación móvil y para las etiquetas en Adobe Experience Platform. El SDK de Adobe Experience Platform Mobile proporciona API de integración del lado del cliente para sus móviles a través de SDK compatibles con Android y iOS.

Para configurar la aplicación con los SDK para móviles de Adobe Experience Platform, siga estos pasos:

  1. Compruebe requisitos previos.
  2. Configure una propiedad de etiquetas móviles en la recopilación de datos de Adobe Experience Platform.
  3. Obtenga el SDK de Adobe Experience Platform Mobile como se detalla en esta página.
  4. (opcional) Habilite el registro y las métricas del ciclo vital, tal como se detalla en esta página.
  5. (opcional) Agregue Adobe Experience Platform Assurance a su aplicación para validar la implementación. Aprenda a implementar la extensión de Adobe Experience Platform Assurance en esta página.
  6. Configure sus servicios móviles iOS y Android en Adobe Campaign como se detalla en esta página.
  7. Instale y configure Adobe Campaign Extension en su propiedad móvil.
  8. Siga la documentación del SDK de Adobe Experience Platform Mobile para configurar los SDK de Adobe Experience Platform Mobile en su aplicación.

Requisitos previos before-starting

Configuración de permisos setup-permissions

Antes de crear una aplicación móvil, primero debe asegurarse de que tiene o asigna los permisos de usuario correctos para las etiquetas en Adobe Experience Platform. Los permisos de usuario para las etiquetas en Adobe Experience Platform se asignan a los usuarios a través de Adobe Admin Console. Obtenga más información en Documentación de etiquetas.

CAUTION
La configuración push la debe realizar un usuario experto. Según el modelo de implementación y las personas involucradas en esta implementación, es posible que deba asignar el conjunto completo de permisos a un único perfil de producto o compartir permisos entre el desarrollador de la aplicación y el administrador de Adobe Campaign.

Para asignar los derechos de Property y Company, siga los pasos a continuación:

  1. Obtener acceso a Admin Console.

  2. En la ficha Products, seleccione la tarjeta Adobe Experience Platform Data Collection.

  3. Seleccione un(a) Product Profile existente o cree uno nuevo con el botón New profile. Aprenda a crear un nuevo(a) New profile en la documentación de Admin Console.

  4. En la pestaña Permissions, seleccione Property Rights.

  5. Haga clic en Add all. Esto añadirá el siguiente derecho a su perfil de producto:

    • Approve
    • Develop
    • Edit Property
    • Manage Environments
    • Manage Extensions
    • Publish

    Estos permisos son necesarios para instalar y publicar la extensión de Adobe Campaign y publicar la propiedad de la aplicación en Adobe Experience Platform Mobile SDK.

  6. A continuación, seleccione Company rights en el menú de la izquierda.

  7. Añada los siguientes derechos:

    • Manage App Configurations
    • Manage Properties

    Estos permisos son necesarios para que el desarrollador de aplicaciones móviles configure las credenciales push en Recopilación de datos de Adobe Experience Platform.

  8. Haga clic en Save.

Para asignar este(a) Product profile a usuarios, siga los pasos a continuación:

  1. Obtener acceso a Admin Console.

  2. En la ficha Products, seleccione la tarjeta Adobe Experience Platform Data Collection.

  3. Seleccione el Product profile configurado anteriormente.

  4. En la pestaña Users, haga clic en Add user.

  5. Escriba el nombre o la dirección de correo electrónico del usuario y seleccione el usuario. A continuación, haga clic en Save.

    note note
    NOTE
    Si el usuario no se creó anteriormente en Admin Console, consulte la Documentación para agregar usuarios.

Configurar su aplicación configure-app

La configuración técnica implica una estrecha colaboración entre el desarrollador de la aplicación y el administrador empresarial. Antes de empezar a enviar notificaciones push con Adobe Campaign, debe definir la configuración en Adobe Experience Platform Data Collection e integrar su aplicación móvil con los SDK de Adobe Experience Platform Mobile.

Siga los pasos de implementación detallados en los vínculos siguientes:

Configuración de una propiedad de etiquetas móviles en la recopilación de datos de Adobe Experience Platform launch-property

La configuración de una propiedad móvil permite al desarrollador o al experto en marketing de la aplicación móvil configurar los SDK móviles. Normalmente, creará una propiedad móvil para cada aplicación móvil que desee administrar. Aprenda a crear y configurar una propiedad móvil en Documentación del SDK móvil de Adobe Experience Platform.

Obtenga más información acerca de las etiquetas Adobe Experience Platform Data Collection en Documentación de Adobe Experience Platform.

Una vez creada, abra la nueva propiedad de etiqueta y cree una biblioteca. Para ello, haga lo siguiente:

  1. Vaya a Flujo de publicación en el panel de navegación izquierdo y seleccione Agregar biblioteca.
  2. Introduzca el nombre de la biblioteca y seleccione el entorno.
  3. Seleccione Agregar todos los recursos modificados y Guardar y generar en desarrollo.
  4. Finalmente, establezca esta biblioteca como su biblioteca de trabajo desde el botón Seleccionar una biblioteca de trabajo.

Configuración de los servicios móviles en Campaign push-service

Una vez configurada la aplicación móvil en Adobe Experience Platform Data Collection, debe crear dos servicios (uno para dispositivos iOS y otro para dispositivos Android) para poder enviar notificaciones push desde Adobe Campaign.

Las notificaciones push se envían a los usuarios de la aplicación a través de un servicio dedicado. Cuando los usuarios instalan la aplicación, se suscriben a este servicio: Adobe Campaign depende de este servicio para dirigirse únicamente a los suscriptores de la aplicación. En este servicio, debe agregar sus aplicaciones de iOS y Android para enviarlas en dispositivos iOS y Android.

Para crear un servicio para enviar notificaciones push, siga los pasos a continuación:

  1. Vaya a la ficha Profiles and Targets > Services and Subscriptions y haga clic en Create.

    {width="800"}

  2. Escriba Label y Internal name y seleccione un tipo 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. Obtenga más información acerca de las asignaciones de destino en esta página.
  3. A continuación, utilice el icono Add de la derecha para definir las aplicaciones móviles que utilizan este servicio.

iOS

Para crear una aplicación para dispositivos iOS, siga estos pasos:

  1. Seleccione Create an iOS application y haga clic en Next.

    {width="600"}

  2. Escriba el nombre de su aplicación en el campo Label.

  3. (opcional) Puede enriquecer el contenido de un mensaje push con Application variables. Son totalmente personalizables y una parte de la carga útil de mensajes se envía al dispositivo móvil.

    En el ejemplo siguiente, se agregan las variables mediaURl y mediaExt para crear notificaciones push enriquecidas y, a continuación, se proporciona a la aplicación la imagen que se mostrará en la notificación.

    {width="600"}

  4. Vaya a la pestaña Subscription parameters para definir la asignación con una extensión del esquema Subscriber applications (nms:appsubscriptionRcp).

  5. Vaya a la ficha Sounds para definir un sonido para reproducir. Haga clic en Add y rellene el campo Internal name que debe contener el nombre del archivo incrustado en la aplicación o el nombre del sonido del sistema.

  6. Haga clic en Next para comenzar a configurar la aplicación de desarrollo.

  7. La clave de integración es específica para cada aplicación. Vincula la aplicación móvil a Adobe Campaign.

    Asegúrese de que se ha definido el mismo Integration key en Adobe Campaign y en el código de la aplicación a través del SDK.

    Obtenga más información en la documentación para desarrolladores

    note note
    NOTE
    Integration key es totalmente personalizable con un valor de cadena, pero debe ser exactamente igual al especificado en el SDK.
    No puede utilizar el mismo certificado para la versión de desarrollo (entorno limitado) y la versión de producción de la aplicación.
  8. Seleccione el icono del campo Application icon para personalizar la aplicación móvil en el servicio.

  9. Seleccione el Authentication mode. Hay dos modos disponibles:

    • (Recomendado) Token-based authentication: complete la configuración las conexiones APNS Key Id, Team Id y Bundle Id y luego seleccione el certificado p8 haciendo clic en Enter the private key…. Para más información sobre Token-based authentication, consulte la documentación de Apple.

    • Certificate-based authentication: haga clic en Enter the certificate…, seleccione la clave p12 e introduzca la contraseña que proporcionó el desarrollador de aplicaciones móviles. Tenga en cuenta que este certificado viene con una fecha de caducidad y debe renovarse anualmente. Para evitar interrupciones en el servicio para los usuarios, actualice los certificados antes de que caduquen. Los certificados son válidos durante un año y debe actualizarlos para seguir comunicándose con APNS.

  10. Utilice el botón Test the connection para validar la configuración.

  11. Haga clic en Next para configurar la aplicación de producción y siga los mismos pasos detallados anteriormente.

  12. Haga clic en Finish.

La aplicación de iOS ya está lista para su uso en Campaign.

Android

Para crear una aplicación para dispositivos Android, siga estos pasos:

  1. Seleccione Create an Android application y haga clic en Next.

    {width="600"}

  2. Escriba el nombre de su aplicación en el campo Label.

  3. La clave de integración es específica para cada aplicación. Vincula la aplicación móvil a Adobe Campaign.

    Asegúrese de que se ha definido el mismo Integration key en Adobe Campaign y en el código de la aplicación a través del SDK.

    Obtenga más información en la documentación para desarrolladores

    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 el icono del campo Application icon para personalizar la aplicación móvil en el servicio.

  5. Seleccione HTTP v1 en la lista desplegable API version.

  6. Haga clic en Load project json file to extract project details… vínculo para cargar el archivo con clave JSON. Para obtener más información sobre cómo extraer el archivo JSON, consulte Documentación de Google Firebase.

    También puede introducir manualmente los siguientes detalles:

    • Project Id
    • Private Key
    • Client Email
  7. Utilice el botón Test the connection para validar la configuración.

    note caution
    CAUTION
    El botón Test connection no comprueba si el servidor MID tiene acceso al servidor FCM.
  8. (opcional) Si es necesario, puede enriquecer el contenido de un mensaje push con Application variables. Son totalmente personalizables y una parte de la carga útil de mensajes se envía al dispositivo móvil.

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

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

table 0-row-3 1-row-3 2-row-3 1-align-center 2-align-center 3-align-center 5-align-center 6-align-center 7-align-center 9-align-center 10-align-center 11-align-center
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 extensión de Adobe Campaign en la propiedad móvil configure-extension

La extensión de Adobe Campaign Classic para los SDK de Adobe Experience Platform Mobile envía notificaciones push a sus aplicaciones móviles, le ayuda a recopilar tokens push de usuario y administra la medición de interacciones con los servicios de Adobe Experience Platform.

Esta extensión, que se aplica tanto a Campaign Classic v7 como a Campaign v8, está preinstalada en el entorno y debe configurarse. Para configurar la extensión para la propiedad de etiquetas móviles, siga estos pasos:

  1. Abra la propiedad de etiquetas que creó anteriormente.
  2. En el panel de navegación izquierdo, vaya a Extensions y abra la pestaña Catalog. Utilice el campo de búsqueda para encontrar la extensión Adobe Campaign Classic.
  3. En la tarjeta de Campaign Classic, haga clic en el botón Instalar.
  4. Especifique la configuración tal como se describe en Documentación del SDK de Adobe Experience Platform Mobile.

Ahora puede agregar Campaign a la aplicación, tal como se detalla en Documentación del SDK de Adobe Experience Platform Mobile.

recommendation-more-help
35662671-8e3d-4f04-a092-029a056c566b