Documentação Experience Platform Tutorial sobre Aplicativos para dispositivos móveis

Coletar e mapear dados do Analytics

Last update: Thu Nov 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:

Criado para:

Iniciante
Intermediário
Desenvolvedor

Saiba como mapear dados móveis para o Adobe Analytics.

Os dados de evento que você coletou e enviou para o Platform Edge Network em lições anteriores são encaminhados para os serviços configurados na sua sequência de dados, incluindo o Adobe Analytics. Mapeie os dados para as variáveis corretas em seu conjunto de relatórios.

Arquitetura

Pré-requisitos

Noções básicas sobre o rastreamento de ExperienceEvent.
Dados XDM enviados com sucesso no aplicativo de amostra.
Um conjunto de relatórios do Adobe Analytics que você pode usar nesta lição.

Objetivos de aprendizagem

Nesta lição, você vai:

Configure seu fluxo de dados com o serviço Adobe Analytics.
Entenda o mapeamento automático de variáveis do Analytics.
Configurar regras de processamento para mapear dados XDM para variáveis do Analytics.

Adicionar serviço de sequência de dados do Adobe Analytics

Para enviar seus dados XDM do Edge Network para o Adobe Analytics, configure o serviço Adobe Analytics para a sequência de dados configurada como parte de Criar uma sequência de dados.

Na interface da Coleção de dados, selecione Sequências de dados e a sequência de dados.
Em seguida, selecione Adicionar Serviço.
Adicionar Adobe Analytics da lista Serviço,
Digite o nome do conjunto de relatórios do Adobe Analytics que você deseja usar em ID do Conjunto de Relatórios.
Habilite o serviço alternando Habilitado em.
Selecione Salvar.

Mapeamento automático

Muitos dos campos XDM padrão são mapeados automaticamente para variáveis do Analytics. Veja a lista completa aqui.

Exemplo #1 - s.products

Um bom exemplo é a variável de produtos, que não pode ser preenchida com as regras de processamento. Com uma implementação XDM, você passa todos os dados necessários em productListItems e s.products são automaticamente preenchidos por meio do mapeamento do Analytics.

Este objeto:

"productListItems": [
    [
      "name":  "Yoga Mat",
      "SKU": "5829",
      "priceTotal": "49.99",
      "quantity": 1
    ],
    [
      "name":  "Water Bottle",
      "SKU": "9841",
      "priceTotal": "30.00",
      "quantity": 3
    ]
]

resulta em:

s.products = ";5829;1;49.99,9841;3;30.00"

NOTE

Se productListItems[].SKU e productListItems[].name contêm dados, o valor em productListItems[].SKU é usado. Consulte Mapeamento de variável do Analytics no Adobe Experience Edge para obter mais informações.

Exemplo #2 - scAdd

Se você observar com atenção, todos os eventos têm dois campos: value (obrigatório) e id (opcional). O campo value é usado para incrementar a contagem de eventos. O campo id é usado para serialização.

Este objeto:

"commerce" : {
  "productListAdds" : {
    "value" : 1
  }
}

resulta em:

s.events = "scAdd"

Este objeto:

"commerce" : {
  "productListAdds" : {
    "value" : 1,
    "id": "321435"
  }
}

resulta em:

s.events = "scAdd:321435"

Validar com o Assurance

Usando o Assurance, você pode confirmar que está enviando um evento de experiência, os dados XDM estão corretos e o mapeamento do Analytics está acontecendo conforme esperado.

Revise a seção instruções de instalação para conectar seu simulador ou dispositivo ao Assurance.
Enviar um evento productListAdds (adicionar um produto à cesta).
Veja a ocorrência do ExperienceEvent.

Revise a parte XDM do JSON.

code language-json

code language-json
`"xdm" : { "productListItems" : [ { "SKU" : "LLWS05.1-XS", "name" : "Desiree Fitness Tee", "priceTotal" : 24 } ], "timestamp" : "2023-08-04T12:53:37.662Z", "eventType" : "commerce.productListAdds", "commerce" : { "productListAdds" : { "value" : 1 } } // ...`

