Criar uma conexão de origem do Adobe Analytics na interface
Este tutorial fornece etapas para a criação de uma conexão de origem do Adobe Analytics na interface do usuário para trazer os dados do conjunto de relatórios do Adobe Analytics para a Adobe Experience Platform.
Introdução
Este tutorial requer um entendimento prático dos seguintes componentes do Experience Platform:
- Sistema do Experience Data Model (XDM): a estrutura padronizada pela qual o Experience Platform organiza os dados de experiência do cliente.
- Perfil de cliente em tempo real: fornece um perfil de cliente unificado em tempo real com base em dados agregados de várias fontes.
- Sandboxes: o Experience Platform fornece sandboxes virtuais que particionam uma única instância da Platform em ambientes virtuais separados para ajudar a desenvolver aplicativos de experiência digital.
Terminologia principal
É importante entender os seguintes termos principais usados neste documento:
- Atributo padrão: atributos padrão são todos os atributos predefinidos pelo Adobe. Eles contêm o mesmo significado para todos os clientes e estão disponíveis nos grupos de campos de dados de origem Analytics e esquema Analytics.
- Atributo personalizado: atributos personalizados são qualquer atributo na hierarquia de variáveis personalizadas em Analytics. Os atributos personalizados são usados em uma implementação do Adobe Analytics para capturar informações específicas em um conjunto de relatórios e podem diferir no uso de cada conjunto de relatórios. Os atributos personalizados incluem eVars, propriedades e listas. Consulte a Analytics documentação sobre variáveis de conversão a seguir para obter mais informações sobre eVars.
- Qualquer atributo em grupos de campos personalizados: atributos originários de grupos de campos criados por clientes são todos definidos pelo usuário e não são considerados atributos padrão nem personalizados.
- Nomes amigáveis: nomes amigáveis são rótulos fornecidos por humanos para variáveis personalizadas em uma implementação Analytics. Consulte a seguinte Analytics documentação sobre variáveis de conversão para obter mais informações sobre nomes amigáveis.
Criar uma conexão de origem com o Adobe Analytics
- Um fluxo de dados que faz um preenchimento retroativo de 13 meses de dados históricos do conjunto de relatórios no data lake. Esse fluxo de dados termina quando o preenchimento retroativo é concluído.
- Um fluxo de dados que envia dados em tempo real para o data lake e para Real-Time Customer Profile. Esse fluxo de dados é executado continuamente.
Na interface da Platform, selecione Fontes na navegação à esquerda para acessar o espaço de trabalho Fontes. A tela Catálogo exibe uma variedade de fontes com as quais você pode criar uma conta.
Você pode selecionar a categoria apropriada no catálogo no lado esquerdo da tela. Você também pode usar a barra de pesquisa para restringir as fontes exibidas.
Na categoria aplicativos de Adobe, selecione Adobe Analytics e Adicionar dados.
Selecionar dados
A etapa Adicionar dados da origem do Analytics fornece uma lista de dados do conjunto de relatórios Analytics para criar uma conexão de origem com.
Um conjunto de relatórios é um contêiner de dados que forma a base do relatório Analytics. Uma organização pode ter muitos conjuntos de relatórios, cada um contendo diferentes conjuntos de dados.
Você pode assimilar conjuntos de relatórios de qualquer região (Estados Unidos, Reino Unido ou Cingapura) desde que eles estejam mapeados para a mesma organização da instância de sandbox de Experience Platform em que a conexão de origem está sendo criada. Um conjunto de relatórios pode ser assimilado usando apenas um único fluxo de dados ativo. Um conjunto de relatórios que não pode ser selecionado já foi assimilado, na sandbox que você está usando ou em uma sandbox diferente.
Várias conexões de entrada podem ser feitas para trazer vários conjuntos de relatórios para a mesma sandbox. Se os conjuntos de relatórios tiverem esquemas diferentes para variáveis (como eVars ou eventos), eles deverão ser mapeados para campos específicos nos grupos de campos personalizados e evitar conflitos de dados usando o Preparo de dados. Os conjuntos de relatórios podem ser adicionados somente a uma única sandbox.
Para criar uma conexão de origem Analytics, selecione um conjunto de relatórios e clique em Avançar para continuar.
<!—Os Conjuntos de relatórios do Analytics podem ser configurados para uma sandbox por vez. Para importar o mesmo Conjunto de relatórios para uma sandbox diferente, o fluxo do conjunto de dados terá de ser excluído e instanciado novamente por meio da configuração de uma sandbox diferente.—>
Mapeamento
Antes de mapear os dados do Analytics para o esquema XDM de destino, você deve primeiro selecionar se está usando um esquema padrão ou um esquema personalizado.
Um esquema padrão cria um novo esquema em seu nome, contendo o grupo de campos Adobe Analytics ExperienceEvent Template. Para usar um esquema padrão, selecione Esquema padrão.
Com um esquema personalizado, você pode escolher qualquer esquema disponível para seus dados do Analytics, desde que esse esquema tenha o grupo de campos Adobe Analytics ExperienceEvent Template. Para usar um esquema personalizado, selecione Esquema personalizado.
A página Mapping fornece uma interface para mapear campos de origem para seus campos de esquema de destino apropriados. Aqui, é possível mapear variáveis personalizadas para novos grupos de campos de esquema e aplicar cálculos de acordo com o Preparo de dados. Selecione um schema de destino para iniciar o processo de mapeamento.
A seção Mapear campos padrão exibe painéis para Mapeamentos padrão aplicados, Mapeamentos padrão não correspondentes e Mapeamentos personalizados. Consulte a tabela a seguir para obter informações específicas sobre cada categoria:
Para visualizar o grupo de campos de esquema de modelo ExperienceEvent Analytics, selecione Exibir no painel Mapeamentos padrão aplicados.
A página Grupo de campos do esquema do modelo de ExperienceEvent do Adobe Analytics fornece uma interface a ser usada para inspecionar a estrutura do esquema. Quando terminar, selecione Fechar.
O Platform detecta automaticamente seus conjuntos de mapeamento para qualquer conflito de nome amigável. Se não houver conflitos com seus conjuntos de mapeamento, selecione Avançar para continuar.
Mapeamentos personalizados
É possível usar as funções de Preparo de dados para adicionar novos mapeamentos personalizados ou campos calculados para atributos personalizados. Para adicionar mapeamentos personalizados, selecione Personalizado.
Dependendo das suas necessidades, você pode selecionar Adicionar novo mapeamento ou Adicionar campo calculado e continuar criando mapeamentos personalizados para seus atributos personalizados. Para obter etapas abrangentes sobre como usar as funções de Preparo de dados, leia o guia da interface do usuário do Preparo de dados.
A documentação a seguir fornece mais recursos sobre como entender o Preparo de dados, campos calculados e funções de mapeamento:
Filtragem para o perfil do cliente em tempo real filtering-for-profile
Depois de concluir os mapeamentos dos dados do conjunto de relatórios do Analytics, você poderá aplicar regras e condições de filtragem para incluir ou excluir seletivamente os dados da assimilação no Perfil do cliente em tempo real. O suporte para filtragem está disponível apenas para dados do Analytics e os dados são filtrados apenas antes da inserção de Profile… Todos os dados são assimilados no data lake.
Informações adicionais sobre Preparação de dados e filtragem de dados do Analytics para o Perfil de cliente em tempo real
- Você pode usar a funcionalidade de filtragem para dados que vão para o Perfil, mas não para dados que vão para o data lake.
- Você pode usar a filtragem para dados em tempo real, mas não pode filtrar dados de preenchimento retroativo.
- A origem Analytics não preenche dados retroativamente com o Perfil.
- Se você utilizar as configurações de Preparo de dados durante a configuração inicial de um fluxo do Analytics, essas alterações também serão aplicadas ao preenchimento retroativo automático de 13 meses.
- No entanto, esse não é o caso da filtragem, pois ela é reservada apenas para dados em tempo real.
- O Preparo de dados é aplicado aos caminhos de transmissão e assimilação em lote. Se você modificar uma configuração existente de Preparo de dados, essas alterações serão aplicadas aos novos dados recebidos pelos caminhos de transmissão e assimilação em lote.
- No entanto, qualquer configuração de Preparo de dados não se aplica a dados que já foram assimilados no Experience Platform, independentemente de serem dados de transmissão ou em lote.
- Os atributos padrão do Analytics são sempre mapeados automaticamente. Portanto, não é possível aplicar transformações a atributos padrão.
- No entanto, você pode filtrar atributos padrão, desde que eles não sejam necessários no Serviço de identidade ou Perfil.
- Não é possível usar a filtragem em nível de coluna para filtrar campos obrigatórios e campos de identidade.
- Embora seja possível filtrar identidades secundárias, especificamente AAID e AACustomID, não é possível filtrar a ECID.
- Quando ocorre um erro de transformação, a coluna correspondente resulta em NULL.
Filtragem em nível de linha
Você pode filtrar dados para assimilação de Profile em nível de linha e em nível de coluna. A filtragem em nível de linha permite definir critérios como cadeia de caracteres contém, é igual a, começa ou termina com. Você também pode usar a filtragem em nível de linha para unir condições usando AND e OR, e negar condições usando NOT.
Para filtrar os dados do Analytics no nível de linha, selecione Filtro de linha.
Use o painel à esquerda para navegar pela hierarquia do esquema e selecione o atributo de esquema de sua escolha para detalhar ainda mais um esquema específico.
Depois de identificar o atributo que deseja configurar, selecione e arraste o atributo do painel esquerdo para o painel Filtragem.
Para configurar condições diferentes, selecione igual a e selecione uma condição na janela suspensa que aparece.
A lista de condições configuráveis inclui:
- é igual a
- não é igual a
- começa com
- termina com
- não termina com
- contém
- não contém
- existe
- não existe
Em seguida, insira os valores que deseja incluir com base no atributo selecionado. No exemplo abaixo, Apple e Google são selecionados para assimilação como parte do atributo Manufaturer.
Para especificar ainda mais suas condições de filtragem, adicione outro atributo do esquema e adicione valores com base nesse atributo. No exemplo abaixo, o atributo Model é adicionado e modelos como iPhone 13 e Google Pixel 6 são filtrados para assimilação.
Para adicionar um novo contêiner, selecione as reticências (...) na parte superior direita da interface de filtragem e selecione Adicionar contêiner.
Depois que um novo contêiner for adicionado, selecione Incluir e Excluir da janela suspensa exibida.
Em seguida, conclua o mesmo processo arrastando os atributos do esquema e adicionando os valores correspondentes que deseja excluir da filtragem. No exemplo abaixo, iPhone 12, iPhone 12 mini e Google Pixel 5 são todos filtrados da exclusão do atributo Modelo, paisagem é excluída da Orientação da tela e número do modelo A1633 é excluída do Número do modelo.
Quando terminar, selecione Próximo.
Filtragem em nível de coluna
Selecione Filtro de coluna no cabeçalho para aplicar a filtragem em nível de coluna.
A página é atualizada em uma árvore de esquema interativa, exibindo os atributos do esquema no nível da coluna. Aqui, você pode selecionar as colunas de dados que deseja excluir da assimilação de Profile. Como alternativa, é possível expandir uma coluna e selecionar atributos específicos para exclusão.
Por padrão, todos os Analytics vão para Profile e esse processo permite que ramificações de dados XDM sejam excluídas da assimilação de Profile.
Quando terminar, selecione Próximo.
Filtrar identidades secundárias
Use um filtro de coluna para excluir identidades secundárias da assimilação de perfis. Para filtrar identidades secundárias, selecione Filtro de coluna e _identidades.
O filtro se aplica somente quando uma identidade é marcada como secundária. Se as identidades forem selecionadas, mas um evento chegar com uma das identidades marcadas como primárias, elas não serão filtradas.
Fornecer detalhes do fluxo de dados
A etapa Detalhes do fluxo de dados é exibida, onde você deve fornecer um nome e uma descrição opcional para o fluxo de dados. Selecione Avançar quando terminar.
Revisar
A etapa Revisão é exibida, permitindo que você revise o novo fluxo de dados do Analytics antes que ele seja criado. Os detalhes da conexão são agrupados por categorias, incluindo:
- Conexão: exibe a plataforma de origem da conexão.
- Tipo de dados: exibe o Conjunto de relatórios selecionado e sua ID de Conjunto de relatórios correspondente.
Monitorar seu fluxo de dados monitor-your-dataflow
Depois que o fluxo de dados for concluído, selecione Fluxos de dados no catálogo de fontes para monitorar a atividade e o status dos seus dados.
Uma lista dos fluxos de dados existentes do Analytics em sua organização é exibida. Aqui, selecione um conjunto de dados de destino para visualizar sua respectiva atividade de assimilação.
A página Atividade do conjunto de dados fornece informações sobre o progresso dos dados que estão sendo enviados do Analytics para o Experience Platform. A interface exibe métricas como o número de registros assimilados, o número de lotes assimilados e o número de lotes com falha.
A origem instancia dois fluxos de conjunto de dados. Um fluxo representa dados de preenchimento retroativo e o outro é para dados em tempo real. Os dados de preenchimento retroativo não são configurados para assimilação no Perfil do cliente em tempo real, mas são enviados ao data lake para casos de uso analíticos e de ciência de dados.
Para obter mais informações sobre preenchimento retroativo, dados em tempo real e suas respectivas latências, leia a Visão geral da origem do Analytics.
A página de atividade do conjunto de dados não exibe uma lista de lotes individuais. Para exibir uma lista de lotes individuais, selecione um gráfico na interface da atividade do conjunto de dados.
Você será direcionado ao Painel de monitoramento. Em seguida, selecione SOMENTE FALHAS DE ASSIMILAÇÃO: SIM para limpar o filtro e exibir uma lista de lotes individuais.
A interface é atualizada para uma lista de lotes individuais, incluindo informações sobre suas respectivas métricas.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 layout-auto | |
|---|---|
| Métricas | Descrição |
| ID do lote | A ID de um determinado lote. Esse valor é gerado internamente. |
| Nome do conjunto de dados | O nome de um determinado conjunto de dados usado para os dados do Analytics. |
| Fonte | A fonte dos dados assimilados. |
| Atualização dos pacotes | A data da iteração de execução de fluxo mais recente. |
| Registros no conjunto de dados | A contagem total de registros no conjunto de dados. Observação: ocasionalmente, este parâmetro exibirá o status in-progress. Esse status indica que o processo de assimilação de registros ainda não está concluído. |
| Novos fragmentos de perfil | A contagem total de novos fragmentos de perfil que foram assimilados. |
| Fragmentos de perfil existentes | A contagem total de fragmentos de perfil existentes. |
| Registros de identidade identificados | A contagem total de registros de identidade que foram compilados após a assimilação. |
| Registros no perfil | A contagem total de registros assimilados no Perfil de Cliente em Tempo Real. |
Próximas etapas e recursos adicionais
Depois que a conexão é criada, o fluxo de dados é criado automaticamente para conter os dados recebidos e preencher um conjunto de dados com o esquema selecionado. Além disso, ocorre o preenchimento retroativo de dados e a assimilação de até 13 meses de dados históricos. Quando a assimilação inicial for concluída, Analytics dados e serão usados por serviços downstream da plataforma, como o Real-Time Customer Profile e o Serviço de segmentação. Consulte os seguintes documentos para obter mais detalhes:
O vídeo a seguir é destinado a ajudá-lo a entender a assimilação de dados usando o conector do Adobe Analytics Source: