Importación de datos de muestra en Adobe Experience Platform

Última actualización: 2023-07-27
  • Temas:
  • API
    Ver más sobre este tema
  • Creado para:
  • Experienced
    Developer

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.

NOTA

El resultado final de este tutorial es una zona protegida que contiene datos similares a los de Tutorial de introducción a Adobe Experience Platform para arquitectos e ingenieros de datos. Se actualizó en abril de 2023 para admitir la Retos 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 es así, revise esto tutorial.
  • Tiene acceso a una zona protegida de desarrollo de Experience Platform.
  • Conoce su ID de inquilino de Experience Platform. Puede obtenerla realizando una actividad autenticada Solicitud de API
    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.

Uso de Postman

Configuración de variables de entorno

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

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

    NOTA

    Datos de usuario incluidos en platform-utils-main.zip es ficticio y solo debe utilizarse 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 el luma-data carpeta, abra todas las json archivos en un editor de texto y reemplazar todas las instancias de _yourTenantId con su propio id de inquilino, precedido de un guion bajo.

  4. Abrir 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 el FILE_PATH Postman variable de entorno:

    NOTA

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

    Ruta del archivo Mac

    NOTA

    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. Abrir Postman y cree un espacio de trabajo desde el Workspaces menú desplegable:
    Crear espacio de trabajo

  7. Introduzca una Nombre y opcional Resumen para su espacio de trabajo y haga clic en Crear Workspace. Postman cambiará al nuevo espacio de trabajo cuando lo cree.
    Guardar espacio de trabajo

  8. Ahora ajuste algunos ajustes para ejecutar el Postman colecciones en este espacio 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 el General pestaña, actualice el tiempo de espera de la solicitud en ms a 5000 ms y habilitar allow reading file outside this directory
    Configuración

    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 fuera del directorio de trabajo, debe activar un ajuste para indicar la misma intención. Si su FILE_PATH no es lo mismo que PostmanRuta del directorio de trabajo de, se debe activar esta opción.

  10. Cierre el Configuración panel.

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

  12. Importe 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 la Autenticar en las API de Experience Platform tutorial para obtener instrucciones paso a paso.

    • CLIENT_SECRET
    • API_KEYClient ID en la consola de Adobe Developer
    • SCOPES
    • TECHNICAL_ACCOUNT_ID
    • IMS
    • IMS_ORGOrganization ID en la consola de Adobe Developer
    • 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 platform-utils-main.zip archivo. 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. Seleccionar Colecciones y, a continuación, elija la opción import:

    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 JavaScript desde un host de terceros y la firma remota envía la clave privada a un servicio web operado y propiedad del Adobe. Aunque la Adobe de no almacena esta clave privada, las claves de producción nunca deben compartirse con nadie.

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

    Importación de colecciones

  2. Revise las variables de entorno y observe que la variable ACCESS_TOKEN ahora se rellena.

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 el 1-Luma-Loyalty-Data y haga clic en Ejecutar en la pestaña de 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 de la lista desplegable y actualizar el Demora hasta 4000ms, marque la Guardar respuestas y asegúrese de que el orden de ejecución es correcto. Haga clic en Ejecutar datos de fidelización de Luma botón

    Importación de colecciones

    NOTA

    1-Luma-Loyalty-Data crea un esquema para los datos de lealtad del cliente. 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.

    NOTA

    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, todas las solicitudes de Luma-Loyalty-Data la colección debería pasar.

    Resultado de fidelización

  4. Ahora vamos a iniciar sesión en Interfaz de Adobe Experience Platform y vaya a conjuntos de datos.

  5. Abra el Luma Loyalty Dataset conjunto de datos y, en la ventana de actividad del conjunto de datos, puede 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 1000 Nuevos fragmentos de perfil se han creado.
    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 un conjunto de datos rellenado 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 comercio.
    • 5-Luma-Product-Inventory-Events.postman_collection.json crea un esquema y un conjunto de datos rellenado para eventos relacionados con 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 utilizarlo en Adobe Journey Optimizer
    • 7-Luma-Web-Events.postman_collection.json crea un esquema y un conjunto de datos rellenado 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 el Interfaz de Adobe Experience Platform:

  1. Ir a Perfiles > Examinar
  2. Seleccionar Luma Loyalty Id como el Área de nombres de identidad
  3. Buscar por 5625458 como el Valor de identidad
  4. Abra el Daniel Wright perfil
SUGERENCIA

Si no ve el perfil, consulte la Conjuntos de datos para confirmar que todos los conjuntos de datos se han 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 los diagnósticos de error en Conjuntos de datos y arrastre y suelte el archivo de datos json para volver a introducir los datos.

Apertura de perfiles

Navegando por los datos en la Atributos y Eventos , debería 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 tomar la Retos de Journey Optimizer

Si desea obtener más información sobre las políticas de combinación, la gobernanza de datos, el servicio de consultas y el generador de segmentos, pase a lección 11 en el tutorial Introducción a los arquitectos e 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
Tutorial de implementación de Adobe Experience Cloud con 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 en la luma-crm.json archivo con contraseña test para ver la combinación de fragmentos de perfil con 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
Tutorial de implementación de Adobe Experience Cloud en 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 luma-crm.json para ver una combinación de fragmentos de perfil con datos cargados en este tutorial.

Restablecer entorno de espacio aislado

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

En esta página