Creación de perfiles de prueba create-test-profiles

En esta página: Aprenda a crear perfiles de prueba cargando un archivo CSV o utilizando llamadas a la API para poder obtener una vista previa del contenido y probar los recorridos en Adobe Journey Optimizer.

Se requieren perfiles de prueba al usar el modo de prueba en un recorrido, y para previsualizar y probar el contenido.

NOTE
Journey Optimizer ofrece dos formas de simular contenido: haga clic en Simular contenido para probar las variaciones de contenido con datos de entrada de muestra o generación automática de IA; o haga clic en Simular contenido y, a continuación, seleccione Simular contenido (perfiles de AEP) en el menú desplegable para previsualizarlo con perfiles de prueba. Aprenda a simular variaciones de contenido

Puede crear perfiles de prueba al cargar un archivo CSV o al usar llamadas a la API. Adobe Journey Optimizer también proporciona un caso de uso en el producto específico para facilitar la creación del perfil de prueba.

Puede cargar un archivo JSON en un conjunto de datos existente. Para obtener más información, consulte la Documentación de ingesta de datos.

Crear un perfil de prueba es similar a crear perfiles normales en Adobe Experience Platform. Para obtener más información, consulte la Documentación del perfil del cliente en tiempo real.

➡️ Aprenda a crear perfiles de prueba en este vídeo

Requisitos previos test-profile-prerequisites

Para crear perfiles, primero debe crear un esquema y un conjunto de datos en Adobe Journey Optimizer.

Creación de un esquema create-schema

Para crear un esquema, siga estos pasos:

  1. En la sección de menú DATA MANAGEMENT, haga clic en Esquemas y seleccione el botón Crear esquema.

    Menú Esquemas con el botón Crear esquema

  2. Seleccione Standard como opción de creación de esquema.

  3. Seleccione un tipo de esquema, por ejemplo Perfil individual, y haga clic en Siguiente.
    Selección de tipo de esquema que muestra la opción de perfil individual

  4. Escriba un nombre para el esquema y haga clic en Finalizar.
    Nombrar y guardar diálogo de esquema

  5. En la sección Grupos de campos, a la izquierda, haga clic en Agregar y seleccione los grupos de campos correspondientes. Asegúrese de agregar el grupo de campos Detalles de la prueba del perfil.
    Sección de grupos de campos con botón Agregar
    Una vez finalizado, haga clic en Agregar grupos de campos: la lista de grupos de campos se muestra en la pantalla de información general del esquema.
    Resumen del esquema con lista de grupos de campos

    note
    NOTE
    Haga clic en el nombre del esquema para actualizar sus propiedades.
  6. En la lista de campos, haga clic en el campo que desee definir como identidad principal.
    Lista de campos de esquema para seleccionar la identidad principal

  7. En el panel derecho de Propiedades del campo, compruebe las opciones Identidad e Identidad principal y seleccione un área de nombres. Si desea que la identidad principal sea una dirección de correo electrónico, elija el área de nombres Correo electrónico. Haga clic en Aplicar.
    Panel de propiedades de campo con opciones de identidad y de identidad principal

  8. Seleccione el esquema y habilite la opción Perfil en el panel Propiedades del esquema.
    Panel de propiedades del esquema con la opción de perfil habilitada

  9. Haga clic en Guardar.

Para obtener más información sobre la creación de esquemas, consulte la documentación de XDM.

IMPORTANT
Al crear o reemplazar un conjunto de datos para la ingesta de perfiles de prueba, asegúrese de que el esquema tenga el descriptor de identidad correcto aplicado al campo de identidad principal (por ejemplo, /personID) para el área de nombres deseada. Si falta el descriptor de identidad o está configurado incorrectamente, es posible que los perfiles ingeridos en este conjunto de datos no se marquen como perfiles de prueba (testProfile = true), aunque el proceso de ingesta se complete correctamente.
Si los perfiles de prueba no se marcan correctamente después de la ingesta:
  1. Revise el esquema asociado al conjunto de datos.
  2. Confirme que el campo de identidad principal tiene el descriptor de identidad correcto para el área de nombres (consulte los pasos 6-7 anteriores).
  3. Si falta el descriptor, actualice el esquema para agregar el descriptor de identidad y vuelva a introducir los datos.

Crear un conjunto de datos create-dataset

Entonces necesita crear el conjunto de datos en el que se importarán los perfiles. Siga estos pasos:

  1. Vaya a Conjuntos de datos y, a continuación, haga clic en Crear conjunto de datos.
    Menú Conjuntos de datos con el botón Crear conjunto de datos
  2. Elija Crear conjunto de datos a partir del esquema.
    Crear conjunto de datos a partir de la opción de esquema
  3. Seleccione el esquema creado anteriormente y haga clic en Siguiente.
    Pantalla de selección de esquema para la creación del conjunto de datos
  4. Elija un nombre y haga clic en Finalizar.
    Cuadro de diálogo Nombrar y finalizar conjunto de datos
  5. Habilite la opción Perfil.
    Configuración del conjunto de datos con la opción de perfil habilitada
