Conectar o Adobe Analytics ao Experience Platform
Criado para:
- Desenvolvedor
Leia este guia para saber como usar a fonte do Adobe Analytics para assimilar dados do conjunto de relatórios do Analytics na Adobe Experience Platform.
Introdução
Este tutorial requer uma compreensão funcional dos seguintes componentes do Experience Platform:
- Sistema do Experience Data Model (XDM): a estrutura padronizada pela qual a 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: a Experience Platform fornece sandboxes virtuais que particionam uma única instância do Experience 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 atributos predefinidos pela Adobe. Eles contêm o mesmo significado para todos os clientes e estão disponíveis nos grupos de campos de dados de origem do Analytics e esquema do Analytics.
- Atributo personalizado: os atributos personalizados são qualquer atributo na hierarquia de variáveis personalizadas no 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 seguinte documentação do Analytics sobre variáveis de conversão 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.
Navegar pelo catálogo de origens
NOTE- 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 do Experience Platform, selecione Fontes na navegação à esquerda para acessar o espaço de trabalho Fontes. Na categoria aplicativos do Adobe, selecione o cartão Adobe Analytics e Adicionar dados.
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.
- 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.
Um conjunto de relatórios é um container de dados que forma a base dos relatórios do 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 da 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. Se um conjunto de relatórios estiver em cinza e não puder ser selecionado, significa que ele 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.
Selecione o Conjunto de relatórios e use a interface de adição de dados da origem do Analytics para navegar pela lista e identificar o conjunto de relatórios do Analytics que você deseja assimilar na Experience Platform. Selecione 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
IMPORTANTAntes de mapear os dados do Analytics para o esquema XDM de destino, primeiro você deve determinar se está usando um esquema padrão ou personalizado.
Um esquema padrão cria um novo esquema em seu nome. Este esquema recém-criado contém 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.
Use a interface Mapping para mapear campos de origem para seus campos de esquema de destino apropriados. Você pode mapear variáveis personalizadas para novos grupos de campos de esquema e aplicar cálculos, conforme suportado pelo Preparo de dados. Selecione um schema de destino para iniciar o processo de mapeamento.
TIP
Você pode consultar o painel Mapear campos padrão para obter as métricas dos Mapeamentos padrão aplicados. Mapeamentos padrão com conflitos de nome de descritor e Custom mappings.
Mapeamentos padrão
O Experience Platform detecta automaticamente o mapeamento para qualquer conflito de nome. Se não houver conflitos com seus mapeamentos, selecione Avançar para continuar.
TIPMapeamentos personalizados
Você pode 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.
- Filtrar campos: use a entrada de texto Filtrar campos para filtrar campos de mapeamento específicos em seus mapeamentos.
- Adicionar novo mapeamento: para adicionar um novo mapeamento do campo de origem e do campo de destino, selecione Adicionar novo mapeamento.
- Adicionar campo calculado: se necessário, você pode selecionar Adicionar campo calculado para criar um novo campo calculado para seus mapeamentos.
- Importar mapeamento: você pode reduzir o tempo de configuração manual do seu processo de assimilação de dados e limitar erros usando a funcionalidade de mapeamento de importação do Preparo de dados. Selecione Importar mapeamento para importar mapeamentos de um fluxo existente ou de um arquivo exportado. Para obter mais informações, leia o manual sobre importação e exportação de mapeamentos.
- Modelo de download: você também pode baixar uma cópia CSV de seus mapeamentos e configurá-los em seu dispositivo local. Selecione Baixar modelo para baixar uma cópia CSV de seus mapeamentos. Você deve garantir que esteja usando apenas os campos fornecidos no arquivo de origem e no esquema de destino.
Consulte a documentação a seguir para obter mais informações sobre Preparo de dados.
Filtragem para o perfil do cliente em tempo real
Depois de concluir os mapeamentos dos dados do conjunto de relatórios do Analytics, você pode 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 só está disponível para dados do Analytics e os dados são filtrados apenas antes da entrada 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 fonte do Analytics não preenche os 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
IMPORTANTVocê pode filtrar dados para assimilação de perfil no nível da linha e no nível da coluna. Use a filtragem em nível de linha para 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 da linha, selecione Filtro de linha e use o painel esquerdo para navegar pela hierarquia de esquema e identificar o atributo de esquema que deseja selecionar.
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 16 e Google Pixel 9 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 no menu suspenso. Adicione os atributos e valores que deseja excluir e, 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 perfis. Como alternativa, é possível expandir uma coluna e selecionar atributos específicos para exclusão.
Por padrão, todas as análises vão para Perfil e esse processo permite que ramificações de dados XDM sejam excluídas da assimilação de perfis.
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
Após concluir o fluxo de dados, você pode usar a interface Fluxos de dados para monitorar o status do fluxo de dados do Analytics.
Use a interface da atividade do conjunto de dados para obter 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 total de registros no mês anterior, o total de registros assimilados nos últimos sete dias e o tamanho dos dados no mês anterior.
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.
NOTEExcluir seu fluxo de dados
Para excluir o fluxo de dados do Analytics, selecione Fluxos de dados no cabeçalho superior do espaço de trabalho de fontes. Use a página de fluxos de dados para localizar o fluxo de dados do Analytics que você deseja excluir e selecione as reticências (...) ao lado dela. Em seguida, use o menu suspenso e selecione Excluir.
- A exclusão do fluxo de dados ativo do Analytics também excluirá seu conjunto de dados subjacente.
- A exclusão do fluxo de dados de preenchimento retroativo do Analytics não exclui o conjunto de dados subjacente, mas interromperá o processo de preenchimento retroativo do conjunto de relatórios correspondente. Se você excluir o fluxo de dados de preenchimento retroativo, os dados assimilados ainda poderão ser visualizados no conjunto de dados.
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, os dados do Analytics e serão usados pelos serviços downstream do Experience Platform, 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