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:

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:

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.

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.

{
  "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.

{
  "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.

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.

Selecione o í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.

Em seguida, selecione o í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.

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.

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.

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.

Para começar, selecione Importar mapeamento.

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.

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.

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.

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.