Preparo de dados para a coleção de dados

O Preparo de dados é um serviço da Adobe Experience Platform que permite mapear, transformar e validar dados de e para o Experience Data Model (XDM). Ao configurar uma sequência de dados habilitada pela Platform, você pode usar os recursos do Preparo de dados para mapear os dados de origem no XDM durante o envio desses dados para a rede de borda da Platform.

Todos os dados enviados de uma página da Web devem chegar ao Experience Platform como XDM. Há três maneiras de traduzir dados de uma camada de dados na página para o XDM aceito pelo Experience Platform:

  1. Reformate a camada de dados no XDM na própria página da Web.
  2. Use a funcionalidade de elementos de dados nativos das tags para reformatar o formato de camada de dados existente de uma página da Web no XDM.
  3. Reformate um formato de camada de dados existente da página da Web no XDM por meio do Edge Network, usando o Preparo de dados para coleção de dados.

Este guia foca na 3ª opção.

Quando usar o Preparo de dados para a coleção de dados when-to-use-data-prep

Há dois casos de uso em que o Preparo de dados para a coleção de dados é útil:

  1. O site tem uma camada de dados bem formada, controlada e mantida, e há uma preferência por enviá-la diretamente para o Edge Network em vez de usar a manipulação do JavaScript para convertê-la em XDM na página (por meio de elementos de dados de tags ou por manipulação manual do JavaScript).
  2. Um sistema de marcação diferente de Tags é implantado no site.

Enviar uma camada de dados existente para o Edge Network via WebSDK send-datalayer-via-websdk

A camada de dados existente deve ser enviada usando o objeto data dentro do comando sendEvent.

Se você estiver usando Marcas, deverá usar o campo Dados do tipo de ação Enviar Evento, conforme descrito na documentação da extensão de marca do SDK da Web.

O restante deste guia enfocará como mapear a camada de dados para padrões XDM após ter sido enviada pelo WebSDK.

NOTE
Para obter uma orientação abrangente sobre todos os recursos do Preparo de dados, incluindo funções de transformação para campos calculados, consulte a seguinte documentação:

Este guia aborda como mapear seus dados na interface. Para acompanhar as etapas, inicie o processo de criação de uma sequência de dados até (e incluindo) a etapa de configuração básica.

Para obter uma demonstração rápida do processo de preparo de dados para a coleção de dados, assista ao vídeo a seguir:

Selecionar dados select-data

Selecione Salvar e adicionar mapeamento após concluir a configuração básica de uma sequência de dados e a etapa Selecionar dados será exibida. Aqui, você deve fornecer um objeto JSON de amostra que represente a estrutura dos dados que planeja enviar para a Platform.

Para capturar propriedades diretamente da camada de dados, o objeto JSON deve ter uma única propriedade raiz data. As subpropriedades do objeto data devem ser construídas de uma forma que mapeie para as propriedades da camada de dados que você deseja capturar. Selecione a seção abaixo para ver um exemplo de objeto JSON formatado corretamente com um objeto data raiz.

Arquivo JSON de amostra com objeto data raiz
code language-json
{
  "data": {
    "eventMergeId": "cce1b53c-571f-4f36-b3c1-153d85be6602",
    "eventType": "view:load",
    "timestamp": "2021-09-30T14:50:09.604Z",
    "web": {
      "webPageDetails": {
        "siteSection": "Product section",
        "server": "example.com",
        "name": "product home",
        "URL": "https://www.example.com"
      },
      "webReferrer": {
        "URL": "https://www.adobe.com/index2.html",
        "type": "external"
      }
    },
    "commerce": {
      "purchase": 1,
      "order": {
        "orderID": "1234"
      }
    },
    "product": [
      {
        "productInfo": {
          "productID": "123"
        }
      },
      {
        "productInfo": {
          "productID": "1234"
        }
      }
    ],
    "reservation": {
      "id": "anc45123xlm",
      "name": "Embassy Suits",
      "SKU": "12345-L",
      "skuVariant": "12345-LG-R",
      "priceTotal": "112.99",
      "currencyCode": "USD",
      "adults": 2,
      "children": 3,
      "productAddMethod": "PDP",
      "_namespace": {
        "test": 1,
        "priceTotal": "112.99",
        "category": "Overnight Stay"
      },
      "freeCancellation": false,
      "cancellationFee": 20,
      "refundable": true
    }
  }
}

Para capturar propriedades de um elemento de dados de objeto XDM, as mesmas regras se aplicam ao objeto JSON, mas a propriedade raiz deve ser identificada como xdm. Selecione a seção abaixo para ver um exemplo de objeto JSON formatado corretamente com um objeto xdm raiz.

