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 mezclas, esquemas, conjuntos de datos y, a continuación, importar datos de muestra en el Experience Platform.

Ejemplo de uso de datos

Los usuarios empresariales Experience Platform a menudo tienen que seguir una serie de pasos que incluyen la identificación de mezclas, 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 poder 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 también tiene presencia en línea con un sitio web y aplicaciones móviles. Están invirtiendo en Adobe Experience Platform para combinar los datos de fidelidad, CRM, web y compras sin conexión en perfiles de clientes en tiempo real y activar 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. Cree una carpeta en el equipo local con el nombre DataInExperiencePlatform y se utilizará para guardar los archivos utilizados en el tutorial.

2. Descargue el archivo data.zip que contiene los archivos necesarios para este tutorial.

3. Descomprima y guárdelo en la carpeta DataInExperiencePlatform.

4. Tenga en cuenta la ubicación, ya que es posible que la necesitemos más adelante al configurar la variable de entorno file_path

5. Inicie Postman y cree un nuevo espacio de trabajo.

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

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

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

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

   

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 las siguientes variables de entorno, se puede obtener valor del proyecto Adobe Developer Console

    • 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 carpeta local donde descargó el zip.file. 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 incluye mezclas personalizadas 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 alguna de las solicitudes de recopilación falla durante el motor de ejecución de la colección postman, detenga la ejecución y ejecute las solicitudes de recopilación una por 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 detalles demográficos, detalles de contacto personal y mezclas de perfiles 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 mezclas 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. Cree una carpeta en el equipo local con el nombre DataInExperiencePlatform y se utilizará para guardar los archivos necesarios en el tutorial.

7. Descargue el archivo data.zip , que contiene los archivos necesarios para este tutorial.

8. Descomprima y manténgalo en la carpeta DataInExperiencePlatform .

9. Abra la carpeta DataInExperiencePlatform en una ventana de terminal.

10. Ejecute Luma-Loyalty-Data.postman_collection.json para generar mezclas, esquemas, conjuntos 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

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 generar mezclas, esquemas, conjuntos de datos y para ingerir datos de CRM de muestra 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 generar mezclas, esquemas, conjuntos de datos y para ingerir datos de productos de muestra 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 generar mezclas, esquemas, conjuntos de datos y para ingerir datos de productos de muestra 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.