DocumentaçãoExperience PlatformTutoriais

Importar dados de amostra para o Adobe Experience Platform

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:
  • API

Criado para:

  • Experiente
  • Desenvolvedor

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.

Exemplo de caso de uso de dados

Os usuários empresariais do Experience Platform geralmente precisam percorrer uma série de etapas que incluem a identificação de grupos de campos, a criação de esquemas, a preparação de dados, a criação de conjuntos de dados e 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 colocar os dados em uma sandbox da Platform o mais rápido possível.

Este tutorial se concentra 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 ativam esses perfis para elevar o nível do marketing. Geramos dados de amostra para o Luma e, no restante deste tutorial, você importará esses dados para um dos seus ambientes de sandbox do Experience Platform.

NOTE
O resultado final deste tutorial é uma sandbox que contém dados semelhantes ao tutorial de Introdução à Adobe Experience Platform para arquitetos de dados e engenheiros de dados. Ele foi atualizado em abril de 2023 para oferecer suporte aos desafios do Journey Optimizer. Ele foi atualizado em junho de 2023 para alternar o método de autenticação para OAuth.

Pré-requisitos

  • Você tem acesso às APIs do Experience Platform e sabe como realizar a autenticação. Caso contrário, confira este tutorial.
  • Você tem acesso a uma sandbox de desenvolvimento de Experience Platform.
  • Você sabe sua ID de locatário do Experience Platform. Você pode obtê-la fazendo uma solicitação de API autenticada
    ou extraindo-o do URL ao fazer logon na sua conta da Platform. Por exemplo, na URL a seguir, o locatário é "techmarketingdemos" https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home.

Usando o Postman postman

Configurar variáveis de ambiente

