Mapeamento de campo do objeto XDM para o Adobe Analytics

A tabela a seguir mostra as variáveis XDM que a Edge Network da Adobe Experience Platform mapeia automaticamente para o Adobe Analytics. Se você usar esses caminhos de campo XDM, nenhuma configuração adicional será necessária para enviar dados ao Adobe Analytics. Esses campos estão incluídos no grupo de campos Modelo de evento de experiência do Adobe Analytics. O uso desses campos é recomendado se você pretende enviar dados para o Adobe Analytics e a Adobe Experience Platform.

Se sua organização planeja migrar para o Customer Journey Analytics, a Adobe recomenda usar o objeto data para enviar dados diretamente para o Adobe Analytics sem estar em conformidade com um esquema. Essa estratégia permite que sua organização use seu próprio esquema, em vez de usar o Modelo de evento de experiência do Adobe Analytics (que é menos aplicável ao Customer Journey Analytics). Consulte Mapeamento de variável de objeto de dados para o Adobe Analytics para obter uma tabela de mapeamento semelhante.

Prioridades de valor

A maioria dos campos de objeto XDM nesta tabela corresponde a um campo de objeto de dados mapeado. Durante a assimilação do Adobe Analytics, os valores são mapeados primeiro do XDM para as variáveis do Analytics. Os campos de objeto de dados reconhecidos são mapeados e substituem quaisquer valores definidos anteriormente quando eles são mapeados para a mesma variável do Analytics. Por exemplo, se data.__adobe.analytics.events estiver presente, ele substituirá todo o conjunto de eventos que de outra forma seriam derivados do XDM. Os eventos não são combinados em ambas as fontes.

Mapeamento de campos de objetos XDM

As atualizações anteriores desta tabela podem ser encontradas no histórico de confirmações desta página no GitHub.

