Importación de datos de ejemplo en Adobe Experience Platform

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.

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 variable Interfaz de usuario de la aplicación Postman o utilice la línea de comandos Corredor de colecciones para 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 esta tutorial.
• Tiene acceso al entorno limitado del Experience Platform.
• Conozca su ID de inquilino de Experience Platform. Su ID de inquilino debe aparecer en la dirección URL cuando inicie sesión en la cuenta de Platform. En la siguiente URL, el inquilino es "techmarketingdemos" https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home. También puede obtenerla realizando una autenticación Solicitud de API.

Uso de Postman

Importar colección Postman y configurar variables de entorno

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.

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

2. Desde la carpeta de descargas, mueva la variable platform-utils-main.zip en la ubicación deseada del 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 FILE_PATH variable de entorno de postman

   NOTA

   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 .

   

   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 where valor de metadatos de

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

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

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

8. En el General , actualicemos el tiempo de espera de la solicitud en ms para 5000 ms y habilitar 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. Importemos el archivo de entorno json descargado, DataInExperiencePlatform.postman_environmenty 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 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

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

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

    

19. Revise las variables de entorno y puede observar que la variable JWT_TOKEN y ACCESS_TOKEN ahora se rellenan.

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

21. Abra el Luma-Loyalty-Data colección y haga clic en Ejecutar en la ficha información general para iniciar un ejecutor de colecciones.

    

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

    

    NOTA

    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.

    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.

23. Si todo va bien, todas las solicitudes de la variable Luma-Loyalty-Data la colección debe pasar.

    

24. Ahora vamos a iniciar sesión en Interfaz de usuario de Adobe Experience Platform y navegar a conjuntos de datos.

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

26. 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. Instalación de Node.js mediante el administrador de paquetes.

2. Ejecutar 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 here para instalar newman en su sistema

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

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

7. Desde la carpeta de descargas, mueva la variable platform-utils-main.zip en la ubicación deseada del 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 FILE_PATH variable de entorno de postman

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

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

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

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

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

    

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

    • Ejecutar 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
    • Ejecutar 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
    • Ejecutar 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

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