Importar dados de amostra para a Adobe Experience Platform

Saiba como configurar um ambiente de caixa de proteção do Experience Platform com alguns dados de amostra. Usando uma coleção de cartazes, você pode criar grupos de campos, esquemas, conjuntos de dados e, em seguida, importar dados de amostra para o Experience Platform.

Caso de uso de dados de amostra

Geralmente, os usuários de negócios do Experience Platform precisam passar por uma série de etapas que incluem identificar grupos de campos, criar esquemas, preparar dados, criar conjuntos de dados e assimilar dados antes de explorar alguns dos recursos oferecidos pelo Experience Platform. Neste tutorial, você pode encontrar uma maneira fácil de automatizar algumas etapas e obter dados no Platform o mais rápido possível.

Este tutorial foca em uma marca de varejo ficcional chamada Luma. O Luma opera lojas brick-and-mortar em vários países e tem uma presença online com um site e aplicativos móveis. Eles investem no Adobe Experience Platform para combinar dados de fidelidade, CRM, Web e compra offline em perfis de clientes em tempo real e ativar esses perfis para elevar seu marketing ao próximo nível. Temos dados de amostra gerados para o Luma e, na próxima seção, você pode explorar como importar dados para o Experience Platform.

Para concluir este tutorial, você pode usar a Interface do usuário do aplicativo Postman ou usar a linha de comando Collection Runner for Postman (Newman)

Pré-requisitos

  • Você autenticou e tem acesso às APIs do Experience Platform. Caso contrário, você pode configurá-lo rapidamente seguindo este tutorial.
  • Você tem acesso ao ambiente sandbox do Experience Platform.

Usando o Postman

Importar Coleção de Postman e configurar variáveis de ambiente

Antes de seguir as etapas, baixe o aplicativo Postman e tenha acesso às APIs do Experience Platform. Neste tutorial, usaremos um ambiente sandbox. Ele fornece um ambiente isolado onde você pode experimentar a funcionalidade sem misturar recursos e dados com seu ambiente de produção. Vamos começar.

OBSERVAÇÃO

