Aprenda a configurar un entorno de zona protegida de Experience Platform con datos de ejemplo. Con una colección de Postman puede crear grupos de campos, esquemas, conjuntos de datos y luego importar datos de ejemplo a Experience Platform.
Los usuarios empresariales Experience Platform a menudo tienen que seguir una serie de pasos que incluyen la identificación de grupos de campos, la creación de esquemas, la preparación de datos, la creación de conjuntos de datos y, a continuación, la ingesta de datos para poder explorar las funcionalidades de marketing que ofrece el Experience Platform. Este tutorial automatiza algunos de los pasos para que pueda obtener datos en un entorno limitado de Platform lo antes posible.
Este tutorial se centra en una marca comercial ficticia llamada Luma. Invierten en Adobe Experience Platform para combinar lealtad, CRM, catálogo de productos y datos de compras sin conexión en perfiles de clientes en tiempo real y activan estos perfiles para llevar su marketing al siguiente nivel. Hemos generado datos de ejemplo para Luma y, en el resto de este tutorial, importará estos datos en uno de los entornos de entorno limitado del Experience Platform.
El resultado final de este tutorial es un simulador de pruebas que contiene datos similares a los de Tutorial Introducción a Adobe Experience Platform para arquitectos de datos e ingenieros de datos. Se actualizó en abril de 2023 para admitir la variable Desafíos de Journey Optimizer.
techmarketingdemos
" https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home
.Antes de seguir los pasos, asegúrese de haber descargado el Postman aplicación. ¡Empecemos!
Descargue el platform-utils-main.zip , que contiene todos los archivos necesarios para este tutorial.
Los datos de usuario contenidos en la variable platform-utils-main.zip es ficticio y debe utilizarse únicamente con fines de demostración.
Desde la carpeta de descargas, mueva el archivo platform-utils-main.zip
a la ubicación deseada en el equipo y descomprímalo.
En el luma-data
carpeta, abra todas las json
archivos en un editor de texto y reemplazar todas las instancias de _yourOrganizationID
con su propio id de inquilino, precedido por un guion bajo.
Apertura luma-offline-purchases.json
y luma-web-events.json
en un editor de texto y actualice todas las marcas de tiempo para que los eventos se produzcan en el último mes (por ejemplo, busque "timestamp":"2022-11
y reemplace el año y el mes)
Tenga en cuenta la ubicación de la carpeta descomprimida, ya que la necesita más adelante al configurar la variable FILE_PATH
Variable de entorno de Postman:
Para obtener la ruta de archivo en el Mac, vaya a la platform-utils-main
carpeta, haga clic con el botón derecho en la carpeta y seleccione Obtener información .
Para obtener la ruta de archivo en las ventanas, haga clic en para abrir la ubicación de la carpeta deseada y, a continuación, haga clic con el botón secundario del mouse (ratón) a la derecha de la ruta en la barra de direcciones. Copie la dirección para obtener la ruta del archivo.
Abra Postman y cree un nuevo espacio de trabajo desde la Espacios de trabajo menú desplegable:
Escriba un Nombre y opcional Resumen para el espacio de trabajo y haga clic en Crear espacio de trabajo. Postman cambiará a su nuevo espacio de trabajo cuando lo cree.
Ahora, ajuste algunos ajustes para ejecutar las colecciones de Postman en este espacio de trabajo. En el encabezado de Postman, haga clic en el icono de engranaje y seleccione Configuración para abrir el modal de configuración. También puede utilizar el atajo de teclado (CMD/CTRL + ,) para abrir el modal.
En el General
, actualice el tiempo de espera de la solicitud en ms a 5000 ms
y habilitar allow reading file outside this directory
Si los archivos se cargan desde el directorio de trabajo, se ejecutarán sin problemas entre dispositivos si los mismos archivos se almacenan en los demás dispositivos. Sin embargo, si desea ejecutar archivos desde fuera del directorio de trabajo, debe activarse una configuración para indicar la misma intención. Si su FILE_PATH
no es la misma que la ruta del directorio de trabajo de Postman, entonces esta opción debe estar habilitada.
Cierre las Configuración panel.
Seleccione el Entornos y, a continuación, seleccione Importar:
Importe el archivo de entorno json descargado, DataInExperiencePlatform.postman_environment
En Postman, seleccione su entorno en el menú desplegable superior derecho y haga clic en el icono de ojo para ver las variables de entorno:
Asegúrese de que las siguientes variables de entorno estén rellenadas. Para obtener información sobre cómo obtener el valor de las variables de entorno, consulte la Autenticar con las API de Experience Platform tutorial para obtener instrucciones paso a paso.
CLIENT_SECRET
API_KEY
—Client ID
en la consola de Adobe DeveloperTECHNICAL_ACCOUNT_ID
META_SCOPE
IMS
IMS_ORG
—Organization ID
en la consola de Adobe DeveloperPRIVATE_KEY
SANDBOX_NAME
CONTAINER_ID
TENANT_ID
: asegúrese de incluir un guion bajo, por ejemplo _techmarketingdemos
platform_end_point
FILE_PATH
: utilice la ruta de la carpeta local en la que ha descomprimido la variable platform-utils-main.zip
archivo. Asegúrese de que incluye el nombre de la carpeta, por ejemplo /Users/dwright/Desktop/platform-utils-main
Guardar el entorno actualizado
A continuación, debe importar las colecciones en Postman.
Select Colecciones y, a continuación, elija la opción de importación:
Importe las siguientes colecciones:
0-Authentication.postman_collection.json
1-Luma-Loyalty-Data.postman_collection.json
2-Luma-CRM-Data.postman_collection.json
3-Luma-Product-Catalog.postman_collection.json
4-Luma-Offline-Purchase-Events.postman_collection.json
5-Luma-Product-Inventory-Events.postman_collection.json
6-Luma-Test-Profiles.postman_collection.json
7-Luma-Web-Events.postman_collection.json
A continuación, debe autenticarse y generar un token de usuario. Tenga en cuenta que los métodos de generación de tokens utilizados en este tutorial solo son adecuados para usos que no sean de producción. La firma local carga una biblioteca JavaScript desde un host de terceros, y la firma remota envía la clave privada a un servicio web administrado por un Adobe. Aunque Adobe no almacena esta clave privada, las claves de producción nunca deben compartirse con nadie.
Abra el Authentication
colección, seleccione IMS: JWT Generate + Auth via User Token
solicitud del POST y haga clic en SEND
para autenticarse y obtener el token de acceso.
Revise las variables de entorno y observe que la variable JWT_TOKEN
y ACCESS_TOKEN
ahora se rellenan.
Ahora puede preparar e importar los datos en el simulador para pruebas de Platform. Las colecciones de Postman que importaste harán todo el trabajo pesado!
Abra el 1-Luma-Loyalty-Data
colección y haga clic en Ejecutar en la ficha información general para iniciar un ejecutor de colecciones.
En la ventana del runner de la colección, asegúrese de seleccionar el entorno en la lista desplegable y actualizar el Retraso a 4000ms
, marque la casilla Guardar respuestas y asegúrese de que el orden de ejecución es correcto. Haga clic en el Ejecutar datos de fidelidad de Luma botón
1-Luma-Loyalty-Data crea un esquema para los datos de lealtad del cliente. El esquema se basa en la clase de perfil individual XDM, el grupo de campos estándar y un grupo de campos y un tipo de datos personalizados. La colección crea un conjunto de datos con el esquema y carga datos de lealtad de clientes de muestra en Adobe Experience Platform.
Si se produce un error en alguna solicitud de recopilación durante el ejecutor de la recopilación de Postman, detenga la ejecución y ejecute las solicitudes de recopilación de una en una.
Si todo va bien, todas las solicitudes de la variable Luma-Loyalty-Data
la colección debe pasar.
Ahora vamos a iniciar sesión en Interfaz de Adobe Experience Platform y navegar a conjuntos de datos.
Abra el Luma Loyalty Dataset
conjunto de datos, y en la ventana de actividad de conjunto de datos, puede ver una ejecución por lotes exitosa que ingería 1000 registros. También puede hacer clic en la opción de vista previa del conjunto de datos para verificar los registros ingestados. Es posible que tenga que esperar varios minutos para confirmar que 1000 Nuevos fragmentos de perfil se han creado.
Repita los pasos del 1 al 3 para ejecutar las otras colecciones:
2-Luma-CRM-Data.postman_collection.json
crea un esquema y un conjunto de datos rellenado para los datos CRM de los clientes. El esquema se basa en la clase de Perfil individual XDM que incluye Detalles demográficos, Detalles de contacto personal, Detalles de preferencia y un grupo de campos de identidad personalizado.3-Luma-Product-Catalog.postman_collection.json
crea un esquema y un conjunto de datos rellenado para la información del catálogo de productos. El esquema se basa en una clase de catálogo de productos personalizada y utiliza un grupo de campos de catálogo de productos personalizado.4-Luma-Offline-Purchase-Events.postman_collection.json
crea un esquema y rellena un conjunto de datos para los datos de evento de compra sin conexión de los clientes. El esquema se basa en la clase XDM ExperienceEvent y consta de una identidad personalizada y de grupos de campos de Detalles comerciales .5-Luma-Product-Inventory-Events.postman_collection.json
crea un esquema y un conjunto de datos rellenado para eventos relacionados con productos que entran y salen de existencias. El esquema se basa en una clase de evento empresarial personalizada y un grupo de campos personalizado.6-Luma-Test-Profiles.postman_collection.json
crea un esquema y rellena un conjunto de datos con perfiles de prueba para usar en Adobe Journey Optimizer7-Luma-Web-Events.postman_collection.json
crea un esquema y rellena un conjunto de datos con datos web históricos simples.Los datos de ejemplo se han diseñado para que, cuando se hayan ejecutado las colecciones, se creen perfiles de cliente en tiempo real que combinen datos de varios sistemas. Un buen ejemplo de esto es el primer registro de los conjuntos de datos de compra sin conexión, CRM y de fidelidad. Busque ese perfil para confirmar que se han introducido los datos. En el Interfaz de Adobe Experience Platform:
Luma Loyalty Id
como el Área de nombres de identidad5625458
como el Valor de identidadDaniel Wright
perfilSi no ve el perfil, consulte la Conjuntos de datos para confirmar que todos los conjuntos de datos se crearon e incorporaron correctamente. Si se ve bien, espere quince minutos y vea si el perfil está disponible en el visor. Si hubo problemas con la ingesta de datos, compruebe los mensajes de error para intentar localizar el problema. También puede intentar habilitar los diagnósticos de error en la variable Conjuntos de datos y arrastre y suelte el archivo de datos json para volver a introducir los datos.
Explorando los datos del Atributos y Eventos , debería ver que el perfil contiene datos de los distintos archivos de datos:
Si desea obtener más información sobre Adobe Journey Optimizer, este simulador para pruebas contiene todo lo que necesita para tomar el Desafíos de Journey Optimizer
Si desea obtener información sobre las políticas de combinación, el control de datos, el servicio de consultas y el generador de segmentos, vaya a lección 11 del tutorial Introducción a los arquitectos de datos y a los ingenieros de datos. Las lecciones anteriores de este otro tutorial le permiten crear manualmente todo lo que acaba de completar estas colecciones de Postman: ¡disfrute del inicio inicial!
Si desea crear una implementación de SDK web de muestra para vincularla a este entorno limitado, consulte
Tutorial de implementación de Adobe Experience Cloud con SDK web. Después de configurar las lecciones de "Configuración inicial", "Configuración de etiquetas" y "Configurar Experience Platform" del tutorial del SDK web, inicie sesión en el sitio web de Luma con las diez primeras direcciones de correo electrónico de la luma-crm.json
archivo con la contraseña test
para ver cómo se combinan los fragmentos de perfil con los datos cargados en este tutorial.
Si desea crear una implementación de SDK móvil de ejemplo para vincular a este entorno limitado, consulte
Tutorial sobre implementación de Adobe Experience Cloud en aplicaciones móviles. Después de configurar las lecciones de "Configuración inicial", "Implementación de aplicación" y "Experience Platform" del tutorial del SDK web, inicie sesión en el sitio web de Luma con las primeras direcciones de correo electrónico de la luma-crm.json
para ver una combinación de fragmentos de perfil con datos cargados en este tutorial.
Al restablecer un simulador para pruebas que no sean de producción, se eliminan todos los recursos asociados a ese simulador para pruebas (esquemas, conjuntos de datos, etc.), al tiempo que se mantienen el nombre del simulador para pruebas y los permisos asociados. Este simulador de pruebas "limpio" sigue estando disponible con el mismo nombre para los usuarios que tienen acceso a él.
Siga los pasos here para restablecer un entorno de entorno limitado.