Importación de datos de ejemplo en Adobe Experience Platform

En este tutorial, explicaremos cómo configurar su entorno de simulación de pruebas de Experience Platform con algunos datos de ejemplo que puede explorar. Con una colección de postman, puede crear grupos de campos, esquemas, conjuntos de datos y luego importar datos de ejemplo en Experience Platform.

Ejemplo de uso de datos

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 IU de la aplicación Postman o utilizar la línea de comandos Collection Runner for Postman (Newman)

Requisitos previos

• Se ha autenticado y tiene acceso a las API de Experience Platform. Si no es así, puede configurarlo rápidamente siguiendo este tutorial.
• Tiene acceso al entorno limitado del Experience Platform.

Uso de Postman

Importar colección Postman y configurar variables de entorno

Antes de seguir los pasos, asegúrese de haber descargado la aplicación Postman y tener 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.

1. Descargue el archivo platform-utils-main.zip , que contiene todos los archivos necesarios para este tutorial.

2. Desde la carpeta de descargas, mueva el archivo platform-utils-main.zip a la ubicación deseada en el equipo y descomprima el archivo.

3. Tenga en cuenta la ubicación del archivo descomprimido, ya que es posible que lo necesitemos más adelante al configurar la variable de entorno de postman FILE_PATH

   NOTA

   Para obtener la ruta de archivo en su Mac, vaya a la carpeta platform-utils-main, haga clic con el botón derecho en la carpeta y seleccione la opción Obtener información.

   

   NOTA

   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.

   

4. Inicie Postman y cree un nuevo espacio de trabajo. Copie el valor de metadatos where del

5. Para crear un nuevo espacio de trabajo, utilice el menú desplegable Workspaces situado a la izquierda de Postman. Puede seleccionar un espacio de trabajo existente o crear un nuevo espacio de trabajo para el proyecto.
   

6. Introduzca un Name y un Summary opcional para el espacio de trabajo y haga clic en Crear espacio de trabajo. Postman cambiará a su nuevo espacio de trabajo cuando lo cree.
   

7. 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 Settings para abrir el modal de la configuración. También puede utilizar el atajo de teclado (CMD/CTRL + ,) para abrir el modal.

8. En la pestaña General, actualicemos el tiempo de espera de la solicitud en ms a 5000 ms y habilitemos allow reading file outside this directory

   

   NOTA

   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.

9. Cierre el panel de configuración.

10. Seleccione la opción entornos y haga clic en la opción de importación.
    

11. Importe el archivo de entorno json descargado, DataInExperiencePlatform.postman_environment, y haga clic en Importar

12. 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.
    

13. 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 el tutorial Autenticar con las API de Experience Platform 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

14. Actualice la variable FILE_PATH a la ruta de la carpeta local donde ha descomprimido el archivo platform-utils-main.zip. 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.
    

15. 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

16. Seleccione colecciones y, a continuación, elija la opción de importación

    

17. 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

    

18. Abra la colección Authentication, seleccione la solicitud del POST IMS: JWT Generate + Auth via User Token y haga clic en SEND para autenticarse y obtener el token de acceso.

    

19. Revise las variables de entorno y puede observar que JWT_TOKEN y ACCESS_TOKEN ya están rellenadas.

20. Abra la colección Luma-Loyalty-Data y haga clic en Ejecutar en la ficha Información general para iniciar un Ejecutor de colecciones.

    

21. 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 botón Run Luma Loyalty Data

    

    NOTA

    La ejecución de Luma-Loyalty- Datacollection 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.

    NOTA

    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.

22. Si todo va bien, todas las solicitudes de la colección Luma-Loyalty-Data deben pasar.

    

23. Ahora vamos a iniciar sesión en Adobe Experience Platform UI y a navegar a conjuntos de datos.

24. Abra el conjunto de datos Luma Loyalty Dataset y, en la ventana de actividad del conjunto de datos, puede ver una ejecución por lotes exitosa que ingerió 1000 registros. También puede hacer clic en la opción de vista previa del conjunto de datos para verificar los registros ingestados.
    

25. 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.

Uso de Newman

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.

Instalación de NodeJs y Newman

1. Para ejecutar Newman, asegúrese de que tiene Node.js >= v10. Instale Node.js mediante el administrador de paquetes.

2. Ejecute el comando node -v para asegurarse de que el nodo está instalado.

3. 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.

4. Siga los pasos aquí para instalar newman para su sistema

5. Ejecute el comando newman -v para asegurarse de que newman está instalado.

6. Descargue el archivo platform-utils-main.zip , que contiene todos los archivos necesarios para este tutorial.

7. Desde la carpeta de descargas, mueva el archivo platform-utils-main.zip a la ubicación deseada en el equipo y descomprima el archivo.

8. Tenga en cuenta la ubicación del archivo descomprimido, ya que es posible que lo necesitemos más adelante al configurar la variable de entorno de postman FILE_PATH

9. Abra la carpeta platform-utils-main en una ventana de terminal.

10. Ejecute Luma-Loyalty-Data.postman_collection.json para crear grupos de campos, esquema, conjunto de datos e ingerir datos de lealtad de ejemplo 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

11. Si todo va bien, todas las solicitudes de la colección Luma-Loyalty-Data deben pasar.

12. Ahora vamos a iniciar sesión en Adobe Experience Platform UI y a navegar a conjuntos de datos.

13. Abra el conjunto de datos Luma Loyalty Dataset y, en la ventana de actividad del conjunto de datos, puede ver una ejecución por lotes exitosa que ingerió 1000 registros. También puede hacer clic en la opción de vista previa del conjunto de datos para verificar los registros ingestados.

    

14. Repita los pasos del 10 al 13 para ejecutar las colecciones siguientes:

    • Ejecute Luma-CRM-Data.postman_collection.json para crear grupos de campos, esquemas, conjuntos de datos y para 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
    • Ejecute Luma-Product-Catalog.postman_collection.json para crear grupos de campos, esquemas, conjuntos de datos y para 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
    • Ejecute Luma-Offline-Purchase-Events.postman_collection.json para crear grupos de campos, esquemas, conjuntos de datos y para 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

Restablecer entorno de espacio aislado

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 aquí para restablecer un entorno de entorno limitado.