Assimilar dados do Algolia User Profiles na Experience Platform usando a interface
Este tutorial o orienta pela assimilação de dados da conta do Algolia User Profiles na Adobe Experience Platform usando a interface do usuário.
Introdução
Este tutorial presume que você esteja familiarizado com os seguintes componentes do Experience Platform:
-
Experience Data Model (XDM) Sistema: a estrutura padronizada que a Experience Platform usa para organizar dados de experiência do cliente.
- Noções básicas sobre a composição do esquema: saiba mais sobre a composição do esquema, incluindo princípios-chave e práticas recomendadas.
- Tutorial do Editor de esquemas: saiba como criar esquemas personalizados usando a interface do Editor de esquemas.
-
Real-Time Customer Profile: um perfil de cliente unificado em tempo real com base em dados agregados de várias fontes.
-
Fontes: assimile dados de várias fontes e use os serviços da Experience Platform para estruturar, rotular e aprimorar os dados.
Coletar credenciais necessárias
Para conectar Algolia ao Adobe Experience Platform, forneça as seguintes credenciais:
Para obter mais informações, consulte a Algolia documentação de autenticação.
Conectar sua conta do Algolia
Na interface do Experience Platform, selecione Fontes na navegação à esquerda para abrir o espaço de trabalho Fontes. Use o painel ou a barra de pesquisa Categorias para encontrar a origem desejada.
Para conectar Algolia, escolha o cartão de origem Algolia em Parceiros de Dados e Identidade e selecione Configurar.
Autenticação
Usar uma conta existente
Para usar uma conta existente, escolha Conta existente e selecione a conta Algolia User Profiles que deseja usar. Em seguida, selecione Próximo.
Criar uma nova conta
Para criar uma nova conta, selecione Nova conta e digite um nome, uma descrição opcional e suas credenciais do Algolia. Selecione Conectar à origem e aguarde o estabelecimento da conexão.
Adicionar dados
Após a criação da conta Algolia User Profiles, a etapa Adicionar dados é exibida. Use-o para selecionar e visualizar os dados do perfil do usuário para assimilação.
- À esquerda, insira Índices e Afinidade(s) opcionais.
- À direita, visualize até 100 linhas de perfis de usuário.
Depois de concluído, selecione Próximo.
Fornecer detalhes do fluxo de dados
Se estiver usando um conjunto de dados existente, escolha um associado a um esquema que inclua o grupo de campos Algolia Profile. Verifique se o campo Algolia User Token está usando o namespace de identidade Algolia User Token. Se o Algolia User Token não estiver criado ou atribuído no momento, as instruções serão fornecidas abaixo.
Se estiver criando um novo conjunto de dados, selecione um esquema usando o grupo de campos Algolia Profile.
Criar namespace de identidade Algolia User Token
Será necessário criar o namespace de identidade Algolia User Token se ele ainda não existir em sua organização.
Use a navegação à esquerda e selecione Identidades para acessar o espaço de trabalho da interface do Serviço de Identidade e selecione Criar namespace de identidade.
Em seguida, forneça um Nome para Exibição e um Símbolo de Identidade para o seu namespace personalizado. Durante essa etapa, você também deve configurar o tipo do namespace. Quando terminar, selecione Criar.
Depois de adicionado, o namespace aparece na lista. Agora você pode aplicá-la ao esquema.
Aplicar o namespace ao esquema
Use a navegação à esquerda e selecione Esquemas para acessar o espaço de trabalho da interface de Esquemas. Use o espaço de trabalho de esquemas para criar ou atualizar um esquema com o grupo de campos Algolia Profile Details. Em seguida, navegue até o campo Token de usuário e use o painel direito para selecionar a caixa Identidade. Use também a caixa de entrada para definir o namespace de identidade Algolia User Token. Quando terminar, selecione Salvar.
Depois que o campo Token de Usuário recebe o namespace de identidade Algolia User Token, a identidade aparece no perfil de usuário para qualquer perfil.
Mapear campos de dados para um esquema XDM
Use a interface de mapeamento para mapear os dados de origem para campos de esquema. Para obter mais informações, consulte o guia de mapeamento.
Programar execuções de assimilação
Em seguida, use a interface de programação para definir a programação de assimilação do fluxo de dados.
Configure a frequência para indicar a frequência de execução do fluxo de dados. Você pode definir a frequência como:
- Uma vez: defina sua frequência como
oncepara criar uma assimilação única. As configurações para intervalo e preenchimento retroativo não estão disponíveis ao criar um fluxo de dados de assimilação única. Por padrão, a frequência de agendamento é definida como uma vez. - Minuto: Defina sua frequência como
minutepara agendar seu fluxo de dados para assimilar dados por minuto. - Hora: Defina sua frequência como
hourpara agendar seu fluxo de dados para assimilar dados por hora. - Dia: Defina sua frequência como
daypara agendar seu fluxo de dados para assimilar dados por dia. - Semana: Defina sua frequência como
weekpara agendar seu fluxo de dados para assimilar dados por semana.
Depois de selecionar uma frequência, você pode definir o intervalo para estabelecer o intervalo de tempo entre cada assimilação. Por exemplo, se você definir a frequência como dia e configurar o intervalo como 15, o fluxo de dados será executado a cada 15 dias. Você não pode definir o intervalo como zero. O valor mínimo de intervalo aceito para cada frequência é o seguinte:
- Uma vez: n/d
- Minuto: 15
- Hora: 1
- Dia: 1
- Semana: 1
Revisar seu fluxo de dados
Use a página de revisão para obter um resumo do seu fluxo de dados antes da assimilação. Os detalhes estão agrupados nas seguintes categorias:
- Conexão - Mostra o tipo de origem, o caminho relevante do arquivo de origem escolhido e o número de colunas nesse arquivo de origem.
- Atribuir campos de conjunto de dados e mapa - Mostra em qual conjunto de dados os dados de origem estão sendo assimilados, incluindo o esquema ao qual o conjunto de dados pertence.
- Agendamento - Mostra o período, a frequência e o intervalo ativos do agendamento de assimilação.
Depois de revisar o fluxo de dados, selecione Concluir e aguarde algum tempo para que o fluxo de dados seja criado.
Próximas etapas
Ao seguir este tutorial, você criou com êxito um fluxo de dados para trazer dados de intenção da sua origem Algolia para a Experience Platform. Para obter recursos adicionais, consulte a documentação descrita abaixo.
Monitorar seu fluxo de dados
Depois que o fluxo de dados for criado, você poderá monitorar os dados que estão sendo assimilados por meio dele para exibir informações sobre taxas de assimilação, sucesso e erros. Para obter mais informações sobre como monitorar o fluxo de dados, visite o tutorial em monitoramento de contas e fluxos de dados na interface.
Atualizar seu fluxo de dados
Para atualizar as configurações do agendamento de fluxos de dados, mapeamento e informações gerais, visite o tutorial em atualizando fluxos de dados de fontes na interface.
Excluir seu fluxo de dados
Você pode excluir fluxos de dados que não são mais necessários ou que foram criados incorretamente usando a função Excluir disponível no espaço de trabalho Fluxos de Dados. Para obter mais informações sobre como excluir fluxos de dados, visite o tutorial em excluindo fluxos de dados na interface.