"xdm" : {
  "productListItems" : [ {
    "SKU" : "LLWS05.1-XS",
    "name" : "Desiree Fitness Tee",
    "priceTotal" : 24
  } ],
"timestamp" : "2023-08-04T12:53:37.662Z",
"eventType" : "commerce.productListAdds",
"commerce" : {
  "productListAdds" : {
    "value" : 1
  }
}
// ...

Revise o evento analytics.mapping.

Observe o seguinte no mapeamento do Analytics:

eventos são preenchidos com scAdd com base em commerce.productListAdds.
pl (variável products) são preenchidos com um valor concatenado com base em productListItems.
Há outras informações interessantes nesse evento, incluindo todos os dados de contexto.

Mapeamento com dados de contexto

Os dados XDM encaminhados para o Analytics são convertidos em dados de contexto, incluindo campos padrão e personalizados.

A chave de dados de contexto é construída seguindo esta sintaxe:

a.x.[xdm path]

Por exemplo:

// Standard Field
a.x.commerce.saveforlaters.value

// Custom Field
a.x._techmarketingdemos.appinformation.appstatedetails.screenname

NOTE

Campos personalizados são colocados sob o identificador Experience Cloud Org.

_techmarketingdemos é substituído pelo valor exclusivo de sua organização.

Para mapear esses dados de contexto XDM para seus dados do Analytics em seu conjunto de relatórios, você pode:

Usar um grupo de campos

Adicione o grupo de campos Extensão completa do Adobe Analytics ExperienceEvent ao esquema.
Crie cargas XDM no aplicativo, de acordo com o grupo de campos Extensão Completa do Adobe Analytics ExperienceEvent, de modo semelhante ao que você fez na lição Rastrear Dados do Evento, ou
Crie regras na propriedade Tags que usam ações de regra para anexar ou modificar dados ao grupo de campos Extensão completa do Adobe Analytics ExperienceEvent. Consulte para obter mais detalhes Anexar dados a eventos do SDK ou Modificar dados em eventos do SDK.

eVars de merchandising

Se você estiver usando eVars de merchandising na configuração do Analytics, por exemplo, para capturar a cor dos produtos, como &&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60, é necessário estender a carga XDM definida em Rastrear dados do evento para capturar essas informações de merchandising.

No JSON:

code language-json

code language-json
`{ "productListItems": [ { "SKU": "LLWS05.1-XS", "name": "Desiree Fitness Tee", "priceTotal": 24, "_experience": { "analytics": { "events1to100": { "event10": { "value": 50 } }, "customDimensions": { "eVars": { "eVar1": "red", } } } } } ], "eventType": "commerce.productListAdds", "commerce": { "productListAdds": { "value": 1 } } }`

{
  "productListItems": [
      {
          "SKU": "LLWS05.1-XS",
          "name": "Desiree Fitness Tee",
          "priceTotal": 24,
          "_experience": {
              "analytics": {
                  "events1to100": {
                      "event10": {
                          "value": 50
                      }
                  },
                  "customDimensions": {
                      "eVars": {
                          "eVar1": "red",
                      }
                  }
              }
          }
      }
  ],
  "eventType": "commerce.productListAdds",
  "commerce": {
      "productListAdds": {
          "value": 1
      }
  }
}

No código:

code language-swift

code language-swift
`var xdmData: [String: Any] = [ "productListItems": [ [ "name": productName, "SKU": sku, "priceTotal": priceString, "_experience" : [ "analytics": [ "events1to100": [ "event10": [ "value:": value ] ], "customDimensions": [ "eVars": [ "eVar1": color ] ] ] ] ] ], "eventType": "commerce.productViews", "commerce": [ "productViews": [ "value": 1 ] ] ]`

var xdmData: [String: Any] = [
  "productListItems": [
    [
      "name":  productName,
      "SKU": sku,
      "priceTotal": priceString,
      "_experience" : [
        "analytics": [
          "events1to100": [
            "event10": [
              "value:": value
            ]
          ],
          "customDimensions": [
            "eVars": [
              "eVar1": color
            ]
          ]
        ]
      ]
    ]
  ],
  "eventType": "commerce.productViews",
  "commerce": [
    "productViews": [
      "value": 1
    ]
  ]
]

Usar regras de processamento

Veja como uma regra de processamento usando esses dados pode ser exibida:

Você Substitui o valor de (1) Nome da Tela do Aplicativo (eVar 2) (2) pelo valor de a.x._techmarketingdemo.appinformation.appstatedetails.screenname (3) se a.x._techmarketingdemo.appinformation.appstatedetails.screenname (4) estiver definido (5).
Você Definir evento (6) Adicionar à Lista de Desejos (Evento 3) (7) a a.x.commerce.saveForLaters.value(Context) (8) se a.x.commerce.saveForLaters.value(Context) (9) estiver definido (10).

regras de processamento do analytics

IMPORTANT

Algumas das variáveis mapeadas automaticamente podem não estar disponíveis para uso nas regras de processamento.

Na primeira vez que você mapeia para uma regra de processamento, a interface não mostra as variáveis de dados de contexto do objeto XDM. Para corrigir isso, selecione qualquer valor, Salve e volte para editar. Todas as variáveis XDM agora devem aparecer.

Informações adicionais sobre regras de processamento e dados de contexto podem ser encontradas aqui.

TIP

Ao contrário de implementações anteriores do aplicativo móvel, não há distinção entre exibições de página/tela e outros eventos. Em vez disso, você pode incrementar a métrica Exibição de página definindo a dimensão Nome de página em uma regra de processamento. Como você está coletando o campo personalizado screenName no tutorial, é altamente recomendável mapear o nome da tela como Nome da Página em uma regra de processamento.

Migrar da extensão móvel do Analytics

Se você desenvolveu seu aplicativo móvel usando a extensão para dispositivos móveis do Adobe Analytics, provavelmente usou as chamadas de API MobileCore.trackAction e MobileCore.trackState.

Se você decidir migrar para usar o Edge Network recomendado, terá opções:

Implemente a extensão do Edge Network e use as Edge.sendEvent APIs, conforme ilustrado na lição sobre como Rastrear dados do evento. Este tutorial foca nesta implementação.
Implemente a extensão do Edge Bridge e continue usando suas chamadas de API MobileCore.trackAction e MobileCore.trackState. Consulte Implementar a extensão do Edge Bridge para obter mais detalhes e um tutorial separado.

SUCCESS

Você configurou o aplicativo para mapear os objetos XDM da Experience Edge para variáveis do Adobe Analytics, habilitando o serviço Adobe Analytics no fluxo de dados e usando regras de processamento, quando aplicável.
Obrigado por investir seu tempo aprendendo sobre o Adobe Experience Platform Mobile SDK. Se você tiver dúvidas, quiser compartilhar comentários gerais ou tiver sugestões sobre conteúdo futuro, compartilhe-os nesta postagem de Discussão da Comunidade Experience League.

Próximo: Enviar dados para o Experience Platform

recommendation-more-help

9fed61f5-c338-47ad-8005-0b89a5f4af8b