Aprenda a configurar un entorno limitado de Experience Platform con algunos datos de ejemplo. Con una colección de postman, puede crear grupos de campos, esquemas, conjuntos de datos y luego importar datos de ejemplo en Experience Platform.
Los usuarios empresariales Experience Platform suelen tener 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 antes de explorar algunas de las funcionalidades que ofrece el Experience Platform. En este tutorial, puede encontrar una forma sencilla de automatizar algunos de los pasos y obtener datos en Platform lo antes posible.
Este tutorial se centra en una marca comercial ficticia llamada Luma. Luma tiene tiendas de ladrillos y morteros en varios países y tiene presencia en línea con un sitio web y aplicaciones móviles. Invierten en Adobe Experience Platform para combinar lealtad, CRM, web y datos de compra sin conexión en perfiles de clientes en tiempo real y activan estos perfiles para llevar su marketing al siguiente nivel. Se han generado datos de ejemplo para Luma y, en la siguiente sección, puede explorar cómo importar datos a Experience Platform.
Para completar este tutorial, puede utilizar la variable Interfaz de usuario de la aplicación Postman o utilice la línea de comandos Corredor de colecciones para Postman (Newman)
techmarketingdemos
" https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home
. También puede obtenerla realizando una autenticación Solicitud de API.Antes de seguir los pasos, asegúrese de haber descargado el Postman y tienen acceso a las API de Experience Platform. Para este tutorial, se utilizará un entorno limitado. Proporciona un entorno aislado en el que puede probar la funcionalidad sin mezclar recursos y datos con el entorno de producción. Empecemos.
Los datos de usuario contenidos en la variable platform-utils-main.zip es ficticio y debe utilizarse únicamente con fines de demostración.
Descargue el platform-utils-main.zip , que contiene todos los archivos necesarios para este tutorial.
Desde la carpeta de descargas, mueva la variable platform-utils-main.zip
en la ubicación deseada del equipo y descomprima el archivo.
Tenga en cuenta la ubicación del archivo descomprimido, ya que es posible que lo necesitemos 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.
Inicie Postman y cree un nuevo espacio de trabajo. Copie el where
valor de metadatos de
Para crear un nuevo espacio de trabajo, utilice el Espacios de trabajo menú desplegable a la izquierda de Postman. Puede seleccionar un espacio de trabajo existente o crear un nuevo espacio de trabajo para el proyecto.
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 vamos a realizar algunos ajustes adicionales para ejecutar nuestras colecciones de postman en este espacio de trabajo. En el encabezado de Postman, haga clic en el icono de la llave inglesa 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
, actualicemos el tiempo de espera de la solicitud en ms para 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 el directorio de trabajo externo, debe activar una configuración para que declare la misma intención. Si su FILE_PATH
no es lo mismo que la ruta del directorio de trabajo del postman, entonces esta opción debe estar habilitada.
Cierre el panel de configuración.
Seleccione la opción entornos y haga clic en la opción de importación.
Importemos el archivo de entorno json descargado, DataInExperiencePlatform.postman_environment
y haga clic en Importar
En Postman, seleccione el entorno en la lista desplegable superior derecha 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
TECHNICAL_ACCOUNT_ID
META_SCOPE
IMS
IMS_ORG
PRIVATE_KEY
SANDBOX_NAME
CONTAINER_ID
TENANT_ID
platform_end_point
FILE_PATH
PRIVATE_KEY
Actualice el FILE_PATH
a la ruta de la carpeta local donde descomprimió la variable platform-utils-main.zip
archivo. Puede editar variables abriendo un entorno desde Entornos a la izquierda o abriendo el aspecto rápido del entorno (botón de ojo) en la parte superior derecha de Postman y haciendo clic en Editar.
Ahora, es necesario rellenar los valores para las siguientes variables de entorno. Para ello, necesitamos cargar los archivos de colección en nuestro espacio de trabajo.
JWT_TOKEN
ACCESS_TOKEN
Seleccione colecciones y, a continuación, elija la opción de importación
Importar los siguientes archivos de colección en postman
Authentication.postman_collection.json
Luma-Loyalty-Data.postman_collection.json
Luma-CRM-Data.postman_collection.json
Luma-Product-Catalog.postman_collection.json
Luma-Offline-Purchase-Events.postman_collection.json
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 puede observar que la variable JWT_TOKEN
y ACCESS_TOKEN
ahora se rellenan.
En el luma-data
carpeta, abra todas las json
archivos en un editor de texto y reemplazar todas las instancias de _techmarketingdemos
con su propio id de inquilino, precedido por un guion bajo.
Abra el 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 ejecutor de recopilación, asegúrese de seleccionar el entorno de la lista desplegable, proporcionar un retraso de 4000 ms, marcar la opción guardar respuestas y asegurarse de que el orden de ejecución es correcto. Haga clic en el Ejecutar datos de fidelidad de Luma botón
Luma-Loyalty-Data la ejecución de recopilación crearía un esquema para contener los datos de lealtad del cliente. El esquema se basa en la clase de perfil individual XDM que consta de grupos de campos personalizados y tipos de datos. La colección tambié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 motor de ejecución de la colecció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 usuario 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.
Repita los pasos 21-23 para ejecutar las colecciones siguientes:
Luma-CRM-Data.postman_collection.json
: la ejecución de recopilación crearía un esquema para contener los datos CRM de los clientes. El esquema se basa en la clase de perfil individual XDM que incluye los grupos de campos Detalles demográficos, Detalles de contacto personal y Perfil de identidad de Luma. La colección también crea un conjunto de datos con el esquema y carga datos de CRM de cliente de muestra en Adobe Experience Platform.Luma-Product-Catalog.postman_collection.json
: la ejecución de recopilación crearía un esquema para contener la información del catálogo de productos. El esquema se basa en una clase personalizada que incluye mezcla de catálogos de productos, detalles comerciales y mezcla de eventos de experiencias de consumidores. La colección también crea un conjunto de datos con el esquema y carga los datos del producto en Adobe Experience Platform.Luma-Offline-Purchase-Events.postman_collection.json
: la ejecución de recopilación crearía un esquema para contener los datos de evento de compra sin conexión de los clientes. El esquema se basa en la clase XDM ExperienceEvent y comprende grupos de campos para capturar la información de lealtad del cliente y sus eventos de compra sin conexión. La colección también crea un conjunto de datos con el esquema y carga datos de eventos de compra sin conexión en Adobe Experience Platform.Antes de seguir los pasos, asegúrese de tener acceso a las API de Experience Platform. Para este tutorial, se utilizará un entorno limitado, ya que proporciona un entorno aislado en el que puede probar la funcionalidad sin mezclar recursos y datos con el entorno de producción.
Para ejecutar Newman, asegúrese de que tiene Node.js >= v10. Instalación de Node.js mediante el administrador de paquetes.
Ejecutar el comando node -v
para asegurarse de que el nodo está instalado.
La forma más sencilla de instalar Newman es utilizar NPM. Si tiene instalado Node.js, lo más probable es que también tenga instalado NPM.
Siga los pasos here para instalar newman en su sistema
Ejecutar el comando newman -v
para asegurarse de que newman está instalado.
Descargue el platform-utils-main.zip , que contiene todos los archivos necesarios para este tutorial.
Desde la carpeta de descargas, mueva la variable platform-utils-main.zip
en la ubicación deseada del equipo y descomprima el archivo.
Tenga en cuenta la ubicación del archivo descomprimido, ya que es posible que lo necesitemos más adelante al configurar la variable FILE_PATH
variable de entorno de postman
Abra el platform-utils-main
en una ventana de terminal.
Ejecutar Luma-Loyalty-Data.postman_collection.json
para crear grupos de campos, esquema, conjunto de datos e ingerir datos de lealtad de muestra en Adobe Experience Platform
newman run Luma-Loyalty-Data.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json —insecure --delay-request 4000
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 usuario 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.
Repita los pasos del 10 al 13 para ejecutar las colecciones siguientes:
Luma-CRM-Data.postman_collection.json
para crear grupos de campos, esquema, conjunto de datos e ingerir datos CRM de ejemplo en Adobe Experience Platform
newman run Luma-CRM-Data.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
Luma-Product-Catalog.postman_collection.json
para crear grupos de campos, esquema, conjunto de datos e ingerir datos de productos de ejemplo en Adobe Experience Platform
newman run Luma-Product-Catalog.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
Luma-Offline-Purchase-Events.postman_collection.json
para crear grupos de campos, esquema, conjunto de datos e ingerir datos de productos de ejemplo en Adobe Experience Platform
newman run Luma-Offline-Purchase-Events.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
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.