Preparo de dados para a coleção de dados

Use o Data Prep, um serviço do Adobe Experience Platform, para mapear, transformar e validar dados de e para o Experience Data Model (XDM). Ao configurar uma sequência de dados habilitada para Experience Platform, você pode usar os recursos do Data Prep para mapear os dados de origem no XDM ao enviá-los para o Adobe Experience Platform Edge Network.

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 aborda a terceira opção.

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

O Preparo de dados para a coleção de dados é útil em duas situações:

Enviar uma camada de dados existente para a Edge Network via Web SDK send-datalayer-via-websdk

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

Se você estiver usando Tags, deverá usar o campo Data do tipo de ação Send Event.

O restante deste guia aborda como mapear a camada de dados para padrões XDM após ela ser enviada pelo Web SDK.

Este guia aborda como mapear seus dados na interface. Para concluir 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 Preparação de dados para coleção de dados, assista ao vídeo a seguir:

Fornecer dados de amostra select-data

Selecione Save and Add Mapping depois de concluir a configuração básica para uma sequência de dados, e a etapa Select data é exibida. Aqui, você deve fornecer um objeto JSON de amostra que represente a estrutura dos dados que planeja enviar para o Experience 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. Selecione Next para continuar.

Mapear seus dados mapping

A etapa Mapping é exibida, permitindo mapear os campos nos dados de origem para o esquema de evento de destino no Experience Platform. Aqui, é possível configurar o mapeamento de duas maneiras:

Criar regras de mapeamento create-mapping

Para criar uma regra de mapeamento, selecione Add new mapping.

Selecione o ícone de origem ( ) e, na caixa de diálogo exibida, selecione o campo de origem que você deseja mapear na tela fornecida. Depois de escolher um campo, use o botão Select 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 você deseja mapear os dados antes de confirmar com Select.

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

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 Import Mapping.

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 Preview.

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 o que você espera e selecione Import para confirmar e adicionar os mapeamentos ao novo fluxo de dados.

Concluir o mapeamento complete-mapping

Continue mapeando os campos restantes para o schema 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 Required fields 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 Save para finalizar as alterações.

Próximas etapas next-steps

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 de sequências de dados, agora pode retornar à etapa em exibindo detalhes da sequência de dados.