DocumentaciónExperience PlatformTutoriales

Importación de datos de ejemplo en Adobe Experience Platform

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Experimentado
  • Desarrollador

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.

Caso de uso de datos de ejemplo

Los usuarios empresariales de Experience Platform suelen tener que pasar por 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 la ingesta de datos antes de poder explorar las capacidades de marketing que ofrece 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 activar estos perfiles para llevar su marketing al siguiente nivel. Hemos generado datos de muestra para Luma y, en el resto de este tutorial, importará estos datos en uno de los entornos de zona protegida de Experience Platform.

NOTE
El resultado final de este tutorial es una zona protegida que contiene datos similares al tutorial Introducción a Adobe Experience Platform para arquitectos e ingenieros de datos. Se actualizó en abril de 2023 para admitir los desafíos de Journey Optimizer. Se actualizó en junio de 2023 para cambiar el método de autenticación a OAuth.

Requisitos previos

  • Tiene acceso a las API de Experience Platform y sabe cómo autenticarse. Si no, revise este tutorial.
  • Tiene acceso a una zona protegida de desarrollo de Experience Platform.
  • Conoce su ID de inquilino de Experience Platform. Puede obtenerla realizando una solicitud de API autenticada
    o extrayéndolo de la dirección URL cuando inicie sesión en su cuenta de Platform. Por ejemplo, en la siguiente URL, el inquilino es "techmarketingdemos" https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home.

Usando Postman postman

Configuración de variables de entorno

Antes de seguir los pasos, asegúrese de haber descargado la aplicación Postman. ¡Empecemos!

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

    note note
    NOTE
    Los datos de usuario que contiene el archivo platform-utils-main.zip son ficticios y solo se pueden usar con fines de demostración.

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

  3. En la carpeta luma-data, abra todos los archivos de json en un editor de texto y reemplace todas las instancias de _yourTenantId con su propio id. de inquilino, precedido por un guion bajo.

  4. Abra luma-offline-purchases.json, luma-inventory-events.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)

  5. Tenga en cuenta la ubicación de la carpeta descomprimida, ya que la necesitará más adelante al configurar la variable de entorno FILE_PATH Postman:

    note note
    NOTE
    Para obtener la ruta de archivo en su Mac, navegue hasta la carpeta platform-utils-main, haga clic con el botón derecho en la carpeta y seleccione la opción Obtener información.
    Ruta de archivo MAC
    note note
    NOTE
    Para obtener la ruta de acceso del 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 de acceso en la barra de direcciones. Copie la dirección para obtener la ruta del archivo.
    Ruta de archivo de Windows

  6. Abra Postman y cree un área de trabajo desde el menú desplegable Espacios de trabajo:
    Crear espacio de trabajo

  7. Escriba un Nombre y un Resumen opcionales para su área de trabajo y haga clic en Crear Workspace. Postman cambiará a su nuevo área de trabajo cuando lo cree.
    Guardar espacio de trabajo

  8. Ahora, ajuste algunas configuraciones para ejecutar las colecciones Postman en esta área 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 método abreviado de teclado (CMD/CTRL + ,) para abrir el modal.

  9. En la ficha General, actualice el tiempo de espera de la solicitud en ms a 5000 ms y habilite allow reading file outside this directory
    Configuración

    note note
    NOTE
    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 activar un ajuste para indicar la misma intención. Si su FILE_PATH no es la misma que la ruta del directorio de trabajo de Postman, esta opción debería estar habilitada.

  10. Cierre el panel Configuración.

  11. Seleccione los Entornos y luego seleccione Importar:
    Importación de entorno

  12. Importar el archivo de entorno json descargado, DataInExperiencePlatform.postman_environment

  13. En Postman, seleccione su entorno en la lista desplegable superior derecha y haga clic en el icono del ojo para ver las variables de entorno:
    Selección de entorno

  14. Asegúrese de que se rellenan las siguientes variables de entorno. Para obtener información sobre cómo obtener el valor de las variables de entorno, consulte el tutorial Autenticar en las API de Experience Platform para obtener instrucciones paso a paso.

    • CLIENT_SECRET
    • API_KEY—Client ID en Adobe Developer Console
    • SCOPES
    • TECHNICAL_ACCOUNT_ID
    • IMS
    • IMS_ORG—Organization ID en Adobe Developer Console
    • SANDBOX_NAME
    • TENANT_ID: asegúrese de que comienza con un guion bajo, por ejemplo _techmarketingdemos
    • CONTAINER_ID
    • platform_end_point
    • FILE_PATH: utilice la ruta de la carpeta local en la que ha descomprimido el archivo platform-utils-main.zip. Asegúrese de que incluye el nombre de la carpeta, por ejemplo /Users/dwright/Desktop/platform-utils-main

  15. Guardar el entorno actualizado

Importar colecciones de Postman

A continuación, debe importar las colecciones en Postman.

  1. Seleccione Colecciones y luego elija la opción de importación:

    Colecciones

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

    Importación de colecciones

Autenticar

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 el uso que no sea de producción. La firma local carga una biblioteca de JavaScript desde un host de terceros y la firma remota envía la clave privada a un servicio web de Adobe. Aunque la Adobe de no almacena esta clave privada, las claves de producción nunca deben compartirse con nadie.

  1. Abra la colección 0-Authentication, seleccione la solicitud OAuth: Request Access Token y haga clic en SEND para autenticar y obtener el token de acceso.

    Importación de colecciones

  2. Revise las variables de entorno y observe que ACCESS_TOKEN se ha rellenado.

