Saiba como configurar um ambiente de sandbox da Experience Platform com dados de amostra. Usando uma coleção do Postman, você pode criar grupos de campos, esquemas, conjuntos de dados e, em seguida, importar dados de amostra para a Experience Platform.
Os usuários da Experience Platform business geralmente precisam passar por uma série de etapas que incluem a identificação de grupos de campos, a criação de schemas, a preparação de dados, a criação de conjuntos de dados e, em seguida, a assimilação de dados, antes que possam explorar os recursos de marketing oferecidos pelo Experience Platform. Este tutorial automatiza algumas etapas para que você possa inserir dados em uma sandbox da Platform o mais rápido possível.
Este tutorial foca em uma marca fictícia de varejo chamada Luma. Eles investem no Adobe Experience Platform para combinar dados de fidelidade, CRM, catálogo de produtos e compra offline em perfis de clientes em tempo real e ativar esses perfis para elevar seu marketing ao próximo nível. Geramos dados de amostra para o Luma e, no restante deste tutorial, você importará esses dados para um de seus ambientes de sandbox do Experience Platform.
O resultado final deste tutorial é uma sandbox contendo dados semelhantes ao Tutorial Introdução à Adobe Experience Platform para arquitetos de dados e engenheiros de dados. Ela foi atualizada em abril de 2023 para oferecer suporte à variável Desafios da Journey Optimizer.
techmarketingdemos
" https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home
.Antes de seguir as etapas, certifique-se de ter baixado a variável Postman aplicativo. Vamos começar!
Baixe o platform-utils-main.zip , que contém todos os arquivos necessários para este tutorial.
Os dados do usuário contidos na variável platform-utils-main.zip O ficheiro é fictício e deve ser utilizado apenas para fins de demonstração.
Na pasta de downloads, mova o arquivo platform-utils-main.zip
para o local desejado em seu computador e descompacte-o.
No luma-data
, abra todas as json
arquivos em um editor de texto e substitua todas as instâncias de _yourOrganizationID
com sua própria ID de locatário, precedida por um sublinhado.
Abrir luma-offline-purchases.json
e luma-web-events.json
em um editor de texto e atualize todos os carimbos de data e hora para que os eventos ocorram no último mês (por exemplo, pesquise por "timestamp":"2022-11
e substituir o ano e o mês)
Observe a localização da pasta descompactada, pois você precisará dela posteriormente ao configurar a variável FILE_PATH
Variável de ambiente do Postman:
Para obter o caminho do arquivo na Mac, navegue até o platform-utils-main
, clique com o botão direito do mouse na pasta e selecione Obter informações opção.
Para obter o caminho do arquivo em suas janelas, clique em para abrir o local da pasta desejada e clique com o botão direito do mouse à direita do caminho na barra de endereços. Copie o endereço para obter o caminho do arquivo.
Abra o Postman e crie um novo espaço de trabalho na Áreas de trabalho menu suspenso:
Insira um Nome e opcional Resumo para o seu espaço de trabalho e clique em Criar espaço de trabalho. O Postman mudará para seu novo espaço de trabalho ao criá-lo.
Agora ajuste algumas configurações para executar as coleções do Postman neste espaço de trabalho. No cabeçalho do Postman, clique no ícone de engrenagem e selecione Configurações para abrir o modal de configurações. Você também pode usar o atalho de teclado (CMD/CTRL + ,) para abrir a modal.
Em General
, atualize o tempo limite da solicitação em ms para 5000 ms
e ativar allow reading file outside this directory
Se os arquivos forem carregados de dentro do diretório de trabalho, ele será executado sem problemas em todos os dispositivos, se os mesmos arquivos forem armazenados em outros dispositivos. No entanto, se você deseja executar arquivos de fora do diretório de trabalho, uma configuração deve ser ativada para declarar a mesma intenção. Se o seu FILE_PATH
não for o mesmo que o caminho do diretório de trabalho do Postman, essa opção deverá ser ativada.
Feche o Configurações painel.
Selecione o Ambientes e depois selecione Importar:
Importe o arquivo de ambiente json baixado, DataInExperiencePlatform.postman_environment
No Postman, selecione o ambiente na lista suspensa superior direita e clique no ícone de olho para exibir as variáveis de ambiente:
Verifique se as variáveis de ambiente a seguir foram preenchidas. Para saber como obter o valor das variáveis de ambiente, verifique o Autenticar para APIs do Experience Platform tutorial para obter instruções passo a passo.
CLIENT_SECRET
API_KEY
—Client ID
no Adobe Developer ConsoleTECHNICAL_ACCOUNT_ID
META_SCOPE
IMS
IMS_ORG
—Organization ID
no Adobe Developer ConsolePRIVATE_KEY
SANDBOX_NAME
CONTAINER_ID
TENANT_ID
—certifique-se de liderar com um sublinhado, por exemplo _techmarketingdemos
platform_end_point
FILE_PATH
—use o caminho da pasta local onde você descompactou o platform-utils-main.zip
arquivo. Certifique-se de incluir o nome da pasta, por exemplo /Users/dwright/Desktop/platform-utils-main
Salvar o ambiente atualizado
Em seguida, é necessário importar as coleções para o Postman.
Selecionar Coleções e escolha a opção de importação:
Importe as seguintes coleções:
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
Em seguida, é necessário autenticar e gerar um token de usuário. Esteja ciente de que os métodos de geração de tokens usados neste tutorial são adequados apenas para uso não relacionado à produção. A assinatura local carrega uma biblioteca do JavaScript de um host de terceiros e a assinatura remota envia a chave privada para um serviço da Web de propriedade e operado pelo Adobe. Embora o Adobe não armazene essa chave privada, as chaves de produção nunca devem ser compartilhadas com ninguém.
Abra o Authentication
, selecione a IMS: JWT Generate + Auth via User Token
POST e clique em SEND
para autenticar e obter o token de acesso.
Revise as variáveis de ambiente e observe que a variável JWT_TOKEN
e ACCESS_TOKEN
agora são preenchidas.
Agora você pode preparar e importar os dados para a sandbox da Platform. As coleções de Postman que você importou farão todo o trabalho pesado!
Abra o 1-Luma-Loyalty-Data
coleção e clique em Executar na guia visão geral para iniciar um Collection Runner.
Na janela do runner da coleção, selecione o ambiente na lista suspensa e atualize o Atraso para 4000ms
, marque a opção Salvar respostas e verifique se a ordem de execução está correta. Clique no botão Executar dados de fidelidade do Luma botão
1-Luma-Loyalty-Data cria um schema para dados de fidelidade do cliente. O esquema é baseado na classe Perfil individual XDM, no grupo de campos padrão e em um grupo de campos e tipo de dados personalizados. A coleção cria um conjunto de dados usando o esquema e faz upload de dados de fidelidade do cliente de amostra para o Adobe Experience Platform.
Se houver falha em solicitações de coleta durante o executor da coleta do Postman, pare a execução e execute as solicitações de coleta uma por uma.
Se tudo correr bem, todas as solicitações no Luma-Loyalty-Data
A coleção deve ser aprovada.
Agora vamos fazer logon no Interface do Adobe Experience Platform e navegue até os conjuntos de dados.
Abra o Luma Loyalty Dataset
conjunto de dados e, na janela de atividade do conjunto de dados, é possível visualizar uma execução em lote bem-sucedida que assimilou 1000 registros. Você também pode clicar na opção visualizar conjunto de dados para verificar os registros assimilados. Talvez seja necessário aguardar vários minutos para confirmar que 1000 Novos fragmentos de perfil foram criadas.
Repita as etapas 1 a 3 para executar as outras coleções:
2-Luma-CRM-Data.postman_collection.json
cria um esquema e um conjunto de dados preenchido para dados do CRM de clientes. O esquema é baseado na classe Perfil individual XDM que compreende Detalhes demográficos, Detalhes de contato pessoal, Detalhes de preferência e um grupo de campo de identidade personalizado.3-Luma-Product-Catalog.postman_collection.json
cria um esquema e um conjunto de dados preenchido para informações do catálogo de produtos. O esquema é baseado em uma classe personalizada de catálogo de produtos e usa um grupo de campos personalizado de catálogo de produtos.4-Luma-Offline-Purchase-Events.postman_collection.json
cria um esquema e um conjunto de dados preenchido para dados de eventos de compra offline de clientes. O esquema é baseado na classe XDM ExperienceEvent e inclui uma identidade personalizada e grupos de campos Detalhes de comércio .5-Luma-Product-Inventory-Events.postman_collection.json
cria um esquema e um conjunto de dados preenchido para eventos relacionados a produtos que entram e saem do estoque. O esquema é baseado em uma classe de evento comercial personalizada e em um grupo de campo personalizado.6-Luma-Test-Profiles.postman_collection.json
cria um esquema e um conjunto de dados preenchido com perfis de teste para usar no Adobe Journey Optimizer7-Luma-Web-Events.postman_collection.json
cria um esquema e um conjunto de dados preenchido com dados históricos da Web simples.Os dados de amostra foram projetados para que, quando as coleções forem executadas, os Perfis do cliente em tempo real sejam criados e combinem dados de vários sistemas. Um bom exemplo disso é o primeiro registro dos conjuntos de dados de fidelidade, CRM e compra offline. Procure esse perfil para confirmar que os dados foram assimilados. No Interface do Adobe Experience Platform:
Luma Loyalty Id
como Namespace de identidade5625458
como Valor de identidadeDaniel Wright
perfilSe você não vir o perfil, verifique o Conjuntos de dados para confirmar que todos os conjuntos de dados foram criados e assimilados com êxito. Se isso parecer bom, espere 15 minutos e veja se o perfil está disponível no visualizador. Se houver problemas com a assimilação de dados, verifique as mensagens de erro para tentar localizar o problema. Você também pode tentar ativar o diagnóstico de erros no Conjuntos de dados e arraste e solte o arquivo de dados json para assimilar novamente os dados.
Ao navegar pelos dados no Atributos e Eventos , você deve ver que o perfil contém dados dos vários arquivos de dados:
Se você quiser saber mais sobre o Adobe Journey Optimizer, esta sandbox contém tudo o que você precisa para pegar a variável Desafios da Journey Optimizer
Se você quiser saber mais sobre as políticas de mesclagem, governança de dados, serviço de query e o construtor de segmentos, vá para lição 11 do tutorial Introdução aos arquitetos de dados e engenheiros de dados. As lições anteriores deste outro tutorial permitem criar manualmente tudo o que acabou de ser preenchido por essas coleções do Postman — aproveite o início da página!
Se quiser criar uma implementação de SDK da Web de amostra para vincular a essa sandbox, verifique o
Implementar o Adobe Experience Cloud com o tutorial do SDK da Web. Depois de configurar as lições "Configuração inicial", "Configuração de tags" e "Configurar Experience Platform" do tutorial do SDK da Web, faça logon no site Luma usando os primeiros dez endereços de email na luma-crm.json
arquivo usando a senha test
para ver os fragmentos de perfil se mesclam aos dados carregados neste tutorial.
Se você deseja criar uma amostra da implementação do SDK móvel para vincular a essa sandbox, consulte
Tutorial Implementar o Adobe Experience Cloud em aplicativos móveis. Após configurar as lições de "Configuração inicial", "Implementação do aplicativo" e "Experience Platform" do tutorial do SDK da Web, faça logon no site Luma usando os primeiros endereços de email na luma-crm.json
para ver uma mesclagem de fragmento de perfil com dados carregados neste tutorial.
A redefinição de uma sandbox de não produção exclui todos os recursos associados a ela (esquemas, conjuntos de dados e assim por diante), mantendo o nome da sandbox e as permissões associadas. Essa sandbox "limpa" continua disponível com o mesmo nome para usuários que têm acesso a ela.
Siga as etapas here para redefinir um ambiente sandbox.