Arquivo JSON de amostra com objeto xdm raiz
code language-json
{
  "xdm": {
    "environment": {
      "type": "browser",
      "browserDetails": {
        "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_5) AppleWebkit/537.36 (KHTML, like Gecko) Chrome/49.0.2623.112 Safari/537.36",
        "javaScriptEnabled": true,
        "javaScriptVersion": "1.8.5",
        "cookiesEnabled": true,
        "viewportHeight": 900,
        "viewportWidth": 1680,
        "javaEnabled": true
      },
      "domain": "adobe.com",
      "colorDepth": 24,
      "viewportHeight": 1050,
      "viewportWidth": 1680
    },
    "device": {
      "screenHeight": 1050,
      "screenWidth": 1680
    }
  }
}

Você pode selecionar a opção para fazer upload do objeto como um arquivo ou colar o objeto bruto na caixa de texto fornecida. Se o JSON for válido, um esquema de visualização será exibido no painel direito. Clique em Avançar para continuar.

Amostra JSON dos dados de entrada esperados.

NOTE
Use um objeto JSON de amostra que represente cada elemento de camada de dados que pode ser usado em qualquer página. Por exemplo, nem todas as páginas usam elementos de camada de dados do carrinho de compras. No entanto, os elementos da camada de dados do carrinho de compras devem ser incluídos nesta amostra de objeto JSON.

Mapeamento

A etapa Mapeamento é exibida, permitindo mapear os campos nos dados de origem para o esquema de evento de público alvo na Platform. Aqui, é possível configurar o mapeamento de duas maneiras:

Criar regras de mapeamento create-mapping

Para criar uma regra de mapeamento, selecione Adicionar novo mapeamento.

Adicionando um novo mapeamento.

Selecione o ícone de origem ( Ícone de origem ) e, na caixa de diálogo exibida, selecione o campo de origem que deseja mapear na tela fornecida. Depois de escolher um campo, use o botão Selecionar para continuar.

Selecionando o campo a ser mapeado no esquema de origem.

Em seguida, selecione o ícone de esquema ( Ícone de esquema ) para abrir uma caixa de diálogo semelhante para o esquema de evento de destino. Escolha o campo para o qual deseja mapear os dados antes de confirmar com Selecionar.

Selecionando o campo a ser mapeado no esquema de destino.

A página de mapeamento é exibida novamente com o mapeamento do campo concluído. A seção Progresso do mapeamento é atualizada para refletir o número total de campos que foram mapeados com sucesso.

Campo mapeado com êxito com progresso refletido.

TIP
Se quiser mapear uma matriz de objetos (no campo de origem) para uma matriz de objetos diferentes (no campo de destino), adicione [*] após o nome da matriz nos caminhos dos campos de origem e destino, conforme mostrado abaixo.
Mapeamento de objeto de matriz.

Importar regras de mapeamento existentes import-mapping

Se você tiver criado um fluxo de dados anteriormente, poderá reutilizar suas regras de mapeamento configuradas para um novo fluxo de dados.

WARNING
A importação de regras de mapeamento de outro fluxo de dados substitui todos os mapeamentos de campo que você tenha adicionado antes da importação.

Para começar, selecione Importar mapeamento.

Botão Importar Mapeamento sendo selecionado.

Na caixa de diálogo exibida, selecione a sequência de dados cujas regras de mapeamento você deseja importar. Depois que a sequência de dados for escolhida, selecione Visualizar.

Selecionando uma sequência de dados existente.

NOTE
As sequências de dados só podem ser importadas dentro da mesma sandbox. Em outras palavras, não é possível importar uma sequência de dados de uma sandbox para outra.

A próxima tela mostra uma visualização das regras de mapeamento salvas para a sequência de dados selecionada. Verifique se os mapeamentos exibidos são os esperados e selecione Importar para confirmar e adicionar os mapeamentos à nova sequência de dados.

Regras de mapeamento a serem importadas.

NOTE
Se algum campo de origem das regras de mapeamento importadas não estiver incluído nos dados JSON de amostra que você forneceu anteriormente, esses mapeamentos de campo não serão incluídos na importação.

Concluir o mapeamento

Para continuar, siga as etapas acima para mapear o restante dos campos para o esquema de destino. Embora não seja necessário mapear todos os campos de origem disponíveis, todos os campos no esquema de destino definidos como obrigatório devem ser mapeados para concluir esta etapa. O contador Campos obrigatórios indica quantos campos obrigatórios ainda não estão mapeados na configuração atual.

Quando a contagem de campos necessária atingir zero e você estiver satisfeito com o mapeamento, selecione Salvar para finalizar as alterações.

Mapeamento concluído

Próximas etapas

Este guia abordou como mapear seus dados para o XDM ao configurar uma sequência de dados na interface. Se você estava seguindo o tutorial geral para sequências de dados, agora pode retornar à etapa sobre visualizar detalhes da sequência de dados.

recommendation-more-help
c4bd45d4-a044-4e32-94ad-5e2f71800fac