Importación de datos

Ahora puede preparar e importar los datos en su zona protegida de Platform. Las colecciones de Postman que importó harán todo el trabajo pesado.

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

    Importación de colecciones

  2. En la ventana del ejecutor de recopilación, asegúrese de seleccionar el entorno del menú desplegable, actualizar Delay a 4000ms, comprobar la opción Guardar respuestas y asegurarse de que el orden de ejecución sea correcto. Haga clic en el botón Ejecutar datos de fidelización de Luma

    Importación de colecciones

    note note
    NOTE
    1-Luma-Loyalty-Data crea un esquema para los datos de fidelidad de clientes. El esquema se basa en la clase de perfil individual de XDM, el grupo de campos estándar y un grupo de campos y tipo de datos personalizados. La colección crea un conjunto de datos mediante el esquema y carga datos de fidelidad de cliente de muestra en Adobe Experience Platform.
    note note
    NOTE
    Si alguna solicitud de colección falla durante el ejecutor de la colección de Postman, detenga la ejecución y ejecute las solicitudes de colección una por una.

  3. Si todo va bien, se pasarán todas las solicitudes de la colección Luma-Loyalty-Data.

    Resultado de fidelización

  4. Ahora vamos a iniciar sesión en la interfaz de Adobe Experience Platform y navegar a los conjuntos de datos.

  5. Abra el conjunto de datos Luma Loyalty Dataset y en la ventana de actividad del conjunto de datos podrá ver una ejecución por lotes correcta que ha introducido 1000 registros. También puede hacer clic en la opción del conjunto de datos de vista previa para verificar los registros ingeridos. Es posible que tenga que esperar varios minutos para confirmar que se crearon 1000 nuevos fragmentos de perfil.
    Conjunto de datos de fidelización

  6. Repita los pasos del 1 al 3 para ejecutar las demás colecciones:

    • 2-Luma-CRM-Data.postman_collection.json crea un esquema y rellena un conjunto de datos 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 grupos de campos Detalles de Commerce.
    • 5-Luma-Product-Inventory-Events.postman_collection.json crea un esquema y rellena un conjunto de datos para los eventos relacionados con los productos que entran y salen del stock. El esquema se basa en una clase de evento empresarial personalizada y un grupo de campos personalizados.
    • 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 Optimizer
    • 7-Luma-Web-Events.postman_collection.json crea un esquema y rellena un conjunto de datos con datos web históricos simples.

Validación

Los datos de ejemplo se han diseñado para que, cuando se hayan ejecutado las colecciones, se creen perfiles de clientes en tiempo real que combinen datos de varios sistemas. Un buen ejemplo de esto es el primer registro de los conjuntos de datos de lealtad, CRM y compra sin conexión. Busque ese perfil para confirmar que se han introducido los datos. En la interfaz de Adobe Experience Platform:

  1. Ir a Perfiles > Examinar
  2. Seleccione Luma Loyalty Id como área de nombres de identidad
  3. Busque 5625458 como valor de identidad
  4. Abrir el perfil Daniel Wright
TIP
Si no ve el perfil, consulte la página Conjuntos de datos para confirmar que todos los conjuntos de datos se hayan creado e ingerido correctamente. Si esto parece correcto, espere 15 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 diagnósticos de error en la página Conjuntos de datos y arrastrar y soltar el archivo de datos json para volver a ingerir los datos.

Abriendo un perfil

Si explora los datos de las fichas Atributos y Eventos, verá que el perfil contiene datos de los distintos archivos de datos:
Datos de evento del archivo de eventos de compra sin conexión

Pasos siguientes

Si desea obtener más información sobre Adobe Journey Optimizer, esta zona protegida contiene todo lo necesario para superar los 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, pase a la 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 han permitido crear manualmente todo lo que acaba de completar con estas colecciones de Postman: ¡disfrute del principio!

Si desea crear una implementación de SDK web de ejemplo para vincularla a esta zona protegida, visite el
Implementar Adobe Experience Cloud con tutorial de SDK web. Después de configurar las lecciones "Configuración inicial", "Configuración de etiquetas" y "Configuración de 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 del archivo luma-crm.json con la contraseña test para ver cómo los fragmentos de perfil se combinan con los datos cargados en este tutorial.

Si desea crear una implementación de SDK móvil de ejemplo para vincularla a este simulador de pruebas, consulte el
Implementar Adobe Experience Cloud en el tutorial de aplicaciones móviles. Después de configurar las lecciones "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 del archivo luma-crm.json para ver cómo se combina un fragmento de perfil con los datos cargados en este tutorial.

Restablecer entorno de espacio aislado reset-sandbox

Al restablecer una zona protegida que no sea de producción, se eliminarán todos los recursos asociados a ella (esquemas, conjuntos de datos, etc.), pero se conservarán el nombre y los permisos asociados a la zona protegida. Esta zona protegida "limpia" sigue estando disponible con el mismo nombre para los usuarios que tienen acceso a ella.

Siga los pasos aquí para restablecer un entorno de espacio aislado.

recommendation-more-help
9051d869-e959-46c8-8c52-f0759cee3763