Pré-requisitos

Certifique-se de atender a todos os requisitos a seguir antes de usar a funcionalidade descrita neste caso de uso:

  • Uma implementação em funcionamento que coleta dados no data lake do Experience Platform.
  • Acesso ao complemento Data Distiller para garantir que você esteja autorizado a executar consultas em lote. Consulte Pacote do Serviço de Consulta para obter mais informações.
  • Acesso à funcionalidade Exportar conjuntos de dados, disponível após a compra do pacote do Real-Time CDP Prime ou Ultimate, Adobe Journey Optimizer ou Customer Journey Analytics. Consulte Exportar conjuntos de dados para destinos de armazenamento na nuvem para obter mais informações.
  • Um ou mais destinos configurados (por exemplo: Amazon S3, Armazenamento da Google Cloud) para onde você pode exportar os dados brutos do feed de dados.

Serviço de consulta

O Serviço de consulta de Experience Platform permite consultar e associar qualquer conjunto de dados no data lake de Experience Platform como se fosse uma tabela de banco de dados. Você pode capturar os resultados como um novo conjunto de dados para uso em relatórios ou para exportação.

Você pode usar a interface de usuário do Serviço de Consulta, um cliente conectado por meio do protocolo PostgresQL ou as APIs RESTful para criar e agendar consultas que coletam os dados do seu feed de dados.

Criar consulta

Você pode usar toda a funcionalidade do SQL ANSI padrão para instruções SELECT e outros comandos limitados para criar e executar queries que geram os dados para seu feed de dados. Consulte Sintaxe SQL para obter mais informações. Além dessa sintaxe SQL, o Adobe suporta:

Colunas de feed de dados

Os campos XDM que você pode usar no query dependem da definição de esquema em que seus conjuntos de dados se baseiam. Entenda o esquema subjacente ao conjunto de dados. Consulte para obter mais informações o guia da interface do usuário de conjuntos de dados.

Para ajudar você a definir o mapeamento entre as colunas do Feed de dados e os campos XDM, consulte Mapeamento de campos do Analytics. Consulte também a Visão geral da interface do usuário de esquemas para obter mais informações sobre como gerenciar recursos XDM, incluindo esquemas, classes, grupos de campos e tipos de dados.

Por exemplo, caso queira usar nome da página como parte do seu feed de dados:

  • Na interface do Feed de dados do Adobe Analytics, você selecionaria pagename como coluna para adicionar à sua definição de feed de dados.
  • No Serviço de consulta, você inclui web.webPageDetails.name do conjunto de dados sample_event_dataset_for_website_global_v1_1 (com base no Esquema de evento de amostra para o site (Esquema de evento de experiência Global v1.1)) em sua consulta. Consulte o grupo de campos de esquema Detalhes da Web para obter mais informações.

Identidades

No Experience Platform, várias identidades estão disponíveis. Ao criar suas consultas, verifique se você está consultando identidades corretamente.

Geralmente você encontra identidades em um grupo de campos separado. Em uma implementação, a ECID (ecid) pode ser definida como parte de um grupo de campos com um objeto core, o qual faz parte de um objeto identification (por exemplo: _sampleorg.identification.core.ecid). As ECIDs podem ser organizadas de forma diferente em seus esquemas.

Como alternativa, você pode usar identityMap para consultar identidades. O identityMap é do tipo Map e usa uma estrutura de dados aninhada.

Consulte Definir campos de identidade na interface para obter mais informações sobre como definir campos de identidade no Experience Platform.

Consulte Identificadores primários em dados do Analytics para entender como as identidades do Adobe Analytics são mapeadas para identidades Experience Platform ao usar o conector de origem do Analytics. Esse mapeamento pode servir como orientação para configurar suas identidades, mesmo quando não estiver usando o conector de origem do Analytics.

Dados e identificação do nível de ocorrência

Com base na implementação, os dados de nível de ocorrência tradicionalmente coletados no Adobe Analytics agora são armazenados como dados de evento com carimbo de data e hora no Experience Platform. A tabela a seguir é extraída do mapeamento de campo do Analytics e mostra exemplos de como mapear colunas do Feed de dados do Adobe Analytics específicas para o nível de ocorrência com campos XDM correspondentes em suas consultas. A tabela também mostra exemplos de como as ocorrências, visitas e visitantes são identificados usando campos XDM.