NOTE
Para obtener más información sobre la creación de conjuntos de datos, consulte la documentación del servicio de catálogo.

Caso de uso dentro del producto use-case-1

Desde la página de inicio de Adobe Journey Optimizer, puede aprovechar los perfiles de prueba en el caso de uso del producto. Este caso de uso facilita la creación de perfiles de prueba utilizados para probar recorridos antes de publicar.

Tarjeta del caso de uso de perfiles de prueba en la página principal

Haga clic en el botón Comenzar para iniciar el caso de uso.

Se requiere la siguiente información:

  1. Área de nombres de identidad: El área de nombres de identidad se usa para identificar los perfiles de prueba de forma única. Por ejemplo, si se usa el correo electrónico para identificar los perfiles de prueba, se debe seleccionar el área de nombres de identidad Correo electrónico. Si el identificador único es el número de teléfono, se debe seleccionar el área de nombres de identidad Teléfono.

  2. archivo CSV: un archivo separado por comas que contiene la lista de perfiles de prueba que se van a crear. El caso de uso espera un formato predefinido para el archivo CSV que contiene la lista de perfiles de prueba que se van a crear. Cada fila del archivo debe incluir los siguientes campos en el orden correcto como se indica a continuación:

    1. Id. de persona: Identificador único del perfil de prueba. Los valores de este campo deben reflejar el área de nombres de identidad seleccionada. (Por ejemplo, si Phone está seleccionado para el área de nombres de identidad, los valores de este campo deben ser números de teléfono. Del mismo modo, si se selecciona Correo electrónico, los valores de este campo deben ser correos electrónicos)
    2. Dirección de correo electrónico: dirección de correo electrónico del perfil de prueba. (El campo ID de persona y el campo Dirección de correo electrónico podrían contener los mismos valores si se selecciona Correo electrónico como área de nombres de identidad)
    3. Nombre: Nombre del perfil de prueba.
    4. Apellido: Apellido del perfil de prueba.
    5. Ciudad: perfil de prueba ciudad de residencia
    6. País: perfil de prueba del país de residencia
    7. Sexo: género del perfil de prueba. Los valores disponibles son hombre, mujer y no especificado

Después de seleccionar el área de nombres de identidad y proporcionar el archivo CSV en función del formato anterior, seleccione el botón Ejecutar en la parte superior derecha. El caso de uso puede tardar unos minutos en completarse. Una vez que el caso de uso termina de procesar y crear los perfiles de prueba, se envía una notificación al usuario.

NOTE
Los perfiles de prueba pueden anular los perfiles existentes. Antes de ejecutar el caso de uso, asegúrese de que el CSV solo contiene perfiles de prueba y de que se ejecuta en la zona protegida correcta.

Creación de perfiles de prueba con un archivo CSV create-test-profiles-csv

En Adobe Experience Platform, puede crear perfiles cargando un archivo csv que contenga los diferentes campos de perfil en el conjunto de datos. Este es el método más sencillo.

  1. Cree un archivo csv simple con un software de hoja de cálculo.
  2. Agregue una columna para cada campo obligatorio. Asegúrese de agregar el campo de identidad principal (personID en el ejemplo anterior) y el campo testProfile establecido en true.
    Archivo CSV con encabezados de columna que incluye personID y testProfile
  3. Añada una línea por perfil y rellene los valores de cada campo.
    Archivo CSV con datos de perfil de prueba de ejemplo
  4. Guarde la hoja de cálculo como archivo csv. Asegúrese de que se utilizan comas como separadores.
  5. Vaya a Adobe Experience Platform flujos de trabajo.
    Menú de flujos de trabajo en Adobe Experience Platform
  6. Elija Asignar CSV al esquema XDM y, a continuación, haga clic en Iniciar.
    Asignar CSV a la opción de flujo de trabajo de esquema XDM
  7. Seleccione el conjunto de datos en el que desea importar los perfiles. Haga clic en Next.
    Pantalla de selección de conjuntos de datos para importación de CSV
  8. Haga clic en Elegir archivos y seleccione el archivo CSV. Cuando se cargue el archivo, haga clic en Siguiente.
    Pantalla de carga de archivos con el botón Elegir archivos
  9. Asigne los campos csv de origen a los campos de esquema y haga clic en Finalizar.
    Interfaz de asignación de campos CSV que muestra los campos de origen y destino
  10. Comienza la importación de datos. El estado pasará de Procesando a Correcto. Haga clic en Vista previa del conjunto de datos, en la parte superior derecha.
    Estado de importación que muestra Correcto con el botón Vista previa del conjunto de datos
  11. Compruebe que los perfiles de prueba se hayan agregado correctamente.
    Vista previa del conjunto de datos que muestra perfiles de prueba importados