Caminho de campo XDM
Variável e descrição do Analytics
xdm.application.isClose
Ajuda a definir a métrica de ciclo de vida móvel Falhas.
xdm.application.isInstall
Ajuda a determinar quando aumentar a métrica de ciclo de vida móvel Primeiras inicializações.
xdm.application.closeType
Determina se um evento de encerramento é uma falha ou não. Os valores válidos incluem close (Uma sessão de ciclo de vida termina e um evento de pausa foi recebido para a sessão anterior) e unknown (Uma sessão do ciclo de vida termina sem um evento de pausa). Ajuda a definir a métrica de ciclo de vida móvel Falhas.
xdm.application.isInstall
A métrica de ciclo de vida móvel Instalações.
xdm.application.isLaunch
A métrica de ciclo de vida móvel Inicializações.
xdm.application.name
Ajuda a definir a dimensão de ciclo de vida móvel ID do aplicativo.
xdm.application.isUpgrade
A métrica de ciclo de vida móvel Atualizações.
xdm.application.version
Ajuda a definir a dimensão de ciclo de vida móvel ID do aplicativo.
xdm.application.sessionLength
A métrica de ciclo de vida móvel Duração da sessão anterior.
xdm.commerce.checkouts.id
Aplica serialização de eventos para a métrica Check-outs.
xdm.commerce.checkouts.value
Aumenta a métrica Check-outs pela quantidade desejada.
xdm.commerce.order.currencyCode
Define a variável da configuração currencyCode.
xdm.commerce.order.purchaseID
Define a variável da página purchaseID.
xdm.commerce.order.payments[0].transactionID
Define a variável de página transactionID.
xdm.commerce.productListAdds.id
Aplica serialização de eventos à métrica Adições ao carrinho.
xdm.commerce.productListAdds.value
Incrementa a métrica Adições ao carrinho.
xdm.commerce.productListOpens.id
Aplica serialização de eventos à métrica Carrinhos.
xdm.commerce.productListOpens.value
Incrementa a métrica Carrinhos.
xdm.commerce.productListRemovals.id
Aplica serialização de eventos à métrica Remoções do carrinho.
xdm.commerce.productListRemovals.value
Incrementa a métrica Remoções do carrinho.
xdm.commerce.productListViews.id
Aplica serialização de eventos à métrica Visualizações do carrinho.
xdm.commerce.productListViews.value
Incrementa a métrica Visualizações do carrinho.
xdm.commerce.productViews.id
Aplica serialização de eventos à métrica Visualizações do produto.
xdm.commerce.productViews.value
Incrementa a métrica Visualizações de produto.
xdm.commerce.purchases.value
Incrementa a métrica Pedidos.
xdm.device.model
A dimensão de ciclo de vida móvel Nome do dispositivo.
xdm.device.colorDepth
Ajuda a definir a dimensão Intensidade de cor.
xdm.device.screenHeight
Ajuda a definir a dimensão Resolução do monitor.
xdm.device.screenWidth
Ajuda a definir a dimensão Resolução do monitor.
xdm.device.type
O tipo de dispositivo móvel.
xdm.environment.browserDetails.acceptLanguage
Ajuda a definir a dimensão Idioma.
xdm.environment.browserDetails.cookiesEnabled
Define a dimensão Suporte a cookies. Os valores válidos incluem Y (o navegador aceita cookies) e N (o navegador rejeita cookies).
xdm.environment.browserDetails.javaEnabled
Define a dimensão Java habilitado. Os valores válidos incluem Y (O Java está habilitado) e N (O Java está desabilitado).
xdm.environment.browserDetails.userAgent
Usado como um método de identificação visitante único de fallback. Normalmente preenchida com o uso do cabeçalho da solicitação HTTP do User-Agent. Você pode mapear esse campo para uma eVar se quiser usá-la nos relatórios.
xdm.environment.browserDetails.viewportHeight
Define a dimensão Altura da janela do navegador.
xdm.environment.browserDetails.viewportWidth
Define a dimensão Largura do navegador.
xdm.environment.carrier
A dimensão de ciclo de vida móvel Nome da operadora.
xdm.environment.connectionType
Ajuda a definir a dimensão Tipo de conexão.
xdm.environment._dc.language
Define a variável de dados de contexto a.locale. Usado apenas se xdm.environment.language não estiver definido. A Adobe recomenda usar este campo em vez de xdm.environment.language.
xdm.environment.ipV4
Usado como um método de identificação visitante único de fallback. Normalmente preenchida com o uso do cabeçalho HTTP do X-Forwarded-For.
xdm.environment.language
Define a variável de dados de contexto a.locale. Em vez disso, a Adobe recomenda usar xdm.environment._dc.language.
xdm.environment.operatingSystem
A dimensão de ciclo de vida móvel Sistema operacional.
xdm.environment.operatingSystemVersion
Ajuda a definir a dimensão de ciclo de vida móvel Versão do sistema operacional.
xdm._experience.analytics.customDimensions.
eVars.eVar1
[...]
xdm._experience.analytics.customDimensions.
eVars.eVar250
Define a respectiva dimensão da eVar.
xdm._experience.analytics.customDimensions.
hierarchies.hier1
[...]
xdm._experience.analytics.customDimensions.
hierarchies.hier5
Define a respectiva dimensão da Hierarquia.
xdm._experience.analytics.customDimensions.
listProps.prop1.delimiter
[...]
xdm._experience.analytics.customDimensions.
listProps.prop75.delimiter
Sobreposição do delimitador de propriedade de lista. O uso desse campo não é recomendado, pois o delimitador é recuperado automaticamente do Administrador da variável de tráfego nas configurações do conjunto de relatórios. O uso desse campo pode criar uma incompatibilidade entre o delimitador usado e o delimitador esperado pelo Analytics.
xdm._experience.analytics.customDimensions.
listProps.prop1.values
[...]
xdm._experience.analytics.customDimensions.
listProps.prop75.values
Uma matriz de sequência de caracteres que contém os respectivos valores da Propriedade de lista.
xdm._experience.analytics.customDimensions.
lists.list1.list[].value
[...]
xdm._experience.analytics.customDimensions.
lists.list3.list[].value
Concatena todas as strings value em cada matriz list[] à sua respectiva variável de lista. O delimitador é escolhido automaticamente com base no valor definido em Configurações do conjunto de relatórios.
xdm._experience.analytics.customDimensions.
props.prop1
[...]
xdm._experience.analytics.customDimensions.
props.prop75
Define a respectiva dimensão de Propriedade.
xdm._experience.analytics.event1to100.
event1.id
[...]
xdm._experience.analytics.event901to1000.
event1000.id
Aplica a serialização de eventos à respectiva métrica de Eventos personalizados. Cada ID de evento reside no grupo principal de um conjunto de 100 grupos. Por exemplo, para aplicar a serialização a event678, use xdm._experience.analytics.event601to700.event678.id.
xdm._experience.analytics.event1to100.
event1.value
[...]
xdm._experience.analytics.event901to1000.
event1000.value
Aumenta a respectiva métrica de Eventos personalizados de acordo com o valor desejado. Cada evento reside no grupo principal de um conjunto de 100 grupos. Por exemplo, o campo para event567 é xdm._experience.analytics.event501to600.event567.value.
xdm.identityMap.ECID[0].id
A ID do serviço de identidade da Adobe Experience Cloud.
xdm.marketing.trackingCode
Define a dimensão Código de rastreamento.
xdm.media.mediaTimed.completes.value
A métrica de serviços de mídia de streaming Conteúdo completo.
xdm.media.mediaTimed.dropBeforeStart.value
a.media.view, a.media.timePlayed, a.media.play
xdm.media.mediaTimed.federated.value
A métrica de serviços de mídia de streaming Dados federados.
xdm.media.mediaTimed.firstQuartiles.value
A métrica de serviços de mídia de streaming Marcador de progresso de 25%.
xdm.media.mediaTimed.mediaSegmentView.value
A métrica de serviços de mídia de streaming Visualizações de segmento de conteúdo.
xdm.media.mediaTimed.midpoints.value
A métrica de serviços de mídia de streaming Marcador de progresso de 50%.
xdm.media.mediaTimed.pauseTime.value
A métrica de serviços de mídia de streaming Duração total da pausa.
xdm.media.mediaTimed.pauses.value
A métrica de serviços de mídia de streaming Eventos de pausa.
xdm.mediaCollection.sessionDetails.assetID
A dimensão dos serviços de mídia de streaming ID do ativo.
xdm.mediaCollection.sessionDetails.friendlyName
A dimensão dos serviços de mídia de streaming Nome do vídeo.
xdm.mediaCollection.sessionDetails.originator
A dimensão dos serviços de mídia de streaming Originador.
xdm.mediaCollection.sessionDetails.episode
A dimensão dos serviços de mídia de streaming Episódio.
xdm.mediaCollection.sessionDetails.genre
A dimensão dos serviços de mídia de streaming Gênero.
xdm.mediaCollection.sessionDetails.rating
A dimensão dos serviços de mídia de streaming Classificação de conteúdo.
xdm.mediaCollection.sessionDetails.season
A dimensão dos serviços de mídia de streaming Temporada.
xdm.mediaCollection.sessionDetails.name
A dimensão dos serviços de mídia de streaming ID de conteúdo.
xdm.mediaCollection.sessionDetails.show
A dimensão de serviços de mídia de streaming Programa.
xdm.mediaCollection.sessionDetails.showType
A dimensão dos serviços de mídia de streaming Tipo de programa.
xdm.mediaCollection.sessionDetails.length
A dimensão dos serviços de mídia de streaming Duração do vídeo.
xdm.media.mediaTimed.primaryAssetViewDetails.@id
A dimensão dos serviços de mídia de streaming ID da sessão de mídia.
xdm.mediaCollection.sessionDetails.channel
A dimensão dos serviços de mídia de streaming Canal de conteúdo.
xdm.mediaCollection.sessionDetails.contentType
A dimensão dos serviços de mídia de streaming Tipo de conteúdo.
xdm.mediaCollection.sessionDetails.network
A dimensão dos serviços de mídia de streaming Rede.
xdm.media.mediaTimed.primaryAssetViewDetails.
mediaSegmentView.value
A dimensão dos serviços de mídia de streaming Segmento de conteúdo.
xdm.mediaCollection.sessionDetails.playerName
A dimensão dos serviços de mídia de streaming Nome do reprodutor de conteúdo.
xdm.mediaCollection.sessionDetails.appVersion
A dimensão dos serviços de mídia de streaming Versão do SDK.
xdm.mediaCollection.sessionDetails.feed
A dimensão dos serviços de mídia de streaming Tipo de feed de mídia.
xdm.mediaCollection.sessionDetails.streamFormat
A dimensão dos serviços de mídia de streaming Formato de transmissão.
xdm.media.mediaTimed.progress10.value
A métrica de serviços de mídia de streaming Marcador de progresso de 10%.
xdm.media.mediaTimed.progress95.value
A métrica de serviços de mídia de streaming Marcador de progresso de 95%.
xdm.mediaCollection.sessionDetails.hasResume
A métrica de serviços de mídia de streaming Resumos de conteúdo.
xdm.media.mediaTimed.starts.value
A métrica de serviços de mídia de streaming Inícios de mídia.
xdm.media.mediaTimed.thirdQuartiles.value
A métrica de serviços de mídia de streaming Marcador de progresso de 75%.
xdm.media.mediaTimed.timePlayed.value
A métrica de serviços de mídia de streaming Tempo gasto com conteúdo.
xdm.media.mediaTimed.totalTimePlayed.value
A métrica de serviços de mídia de streaming Tempo gasto com a mídia.
xdm.placeContext.geo._schema.latitude
A latitude do visitante. Ajuda a definir as dimensões de local do ciclo de vida do dispositivo móvel..
xdm.placeContext.geo._schema.longitude
A longitude do visitante. Ajuda a definir as dimensões de Local do ciclo de vida do dispositivo móvel..
xdm.placeContext.geo.postalCode
A dimensão Código postal.
xdm.placeContext.geo.stateProvince
A dimensão Estados dos Estados Unidos.
xdm.placeContext.localTime
Aparece como t_time_info nos feeds de dados.
xdm.productListItems[]._experience.analytics.
customDimensions.eVars.eVar1
[...]
xdm.productListItems[]._experience.analytics.
customDimensions.eVars.eVar250
Aplica um merchandising de sintaxe do produto para eVars.
xdm.productListItems[]._experience.analytics.
event1to100.event1.value
[...]
xdm.productListItems[]._experience.analytics.
event901-1000.event1000.value
Aplica um merchandising de sintaxe do produto para eventos.
xdm.productListItems[].productCategories[].categoryID
A dimensão Categoria. Consulte também a variável da página de produtos.
xdm.productListItems[].name
A dimensão Produto. Consulte também a variável da página de produtos. Se xdm.productListItems[].SKU e xdm.productListItems[].name contêm dados, o valor em xdm.productListItems[].SKU é usado.
xdm.productListItems[].priceTotal
Ajuda a determinar a métrica Receita. Consulte também a variável da página de produtos.
xdm.productListItems[].quantity
Ajuda a determinar a métrica Unidades. Consulte também a variável da página de produtos.
xdm.productListItems[].SKU
A dimensão Produto. Consulte também a variável da página de produtos. Se xdm.productListItems[].SKU e xdm.productListItems[].name contêm dados, o valor em xdm.productListItems[].SKU é usado.
xdm.web.webInteraction.URL
A variável de implementação linkURL.
xdm.web.webInteraction.name
A dimensão Link personalizado, Link de download ou Link de saída, dependendo do valor em xdm.web.webInteraction.type
xdm.web.webInteraction.type
Determina o tipo de link clicado. Os valores válidos incluem other (Links personalizados), download (Links de download) e exit (Links de saída).
xdm.web.webPageDetails.URL
A dimensão URL da página.
xdm.web.webPageDetails.isErrorPage
Sinalizador que ajuda a determinar a dimensão e a métrica “Páginas não encontradas”.
xdm.web.webPageDetails.name
A dimensão Página.
xdm.web.webPageDetails.server
A dimensão Servidor.
xdm.web.webPageDetails.siteSection
A dimensão Seção do site.
xdm.web.webReferrer.URL
A dimensão Referenciador.