Os dados do usuário contidos no arquivo platform-utils-main.zip são fictícios e devem ser usados somente para fins de demonstração.

  1. Baixe o arquivo platform-utils-main.zip, que contém todos os arquivos necessários para este tutorial.

  2. Na pasta de downloads, mova o arquivo platform-utils-main.zip para o local desejado em seu computador e descompacte-o.

  3. Anote o local do arquivo descompactado, pois talvez seja necessário mais tarde ao configurar a variável de ambiente FILE_PATH postman

    OBSERVAÇÃO

    Para obter o caminho do arquivo no Mac, navegue até a pasta platform-utils-main, clique com o botão direito do mouse na pasta e selecione a opção Obter informações.

    Caminho do arquivo Mac

    OBSERVAÇÃ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.

    Caminho do arquivo do Windows

  4. Inicie o Postman e crie um novo espaço de trabalho. Copie o valor de metadados where do

  5. Para criar um novo espaço de trabalho, use o menu suspenso Espaços de trabalho à esquerda do Postman. Você pode selecionar um espaço de trabalho existente ou criar um novo espaço de trabalho para o seu projeto.
    Criar espaço de trabalho

  6. Insira um Nome e um Resumo opcional 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.
    Salvar espaço de trabalho

  7. Agora vamos executar algumas configurações adicionais para executar nossas coleções de pôster neste espaço de trabalho. No cabeçalho do Postman, clique no ícone da chave inglesa e selecione Settings para abrir a modal das configurações. Você também pode usar o atalho de teclado (CMD/CTRL + ,) para abrir a modal.

  8. Na guia General, atualizaremos o tempo limite da solicitação em ms para 5000 ms e habilitaremos allow reading file outside this directory

    Configurações

    OBSERVAÇÃO

    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ê quiser executar arquivos de fora do diretório de trabalho, uma configuração deve ser ativada para declarar a mesma intenção. Se FILE_PATH não for o mesmo que o caminho do diretório de trabalho do postman, essa opção deverá ser ativada.

  9. Feche o painel de configurações.

  10. Selecione a opção de ambientes e clique na opção de importação.
    Importação de Ambiente

  11. Vamos importar o arquivo de ambiente json baixado, DataInExperiencePlatform.postman_environment, e clique em Importar

  12. No Postman, selecione o ambiente na lista suspensa superior direita e clique no ícone de olho para exibir as variáveis de ambiente.
    Seleção de ambiente

  13. Verifique se as variáveis de ambiente a seguir foram preenchidas. Para saber como obter o valor das variáveis de ambiente, consulte o tutorial Autenticar para APIs para obter instruções passo a passo.

    • CLIENT_SECRET
    • API_KEY
    • TECHNICAL_ACCOUNT_ID
    • META_SCOPE
    • IMS
    • IMS_ORG
    • PRIVATE_KEY
    • SANDBOX_NAME
    • CONTAINER_ID
    • TENANT_ID
    • platform_end_point
    • FILE_PATH
    • PRIVATE_KEY
  14. Atualize a variável FILE_PATH para o caminho da pasta local, onde você descompactou o arquivo platform-utils-main.zip. Você pode editar variáveis abrindo um ambiente em Ambientes à esquerda ou abrindo o ambiente de aparência rápida (botão de olho) na parte superior direita do Postman e clicando em Editar.
    Caminho do arquivo

  15. Agora, precisamos preencher os valores para as seguintes variáveis de ambiente. Para fazer isso, precisamos fazer upload dos arquivos de coleção no nosso espaço de trabalho.

    • JWT_TOKEN
    • ACCESS_TOKEN
  16. Selecione as coleções e escolha a opção de importação

    Coleções

  17. Importe os seguintes arquivos de coleção no postman

    • Authentication.postman_collection.json
    • Luma-Loyalty-Data.postman_collection.json
    • Luma-CRM-Data.postman_collection.json
    • Luma-Product-Catalog.postman_collection.json
    • Luma-Offline-Purchase-Events.postman_collection.json

    Importação de Coleções

  18. Abra a coleção Authentication, selecione a solicitação de POST IMS: JWT Generate + Auth via User Token e clique em SEND para autenticar e obter o token de acesso.

    Importação de Coleções

  19. Revise as variáveis de ambiente e observe que JWT_TOKEN e ACCESS_TOKEN agora estão preenchidas.

  20. Abra a coleção Luma-Loyalty-Data e clique em Executar na guia de visão geral para iniciar um Executor de Coleção.

    Importação de Coleções

  21. Na janela do executor da coleta, selecione o ambiente na lista suspensa, forneça um atraso de 4000 ms, marque a opção Save responses e verifique se a ordem de execução está correta. Clique no botão Executar dados de fidelidade do Luma

    Importação de Coleções

    OBSERVAÇÃO

    A execução Luma-Loyalty- Datacollection criaria um schema para conter dados de fidelidade do cliente. O esquema é baseado na classe Perfil individual XDM que compreende grupos de campos e tipos de dados personalizados. A coleta também cria um conjunto de dados usando o esquema e faz upload de dados de fidelidade de clientes de amostra para o Adobe Experience Platform.

    OBSERVAÇÃO

    Se alguma solicitação de coleção falhar durante o executor da coleção de pôster, pare a execução e execute as solicitações de coleção uma por uma.

  22. Se tudo correr bem, todas as solicitações na coleção Luma-Loyalty-Data deverão ser enviadas.

    Resultado da Fidelidade

  23. Agora vamos fazer logon em Adobe Experience Platform UI e navegar até os conjuntos de dados.

  24. Abra o conjunto de dados Luma Loyalty Dataset e, na janela de atividade do conjunto de dados, é possível visualizar uma execução em lote bem-sucedida que tenha assimilado 1000 registros. Você também pode clicar na opção visualizar conjunto de dados para verificar os registros assimilados.
    Conjunto de dados de fidelidade

  25. Repita as etapas 21 a 23 para executar as coleções abaixo:

    • Luma-CRM-Data.postman_collection.json : a execução da coleta criaria um esquema para conter os dados do CRM dos clientes. O esquema é baseado na classe Perfil individual XDM que inclui os grupos de campos Detalhes demográficos, Detalhes de contato pessoal e Perfil de identidade Luma. A coleta também cria um conjunto de dados usando o esquema e faz upload de dados de CRM de exemplo do cliente para o Adobe Experience Platform.
    • Luma-Product-Catalog.postman_collection.json : a execução da coleção criaria um schema para conter informações do catálogo de produtos. O esquema é baseado em uma classe personalizada que compreende mixin de catálogo de produtos, detalhes de Comércio e mixin de Evento de experiência do consumidor. A coleta também cria um conjunto de dados usando o esquema e faz upload dos dados do produto no Adobe Experience Platform.
    • Luma-Offline-Purchase-Events.postman_collection.json: a execução da coleta criaria um esquema para conter os dados do evento de compra offline dos clientes. O esquema é baseado na classe XDM ExperienceEvent e compreende grupos de campos para capturar informações de fidelidade do cliente e seus eventos de compra offline. A coleta também cria um conjunto de dados usando o esquema e carrega os dados de eventos de compra offline no Adobe Experience Platform.

