Personalización de contenido de AEM Mobile aem-mobile-content-personalization

NOTE
Adobe SPA recomienda utilizar el Editor de para proyectos que requieran una representación del lado del cliente basada en el marco de trabajo de la aplicación de una sola página (por ejemplo, React). Más información.
NOTE
Este documento forma parte del Introducción a AEM Mobile Guía, un punto de partida recomendado para referencia de AEM Mobile.

La función de personalización de contenido de AEM Mobile permite AEM Autores de para personalizar el contenido de la aplicación móvil mediante Adobe Target. Esto permite enviar ofertas segmentadas a usuarios de aplicaciones móviles. Adobe Experience Manager Mobile permite crear, segmentar y entregar contenido que proporcione al usuario contenido específico para sus propios gustos individuales.

AEM En la práctica, para que los autores empiecen a crear este contenido, los administradores y desarrolladores deben preparar primero el entorno.

AEM administradores de son necesarios para establecer una conexión entre AEM Mobile y el Cloud Service de Adobe Target.

Mientras tanto, AEM Mobile desarrolladores deben editar sus scripts existentes para facilitar la creación de contenido de destino.

Para administradores for-administrators

Existen varios pasos que deben cumplirse para que los autores de contenido puedan empezar a generar contenido de destino para aplicaciones móviles: Obtención del conjunto adecuado de permisos para usuarios y grupos, creación de servicios en la nube, configuración de la aplicación para la actividad y, finalmente, generación del contenido.

Este artículo le guía a través del proceso utilizado para configurar la variable Aplicación de referencia híbrida de AEM Mobile para la segmentación.

En adelante, se supone que la aplicación de referencia híbrida de AEM Mobile se ha implementado correctamente y se puede acceder a ella desde el panel de AEM Mobile.

AEM Para que los autores puedan generar contenido de destino dentro de una aplicación, la instancia de debe ser configurado con el Cloud Service de Adobe Target.

Permisos permissions

Los usuarios que necesitan acceder a la consola de personalización deben formar parte de target-activity-authors grupo.

Se sugiere que, como parte de la configuración de usuarios y grupos, el grupo de actividad de destinatario se agregue al grupo de administradores de aplicaciones. Al agregar el grupo target-activity-authors, esto permite a los usuarios ver la entrada del menú de navegación Personalización.

NOTE
Si se olvida agregar los usuarios o grupos a los que desea tener acceso con el Admin Console de personalización al grupo target-activity-authors, los usuarios no podrán ver la consola de personalización.

Cloud Services cloud-services

Para que el contenido de destino funcione para aplicaciones móviles, hay dos servicios que deben configurarse: el servicio Adobe Target y el servicio Adobe Mobile Services. El servicio Adobe Target proporciona el motor para procesar las solicitudes de los clientes y devolver el contenido personalizado. El servicio de Adobe Mobile Services proporciona la conexión entre los servicios de Adobe y la aplicación móvil a través del archivo ADBMobileConfig.json, que consume el complemento AMS Cordova. Desde el panel de control de AEM Mobile, puede configurar la aplicación añadiendo los dos servicios.

En el panel de AEM Mobile, busque Administrar Cloud Service y haga clic en el botón +.

chlimage_1-38

En el asistente Agregar Cloud Service, seleccione la tarjeta de servicio en la nube Adobe Target y haga clic en Siguiente.

chlimage_1-39

En la lista desplegable Seleccionar una configuración, puede crear una configuración o seleccionar una de las existentes. Para crear una configuración, seleccione "Crear configuración" en la lista desplegable. Introduzca un título para la configuración de Target. Introduzca el código de cliente, el correo electrónico y la contraseña asociados a su cuenta de Target. Si no conoce los valores de estos campos, póngase en contacto con el servicio de asistencia de Adobe Target. Haga clic en el botón "Verificar" para validar las credenciales. Una vez verificado, haga clic en el botón Enviar para crear el servicio en la nube.

NOTE
El servicio en la nube que se crea se asocia automáticamente a la aplicación móvil mediante el asistente. El valor de la propiedad cq:cloudserviceconfigs se establece en el nodo jcr:content del nodo de grupo de aplicaciones. Para el ejemplo de aplicación híbrida, se establece en /content/mobileapps/hybrid-reference-app/jcr:content con el valor que señala al nodo de marco de trabajo generado automáticamente en /etc/cloudservices/testandtarget/adobe-target-aem-apps/framework. El nodo de marco de trabajo tiene dos propiedades establecidas de forma predeterminada: sexo y edad. AEM El marco de trabajo solo se utiliza con la vista previa de la vista previa de la y no tiene ningún impacto en el dispositivo.

