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

NOTE
Ao criar um fluxo de dados de origem do Analytics em uma sandbox de produção, dois fluxos de dados são criados:
  • 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.

catálogo

Selecionar dados

IMPORTANT
Os conjuntos de relatórios listados na tela podem vir de várias regiões. Você é responsável por entender as limitações e obrigações de seus dados e como usá-los entre regiões do Adobe Experience Platform. Verifique se isso é permitido pela sua empresa.

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.

NOTE
Os dados de vários conjuntos de relatórios podem ser ativados para o Perfil do cliente em tempo real somente se não houver conflitos de dados, como duas propriedades personalizadas (eVars, listas e props) com significado diferente.

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

IMPORTANT
As transformações de Preparo de dados podem adicionar latência ao fluxo de dados geral. A latência adicional adicionada varia de acordo com a complexidade da lógica de transformação.

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.

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.

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.

TIP
Somente esquemas que têm o grupo de campos Adobe Analytics ExperienceEvent Template são exibidos no menu de seleção de esquema. Outros esquemas são omitidos. Se não houver esquemas apropriados disponíveis para seus dados do Conjunto de relatórios, você deve criar um novo esquema. Para obter etapas detalhadas sobre como criar esquemas, consulte o guia em criar e editar esquemas na interface.

selecionar-esquema

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:

Mapear campos padrão
Descrição
Mapeamentos padrão aplicados
O painel Mapeamentos padrão aplicados exibe o número total de atributos mapeados. Os mapeamentos padrão se referem aos conjuntos de mapeamento entre todos os atributos nos dados de origem Analytics e atributos correspondentes no grupo de campos Analytics. Eles são pré-mapeados e não podem ser editados.
Mapeamentos padrão não correspondentes
O painel Mapeamentos padrão não correspondentes refere-se ao número de atributos mapeados que contêm conflitos de nome amigável. Esses conflitos aparecem quando você está reutilizando um esquema que já tem um conjunto preenchido de descritores de campo de um conjunto de relatórios diferente. Você pode continuar com o fluxo de dados do Analytics mesmo com conflitos de nome amigáveis.
Mapeamentos personalizados
O painel Mapeamentos personalizados exibe o número de atributos personalizados mapeados, incluindo eVars, propriedades e listas. Mapeamentos personalizados se referem aos conjuntos de mapeamento entre atributos personalizados nos dados de origem Analytics e atributos nos grupos de campos personalizados incluídos no esquema selecionado.

mapear-campos-padrão

Para visualizar o grupo de campos de esquema de modelo ExperienceEvent Analytics, selecione Exibir no painel Mapeamentos padrão aplicados.

exibir

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.

visualização de grupo de campos

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.

mapeamento

TIP
Se houver conflitos de nome amigável entre seu Conjunto de relatórios de origem e o esquema selecionado, você ainda poderá continuar com o fluxo de dados do Analytics, reconhecendo que os descritores de campo não serão alterados. Como alternativa, você pode optar por criar um novo esquema com um conjunto de descritores em branco.

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.

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.

recommendation-more-help

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

IMPORTANT
Use a filtragem de nível de linha para aplicar condições e determinar quais dados incluir para ingestão de perfil. Use a filtragem em nível de coluna para selecionar as colunas de dados que você deseja excluir para assimilação de perfil.

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.

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

painel esquerdo

Depois de identificar o atributo que deseja configurar, selecione e arraste o atributo do painel esquerdo para o painel Filtragem.

painel-filtro

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

condições

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.

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

include-model

Para adicionar um novo contêiner, selecione as reticências (...) na parte superior direita da interface de filtragem e selecione Adicionar contêiner.

adicionar-contêiner

Depois que um novo contêiner for adicionado, selecione Incluir e Excluir da janela suspensa exibida.

excluir

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.

excluir-exemplos

Filtragem em nível de coluna

Selecione Filtro de coluna no cabeçalho para aplicar a filtragem em nível de coluna.

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

colunas-selecionadas

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.

identidades-secundárias

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.

detalhes do fluxo de dados

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.

avaliação

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.

O catálogo de fontes com a guia de fluxos de dados selecionada.

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.

Uma lista de fluxos de dados existentes do Adobe Analytics em sua organizaçã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 para um determinado conjunto de dados de destino para dados do Adobe Analytics.

Exibir lotes individuais usando a interface de monitoramento herdada

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.

A página de atividade do conjunto de dados com um gráfico selecionado.

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.

Painel de monitoramento com o filtro de falha selecionado.

A interface é atualizada para uma lista de lotes individuais, incluindo informações sobre suas respectivas métricas.

A página de monitoramento herdada dos dados em lote.

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:

WARNING
A interface do usuário Platform mostrada no vídeo a seguir está desatualizada. Consulte a documentação acima para obter as capturas de tela e a funcionalidade mais recentes da interface.
337b99bb-92fb-42ae-b6b7-c7042161d089