Nesta página: saiba como criar perfis de teste carregando um arquivo CSV ou usando chamadas de API para poder visualizar o conteúdo e testar jornadas no Adobe Journey Optimizer.
Perfis de teste são necessários ao usar o modo de teste em uma jornada e para visualizar e testar seu conteúdo.
Você pode criar perfis de teste carregando um arquivo CSV ou usando chamadas de API. Adobe Journey Optimizer também fornece um caso de uso no produto específico para facilitar a criação do perfil de teste.
Você pode fazer upload de um arquivo JSON em um conjunto de dados existente. Para obter mais informações, consulte a documentação de Assimilação de dados.
Criar um perfil de teste é semelhante a criar perfis comuns no Adobe Experience Platform. Para obter mais informações, consulte a documentação de Perfil do cliente em tempo real.
➡️ Saiba como criar perfis de teste neste vídeo
Pré-requisitos test-profile-prerequisites
Para criar perfis, primeiro crie um esquema e um conjunto de dados no Adobe Journey Optimizer.
Criar um esquema create-schema
Para criar um esquema, siga estas etapas:
-
Na seção de menu DATA MANAGEMENT, clique em Esquemas e selecione o botão Criar esquema.
-
Selecione Padrão como a opção de criação do esquema.
-
Selecione um tipo de esquema, por exemplo Perfil Individual, e clique em Próximo.
-
Insira um nome para o esquema e clique em Concluir.
-
Na seção Grupos de campos, à esquerda, clique em Adicionar e selecione os grupos de campos apropriados. Adicione o grupo de campos Detalhes do teste de perfil.
Depois de concluído, clique em Adicionar grupos de campos: a lista de grupos de campos é exibida na tela de visão geral do esquema.
note NOTE Clique no nome do schema para atualizar suas propriedades. -
Na lista de campos, clique no campo que você deseja definir como a identidade principal.
-
No painel direito Propriedades do campo, verifique as opções Identidade e Identidade primária e selecione um namespace. Se você quiser que a identidade principal seja um endereço de email, escolha o namespace Email. Clique em Aplicar.
-
Selecione o esquema e habilite a opção Perfil no painel Propriedades do esquema.
-
Clique em Salvar.
Para obter mais informações sobre a criação de esquemas, consulte a documentação XDM.
/personID) para o namespace pretendido. Se o descritor de identidade estiver ausente ou configurado incorretamente, os perfis assimilados neste conjunto de dados podem não ser sinalizados como perfis de teste (testProfile = true), mesmo que o processo de assimilação seja concluído com êxito.- Revise o esquema associado ao seu conjunto de dados.
- Confirme se o campo de identidade principal tem o descritor de identidade correto para o namespace (consulte as etapas 6 a 7 acima).
- Se o descritor estiver ausente, atualize o esquema para adicionar o descritor de identidade e assimilar novamente seus dados.
Criar um conjunto de dados create-dataset
Em seguida, é necessário criar o conjunto de dados no qual os perfis serão importados. Siga estas etapas:
- Navegue até Conjuntos de Dados e clique em Criar conjunto de dados.
- Escolha Criar conjunto de dados do esquema.
- Selecione o esquema criado anteriormente e clique em Avançar.
- Escolha um nome e clique em Concluir.
- Habilite a opção Perfil.
Caso de uso no produto use-case-1
Na página inicial do Adobe Journey Optimizer, você pode aproveitar o caso de uso de perfis de teste no produto. Esse caso de uso facilita a criação de perfis de teste usados para jornadas de teste antes da publicação.
Clique no botão Começar para iniciar o caso de uso.
As seguintes informações são obrigatórias:
-
Namespace de identidade: o namespace de identidade usado para identificar exclusivamente os perfis de teste. Por exemplo, se o email for usado para identificar os perfis de teste, o namespace de identidade Email deverá ser selecionado. Se o identificador exclusivo for o número de telefone, o namespace de identidade Telefone deverá ser selecionado.
-
Arquivo CSV: um arquivo separado por vírgulas contendo a lista de perfis de teste a serem criados. O caso de uso espera um formato predefinido para o arquivo CSV que contém a lista de perfis de teste a serem criados. Cada linha no arquivo deve incluir os seguintes campos na ordem correta, como a seguir:
- Id de pessoa: identificador exclusivo do perfil de teste. Os valores desse campo devem refletir o namespace de identidade que foi selecionado. (Por exemplo, se Telefone for selecionado para o namespace de identidade, os valores desse campo deverão ser números de telefone. Da mesma forma, se Email for selecionado, os valores deste campo deverão ser emails)
- Endereço de email: testar endereço de email do perfil. (O campo Id da Pessoa e o campo Endereço de Email poderão conter os mesmos valores se Email for selecionado como namespace de identidade)
- Nome: nome do perfil de teste.
- Sobrenome: testar sobrenome do perfil.
- Cidade: cidade de residência do perfil de teste
- País: país de residência do perfil de teste
- Gênero: gênero do perfil de teste. Os valores disponíveis são masculino, feminino e não_especificado
Depois de selecionar o namespace de identidade e fornecer o arquivo CSV com base no formato acima, selecione o botão Executar no canto superior direito. O caso de uso pode levar alguns minutos para ser concluído. Quando o caso de uso concluir o processamento e a criação dos perfis de teste, uma notificação será enviada ao usuário.
Criar perfis de teste usando um arquivo CSV create-test-profiles-csv
No Adobe Experience Platform, é possível criar perfis carregando um arquivo csv contendo os diferentes campos de perfil no conjunto de dados. Esse é o método mais fácil.
- Crie um arquivo csv simples usando um software de planilha.
- Adicione uma coluna para cada campo obrigatório. Adicione o campo de identidade principal (
personIDno nosso exemplo acima) e o campotestProfiledefinido comotrue.
- Adicione uma linha por perfil e preencha os valores para cada campo.
- Salve a planilha como um arquivo csv. Verifique se as vírgulas são usadas como separadores.
- Navegue até Adobe Experience Platform Workflows.
- Escolha Mapear CSV para esquema XDM e clique em Iniciar.
- Selecione o conjunto de dados para o qual você deseja importar os perfis. Clique em Next.
- Clique em Escolher arquivos e selecione seu arquivo csv. Quando o arquivo for carregado, clique em Avançar.
- Mapeie os campos csv de origem para os campos de esquema e clique em Concluir.
- A importação de dados é iniciada. O status será movido de Processando para Sucesso. Clique em Visualizar conjunto de dados, na parte superior direita.
- Verifique se os perfis de teste foram adicionados corretamente.
Seus perfis de teste são adicionados e agora podem ser usados ao testar uma jornada. Consulte esta seção.
Criar perfis de teste usando chamadas de API create-test-profiles-api
Você também pode criar perfis de teste por meio de chamadas de API. Saiba mais em Adobe Experience Platform documentação.
Você deve usar um esquema de Perfil que contenha o grupo de campos Detalhes do teste de perfil. O sinalizador testProfile faz parte deste grupo de campos.
Ao criar um perfil, passe o valor: testProfile = true.
Você também pode atualizar um perfil existente para alterar seu sinalizador testProfile para true.
Este é um exemplo de uma chamada de API para criar um perfil de teste:
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 tutorial video
Saiba como criar perfis de teste.
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.