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 y 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. Marque requisitos previos.
  2. Configuración de un propiedad de etiqueta móvil en Recopilación de datos de Adobe Experience Platform.
  3. Obtenga el SDK de Adobe Experience Platform Mobile tal como se detalla en esta página.
  4. (Opcional) Habilite el registro y las métricas del ciclo vital, tal como se detalla a continuación en esta página.
  5. (opcional) Agregar Adobe Experience Platform Assurance en la aplicación to validate your implementation. Learn how to implement Adobe Experience Platform Assurance extension in this page.
  6. Configure los servicios móviles de iOS y Android en Adobe Campaign según se detalla en esta página.
  7. Instalación y configuración Extensión de Adobe Campaign en su propiedad móvil.
  8. Seguir Documentación del SDK de Adobe Experience Platform Mobile para configurar los SDK de Adobe Experience Platform Mobile en la 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 tenga que asignar el conjunto completo de permisos a un único perfil de producto o compartir permisos entre el desarrollador de aplicaciones y Adobe Campaign administrador.

Para asignar Propiedad y Compañía derechos, siga los pasos a continuación:

  1. Acceda a la Admin Console.

  2. Desde el Products , seleccione la pestaña Adobe Experience Platform Data Collection Tarjeta de.

  3. Seleccionar un existente Product Profile o cree uno nuevo con la variable New profile botón. Obtenga información sobre cómo crear un nuevo New profile en el 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 SDK de Adobe Experience Platform Mobile.

  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 pueda configurar las credenciales push en Recopilación de datos de Adobe Experience Platform.

  8. Haga clic en Save.

Para asignar esto Product profile para los usuarios de, siga los pasos a continuación:

  1. Acceda a la Admin Console.

  2. Desde el Products , seleccione la pestaña Adobe Experience Platform Data Collection Tarjeta de.

  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 ha creado anteriormente en Admin Console, consulte la Documentación de Adición de 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 integre su aplicación móvil con los SDK para móviles de Adobe Experience Platform.

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

  • Para Apple iOS: Obtenga información sobre cómo registrar la aplicación con APNS en Documentación de Apple
  • Para Google Android: Obtenga información sobre cómo configurar una aplicación cliente de Firebase Cloud Messaging en Android en Documentación de Google

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. Obtenga información sobre cómo crear y configurar una propiedad móvil en Documentación del SDK de Adobe Experience Platform Mobile.

Más información sobre Adobe Experience Platform Data Collection etiquetas 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. Navegar a Flujo de publicación en el panel de navegación izquierdo y seleccione Añadir biblioteca.
  2. Introduzca el nombre de la biblioteca y seleccione el entorno.
  3. Seleccionar Añadir todos los recursos modificados, y Guardar y generar en desarrollo.
  4. Finalmente, establezca esta biblioteca como su biblioteca de trabajo desde el Seleccionar una biblioteca de trabajo botón.

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

Una vez configurada la aplicación móvil en en, Adobe Experience Platform Data Collection, debe crear dos servicios (uno para dispositivos iOS y otro para Android) desde los que poder enviar notificaciones push 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. Navegar a Profiles and Targets > Services and Subscriptions y haga clic en Create.

    {width="800"}

  2. Introduzca una Label y un Internal name y seleccione una Mobile application escriba.

    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 sobre las asignaciones de destino en esta página.
  3. A continuación, utilice el Add en la parte 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. Introduzca el nombre de su aplicación en la Label field.

  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, la variable mediaURl y mediaExt Las variables de se agregan para crear notificaciones push enriquecidas y, a continuación, proporcionan a la aplicación la imagen que se mostrará en la notificación.

    {width="600"}

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

  5. Vaya a la 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 es el mismo Integration key se define 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 de la 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… a continuación, seleccione la clave p12 e introduzca la contraseña proporcionada por 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. Introduzca el nombre de su aplicación en la Label field.

  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 es el mismo Integration key se define 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 de la Application icon para personalizar la aplicación móvil en el servicio.

  5. Seleccionar HTTP v1 in API version lista desplegable.

  6. Clic Load project json file to extract project details… 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 Test connection no comprueba si el servidor MID tiene acceso al servidor FCM.
  8. (opcional) Puede enriquecer el contenido de un mensaje push con Application variables si es necesario. 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

El Extensión de Adobe Campaign Classic para los SDK de Adobe Experience Platform Mobile alimenta las notificaciones push de sus aplicaciones móviles y le ayuda a recopilar tokens push de usuario y a gestionar 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 Extensiones y abra el Catálogo pestaña. Utilice el campo de búsqueda para encontrar la variable Adobe Campaign Classic extensión.
  3. En la tarjeta de Campaign Classic, haga clic en Instalar botón.
  4. Introduzca la configuración tal como se describe en Documentación del SDK de Adobe Experience Platform Mobile.

Ahora puede añadir 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