Configuración manual de la integración con Adobe Target manually-configuring-the-integration-with-adobe-target

CAUTION
AEM 6.4 ha llegado al final de la compatibilidad ampliada y esta documentación ya no se actualiza. Para obtener más información, consulte nuestra períodos de asistencia técnica. Buscar las versiones compatibles here.

Puede modificar las configuraciones del asistente para la inclusión que realizó al utilizar el asistente o puede integrarlas manualmente con Adobe Target sin utilizar el asistente.

Modificación de las configuraciones del Asistente para la inclusión modifying-the-opt-in-wizard-configurations

La variable Asistente de inclusión that se integra AEM con Adobe Target crea automáticamente una configuración de nube de Target denominada Configuración de Target aprovisionada. El asistente también crea un marco de Target para la configuración de nube denominada Marco de destino aprovisionado. Si es necesario, puede modificar las propiedades de la configuración de nube y del marco.

También puede configurar Adobe Target para que use Adobe Target como fuente de informes cuando se dirija el contenido configurando la Configuración de A4T Analytics Cloud.

Para localizar la configuración de nube y el marco, vaya a Cloud Services via Herramientas > Implementación > Cloud. (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)
Debajo de Adobe Target, toque o haga clic en Mostrar configuraciones.

Propiedades de configuración de Target aprovisionadas provisioned-target-configuration-properties

Los siguientes valores de propiedad se utilizan en la configuración de nube de Configuración de Target aprovisionada que crea el asistente de inclusión:

  • Código de cliente: Tal como se ha introducido en el asistente de inclusión.

  • Correo electrónico: Tal como se ha introducido en el asistente de inclusión.

  • Contraseña: Tal como se ha introducido en el asistente de inclusión.

  • Tipo de API: REST

  • Sincronizar segmentos desde Adobe Target: Seleccionado.

  • Biblioteca de cliente: mbox.js.

  • Utilice DTM para entregar la biblioteca de cliente: No seleccionado. Seleccione esta opción si usar DTM u otro sistema de administración de etiquetas para alojar el archivo mbox.js o AT.js. Adobe recomienda utilizar DTM en lugar de AEM para entregar la biblioteca.

  • Mbox.js personalizado: No se ha especificado ninguno para que se utilice el archivo mbox.js predeterminado. Especifique un archivo mbox.js personalizado para utilizarlo cuando sea necesario. Solo aparece si ha seleccionado mbox.js.

  • AT.js personalizado: No se ha especificado ninguno para que se utilice el archivo AT.js predeterminado. Especifique un archivo AT.js personalizado para usar según sea necesario. Solo aparece si ha seleccionado AT.js.

NOTE
En AEM 6.3, puede seleccionar el archivo de biblioteca de Target. AT.JS, que es una nueva biblioteca de implementación para Adobe Target que está diseñada tanto para implementaciones web típicas como para aplicaciones de una sola página.
AT.js ofrece varias mejoras con respecto a la biblioteca mbox.js:
  • Se han mejorado los tiempos de carga de las páginas en implementaciones web
  • Seguridad mejorada
  • Mejores opciones de implementación para aplicaciones de una sola página
  • AT.js contiene los componentes que se incluían en target.js, de modo que ya no se llama a target.js

Propiedades de Target Framework aprovisionadas provisioned-target-framework-properties

El marco de Target aprovisionado que crea el asistente de inclusión está configurado para enviar datos de contexto desde el almacén de datos de perfil. Los elementos de datos edad y sexo de la tienda se envían a Target de forma predeterminada. Es probable que la solución requiera que se envíen parámetros adicionales.

chlimage_1-158

Puede configurar la estructura para enviar información de contexto adicional a Target como se describe en Adición de un marco de destino.

Configuración de A4T Analytics Cloud configuring-a-t-analytics-cloud-configuration

Puede configurar Adobe Target para que use Adobe Analytics como fuente de informes al destinar contenido.