Una vez completado el asistente, el mosaico Administrar Cloud Service contiene el servicio en la nube de Target. Sin embargo, contiene una advertencia sobre la falta de una cuenta de Adobe Mobile Service.

chlimage_1-40

Adobe Mobile Services adobe-mobile-services

Es necesario vincular también una cuenta de Adobe Mobile Services (AMS) a la aplicación. El servicio AMS proporciona el archivo ADBMobileConfig.json requerido que contiene la información del código de cliente de Target. Antes de crear una asociación con la cuenta de AMS, la cuenta de AMS debe ser modificada por un usuario que tenga permisos de AMS.

Código de cliente client-code

Para iniciar sesión en los servicios de AMS, visite https://mobilemarketing.adobe.com, seleccione la aplicación móvil y haga clic en la configuración. Busque el campo Opciones de Target de SDK, coloque el código de cliente en el campo y haga clic en Guardar.

chlimage_1-41

Ahora que el código de cliente se ha asociado a la aplicación móvil, cuando el servicio en la nube de AMS se configura mediante el Panel de control móvil de Adobe, los ajustes de los servicios se entregarán mediante el archivo ADBMobileConfig.json.

Cloud Service de Adobe Mobile Services adobe-mobile-service-cloud-service

Ahora que AMS está configurado, es hora de asociar la aplicación móvil al panel de control de Adobe Mobile. En el panel de AEM Mobile, busque Administrar Cloud Service y haga clic en el botón +.

chlimage_1-42

Seleccione la tarjeta de Adobe Mobile Services y haga clic en Siguiente.

chlimage_1-43

En el paso del asistente Crear o Seleccionar, seleccione la lista desplegable Mobile Services y la entrada Crear configuración. Proporcione un título, una empresa, un nombre de usuario y una contraseña, y seleccione el centro de datos adecuado. Si no conoce estos valores, póngase en contacto con el administrador de Adobe Mobile Services para obtenerlos. Una vez rellenados todos los campos, haga clic en Verificar. El proceso de verificación va a AMS y verifica las credenciales de la cuenta. Una vez validada correctamente, se rellena una lista de aplicaciones móviles en la que se selecciona la aplicación móvil asociada en el menú desplegable. Clic Enviar para completar el asistente. El proceso puede tardar un poco en obtener los datos de configuración y cualquier análisis asociado con la aplicación. Una vez completado el proceso, haga clic en Listo para volver al Panel de control de Adobe Mobile.

Al volver al panel móvil, el mosaico Administrar Cloud Service contiene el servicio en la nube de AMS. Además, el mosaico Analizar métricas se rellena con informes de ciclo vital.

chlimage_1-44

Para autores for-authors

Requisito previo: Como se ha mencionado anteriormente, los administradores deben configurar la conexión con el servicio de Adobe Target para que los autores puedan generar nuevo contenido de destino.

Una vez que el administrador ha configurado los dos servicios en la nube y el desarrollador ha configurado el controlador de ofertas móviles, los autores de contenido ahora pueden empezar a generar experiencias segmentadas.

La creación de contenido de destino en una aplicación de AEM Mobile sigue un procedimiento similar al de la creación de AEM Sites:

Consulte aquí una descripción general completa de AEM Creación de contenido segmentado en el

Para desarrolladores for-developers

AEM AEM Los desarrolladores de aplicaciones móviles deben seguir siguiendo los patrones que se usan con frecuencia a lo largo de los procesos de desarrollo de componentes en las aplicaciones móviles de los. En este caso, Adobe le guía por los pasos necesarios para permitir que los autores de contenido creen contenido de destino:

Controladores ContentSync de Adobe Target adobe-target-contentsync-handlers

AEM Para enviar contenido al dispositivo del usuario, el contenido se genera procesando las ofertas creadas por los autores de contenido Para gestionar la renderización de ofertas de destino, hay un nuevo controlador de sincronización de contenido que procesa las ofertas. Utilizando la aplicación de referencia híbrida como ejemplo, el paquete de contenido en (inglés) contiene ContentSyncConfig con un mobileappoffers controlador. El siguiente paso es crucial para procesar ofertas en el dispositivo. El controlador de ofertas móviles tiene una propiedad path que identifica la ruta a la actividad de personalización que se va a utilizar para la aplicación.

Por ejemplo, si hay una actividad en /content/campaigns/hybridref, copie esta ruta y péguela como el valor en ruta propiedad del controlador mobileapps.

NOTE
Para la aplicación de referencia híbrida, hay dos controladores de ofertas móviles, uno para desarrollo y otro para producciones.

Una vez establecida la ruta de las actividades en la propiedad path del controlador de ofertas móviles, guarde el controlador. El controlador ya está listo para iniciar las ofertas de procesamiento para dispositivos móviles.

Modo de procesamiento render-mode

