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
IMPORTANTEEste 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:
| Credencial | Descrição |
|---|---|
| ID do aplicativo | O identificador exclusivo atribuído à sua conta do Algolia. |
| Chave de API | A credencial para autenticar e autorizar solicitações de API para os serviços de Algolia. |
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.
DICA
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.
| Configuração de namespace personalizado | Valor |
|---|---|
| Nome de exibição | Algolia User Token |
| Símbolo de Identidade | AlgoliaUserToken |
| Selecionar um tipo | Cookie ID |
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.
| Configuração de agendamento | Descrição |
|---|---|
| Frequência |
Configure a frequência para indicar a frequência de execução do fluxo de dados. Você pode definir a frequência como:
|
| Intervalo |
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:
|
| Hora de início | O carimbo de data e hora da execução projetada, apresentado no fuso horário UTC. |
| Preenchimento retroativo | O preenchimento retroativo determina quais dados são assimilados inicialmente. Se o preenchimento retroativo estiver ativado, todos os arquivos atuais no caminho especificado serão assimilados durante a primeira assimilação agendada. Se o preenchimento retroativo estiver desativado, somente os arquivos carregados entre a primeira execução da assimilação e a hora de início serão assimilados. Os arquivos carregados antes da hora de início não serão assimilados. |
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.