Antes de seguir as etapas, verifique se você baixou o aplicativo Postman. Vamos começar!

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

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

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

  3. Na pasta luma-data, abra todos os arquivos do json em um editor de texto e substitua todas as instâncias do _yourTenantId pela sua ID de locatário, precedida por um sublinhado.

  4. Abrir luma-offline-purchases.json, luma-inventory-events.json e luma-web-events.json em um editor de texto e atualizar todos os carimbos de data e hora para que os eventos ocorram no último mês (por exemplo, pesquisar por "timestamp":"2022-11 e substituir ano e mês)

  5. Observe o local da pasta descompactada, conforme necessário posteriormente ao configurar a variável de ambiente FILE_PATH Postman:

    note note
    NOTE
    Para obter o caminho do arquivo em sua 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 do MAC
    note note
    NOTE
    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

  6. Abra Postman e crie um espaço de trabalho pelo menu suspenso Espaços de Trabalho:
    Criar espaço de trabalho

  7. Insira um Nome e um Resumo opcional para o seu espaço de trabalho e clique em Criar Workspace. Postman mudará para seu novo espaço de trabalho quando você criá-lo.
    Salvar espaço de trabalho

  8. Agora ajuste algumas configurações para executar as Postman coleções neste espaço de trabalho. No cabeçalho de Postman, clique no ícone de engrenagem e selecione Configurações para abrir a modal de configurações. Também é possível usar o atalho de teclado (CMD/CTRL + ,) para abrir a modal.

  9. Na guia General, atualize o tempo limite da solicitação em ms para 5000 ms e habilite allow reading file outside this directory
    Configurações

    note note
    NOTE
    Se os arquivos forem carregados no diretório de trabalho, eles serão executados sem problemas nos dispositivos se os mesmos arquivos estiverem armazenados nos outros dispositivos. No entanto, se você quiser executar arquivos de fora do diretório de trabalho, uma configuração deverá ser ativada para declarar a mesma intenção. Se o FILE_PATH não for o mesmo que o caminho do diretório de trabalho do Postman, essa opção deverá ser habilitada.

  10. Feche o painel Configurações.

  11. Selecione os Ambientes e selecione Importar:
    Importação de ambiente

  12. Importar o arquivo de ambiente json baixado, DataInExperiencePlatform.postman_environment

  13. No Postman, selecione seu ambiente na lista suspensa no canto superior direito e clique no ícone de olho para exibir as variáveis de ambiente:
    Seleção de ambiente

  14. 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 Experience Platform para obter instruções passo a passo.

    • CLIENT_SECRET
    • API_KEY—Client ID no Adobe Developer Console
    • SCOPES
    • TECHNICAL_ACCOUNT_ID
    • IMS
    • IMS_ORG—Organization ID no Adobe Developer Console
    • SANDBOX_NAME
    • TENANT_ID—certifique-se de iniciar com um sublinhado, por exemplo _techmarketingdemos
    • CONTAINER_ID
    • platform_end_point
    • FILE_PATH—usa o caminho da pasta local onde você descompactou o arquivo platform-utils-main.zip. Certifique-se de que inclua o nome da pasta, por exemplo /Users/dwright/Desktop/platform-utils-main

  15. Salvar o ambiente atualizado

Importar coleções do Postman

Em seguida, é necessário importar as coleções para o Postman.

  1. Selecione Coleções e escolha a opção de importação:

    Coleções

  2. 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

    Importação de coleções

Autenticar

Em seguida, é necessário autenticar e gerar um token de usuário. Esteja ciente de que os métodos de geração de token usados neste tutorial são adequados somente para uso de não 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 Adobe e operado. Embora o Adobe não armazene essa chave privada, as chaves de produção nunca devem ser compartilhadas com ninguém.

  1. Abra a coleção 0-Authentication, selecione a solicitação OAuth: Request Access Token e clique em SEND para autenticar e obter o token de acesso.

    Importação de coleções

  2. Revise as variáveis de ambiente e observe que ACCESS_TOKEN agora está preenchido.

Importar dados

Agora você pode preparar e importar os dados para a sandbox da Platform. As coleções do Postman que você importou farão todo o trabalho pesado!

  1. Abra a coleção 1-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

  2. Na janela de execução da coleção, selecione o ambiente na lista suspensa, atualize o Atraso para 4000ms, verifique a opção Salvar respostas e verifique se a ordem de execução está correta. Clique no botão Executar Dados de Fidelidade da Luma

    Importação de coleções

    note note
    NOTE
    1-Luma-Loyalty-Data cria um esquema para dados de fidelidade do cliente. O esquema é baseado na classe Perfil individual XDM, grupo de campos padrão, grupo de campos personalizado e tipo de dados. A coleção cria um conjunto de dados usando o esquema e carrega dados de fidelidade do cliente de amostra para a Adobe Experience Platform.
    note note
    NOTE
    Se alguma solicitação de coleção falhar durante o executor de coleção do Postman, interrompa a execução e execute as solicitações de coleção uma por uma.

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

    Resultado de fidelidade

  4. Agora vamos fazer logon na interface do Adobe Experience Platform e navegar até os conjuntos de dados.

  5. Abra o conjunto de dados Luma Loyalty Dataset e, na janela de atividade do conjunto de dados, você pode ver uma execução em lote bem-sucedida que assimilou 1000 registros. Você também pode clicar na opção de visualização do conjunto de dados para verificar os registros assimilados. Talvez seja necessário aguardar alguns minutos para confirmar que 1000 Novos fragmentos de perfil foram criados.
    Conjunto de Dados de Fidelidade

  6. 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 os dados do CRM dos clientes. O esquema é baseado na classe Perfil individual XDM, que inclui Detalhes demográficos, Detalhes de contato pessoal, Detalhes de preferência e um grupo de campos 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 de catálogo de produtos personalizada e usa um grupo de campos de catálogo de produtos personalizado.
    • 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 compreende uma identidade personalizada e grupos de campos de Detalhes do Commerce.
    • 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 um grupo de campos personalizados.
    • 6-Luma-Test-Profiles.postman_collection.json cria um esquema e conjunto de dados preenchido com perfis de teste para usar no Adobe Journey Optimizer
    • 7-Luma-Web-Events.postman_collection.json cria um esquema e conjunto de dados preenchido com dados históricos da Web simples.

Validação

Os dados de amostra foram projetados para que, quando as coleções forem executadas, sejam criados Perfis de clientes em tempo real que 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 se os dados foram assimilados. Na interface do Adobe Experience Platform:

  1. Ir para Perfis > Procurar
  2. Selecione Luma Loyalty Id como o Namespace de identidade
  3. Procurar 5625458 como Valor de identidade
  4. Abrir o perfil Daniel Wright
TIP
Se você não vir o perfil, verifique a página Conjuntos de dados para confirmar se todos os conjuntos de dados foram criados e assimilados com êxito. Se estiver bom, aguarde quinze 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 habilitar diagnósticos de erro na página Conjuntos de dados e arrastar e soltar o arquivo de dados json para assimilar os dados novamente.

Abrindo um perfil

Ao navegar pelos dados nas guias Atributos e Eventos, você verá que o perfil contém dados dos vários arquivos de dados:
Dados de evento do arquivo de eventos de Compra Offline

Próximas etapas

Se você quiser saber mais sobre o Adobe Journey Optimizer, esta sandbox contém tudo o que você precisa para enfrentar os desafios do Journey Optimizer

Se você quiser saber mais sobre políticas de mesclagem, governança de dados, serviço de consulta e o construtor de segmentos, vá para a lição 11 do tutorial Introdução aos arquitetos de dados e engenheiros de dados. As lições anteriores deste outro tutorial ensinaram a criar manualmente tudo o que acabou de ser preenchido por essas coleções do Postman — aproveite a vantagem inicial!

Se você quiser criar uma amostra de implementação do SDK da Web para vincular a esta sandbox, passe pelo
Implementar o Adobe Experience Cloud com o tutorial do SDK da Web. Depois de definir as lições de "Configuração inicial", "Configuração de tags" e "Configurar Experience Platform" do tutorial do SDK da Web, faça logon no site da Luma usando os primeiros dez endereços de email no arquivo luma-crm.json usando a senha test para ver a mesclagem dos fragmentos de perfil com os dados carregados neste tutorial.

Se você quiser criar um exemplo de implementação do SDK móvel para vincular a esta sandbox, passe pelo
Tutorial Implementar o Adobe Experience Cloud em aplicativos para dispositivos móveis. Depois de configurar as lições "Configuração inicial", "Implementação de aplicativo" e "Experience Platform" do tutorial do SDK da Web, faça logon no site do Luma usando os primeiros endereços de email no arquivo luma-crm.json para ver uma mesclagem de fragmento de perfil com dados carregados neste tutorial.

Redefinir ambiente de sandbox reset-sandbox

A redefinição de uma sandbox de não produção exclui todos os recursos associados a essa sandbox (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 os usuários que têm acesso a ela.

Siga as etapas aqui para redefinir um ambiente de sandbox.

recommendation-more-help
9051d869-e959-46c8-8c52-f0759cee3763