El controlador mobileapps está configurado de forma diferente para las configuraciones de publicación y desarrollo. Para las configuraciones de publicación hay una propiedad llamada renderMode con un valor de publicar se establece en el nodo cq:ContentSyncConfig. El controlador mobileapps hace referencia a renderMode y, si se establece en publish, edita el id de mbox que se crea. AEM De forma predeterminada, los mboxes que crea el usuario tienen el valor —author anexado al id de mbox. Esto identifica que la actividad no se ha publicado y debe utilizar la campaña sin publicar para las resoluciones de oferta.

Cuando el contenido se almacena en zona intermedia mediante el panel de Adobe Mobile, el contenido almacenado en zona intermedia se considera contenido listo para la producción y se procesa mediante la configuración de sincronización de contenido no desarrollada. Procesar de esta manera hará que —author se elimine de todos los id de mbox y espere que una actividad publicada esté disponible en el servidor de Target. Antes de probar el contenido ensayado, asegúrese de que la actividad ya se ha publicado.

Personalization App Development personalization-app-development

Componentes components

AEM La base de cualquier contenido suele ser un componente de página que amplía uno de los componentes de página base wcm/foundation/components/page o foundation/components/page, en función de si utiliza HTL o JSP. La duración de estos pasos se centra en el uso del componente wcm/foundation/components/page. La estructura básica del componente de página se desglosa en varios scripts, cada uno de los cuales proporciona el propósito específico de permitir al desarrollador organizar y anular su código si es necesario. Los dos scripts de interés para la personalización son head.html y body.html. Estos dos scripts proporcionan un área en la que se puede insertar código para admitir ContextHub, Cloud Service y Mobile Authoring.

A continuación se ofrece una descripción general de los dos scripts principales utilizados para habilitar la segmentación de contenido.

head.html head-html

Para permitir que el autor dirija su contenido, se debe añadir el menú objetivo a la página para que pueda cambiar el contexto del modo de edición al modo de objetivo. Para habilitar esta función, el desarrollador debe modificar la secuencia de comandos head.html para incluir el siguiente fragmento de código cerca de la parte superior de head.html o lo más cerca posible de <title></title> como sea posible.

<meta data-sly-test="${!wcmmode.disabled}">
    <div data-sly-call="${clientLib.all @ categories='personalization.kernel'}" data-sly-unwrap></div>
    <div data-sly-resource="${'config' @ resourceType='cq/personalization/components/clientcontext_optimized/config'}" data-sly-unwrap></div>
    <div data-sly-resource="${'contexthub' @ resourceType='granite/contexthub/components/contexthub'}" data-sly-unwrap></div>
</meta>
NOTE
Incluya el script solo cuando el modo WCM esté deshabilitado, de modo que cuando el modo WCM esté deshabilitado (consulte la sección del controlador ContentSync para obtener más información), el script no se incluya en el código de aplicación final.

Para proporcionar a los autores la capacidad de previsualizar el contenido de destino, el editor debe poder localizar la configuración del servicio en la nube de Adobe Target. El bloque de código siguiente agrega dos scripts importantes. La primera es añadir la capacidad de la página para localizar el servicio en la nube de Target asociado y realizar las llamadas a Adobe Target. El segundo es la adición de la categoría cq.apps.targeting.

El cq.apps.targeting la categoría anula el componente cq/personalization/component/target predeterminado y utiliza el componente mobileapps/components/target que procesa ofertas específicas para el consumo de aplicaciones móviles. Se tratarán más detalles sobre esto en la sección Componente de Target.

El código debe añadirse en head.html y colocarse justo antes del final del </head> Elemento.

<div data-sly-test="${!wcmmode.disabled}">
    <div data-sly-include="/libs/cq/cloudserviceconfigs/components/servicelibs/servicelibs.jsp" data-sly-unwrap></div>
    <meta data-sly-call="${clientLib.all @ categories='cq.apps.targeting'}" data-sly-unwrap></meta>
</div>
NOTE
El bloque de código se envuelve dentro de un modo WCM sin desactivarse, por lo que solo entra en juego mientras el autor del contenido trabaja en la creación de contenido. Los scripts del servicio en la nube no se agregan al código de tiempo de ejecución móvil generado.

body.html body-html

Para que el autor del contenido pueda probar diferentes personalidades, la secuencia de comandos body.html debe incluir el siguiente bloque de código como primer elemento secundario del elemento body.

<div data-sly-test="${!wcmmode.disabled}">
    <div data-sly-resource="${'clientcontext' @ resourceType='cq/personalization/components/clientcontext_optimized'}" data-sly-unwrap></div>
</div>

El último bit de código requerido está en la parte inferior de body.html. Este bit de código busca el servicio en la nube asociado e inserta el código de motor de segmentación adecuado.

