Preparar dados para usar em Intelligent Services

Para que Intelligent Services descubra insights de seus dados de eventos de marketing, os dados devem ser semanticamente enriquecidos e mantidos em uma estrutura padrão. Intelligent Services utilize os esquemas Experience Data Model (XDM) para fazer isso. Especificamente, todos os conjuntos de dados que são usados em Intelligent Services devem estar em conformidade com o esquema XDM Consumer ExperienceEvent (CEE) ou usar o conector do Adobe Analytics. Além disso, o Customer AI é compatível com o conector do Adobe Audience Manager.

Este documento fornece orientação geral sobre como mapear os dados de eventos de marketing de vários canais para o esquema CEE, destacando informações sobre campos importantes no esquema para ajudá-lo a determinar como mapear os dados de maneira eficaz para sua estrutura. Se você planeja usar dados do Adobe Analytics, visualize a seção para Preparação de dados do Adobe Analytics. Se você planeja usar os dados do Adobe Audience Manager (somente o Customer AI), visualize a seção para Preparação de dados do Adobe Audience Manager.

Requisitos de dados

Intelligent Services exigem quantidades diferentes de dados históricos, dependendo da meta que você criar. Independentemente disso, os dados que você preparar para all Intelligent Services devem incluir jornadas/eventos de cliente positivos e negativos. Ter eventos negativos e positivos melhora a precisão e a precisão do modelo.

Por exemplo, se estiver usando a AI do cliente para prever a propensão a comprar um produto, o modelo para a AI do cliente precisa de exemplos de caminhos de compra bem-sucedidos e exemplos de caminhos mal-sucedidos. Isso ocorre porque, durante o treinamento do modelo, o Customer AI procura entender quais eventos e jornadas levam a uma compra. Isso também inclui as ações executadas por clientes que não compraram, como um indivíduo que parou a jornada ao adicionar um item ao carrinho. No entanto, esses clientes podem exibir comportamentos semelhantes, a API do cliente pode fornecer insights e detalhar as principais diferenças e fatores que levam a uma pontuação de propensão mais alta. Da mesma forma, o Attribution AI requer ambos os tipos de eventos e jornadas para exibir métricas como eficácia do ponto de contato, principais caminhos de conversão e detalhamentos por posição do ponto de contato.

Para obter mais exemplos e informações sobre requisitos de dados históricos, visite a seção Customer AI ou Attribution AI requisitos de dados históricos na documentação de entrada/saída.

Diretrizes para compilar dados

É recomendável costurar os eventos de um usuário em uma id comum, quando possível. Por exemplo, você pode ter dados do usuário com "id1" em 10 eventos. Posteriormente, o mesmo usuário excluiu a id do cookie e é registrado como "id2" nos próximos 20 eventos. Se você sabe que id1 e id2 correspondem ao mesmo usuário, a prática recomendada é unir todos os 30 eventos a uma id comum.

Se isso não for possível, você deve tratar cada conjunto de eventos como um usuário diferente ao criar os dados de entrada do modelo. Isso garante os melhores resultados durante o treinamento e a pontuação do modelo.

Resumo do workflow

O processo de preparação varia dependendo se os dados são armazenados no Adobe Experience Platform ou externamente. Esta seção resume as etapas necessárias, tendo em conta qualquer um dos cenários.

Preparação de dados externos

Se os dados forem armazenados fora do Experience Platform, será necessário mapear os dados para os campos obrigatórios e relevantes em um Consumer ExperienceEvent schema. Esse esquema pode ser aumentado com grupos de campos personalizados para capturar melhor os dados do cliente. Depois de mapeado, você pode criar um conjunto de dados usando o esquema Consumer ExperienceEvent e assimilar seus dados na Platform. O conjunto de dados CEE pode ser selecionado ao configurar um Intelligent Service.

Dependendo do Intelligent Service que você deseja usar, podem ser necessários campos diferentes. Observe que é uma prática recomendada adicionar dados a um campo se você tiver os dados disponíveis. Para saber mais sobre os campos obrigatórios, visite o Attribution AI ou Guia de entrada/saída do Customer AI.

Preparação de dados do Adobe Analytics