Mapeamento de outros campos XDM para variáveis do Analytics

Se houver dimensões ou métricas que você queira adicionar ao Adobe Analytics, é possível usar Variáveis de dados de contexto.

Mapeamento implícito

Todos os elementos de campo XDM que não são mapeados automaticamente são enviados para o Adobe Analytics como dados de contexto com o prefixo a.x.. Em seguida, você poderá mapear essa variável de dados de contexto para a variável de análise desejada usando regras de processamento. Por exemplo, se você enviar o seguinte evento:

alloy("event",{
    "xdm":{
        "_atag":{
            "search":{
                "term":"Example search term"
            }
        }
    }
})

O SDK da Web envia esses dados para o Adobe Analytics como a variável de dados de contexto a.x._atag.search.term. Em seguida, você pode usar uma regra de processamento para atribuir o valor dessa variável de dados de contexto à variável de análise desejada, como eVar:

Regra de processamento de termo de pesquisa

Mapeamento explícito

Também é possível mapear explicitamente elementos de campo XDM como dados de contexto. Qualquer elemento de campo XDM que seja mapeado explicitamente, usando o elemento contextData, é enviado para o Adobe Analytics como dados de contexto sem um prefixo. Em seguida, você poderá mapear essa variável de dados de contexto para a variável de análise desejada usando regras de processamento. Por exemplo, se você enviar o seguinte evento:

alloy("event",{
    "xdm":{
        "_atag":{
            "analytics": {
                "contextData" : {
                    "someValue" : "1"
                }
            }
        }
    }
})

O SDK da Web envia esses dados para o Adobe Analytics como a variável de dados de contexto somevalue com o valor 1. Em seguida, você pode usar uma regra de processamento para atribuir o valor dessa variável de dados de contexto à variável de análise desejada, como um eVar:

Regra de processamento de termo de pesquisa

recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690