<div data-sly-test="${!wcmmode.disabled}">
    <div data-sly-resource="${'cloudservices' @ resourceType='cq/cloudserviceconfigs/components/servicecomponents'}" data-sly-unwrap></div>
</div>

Aplicación de referencia reference-application

Encontrará ejemplos de head.html y body.html en la Aplicación de referencia híbrida de AEM Mobile mostrando al desarrollador dónde colocar los bloques de script dentro de los dos scripts.

Controladores de sincronización de contenido content-sync-handlers

Cuando el autor del contenido ha terminado de crear contenido para la aplicación móvil, el siguiente paso es descargar la fuente y crear la aplicación o almacenar en zona intermedia el contenido que se va a publicar. El desarrollador debe seguir varios pasos para que esto suceda. Para ayudar a procesar el contenido, AEM Mobile utiliza controladores de sincronización de contenido para procesar y empaquetar el contenido. Se ha introducido un nuevo controlador de sincronización de contenido para el caso de uso Personalización para procesar contenido de destino. El controlador "mobileapps" sabe cómo procesar las ofertas de destino asociadas que ha creado el autor del contenido. El controlador mobileapps amplía el controlador de actualización de páginas abstractas, por lo que muchas de las propiedades son similares. Los detalles del controlador mobileapps tienen las siguientes propiedades.

Propiedad
Valor
Descripción
reescribir

+ relativeParentPath

- "/"

La propiedad rewrite identifica cómo se deben reescribir las rutas dentro del contenido.
includedPageTypes

"cq/personalization/components/teaserpage",

"cq/personalization/components/offerproxy"

La propiedad includePageTypes es opcional y su valor predeterminado son las páginas que tienen tipos de recursos de cq/personalization/components/teaserpage y cq/personalization/components/offerProxy. Estos dos tipos de recursos son los tipos de recursos predeterminados que se usan cuando se segmenta el contenido. Si se deben admitir tipos de recursos adicionales, agréguelos a la lista de includePageTypes.
locationRoot
/content/mobileapps/<app>
La ubicación de la aplicación.
tipo
mobileappoffers
El nombre del controlador que se ofrece en mobileappfers.
selector
tandt
El selector estándar se utiliza para procesar el contenido segmentado.
targetRootDirectory
www
El directorio raíz en el que se debe conservar el contenido procesado.
includeImages
true | false
Si el valor es True, se procesarán las imágenes incluidas en la oferta. Si es false, las imágenes se omiten.
includeVideos
true | false
Si el valor es True, se procesarán los vídeos incluidos en la oferta. Si es false, los vídeos se omiten.
path
/content/campaigns/<brand>
Señala a la marca de la campaña en la que participan las ofertas. Actualmente, todas las ofertas deben provenir de la misma campaña.
profundo
true | false
Si es true, procesa recursivamente todas las páginas secundarias; si es false, no se repite.
extensión
html
Establece la extensión del recurso que se está representando. Configúrelo en html de forma que las páginas tengan la extensión .html.
NOTE
El Aplicación de referencia híbrida de AEM Mobile tiene la configuración predeterminada del controlador mobileappfer. La propiedad path del ejemplo está vacía, ya que depende de la ubicación de la campaña. Después de que un autor de Campaign haya creado una campaña, el administrador de aplicaciones debe asociar la campaña con el controlador especificando la propiedad de ruta de acceso para que apunte a la campaña.

Componente de destino target-component

Para ayudar a procesar contenido específicamente para aplicaciones móviles, AEM Mobile utiliza el componente mobileapps/components/target. El componente target móvil amplía el componente cq/personalization/components/target y anula el script engine_tnt.jsp. Al anular engine_tnt.jsp, AEM Mobile puede controlar el HTML que se genera en el caso de uso de las aplicaciones móviles. Para cada componente segmentado por un autor de contenido, el archivo engine_tnt.jsp crea un mbox asociado.

Para cada mbox, un atributo de cq-targeting se agrega permitiendo a los desarrolladores de aplicaciones escribir código personalizado para consumirlo y utilizarlo como deseen. El Aplicación de referencia híbrida de AEM Mobile tiene un ejemplo de una directiva de Angular que utiliza el atributo cq-targeting. El concepto de reemplazo de contenido, cuándo y cómo se realiza, depende del desarrollador de aplicaciones móviles. AEM Hay un SDK móvil que se entrega a través de /etc/clientlibs/mobileapps/js/mobileapps.js que proporciona una API para llamar al servicio de segmentación de Adobe. Depende del desarrollador de la aplicación especificar cuándo se debe realizar esa llamada según el diseño de la aplicación.

Siguientes pasos? what-s-next

recommendation-more-help
2eeeb575-8007-40cc-a72d-206fbc4ddd4b