O Customer AI e o Attribution AI oferecem suporte nativo aos dados da Adobe Analytics. Para usar os dados do Adobe Analytics, siga as etapas descritas na documentação para configurar um conector de origem do Analytics.

Depois que o conector de origem estiver transmitindo seus dados para o Experience Platform, você poderá selecionar o Adobe Analytics como fonte de dados, seguido por um conjunto de dados durante a configuração da sua instância. Todos os grupos de campos de esquema e campos individuais necessários são criados automaticamente durante a configuração da conexão. Não é necessário extrair, transformar, carregar (ETL) os conjuntos de dados no formato CEE.

IMPORTANTE

O conector Adobe Analytics leva até quatro semanas para preencher dados. Se você tiver configurado uma conexão recentemente, verifique se o conjunto de dados tem o comprimento mínimo de dados necessário para o Cliente ou o Attribution AI. Revise as seções de dados históricos em Customer AI ou Attribution AI, e verifique se você tem dados suficientes para sua meta de previsão.

Preparação de dados do Adobe Audience Manager (somente para o Customer AI)

O Customer AI oferece suporte nativo aos dados do Adobe Audience Manager. Para usar os dados do Audience Manager, siga as etapas descritas na documentação para configurar um conector de origem do Audience Manager.

Depois que o conector de origem estiver transmitindo seus dados para o Experience Platform, você poderá selecionar o Adobe Audience Manager como fonte de dados, seguido por um conjunto de dados durante a configuração do Customer AI. Todos os grupos de campos de esquema e campos individuais são criados automaticamente durante a configuração da conexão. Não é necessário extrair, transformar, carregar (ETL) os conjuntos de dados no formato CEE.

IMPORTANTE

Se você tiver configurado um conector recentemente, verifique se o conjunto de dados tem o comprimento mínimo de dados necessário. Revise a seção de dados históricos na documentação de entrada/saída para o Customer AI e verifique se você tem dados suficientes para o seu objetivo de previsão.

Experience Platform preparação de dados

Se os dados já estiverem armazenados em Platform e não forem transmitidos por meio dos conectores de origem Adobe Analytics ou Adobe Audience Manager (somente no Customer AI), siga as etapas abaixo. Ainda é recomendável entender o esquema CEE.

  1. Revise a estrutura do Consumer ExperienceEvent schema e determine se os dados podem ser mapeados para seus campos.
  2. Entre em contato com os Serviços de consultoria do Adobe para ajudar a mapear seus dados para o esquema e assimilá-los em Intelligent Services ou siga as etapas deste guia se desejar mapear os dados por conta própria.

Noções básicas sobre o esquema CEE

O schema Consumer ExperienceEvent descreve o comportamento de um indivíduo, pois está relacionado a eventos de marketing digital (Web ou dispositivos móveis), bem como a atividades de comércio online ou offline. O uso desse schema é necessário para Intelligent Services devido a seus campos semanticamente bem definidos (colunas), evitando quaisquer nomes desconhecidos que deixariam os dados menos claros.

O esquema CEE, como todos os esquemas XDM ExperienceEvent, captura o estado baseado em séries de tempo do sistema quando um evento (ou conjunto de eventos) ocorreu, incluindo o ponto no tempo e a identidade do assunto envolvido. Os Eventos de experiência são registros de fatos do que aconteceu e, portanto, são imutáveis e representam o que aconteceu sem agregação ou interpretação.

Intelligent Services utilize vários campos principais dentro desse esquema para gerar insights de seus dados de eventos de marketing, todos eles podem ser encontrados no nível raiz e expandidos para mostrar seus subcampos necessários.

Como todos os esquemas XDM, o grupo de campos do esquema CEE é extensível. Em outras palavras, campos adicionais podem ser adicionados ao grupo de campos CEE e diferentes variações podem ser incluídas em vários esquemas, se necessário.

Um exemplo completo do grupo de campos pode ser encontrado no repositório XDM público. Além disso, você pode visualizar e copiar o seguinte arquivo JSON para obter um exemplo de como os dados podem ser estruturados para estar em conformidade com o esquema CEE. Consulte ambos os exemplos enquanto aprende sobre os campos principais descritos na seção abaixo, para determinar como você pode mapear seus próprios dados para o esquema.

Campos principais