Uso de Newman

Antes de seguir as etapas, verifique se você tem acesso às APIs do Experience Platform. Neste tutorial, estamos usando um ambiente de sandbox, pois ele fornece um ambiente isolado onde você pode experimentar a funcionalidade sem misturar recursos e dados com seu ambiente de produção.

Instalar o NodeJs e o Newman

  1. Para executar o Newman, verifique se você tem Node.js >= v10. Instale o Node.js por meio do gerenciador de pacotes.

  2. Execute o comando node -v para verificar se o nó está instalado.

  3. A maneira mais fácil de instalar Newman é usando o NPM. Se você tiver o Node.js instalado, é provável que você também tenha o NPM instalado.

  4. Siga as etapas aqui para instalar o newman para o seu sistema

  5. Execute o comando newman -v para verificar se o newman está instalado.

  6. Baixe o arquivo platform-utils-main.zip, que contém todos os arquivos necessários para este tutorial.

  7. Na pasta de downloads, mova o arquivo platform-utils-main.zip para o local desejado em seu computador e descompacte-o.

  8. Anote o local do arquivo descompactado, pois talvez seja necessário mais tarde ao configurar a variável de ambiente FILE_PATH postman

  9. Abra a pasta platform-utils-main em uma janela de terminal.

  10. Execute Luma-Loyalty-Data.postman_collection.json para criar grupos de campos, esquema, conjunto de dados e assimilar dados de fidelidade de amostra para o Adobe Experience Platform

    • newman run Luma-Loyalty-Data.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json —insecure --delay-request 4000
  11. Se tudo correr bem, todas as solicitações na coleção Luma-Loyalty-Data deverão ser enviadas.

  12. Agora vamos fazer logon em Adobe Experience Platform UI e navegar até os conjuntos de dados.

  13. Abra o conjunto de dados Luma Loyalty Dataset e, na janela de atividade do conjunto de dados, é possível visualizar uma execução em lote bem-sucedida que tenha assimilado 1000 registros. Você também pode clicar na opção visualizar conjunto de dados para verificar os registros assimilados.

    Conjunto de dados de fidelidade

  14. Repita as etapas 10 a 13 para executar abaixo das coleções:

    • Execute Luma-CRM-Data.postman_collection.json para criar grupos de campos, esquema, conjunto de dados e assimilar dados de CRM de amostra para o Adobe Experience Platform
      • newman run Luma-CRM-Data.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
    • Execute Luma-Product-Catalog.postman_collection.json para criar grupos de campos, esquema, conjunto de dados e assimilar dados de produto de amostra no Adobe Experience Platform
      • newman run Luma-Product-Catalog.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
    • Execute Luma-Offline-Purchase-Events.postman_collection.json para criar grupos de campos, esquema, conjunto de dados e assimilar dados de produto de amostra no Adobe Experience Platform
      • newman run Luma-Offline-Purchase-Events.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000

Redefinir ambiente de sandbox

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 aqui para redefinir um ambiente de sandbox.

Nesta página