Show Menu
TÓPICOS×

Preparar dados para uso no Intelligent Services

Para que os Serviços inteligentes detectem insights de seus dados de eventos de marketing, os dados devem ser semanticamente enriquecidos e mantidos em uma estrutura padrão. Os Serviços inteligentes aproveitam os schemas do Experience Data Model (XDM) para conseguir isso. Especificamente, todos os conjuntos de dados usados no Intelligent Services devem estar em conformidade com o schema XDM Consumer ExperienceEvent (CEE) .
Este documento fornece orientação geral sobre como mapear os dados de seus eventos de marketing de vários canais para esse schema, descrevendo informações sobre campos importantes dentro do schema para ajudá-lo a determinar como mapear efetivamente seus dados para sua estrutura.

Como entender o schema CEE

O schema ExperienceEvent do consumidor descreve o comportamento de um indivíduo, pois ele se relaciona aos eventos de marketing digital (Web ou móveis), bem como à atividade de comércio online ou offline. O uso desse schema é necessário para os Serviços inteligentes devido aos campos semânticos bem definidos (colunas), evitando nomes desconhecidos que deixariam os dados menos claros.
Os Serviços inteligentes utilizam vários campos chave dentro desse schema para gerar insights dos dados de seus eventos de marketing, que podem ser encontrados no nível raiz e expandidos para mostrar os subcampos necessários.
Como todos os schemas XDM, a mistura CEE é extensível. Em outras palavras, campos adicionais podem ser adicionados à mistura CEE e variações diferentes podem ser incluídas em vários schemas, se necessário.
Um exemplo completo da mistura pode ser encontrado no repositório XDM público e deve ser usado como referência para os campos principais descritos na seção abaixo.

Campos principais

As seções abaixo destacam os principais campos da mistura CEE que devem ser utilizados para que os Serviços inteligentes gerem insights úteis, incluindo descrições e links para documentação de referência para mais exemplos.

xdm:canal

Este campo representa o canal de marketing relacionado ao ExperienceEvent. O campo inclui informações sobre o tipo de canal, o tipo de mídia e o tipo de local. Este campo _deve_ser fornecido para que a Atribuição AI funcione com seus dados .
Exemplo de schema
{
  "@id": "https://ns.adobe.com/xdm/channels/facebook-feed",
  "@type": "https://ns.adobe.com/xdm/channel-types/social",
  "xdm:mediaType": "earned",
  "xdm:mediaAction": "clicks"
}

Para obter informações completas sobre cada um dos subcampos obrigatórios para xdm:channel , consulte as especificações da experiência do schema do canal. Para obter alguns exemplos de mapeamentos, consulte a tabela abaixo .

Exemplos de mapeamentos de canal

A tabela a seguir fornece alguns exemplos de canais de marketing mapeados para o xdm:channel schema:
Canal
@type
mediaType
mediaAction
Pesquisa paga
https:/ /ns.adobe.com/xdm/canal-types/search
pago
clicks
Social - Marketing
https:/ /ns.adobe.com/xdm/canais-types/social
won
clicks
Exibir
https:/ /ns.adobe.com/xdm/canal-types/display
pago
clicks
Email
https:/ /ns.adobe.com/xdm/canal-types/email
pago
clicks
Quem indicou interna
https:/ /ns.adobe.com/xdm/canal-types/direct
proprietário
clicks
Exibir ViewThrough
https:/ /ns.adobe.com/xdm/canal-types/display
pago
impressões
Redirecionamento de código QR
https:/ /ns.adobe.com/xdm/canal-types/direct
proprietário
clicks
Dispositivo móvel
https:/ /ns.adobe.com/xdm/canal-types/mobile
proprietário
clicks

xdm:productListItems

Este campo é uma matriz de itens que representam os produtos selecionados por um cliente, incluindo o SKU do produto, o nome, o preço e a quantidade.
Exemplo de schema
[
  {
    "xdm:SKU": "1002352692",
    "xdm:name": "24-Watt 8-Light Chrome Integrated LED Bath Light",
    "xdm:currencyCode": "USD",
    "xdm:quantity": 1,
    "xdm:priceTotal": 159.45
  },
  {
    "xdm:SKU": "3398033623",
    "xdm:name": "16ft RGB LED Strips",
    "xdm:currencyCode": "USD",
    "xdm:quantity": 1,
    "xdm:priceTotal": 79.99
  }
]

Para obter informações completas sobre cada um dos subcampos obrigatórios para xdm:productListItems , consulte as especificações do schema de detalhes do comércio.

xdm:comércio