Há vários campos principais no grupo de campos CEE que devem ser utilizados para que Intelligent Services gere insights úteis. Esta seção descreve o caso de uso e os dados esperados para esses campos e fornece links para a documentação de referência para mais exemplos.

Campos obrigatórios

Embora o uso de todos os campos principais seja altamente recomendado, há dois campos que são necessários para que Intelligent Services funcione:

Identidade primária

Um dos campos no esquema deve ser definido como um campo de identidade primário, o que permite que Intelligent Services vincule cada instância dos dados da série de tempo a uma pessoa individual.

Você deve determinar o melhor campo a ser usado como uma identidade primária com base na fonte e na natureza de seus dados. Um campo de identidade deve incluir um namespace de identidade que indica o tipo de dados de identidade que o campo espera como um valor. Alguns valores válidos de namespace incluem:

  • "email"
  • "Telefone"
  • "mcid" (para Adobe Audience Manager IDs)
  • "aaid" (para Adobe Analytics IDs)

Se não tiver certeza de qual campo você deve usar como identidade primária, entre em contato com os Serviços de consultoria da Adobe para determinar a melhor solução. Se uma identidade primária não estiver definida, o aplicativo Serviço inteligente usará o seguinte comportamento padrão:

Padrão Attribution AI Customer AI
Coluna de identidade endUserIDs._experience.aaid.id endUserIDs._experience.mcid.id
Namespace AAID ECID

Para definir uma identidade primária, navegue até o esquema da guia Schemas e selecione o hiperlink do nome do esquema para abrir o Schema Editor.

Navegar para o esquema

Em seguida, navegue até o campo que deseja como uma identidade primária e selecione-o. O menu Field properties é aberto para esse campo.

Selecione o campo

No menu Field properties, role para baixo até encontrar a caixa de seleção Identity. Depois de marcar a caixa , a opção para definir a identidade selecionada como Identidade primária é exibida. Selecione essa caixa também.

Selecionar caixa de seleção

Em seguida, você deve fornecer um Namespace de identidade da lista de namespaces predefinidos na lista suspensa. Neste exemplo, o espaço de nome ECID é selecionado desde que uma Adobe Audience Manager ID mcid.id esteja sendo usada. Selecione Aplicar para confirmar as atualizações, em seguida, selecione Salvar no canto superior direito para salvar as alterações no esquema.

Salve as alterações

xdm:timestamp

Este campo representa a data e hora em que o evento ocorreu. Esse valor deve ser fornecido como uma string, de acordo com o padrão ISO 8601.

xdm:channel

OBSERVAÇÃO

Este campo é obrigatório somente ao usar o Attribution AI.

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.

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 necessários para xdm:channel, consulte a especificação experience channel schema. Para alguns exemplos de mapeamentos, consulte a tabela abaixo.

Exemplo de mapeamento de canal

A tabela a seguir fornece alguns exemplos de canais de marketing mapeados para o schema xdm:channel :

Canal @type mediaType mediaAction
Pesquisa paga https://ns.adobe.com/xdm/channel-types/search pago clicks
Social - Marketing https://ns.adobe.com/xdm/channel-types/social ganho cliques
Exibir https://ns.adobe.com/xdm/channel-types/display pago cliques
Email https://ns.adobe.com/xdm/channel-types/email pago cliques
Referenciador interno https://ns.adobe.com/xdm/channel-types/direct possuído cliques
Exibir ViewThrough https://ns.adobe.com/xdm/channel-types/display pago impressões
Redirecionamento do código QR https://ns.adobe.com/xdm/channel-types/direct possuído cliques
Dispositivo móvel https://ns.adobe.com/xdm/channel-types/mobile possuído cliques

Campos recomendados

O restante dos campos principais são descritos nesta seção. Embora esses campos não sejam necessariamente necessários para que Intelligent Services funcione, é altamente recomendável usar o máximo deles possível para obter insights mais ricos.

xdm:productListItems

Este campo é uma matriz de itens que representam produtos selecionados por um cliente, incluindo o SKU do produto, nome, preço e 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 necessários para xdm:productListItems, consulte a especificação commerce details schema .

xdm:commerce

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 necessários para xdm:commerce, consulte a especificação commerce details schema .

