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.
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:
-
En la sección de menú DATA MANAGEMENT, haga clic en Esquemas y seleccione el botón Crear esquema.
-
Seleccione Standard como opción de creación de esquema.
-
Seleccione un tipo de esquema, por ejemplo Perfil individual, y haga clic en Siguiente.
-
Escriba un nombre para el esquema y haga clic en Finalizar.
-
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.
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.
note NOTE Haga clic en el nombre del esquema para actualizar sus propiedades. -
En la lista de campos, haga clic en el campo que desee definir como identidad principal.
-
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.
-
Seleccione el esquema y habilite la opción Perfil en el panel Propiedades del esquema.
-
Haga clic en Guardar.
Para obtener más información sobre la creación de esquemas, consulte la documentación de XDM.
/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.- Revise el esquema asociado al conjunto de datos.
- Confirme que el campo de identidad principal tiene el descriptor de identidad correcto para el área de nombres (consulte los pasos 6-7 anteriores).
- 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:
- Vaya a Conjuntos de datos y, a continuación, haga clic en Crear conjunto de datos.
- Elija Crear conjunto de datos a partir del esquema.
- Seleccione el esquema creado anteriormente y haga clic en Siguiente.
- Elija un nombre y haga clic en Finalizar.
- Habilite la opción Perfil.
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.
Haga clic en el botón Comenzar para iniciar el caso de uso.
Se requiere la siguiente información:
-
Á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.
-
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:
- 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)
- 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)
- Nombre: Nombre del perfil de prueba.
- Apellido: Apellido del perfil de prueba.
- Ciudad: perfil de prueba ciudad de residencia
- País: perfil de prueba del país de residencia
- 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.
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.
- Cree un archivo csv simple con un software de hoja de cálculo.
- Agregue una columna para cada campo obligatorio. Asegúrese de agregar el campo de identidad principal (
personIDen el ejemplo anterior) y el campotestProfileestablecido entrue.
- Añada una línea por perfil y rellene los valores de cada campo.
- Guarde la hoja de cálculo como archivo csv. Asegúrese de que se utilizan comas como separadores.
- Vaya a Adobe Experience Platform flujos de trabajo.
- Elija Asignar CSV al esquema XDM y, a continuación, haga clic en Iniciar.
- Seleccione el conjunto de datos en el que desea importar los perfiles. Haga clic en Next.
- Haga clic en Elegir archivos y seleccione el archivo CSV. Cuando se cargue el archivo, haga clic en Siguiente.
- Asigne los campos csv de origen a los campos de esquema y haga clic en Finalizar.
- 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.
- Compruebe que los perfiles de prueba se hayan agregado correctamente.
Los perfiles de prueba se han añadido y ahora se pueden utilizar para probar un recorrido. Consulte esta sección.
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.
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
testProfilefield totrue
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
testProfileflag 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
testProfilefield must be set totrue. - 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: “
testProfileflag” = “testProfilefield” - 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
testProfileflag. - 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
testProfilefield totruewhen 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.