Para ello, debe especificar la configuración de nube de A4T con la que conectar la configuración de nube de Adobe Target:

  1. Vaya a Cloud Services a través de la variable Logotipo de AEM > Herramientas > Implementación > Cloud Services.

  2. En la sección Adobe Target, haga clic en Configurar ahora.

  3. Vuelva a conectar con la configuración de Adobe Target.

  4. En el Configuración de A4T Analytics Cloud menú desplegable, seleccione el marco.

    note note
    NOTE
    Solo están disponibles las configuraciones de análisis que están habilitadas para A4T.
    Al configurar A4T con AEM, es posible que vea una entrada que falta en una referencia de configuración. Para poder seleccionar el marco de análisis, haga lo siguiente:
    1. Vaya a Herramientas > General > CRXDE Lite.
    2. Vaya a /libs/cq/analytics/components/testandtargetpage/dialog/items/tabs/items/tab1_general/items/a4tAnalyticsConfig
    3. Establecer la propiedad disable a false.
    4. Toque o haga clic Guardar todo.

    chlimage_1-159

    Haga clic en Aceptar. Cuando segmenta contenido con Adobe Target, puede seleccione el origen del informe.

Integración manual con Adobe Target manually-integrating-with-adobe-target

Integre manualmente con Adobe Target en lugar de utilizar el asistente de inclusión.

NOTE
El archivo de la biblioteca de Target, AT.JS, es una nueva biblioteca de implementación para Adobe Target que está diseñada tanto para implementaciones web típicas como para aplicaciones de una sola página. Adobe recomienda usar AT.js en lugar de mbox.js como biblioteca de cliente.
AT.js ofrece varias mejoras con respecto a la biblioteca mbox.js:
  • Se han mejorado los tiempos de carga de las páginas en implementaciones web
  • Seguridad mejorada
  • Mejores opciones de implementación para aplicaciones de una sola página
  • AT.js contiene los componentes que se incluían en target.js, de modo que ya no se llama a target.js
Puede seleccionar AT.js o mbox.js en el menú desplegable Biblioteca de cliente.

Creación de una configuración de Target Cloud creating-a-target-cloud-configuration

Para permitir que AEM interactúe con Adobe Target, cree una configuración de nube de Target. Para crear la configuración, proporcione el código de cliente de Adobe Target y las credenciales de usuario.

La configuración de la nube de Target solo se crea una vez porque se puede asociar con varias campañas de AEM. Si tiene varios códigos de cliente de Adobe Target, cree una configuración para cada código de cliente.

Puede configurar la configuración de nube para sincronizar segmentos desde Adobe Target. Si activa la sincronización, los segmentos se importan desde Target en segundo plano en cuanto se guarda la configuración de la nube.

Utilice el siguiente procedimiento para crear una configuración de nube de Target en AEM:

  1. Vaya a Cloud Services a través de la variable Logotipo de AEM > Herramientas > Implementación > Cloud Services. (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)

    La variable Adobe Marketing Cloud se abre la página de información general.

  2. En la sección Adobe Target, haga clic en Configurar ahora.

  3. En el cuadro de diálogo Crear configuración:

    1. Asigne una configuración a Título.
    2. Seleccione la plantilla Configuración de Adobe Target.
    3. Haga clic en Crear.

    Se abre el cuadro de diálogo de edición.

    chlimage_1-160

    note note
    NOTE
    Al configurar A4T con AEM, es posible que vea una entrada que falta en una referencia de configuración. Para poder seleccionar el marco de análisis, haga lo siguiente:
    1. Vaya a Herramientas > General > CRXDE Lite.
    2. Vaya a /libs/cq/analytics/components/testandtargetpage/dialog/items/tabs/items/tab1_general/items/a4tAnalyticsConfig
    3. Establecer la propiedad disable a false.
    4. Toque o haga clic Guardar todo.
  4. En el cuadro de diálogo , proporcione valores para estas propiedades.

    • Código de cliente: el código de cliente de la cuenta de Target

    • Correo electrónico: el correo electrónico de la cuenta de Target.

    • Contraseña: la contraseña de la cuenta de Target.

    • Tipo de API: REST o XML

    • Configuración de A4T Analytics Cloud: Seleccione la configuración de Analytics Cloud que se utiliza para las métricas y los objetivos de las actividades de Target. Lo necesita si utiliza Adobe Analytics como fuente de informes al segmentar contenido. Si no ve la configuración de nube, consulte la nota en Configuración de A4T Analytics Cloud.

    • Use objetivos precisos: De forma predeterminada, esta casilla de verificación está seleccionada. Si se selecciona, la configuración del servicio en la nube esperará a que el contexto se cargue antes de cargar el contenido. Véase la nota siguiente.

    • Sincronizar segmentos desde Adobe Target: Seleccione esta opción para descargar los segmentos definidos en Target y utilizarlos en AEM. Debe seleccionar esta opción cuando la propiedad Tipo de API sea REST, ya que los segmentos en línea no son compatibles y siempre necesita utilizar segmentos de Target. (Tenga en cuenta que el término de AEM de "segmento" equivale a la "audiencia" de Target).

    • Biblioteca de cliente: Seleccione si desea la biblioteca de cliente mbox.js o AT.js.

    • Usar DTM para entregar la biblioteca de cliente - Seleccione esta opción para usar AT.js o mbox.js desde DTM u otro sistema de administración de etiquetas. Debe configuración de la integración de DTM para utilizar esta opción. Adobe recomienda utilizar DTM en lugar de AEM para entregar la biblioteca.

    • Mbox.js personalizado: Déjelo en blanco si ha marcado la casilla DTM o para usar el mbox.js predeterminado. También puede cargar el mbox.js personalizado. Solo aparece si ha seleccionado mbox.js.

    • AT.js personalizado: Deje en blanco si ha marcado la casilla DTM o para utilizar el AT.js predeterminado. Como alternativa, cargue su AT.js personalizado. Solo aparece si ha seleccionado AT.js.

    note note
    NOTE
    De forma predeterminada, al entrar en el asistente de configuración de Adobe Target, el direccionamiento preciso está habilitado.
    El direccionamiento preciso significa que la configuración del servicio en la nube espera a que el contexto se cargue antes de cargar el contenido. Como resultado, en términos de rendimiento, un direccionamiento preciso puede provocar un retraso de unos milisegundos antes de cargar el contenido.
    El direccionamiento preciso siempre está habilitado en la instancia de autor. Sin embargo, en la instancia de publicación puede optar por desactivar el direccionamiento preciso globalmente, desactivando la marca de verificación junto al direccionamiento preciso en la configuración del servicio en la nube (http://localhost:4502/etc/cloudservices.html). También puede activar y desactivar el direccionamiento preciso para componentes individuales independientemente de la configuración del servicio en la nube.
    Si ya ha creado componentes de destino y cambia esta configuración, los cambios no afectan a esos componentes. Debe realizar cualquier cambio en esos componentes directamente.
  5. Haga clic en Conectarse a Target para inicializar la conexión con Target. Si la conexión se realiza correctamente, se muestra el mensaje ​ Conexión correcta. Haga clic en OK en el mensaje y, a continuación, OK en el cuadro de diálogo.

    Si no puede conectarse a Target, consulte la sección solución de problemas.

Adición de un marco de trabajo de destino adding-a-target-framework

Después de configurar la nube de Target, agregue un marco de trabajo de Target. La estructura identifica los parámetros predeterminados que se envían a Adobe Target desde los ClientContext o ContextHub componentes. Target usa los parámetros para determinar los segmentos que se aplican al contexto actual.

Puede crear varios marcos de trabajo para una sola configuración de Target. Los marcos de trabajo múltiples son útiles cuando necesita enviar un conjunto diferente de parámetros a Target para diferentes secciones del sitio web. Cree un marco de trabajo para cada conjunto de parámetros que necesite enviar. Asocie cada sección del sitio web con el marco de trabajo adecuado. Tenga en cuenta que una página web solo puede utilizar un marco a la vez.

  1. En la página de configuración de Target, haga clic en el botón + (signo más) junto a Marcos disponibles.

  2. En el cuadro de diálogo Crear marco de trabajo, especifique un Título, seleccione Adobe Target Framework y haga clic en Crear.

    chlimage_1-161

    Se abre la página marco de trabajo. La barra de tareas proporciona componentes que representan información de ClientContext o ContextHub que puede asignar.

    chlimage_1-162

  3. Arrastre el componente Client Context que representa los datos que desea utilizar para la asignación al destino de colocación. También puede arrastrar el componente Almacenamiento de ContextHub al marco de trabajo.

    note note
    NOTE
    Al asignar, los parámetros se pasan a un mbox mediante cadenas simples. No se pueden asignar matrices desde ContextHub.

    Por ejemplo, para usar Datos de perfil acerca de los visitantes del sitio para controlar la campaña de Target, arrastre el componente Datos de perfil a la página. Aparecen las variables de datos de perfil disponibles para su asignación a parámetros de Target.

    chlimage_1-163

  4. Seleccione las variables que desea que sean visibles para el sistema de Adobe Target seleccionando la casilla de verificación Compartir en las columnas correspondientes.

    chlimage_1-164

    note note
    NOTE
    La sincronización de parámetros es solo de una manera, de AEM a Adobe Target.

Se crea el marco de trabajo. Para replicar el marco de trabajo en la instancia de publicación, utilice la opción Activar marco de trabajo de la barra de tareas.

Asociación de actividades a la configuración de Target Cloud associating-activities-with-the-target-cloud-configuration

Asocie su AEM actividades con la configuración de la nube de Target para que pueda imitar las actividades en Adobe Target.

NOTE
Los tipos de actividades estarán disponibles dependiendo de lo siguiente:
  • Si la variable xt_only está activada en el inquilino de Adobe Target (clientcode) que se utiliza en el lado AEM para conectarse a Adobe Target y, a continuación, puede crear only Actividades XT en AEM.
  • Si la variable xt_only opciones es not activado en el inquilino de Adobe Target (clientcode), puede crear both Actividades XT y A/B en AEM.
Nota adicional: xt_only es una configuración aplicada a un inquilino de Target determinado (clientcode) y solo se puede modificar directamente en Adobe Target. No puede activar ni desactivar esta opción en AEM.

Asociación del marco de trabajo de Target con el sitio associating-the-target-framework-with-your-site

Después de crear un marco de Target en AEM, asocie las páginas web con el marco. Los componentes de destino de las páginas envían los datos definidos por el marco a Adobe Target para su seguimiento. (Consulte Segmentación de contenido.)

Cuando asocia una página con la estructura, las páginas secundarias heredan la asociación.

  1. En el Sitios , vaya al sitio que desea configurar.

  2. Con: acciones rápidas o modo de selección, seleccione Ver propiedades.

  3. Seleccione la pestaña Cloud Services.

  4. Pulse o haga clic en  Editar.

  5. Toque o haga clic Agregar configuración under Configuraciones del Cloud Service y seleccione Adobe Target.

    chlimage_1-165

  6. Seleccione el marco en el que desea Referencia de configuración.

    note note
    NOTE
    Asegúrese de seleccionar la variable marco que ha creado y no la configuración de nube de Target en la que se ha creado.
  7. Toque o haga clic Listo.

  8. Active la página raíz del sitio web para replicarla en el servidor de publicación. (Consulte Cómo publicar páginas.)

    note note
    NOTE
    Si el marco que adjuntó a la página aún no se ha activado, se abre un asistente que le permite publicarlo también.

Solución de problemas de conexión de Target troubleshooting-target-connection-problems

Realice las siguientes tareas para solucionar problemas que se producen al conectarse a Target:

  • Asegúrese de que las credenciales de usuario que proporcione sean correctas.
  • Asegúrese de que la instancia de AEM se pueda conectar al servidor de Target. Por ejemplo, asegúrese de que las reglas de firewall no bloqueen las conexiones AEM salientes o que AEM esté configurado para usar los proxies necesarios.
  • Busque mensajes útiles en el registro de errores de AEM. El archivo error.log se encuentra en la variable crx-quickstart/logs directorio donde está instalado AEM.
  • Al editar la actividad en Adobe Target, la URL señala a localhost. Para solucionarlo, establezca el AEM externalizador en la dirección URL correcta.
recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8