Coluna de feed de dadosCampo XDMTipoDescrição
hitid_high + hitid_low_idstringUm identificador exclusivo para identificar uma ocorrência.
hitid_low_idstringUsado com hitid_high para identificar uma ocorrência exclusivamente.
hitid_high_idstringUsado com hitid_high para identificar uma ocorrência exclusivamente.
hit_time_gmtreceivedTimestampstringO carimbo de data e hora da ocorrência, com base no horário UNIX®.
cust_hit_time_gmttimestampstringEsse carimbo de data e hora é usado apenas em conjuntos de dados habilitados para carimbo de data e hora. Esse carimbo de data e hora é enviado com a ocorrência, com base no horário UNIX®.
visid_high + visid_lowidentityMapobjetoUm identificador exclusivo para uma visita.
visid_high + visid_lowendUserIDs._experience.aaid.idstringUm identificador exclusivo para uma visita.
visid_highendUserIDs._experience.aaid.primarybooleanoUsado com visid_low para identificar uma visita de maneira exclusiva.
visid_highendUserIDs._experience.aaid.namespace.codestringUsado com visid_low para identificar uma visita de maneira exclusiva.
visid_lowidentityMapobjetoUsado com visid_high para identificar uma visita de maneira exclusiva.
cust_visididentityMapobjetoA ID de visitante do cliente.
cust_visidendUserIDs._experience.aacustomid.idobjetoA ID de visitante do cliente.
cust_visidendUserIDs._experience.aacustomid.primarybooleanoO código de namespace da ID de visitante do cliente.
cust_visidendUserIDs._experience.aacustomid.namespace.codestringUsado com visid_low para identificar exclusivamente a ID de visitante do cliente.
geo\_*placeContext.geo.*sequência, númeroDados de geolocalização, como país, região, cidade e outros
event_listcommerce.purchases, commerce.productViews, commerce.productListOpens, commerce.checkouts, commerce.productListAdds, commerce.productListRemovals, commerce.productListViews, _experience.analytics.event101to200.*, …, _experience.analytics.event901_1000.*stringEventos de comércio padrão e personalizados acionados na ocorrência.
page_eventweb.webInteraction.typestringO tipo de ocorrência enviado na solicitação da imagem (ocorrência padrão, link de download, link de saída ou link personalizado clicado).
page_eventweb.webInteraction.linkClicks.valuenumberO tipo de ocorrência enviado na solicitação da imagem (ocorrência padrão, link de download, link de saída ou link personalizado clicado).
page_event_var_1web.webInteraction.URLstringUma variável usada somente em solicitações de imagem de rastreamento de link. Essa variável contém o URL do link de download, link de saída, ou link personalizado clicado.
page_event_var_2web.webInteraction.namestringUma variável usada somente em solicitações de imagem de rastreamento de link. Isso lista o nome personalizado do link, se for especificado.
paid_searchsearch.isPaidbooleanoUm sinalizador que é definido se a ocorrência corresponder à detecção de pesquisa paga.
ref_typeweb.webReferrertypestringUma ID numérica que representa o tipo de referência para a ocorrência.

Publicar colunas

Os Feeds de dados do Adobe Analytics usam o conceito de colunas com um prefixo post_, que são colunas que contêm dados após o processamento. Consulte Perguntas frequentes sobre feeds de dados para obter mais informações.

Os dados coletados em conjuntos de dados por meio do Edge Network Experience Platform (SDK da Web, SDK móvel, API do servidor) não têm conceito de campos post_. Como resultado, as colunas de feed de dados com o prefixo post_ e o prefixo non-post_ mapeiam para os mesmos campos XDM. Por exemplo, as colunas de feed de dados page_url e post_page_url mapeiam para o mesmo campo XDM web.webPageDetails.URL.

Consulte Comparar o processamento de dados entre o Adobe Analytics e o Customer Journey Analytics para obter uma visão geral da diferença no processamento de dados.

O tipo de dados da coluna de prefixo post_, quando coletado no data lake do Experience Platform, requer, no entanto, transformações avançadas antes de poder ser usado com êxito em um caso de uso de feed de dados. A execução dessas transformações avançadas em suas consultas envolve o uso de funções definidas por Adobe para sessão, atribuição e desduplicação. Consulte Exemplos sobre como usar essas funções.

Pesquisas

Para pesquisar dados de outros conjuntos de dados, use a funcionalidade SQL padrão (WHERE cláusula, INNER JOIN, OUTER JOIN e outras).

Cálculos

Para realizar cálculos em campos (colunas), use as funções SQL padrão (por exemplo COUNT(*)) ou a parte funções e operadores matemáticos e estatísticos do Spark SQL. Além disso, as funções de janela oferecem suporte para atualizar agregações e retornar itens únicos para cada linha em um subconjunto ordenado. Consulte Exemplos sobre como usar essas funções.