Los perfiles de prueba se han añadido y ahora se pueden utilizar para probar un recorrido. Consulte esta sección.

NOTE
Para obtener más información sobre las importaciones de csv, consulte la documentación de ingesta de datos.

Creación de perfiles de prueba mediante llamadas a API create-test-profiles-api

También puede crear perfiles de prueba mediante llamadas a la API. Obtenga más información en Adobe Experience Platform documentación.

Debe usar un esquema de perfil que contenga el grupo de campos Detalles de la prueba del perfil. El indicador testProfile forma parte de este grupo de campos.
Al crear un perfil, asegúrese de pasar el valor: testProfile = true.

También puede actualizar un perfil existente para cambiar su indicador testProfile a true.

Este es un ejemplo de llamada de API para crear un perfil de prueba:

curl -X POST \
'https://dcs.adobedc.net/collection/xxxxxxxxxxxxxx' \
-H 'Cache-Control: no-cache' \
-H 'Content-Type: application/json' \
-H 'Postman-Token: xxxxx' \
-H 'cache-control: no-cache' \
-H 'x-api-key: xxxxx' \
-H 'x-gw-ims-org-id: xxxxx' \
-d '{
"header": {
"msgType": "xdmEntityCreate",
"msgId": "xxxxx",
"msgVersion": "xxxxx",
"xactionid":"xxxxx",
"datasetId": "xxxxx",
"imsOrgId": "xxxxx",
"source": {
"name": "Postman"
},
"schemaRef": {
"id": "https://example.adobe.com/mobile/schemas/xxxxx",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"body": {
"xdmMeta": {
"schemaRef": {
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"xdmEntity": {
"_id": "xxxxx",
"_mobile":{
"ECID": "xxxxx"
},
"testProfile":true
}
}
}'

Vídeo práctico video

Obtenga información sobre cómo crear perfiles de prueba.

AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

  • TL;DR: This page explains how to create test profiles by uploading a CSV file, using API calls, or the in-product use case, including the schema and dataset prerequisites, so you can preview content and test journeys in Journey Optimizer.

Intents:

  • Set up the schema (with the Profile test details field group) and dataset prerequisites for test profiles
  • Create test profiles by uploading a CSV file using the Map CSV to XDM schema workflow
  • Create test profiles using API calls
  • Use the in-product use case to generate test profiles from a predefined CSV format
  • Flag profiles as test profiles by setting the testProfile field to true

Glossary:

  • Test profile: A profile flagged with testProfile = true, required for using test mode in a journey and for previewing and testing content (product-specific)
  • Profile test details: The field group that must be added to the schema; the testProfile flag is part of this field group (product-specific)
  • Simulate content: The action to test content variations with sample input data or AI auto-generation (product-specific)
  • Simulate content (AEP profiles): The option selected from the Simulate content dropdown to preview content with test profiles (product-specific)
  • In-product use case: A guided card on the Journey Optimizer home page that facilitates test profile creation from a predefined CSV format (product-specific)
  • Identity namespace: The namespace (for example Email or Phone) used to uniquely identify the test profiles (product-specific)

Guardrails:

  • Test profiles are required when using test mode in a journey and to preview and test content.
  • To create profiles you must first create a schema and a dataset; the schema must include the Profile test details field group.
  • The schema must have the correct identity descriptor applied to the primary identity field for the intended namespace; if it is missing or incorrectly configured, ingested profiles may not be flagged as test profiles (testProfile = true) even if ingestion completes successfully.
  • When creating a profile via CSV or API, the testProfile field must be set to true.
  • Test profiles may override existing profiles; before running the in-product use case, ensure the CSV contains test profiles only and that it is executed against the correct sandbox.
  • The in-product use case expects a predefined CSV format with fields in this order: Person Id, Email Address, First Name, Last Name, City, Country, Gender (available values male, female, non_specified).

Terminology:

  • Canonical name: Test profile — Acronym: n/a — variants: test profiles
  • Synonyms: “testProfile flag” = “testProfile field”
  • Do not confuse: “Simulate content” (sample input data or AI auto-generation) ≠ “Simulate content (AEP profiles)” (preview with test profiles)
  • Do not confuse: “Person Id” (unique identifier reflecting the selected identity namespace) ≠ “Email Address” (test profile email address)

FAQ:

  • Q: What are the ways to create test profiles? — By uploading a CSV file, using API calls, or the in-product use case.
  • Q: What must the schema include? — The Profile test details field group, which contains the testProfile flag.
  • Q: Why are my ingested profiles not flagged as test profiles? — The primary identity field may be missing the correct identity descriptor for your namespace; review the schema, confirm the descriptor, and re-ingest the data.
  • Q: How do I mark a profile as a test profile? — Set the testProfile field to true when creating (or updating) the profile.
  • Q: What should I check before running the in-product use case? — That the CSV contains test profiles only and that it runs against the correct sandbox, since test profiles may override existing profiles.
recommendation-more-help
journey-optimizer-help