xdm:web

Este campo representa detalhes da Web relacionados ao ExperienceEvent, como a interação, detalhes da página e referenciador.

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 necessários para xdm:productListItems, consulte a especificação Detalhes da Web do ExperienceEvent .

xdm:marketing

Este campo contém informações relacionadas às 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 necessários para xdm:productListItems, consulte a especificação marketing schema .

Mapeamento e assimilação de dados

Depois de determinar se os dados dos eventos de marketing podem ser mapeados para o esquema CEE, a próxima etapa é determinar quais dados você deve trazer para Intelligent Services. Todos os dados históricos usados em Intelligent Services devem estar dentro da janela de tempo mínima de quatro meses de dados, mais o número de dias planejado como um período de lookback.

Depois de decidir o intervalo de dados que deseja enviar, entre em contato com os Serviços de consultoria da Adobe para ajudar a mapear seus dados para o esquema e assimilá-los no serviço.

Se você tiver uma assinatura Adobe Experience Platform e quiser mapear e assimilar os dados por conta própria, siga as etapas descritas na seção abaixo.

Uso do Adobe Experience Platform

OBSERVAÇÃO

As etapas abaixo exigem uma assinatura do Experience Platform. Se você não tiver acesso à Platform, pule para a seção próximas etapas.

Esta seção descreve o fluxo de trabalho para mapear e assimilar dados no Experience Platform para uso em Intelligent Services, incluindo links para tutoriais para etapas detalhadas.

Criar um esquema CEE e um conjunto de dados

Quando estiver pronto para começar a preparar seus dados para assimilação, a primeira etapa é criar um novo esquema XDM que emprega o grupo de campos CEE. Os seguintes tutoriais abordam o processo de criação de um novo schema na interface do usuário ou na API:

IMPORTANTE

Os tutoriais acima seguem um workflow genérico para criar um schema. Ao escolher uma classe para o esquema, você deve usar a classe XDM ExperienceEvent. Depois que essa classe tiver sido escolhida, você poderá adicionar o grupo de campos CEE ao schema.

Após adicionar o grupo de campos CEE ao schema, é possível adicionar outros grupos de campos, conforme necessário, para campos adicionais em seus dados.

Depois de criar e salvar o esquema, você pode criar um novo conjunto de dados com base nesse esquema. Os seguintes tutoriais abordam o processo de criação de um novo conjunto de dados na interface do usuário ou na API:

Depois que o conjunto de dados for criado, você poderá encontrá-lo na interface do usuário da plataforma no espaço de trabalho Datasets.

Adicionar campos de identidade ao conjunto de dados

Se estiver trazendo dados de Adobe Audience Manager, Adobe Analytics ou outra fonte externa, você terá a opção de definir um campo de esquema como um campo de identidade. Para definir um campo de esquema como um campo de identidade, visualize a seção sobre como definir campos de identidade dentro do tutorial da interface do usuário ou tutorial da API para criar um esquema.

Se estiver assimilando dados de um arquivo CSV local, você pode avançar para a próxima seção em mapear e assimilar dados.

Mapear e assimilar dados

Depois de criar um esquema CEE e um conjunto de dados, você pode começar a mapear as tabelas de dados para o esquema e assimilar esses dados na plataforma. Consulte o tutorial em mapping um arquivo CSV para um esquema XDM para obter etapas sobre como executar isso na interface do usuário. Você pode usar o seguinte arquivo JSON de amostra para testar o processo de assimilação antes de usar seus próprios dados.

Depois que um conjunto de dados é preenchido, o mesmo conjunto de dados pode ser usado para assimilar arquivos de dados adicionais.

Se os dados forem armazenados em um aplicativo de terceiros suportado, você também poderá optar por criar um conector de origem para assimilar os dados de eventos de marketing em Platform em tempo real.

Próximas etapas

Este documento forneceu orientação geral sobre como preparar seus dados para uso em Intelligent Services. Se precisar de consultoria adicional com base no seu caso de uso, entre em contato com o Suporte da Adobe Consulting.

Depois de preencher com êxito um conjunto de dados com os dados de experiência do cliente, você pode usar Intelligent Services para gerar insights. Consulte os seguintes documentos para começar:

Nesta página