Herramientas de zona protegida
Debe tener los dos permisos de control de acceso basados en roles siguientes para usar la característica de herramientas de zona protegida:
-
manage-sandbox o view-sandbox-
manage-packageMejore la precisión de la configuración en todos los entornos limitados y exporte e importe sin problemas las configuraciones de los entornos limitados con la función de herramientas para entornos limitados. Utilice las herramientas de zona protegida para reducir el tiempo de respuesta al valor del proceso de implementación y mover las configuraciones correctas a través de las zonas protegidas.
Puede utilizar la función de herramientas de zona protegida para seleccionar diferentes objetos y exportarlos a un paquete. Un paquete puede constar de un único objeto o de varios objetos. Todos los objetos incluidos en un paquete deben pertenecer a la misma zona protegida.
Objetos admitidos para las herramientas de zona protegida supported-objects
La característica de herramientas de zona protegida permite exportar objetos Adobe Real-Time Customer Data Platform y Adobe Journey Optimizer a un paquete.
Objetos de Real-time Customer Data Platform real-time-cdp-objects
Cambios en las importaciones de audiencias de varias entidades
Con las actualizaciones de arquitectura B2B, ya no podrá importar audiencias de varias entidades con atributos B2B y eventos de experiencia si un paquete que incluía estas audiencias se publicó antes de la actualización. Estas audiencias no se importarán correctamente y no se pueden convertir automáticamente a la nueva arquitectura.
Para solucionar esta limitación, debe crear un nuevo paquete con las audiencias actualizadas y luego importarlas a sus respectivas zonas protegidas de destino con las herramientas de zonas protegidas.
En la tabla siguiente se enumeran Adobe Real-Time Customer Data Platform objetos que actualmente se admiten en las herramientas de zona protegida:
- Las credenciales de la cuenta de origen no se replican en la zona protegida de destino por motivos de seguridad y deberán actualizarse manualmente.
- El flujo de datos de origen se copia en estado de borrador de forma predeterminada.
- Solo se admite el tipo de servicio de segmentación de la Audiencia del cliente.
- Las etiquetas existentes para consentimiento y control se copiarán en el mismo trabajo de importación.
- El sistema seleccionará automáticamente la política de combinación predeterminada en la zona protegida de destino con la misma clase XDM al comprobar las dependencias de la política de combinación.
- Si se detecta un objeto existente con el mismo nombre al importar audiencias, las herramientas de espacio aislado siempre reutilizarán el objeto existente para evitar la proliferación de objetos.
- El sistema deduplicará automáticamente las áreas de nombres de identidad estándar de Adobe al crear en la zona protegida de destino.
- Las audiencias solo se pueden copiar cuando todos los atributos de las reglas de audiencia están habilitados en el esquema de unión. Los esquemas necesarios deben moverse y habilitarse primero para el perfil unificado.
- Las etiquetas existentes para consentimiento y control se copiarán en el mismo trabajo de importación.
- Tiene la flexibilidad de importar esquemas sin la opción de perfil unificado habilitada. Las mayúsculas y minúsculas perimetrales de las relaciones de esquema no se incluyen en el paquete.
- Si se detecta un objeto existente con el mismo nombre al importar esquemas o grupos de campos, las herramientas de espacio aislado siempre reutilizarán el objeto existente para evitar la proliferación de objetos.
Los objetos siguientes se importan, pero están en estado de borrador o desactivado:
Objetos Adobe Journey Optimizer abobe-journey-optimizer-objects
La tabla siguiente enumera Adobe Journey Optimizer objetos que actualmente son compatibles con las herramientas y limitaciones de la zona protegida:
Los objetos siguientes utilizados en el recorrido se copian como objetos dependientes. Durante el flujo de trabajo de importación, puede elegir Crear nuevo o Usar existente para cada uno:
- Públicos
- Detalles del lienzo
- Plantillas de contenido
- Acciones personalizadas
- Fuentes de datos
- Eventos
- Grupos de campos
- Fragmentos
- Esquemas
El sistema copia los eventos y los detalles del evento utilizados en la recorrido y crea una nueva versión en la zona protegida de destino.
Se puede copiar la acción de actualización de perfil utilizada en el recorrido. Las acciones personalizadas se pueden añadir a un paquete de forma independiente. Los detalles de acción utilizados en el recorrido también se copian. Siempre se crea una nueva versión en la zona protegida de destino.
Las acciones personalizadas se pueden añadir a un paquete de forma independiente. Una vez asignada una acción personalizada a un recorrido, ya no se puede editar. Para realizar actualizaciones en las acciones personalizadas, debe:
- mover acciones personalizadas antes de migrar un recorrido
- actualizar configuraciones (como encabezados de solicitud, parámetros de consulta y autenticación) para acciones personalizadas después de la migración
- migrar objetos de recorrido con las acciones personalizadas agregadas durante el primer paso
Los siguientes objetos utilizados en la campaña se copian como objetos dependientes:
- Campañas
- Públicos
- Esquemas
- Plantillas de contenido
- Fragmentos
- Mensaje/Contenido
- Configuración de canal
- Objetos de decisión unificados
- Configuración/variantes del experimento
- Las campañas se pueden copiar junto con todos los elementos relacionados con el perfil, la audiencia, el esquema, los mensajes en línea y los objetos dependientes. Algunos elementos no se copian, como las etiquetas de uso de datos y la configuración de idioma. Para obtener una lista completa de los objetos que no se pueden copiar, consulte la guía exportar objetos a otra zona protegida.
- El sistema detectará y reutilizará automáticamente un objeto de configuración de canal existente en la zona protegida de destino si existe una configuración idéntica. Si no se encuentra ninguna configuración que coincida, la configuración del canal se omite durante la importación y los usuarios deben actualizar manualmente la configuración del canal en la zona protegida de destino para este recorrido.
- Los usuarios pueden reutilizar los experimentos y las audiencias existentes en la zona protegida de Target como objetos dependientes de las campañas seleccionadas.
Los objetos siguientes deben estar presentes en la zona protegida de destino antes de copiar los objetos de Decisioning:
- Atributos de perfil utilizados en objetos de Decisioning
- El grupo de campos de atributos de oferta personalizados
- Los esquemas de flujos de datos utilizados para atributos de contexto en reglas, clasificación o límite.
- Actualmente no se admite la copia de fórmulas de clasificación que utilicen modelos de IA.
- Los elementos de decisión (artículos de oferta) no se incluyen automáticamente. Para asegurarse de que se transfieran, agréguelos manualmente con la opción Agregar al paquete.
- Las directivas que utilizan una estrategia de selección requieren que los elementos de decisión asociados se agreguen manualmente durante el proceso de copia. Las directivas que utilizan elementos de decisión manuales o de reserva tendrán esos elementos incluidos automáticamente como dependencias directas.
- Los elementos de decisión se deben copiar primero, antes que cualquier otro objeto relacionado.
Atributos de perfil utilizados en objetos de Decisioning,
El grupo de campos de atributos de oferta personalizados,
Los esquemas de flujos de datos utilizados para atributos de contexto en reglas, clasificación o límite.
Las superficies (por ejemplo, los ajustes preestablecidos) no se copian. El sistema selecciona automáticamente la coincidencia más cercana posible en la zona protegida de destino en función del tipo de mensaje y el nombre de la superficie. Si no se encuentran superficies en la zona protegida de destino, la copia de superficie fallará, lo que provocará que la copia del mensaje falle porque un mensaje requiere que haya una superficie disponible para la configuración. En este caso, es necesario crear al menos una superficie para el canal derecho del mensaje para que funcione la copia.
Los tipos de identidad personalizados no se admiten como objetos dependientes al exportar un recorrido.
Exportación de objetos a un paquete export-objects
Este ejemplo documenta el proceso de exportación de un esquema y su adición a un paquete. Puede utilizar el mismo proceso para exportar otros objetos, por ejemplo, conjuntos de datos, recorridos y mucho más.
Agregar un objeto a un nuevo paquete add-object-to-new-package
Seleccione Esquemas en el panel de navegación izquierdo y, a continuación, seleccione la pestaña Examinar, que enumera los esquemas disponibles. A continuación, seleccione los puntos suspensivos (...) junto al esquema seleccionado y aparecerá un menú desplegable con los controles. Seleccione Agregar al paquete en la lista desplegable.
En el cuadro de diálogo Agregar al paquete, seleccione la opción Crear nuevo paquete. Proporcione un Nombre para el paquete y una Descripción opcional y, a continuación, seleccione Agregar.
Ha vuelto al entorno Schemas. Ahora puede añadir objetos adicionales al paquete que ha creado siguiendo los pasos que se indican a continuación.
Añadir un objeto a un paquete existente y publicarlo add-object-to-existing-package
Para ver una lista de los esquemas disponibles, seleccione Esquemas en el panel de navegación izquierdo y, a continuación, seleccione la pestaña Examinar. A continuación, seleccione los puntos suspensivos (...) junto al esquema seleccionado para ver las opciones de control en un menú desplegable. Seleccione Agregar al paquete en la lista desplegable.
Aparecerá el cuadro de diálogo Agregar al paquete. Seleccione la opción Paquete existente, luego seleccione la lista desplegable Nombre del paquete y seleccione el paquete requerido. Finalmente, selecciona Agregar para confirmar tus opciones.
Cuadro de diálogo
Se muestra la lista de objetos añadidos al paquete. Para publicar el paquete y hacer que esté disponible para su importación en entornos limitados, seleccione Publicar.
Seleccione Publicar para confirmar la publicación del paquete.
Ha vuelto a la ficha Paquetes del entorno Zonas protegidas, donde puede ver el nuevo paquete publicado.
Importación de un paquete en una zona protegida de destino import-package-to-target-sandbox
Para importar el paquete en una zona protegida de destino, vaya a la pestaña Zonas protegidas Examinar y seleccione la opción más (+) junto al nombre de la zona protegida.
En el menú desplegable, seleccione el nombre del paquete que desee importar a la zona protegida de destino. Agregue un nombre de trabajo, que se usará para la supervisión futura. De forma predeterminada, el perfil unificado se desactiva cuando se importan los esquemas del paquete. Cambie Habilitar esquemas para el perfil para habilitar esto y luego seleccione Siguiente.
La página Objeto de paquete y dependencias proporciona una lista de todos los recursos incluidos en este paquete. El sistema detecta automáticamente los objetos dependientes necesarios para importar correctamente los objetos padre seleccionados. Los atributos que faltan se muestran en la parte superior de la página. Seleccione Ver detalles para obtener un desglose más detallado.
Para utilizar un objeto existente, seleccione el icono de lápiz situado junto al objeto dependiente.
Se muestran las opciones para crear nuevos o utilizar los existentes. Seleccionar Usar existente.
El diálogo Grupo de campos muestra una lista de grupos de campos disponibles para el objeto. Seleccione los grupos de campos requeridos y luego seleccione Guardar.
Ha vuelto a la página Objeto Package y dependencias. Aquí, seleccione Finalizar para completar la importación del paquete.
Exportar e importar una zona protegida completa
Puede exportar todos los tipos de objetos admitidos en un paquete de zona protegida completo y, a continuación, importar el paquete en varios entornos limitados para replicar las configuraciones de objetos. Por ejemplo, esta funcionalidad le permite:
- Vuelva a importar una zona protegida para reproducir todas las configuraciones del objeto si necesita restablecer la zona protegida
- Importe el paquete en otros entornos limitados y utilícelo como entorno limitado de modelo para acelerar el proceso de desarrollo.
Exportar toda una zona protegida export-entire-sandbox
Para exportar una zona protegida completa, ve a la pestaña Zonas protegidas Paquetes y selecciona Crear paquete.
Seleccione Zona protegida completa para el Tipo de paquete en el cuadro de diálogo Crear paquete. Proporcione un nombre de paquete para su nuevo paquete y seleccione la zona protegida en la lista desplegable. Finalmente, selecciona Crear para confirmar tus entradas.
El paquete se ha creado correctamente, seleccione Publish para publicar el paquete.
Ha vuelto a la ficha Paquetes del entorno Zonas protegidas, donde puede ver el nuevo paquete publicado.
Importar todo el paquete de zona protegida import-entire-sandbox-package
Para importar el paquete en una zona protegida de destino, vaya a la pestaña Zonas protegidas Examinar y seleccione la opción más (+) junto al nombre de la zona protegida.
En el menú desplegable, seleccione la zona protegida completa usando la lista desplegable Nombre del paquete. Agregue un nombre de trabajo, que se usará para la supervisión futura y una descripción de trabajo opcional; a continuación, seleccione Siguiente.
Se le dirigirá a la página Objeto del paquete y dependencias, donde podrá ver el número de objetos y dependencias que se importan y excluyen. Aquí, seleccione Importar para completar la importación del paquete.
Espere un poco para que se complete la importación. El tiempo para finalizar puede variar según el número de objetos del paquete. Puede supervisar el trabajo de importación desde la ficha Zonas protegidas Trabajos.
Monitorización de detalles de importación view-import-details
Para ver los detalles importados, vaya a la pestaña Zonas protegidas Trabajos y seleccione el paquete en la lista. También puede utilizar la barra de búsqueda para buscar el paquete.
Seleccione Ver resumen de importación en el panel de detalles derecho de la ficha Trabajos del entorno de zonas protegidas.
El cuadro de diálogo Resumen de importación muestra un desglose de las importaciones con el progreso como porcentaje.
Cuando finaliza la importación, se recibe una notificación en la interfaz de usuario de Experience Platform. Puede acceder a estas notificaciones desde el icono de alertas. Puede navegar a la resolución de problemas desde aquí si un trabajo no se ha realizado correctamente.
Transferir actualizaciones de configuraciones de objetos iterativas entre zonas protegidas mediante las herramientas de zonas protegidas move-configs
Puede utilizar las herramientas de zona protegida para transferir configuraciones de objetos entre diferentes zonas protegidas. Anteriormente, las actualizaciones de configuración de los objetos (como esquemas, grupos de campos y tipos de datos) tenían que volver a crearse o importarse manualmente para transferirse a otros entornos limitados. Con esta capacidad, puede utilizar las herramientas de la zona protegida para acelerar los flujos de trabajo y reducir los posibles errores transfiriendo sin problemas las actualizaciones de configuración en diferentes zonas protegidas.
- Los permisos adecuados para acceder a las herramientas de la zona protegida.
- Un objeto recién creado o actualizado (como un esquema) en la zona protegida de origen.
Tipos de objetos admitidos para la operación de actualización
Se admiten los siguientes tipos de objetos para la actualización:
- Esquemas
- Grupos de campo
- Tipos de datos
- Adición de nuevos campos o grupos de campos al recurso.
- Hacer opcional un campo obligatorio.
- Introducción de nuevos campos obligatorios.
- Introducción de un nuevo campo de relación.
- Introducción de un nuevo campo de identidad.
- Cambiar el nombre para mostrar y la descripción del recurso.
- Eliminando los campos definidos anteriormente.
- Redefinición de campos existentes cuando el esquema está habilitado para el perfil del cliente en tiempo real.
- Eliminación o restricción de los valores de campo admitidos anteriormente.
- Mover los campos existentes a una ubicación diferente en el árbol de esquema: esto creará un nuevo campo en la zona protegida de destino, pero no se eliminará el campo anterior.
- Habilitar o deshabilitar el esquema para que participe en el perfil: esta operación se omitirá en la comparación de diferencias.
- Etiquetas de control de acceso.
Siga los pasos a continuación para aprender a utilizar las herramientas de zona protegida para transferir las configuraciones de objetos en diferentes zonas protegidas.
Objetos importados anteriormente
Siga estos pasos si el caso de uso implica objetos existentes en la zona protegida de origen que requieren actualizaciones de configuración, después de haberse empaquetado e importado a otras zonas protegidas.
En primer lugar, actualice el objeto en la zona protegida de origen. Por ejemplo, vaya al área de trabajo Esquemas, seleccione el esquema y agregue un nuevo grupo de campos.
Una vez que haya actualizado el esquema, vaya a Zonas protegidas, seleccione Paquetes y, a continuación, busque el paquete existente.
Utilice la interfaz de paquetes para comprobar los cambios. Seleccione Buscar actualizaciones para ver cualquier cambio en los artefactos del paquete. A continuación, seleccione Ver diferencia para recibir un resumen detallado de todos los cambios realizados en los artefactos.
Aparecerá la interfaz Ver diff. Consulte este peaje para obtener información sobre los artefactos de origen y destino, así como los cambios que se les deben aplicar.
Durante este paso, también puede seleccionar Resumir con IA para obtener un resumen paso a paso de todos los cambios.
Cuando esté listo, selecciona Actualizar paquete y, a continuación, selecciona Confirmar en la ventana emergente que aparece. Una vez completado el trabajo, puede actualizar la página y seleccionar Ver historial para comprobar la versión del paquete.
Para importar los cambios, vuelva al directorio Paquetes y seleccione los puntos suspensivos (...) junto al paquete. A continuación, seleccione Importar paquete. Experience Platform selecciona automáticamente Actualizar objetos existentes. Compruebe los cambios y, a continuación, seleccione Finalizar.
Para validar aún más el proceso de importación, vaya a la zona protegida de destino y vea manualmente el objeto actualizado desde dicha zona protegida.
Objetos creados manualmente en la zona protegida de Target
Siga estos pasos si el caso de uso implica aplicar cambios de configuración a objetos creados manualmente en zonas protegidas independientes.
En primer lugar, cree y publique un nuevo paquete con el objeto actualizado.
A continuación, importe el paquete en la zona protegida de destino que contiene los objetos que también desea actualizar. Durante el proceso de importación, seleccione Actualizar objetos existentes y, a continuación, utilice el navegador de objetos para seleccionar manualmente los objetos de destino a los que desea aplicar las actualizaciones.
- Es opcional seleccionar una asignación de destino en una zona protegida diferente para los objetos dependientes. Si no se selecciona ninguna, se crea una nueva.
- Para el área de nombres de identidad, el sistema detecta automáticamente si es necesario crear una nueva identidad si es necesario reutilizar una existente en la zona protegida de Target.
Una vez identificados los objetos de destino que desea actualizar, seleccione Finalizar.
Tutorial de vídeo
El siguiente vídeo tiene como objetivo ayudarle a comprender las herramientas de la zona protegida, y describe cómo crear un nuevo paquete, publicarlo e importarlo.
Próximos pasos
Este documento muestra cómo utilizar la función de herramientas de zona protegida en la interfaz de usuario de Experience Platform. Para obtener información sobre las zonas protegidas, consulte la guía de usuario sobre zonas protegidas.
Para ver los pasos de realización de distintas operaciones mediante la API de espacio aislado, consulte la guía para desarrolladores de espacios aislados. Para obtener información general de alto nivel sobre las zonas protegidas en Experience Platform, consulte la documentación general.