Este campo contém informações específicas de comércio sobre o ExperienceEvent, incluindo o número do pedido de compra e as informações de pagamento.
Exemplo de schema
{
    "xdm:order": {
      "xdm:purchaseID": "a8g784hjq1mnp3",
      "xdm:purchaseOrderNumber": "123456",
      "xdm:payments": [
        {
          "xdm:transactionID": "transactid-a111",
          "xdm:paymentAmount": 59,
          "xdm:paymentType": "credit_card",
          "xdm:currencyCode": "USD"
        },
        {
          "xdm:transactionId": "transactid-a222",
          "xdm:paymentAmount": 100,
          "xdm:paymentType": "gift_card",
          "xdm:currencyCode": "USD"
        }
      ],
      "xdm:currencyCode": "USD",
      "xdm:priceTotal": 159
    },
    "xdm:purchases": {
      "xdm:value": 1
    }
  }

Para obter informações completas sobre cada um dos subcampos obrigatórios para xdm:commerce , consulte as especificações do schema de detalhes do comércio.

xdm:web

Este campo representa detalhes da Web relacionados ao ExperienceEvent, como interação, detalhes da página e quem indicou.
Exemplo de schema
{
  "xdm:webPageDetails": {
    "xdm:siteSection": "Shopping Cart",
    "xdm:server": "example.com",
    "xdm:name": "Purchase Confirmation",
    "xdm:URL": "https://www.example.com/orderConf",
    "xdm:errorPage": false,
    "xdm:homePage": false,
    "xdm:pageViews": {
      "xdm:value": 1
    }
  },
  "xdm:webReferrer": {
    "xdm:URL": "https://www.example.com/checkout",
    "xdm:referrerType": "internal"
  }
}

Para obter informações completas sobre cada um dos subcampos obrigatórios para xdm:productListItems , consulte as especificações do schema de detalhes da Web ExperienceEvent.

xdm:marketing

Este campo contém informações relacionadas a atividades de marketing que estão ativas com o ponto de contato.
Exemplo de schema
{
  "xdm:trackingCode": "marketingcampaign111",
  "xdm:campaignGroup": "50%_DISCOUNT",
  "xdm:campaignName": "50%_DISCOUNT_USA"
}

Para obter informações completas sobre cada um dos subcampos obrigatórios para xdm:productListItems , consulte as especificações do setor de marketing .

Dados de mapeamento e assimilação

Depois de determinar se os dados de seus eventos de marketing podem ser mapeados para o schema CEE, você pode start o processo de inserir seus dados nos Serviços inteligentes. Entre em contato com os Serviços de consultoria da Adobe para ajudar a mapear seus dados para o schema e assimilá-los ao serviço.
Se você tiver uma subscrição da plataforma Adobe Experience e quiser mapear e assimilar os dados, siga as etapas descritas na seção abaixo.

Uso da plataforma Adobe Experience

As etapas abaixo exigem uma subscrição para a plataforma Experience. Se você não tiver acesso à Plataforma, pule para a seção de próximas etapas .
Esta seção descreve o fluxo de trabalho para mapear e assimilar dados na Experience Platform para uso em Serviços inteligentes, incluindo links para tutoriais para etapas detalhadas.

Criar um schema CEE e um conjunto de dados

Quando estiver pronto para o start preparando seus dados para ingestão, a primeira etapa é criar um novo schema XDM que emprega a combinação CEE. Os seguintes tutoriais acompanham o processo de criação de um novo schema na interface do usuário ou na API:
Os tutoriais acima seguem um fluxo de trabalho genérico para criar um schema. Ao escolher uma classe para o schema, você deve usar a classe ​XDM ExperienceEvent. Depois que essa classe for escolhida, você poderá adicionar a mistura CEE ao schema.
Depois de adicionar o mixin CEE ao schema, você pode adicionar outras combinações, conforme necessário, para campos adicionais em seus dados.
Depois de criar e salvar o schema, você pode criar um novo conjunto de dados com base nesse schema. Os seguintes tutoriais acompanham o processo de criação de um novo conjunto de dados na interface do usuário ou na API:

Mapear e assimilar dados

Depois de criar um schema CEE e um conjunto de dados, você pode fazer um start mapeando suas tabelas de dados para o schema e ingerir esses dados na Plataforma. Consulte o tutorial sobre como mapear um arquivo CSV para um schema XDM para obter etapas sobre como executar isso na interface do usuário. Depois que um conjunto de dados é preenchido, o mesmo conjunto de dados pode ser usado para assimilar arquivos de dados adicionais.

Próximas etapas

Este documento fornece orientação geral sobre como preparar seus dados para uso nos Serviços inteligentes. Se precisar de consultoria adicional com base no caso de uso, entre em contato com o Suporte de consultoria da Adobe.
Depois de preencher com êxito um conjunto de dados com os dados de experiência do cliente, você pode usar os Serviços inteligentes para gerar insights. Consulte os seguintes documentos para começar: