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.

Resumo do fluxo de trabalho

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

Preparação de dados externos

Se seus dados forem armazenados fora do Experience Platform, siga as etapas abaixo:
  1. Entre em contato com os Serviços de consultoria da Adobe para solicitar credenciais de acesso para um container dedicado do Armazenamento Blob do Azure.
  2. Usando suas credenciais de acesso, carregue seus dados no container Blob.
  3. Trabalhe com os Serviços de consultoria da Adobe para obter seus dados mapeados para o schema ExperienceEvent do consumidor e assimilados aos Serviços inteligentes.

Experience Platform preparação de dados

Se seus dados já estiverem armazenados em Platform, siga as etapas abaixo:
  1. Revise a estrutura do schema ExperienceEvent do consumidor e determine se os dados podem ser mapeados para seus campos.
  2. Entre em contato com os Serviços de consultoria da Adobe para ajudar a mapear seus dados para o schema e assimilá-los aos Serviços inteligentes, ou siga as etapas deste guia se desejar mapear os dados por conta própria.

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.
O schema CEE, como todos os schemas XDM ExperienceEvent, captura o estado baseado na série 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 fato do que ocorreu, e portanto são imutáveis e representam o que aconteceu sem agregação ou interpretação.
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

Há vários campos chave na combinação CEE que devem ser utilizados para que os Serviços inteligentes gerem informações ú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 a utilização de todos os campos principais seja altamente recomendada, há dois campos que são necessários para que os Serviços inteligentes funcionem:

Identidade primária

Um dos campos no seu schema deve ser definido como um campo de identidade principal, que permite que os Serviços inteligentes vinculem 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 dos dados. Um campo de identidade deve incluir uma namespace de identidade que indica o tipo de dados de identidade que o campo espera como um valor. Alguns valores de namespace válidos incluem:
  • "email"
  • "Telefone"
  • "mcid" (para IDs de Adobe Audience Manager)
  • "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.

xdm:timestamp

Esse 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:canal

Este campo é obrigatório somente ao usar a Atribuição 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 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:
Channel
@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

Campos recomendados

O restante dos campos principais são descritos nesta seção. Embora esses campos não sejam necessariamente necessários para que os Serviços inteligentes funcionem, é altamente recomendável que você use tantos deles quanto possível para obter insights mais ricos.

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 .

Mapeamento e assimilação de dados (#mapeamento)

Depois de determinar se os dados de seus eventos de marketing podem ser mapeados para o schema CEE, a próxima etapa é determinar quais dados você deve trazer para os Serviços inteligentes. Todos os dados históricos usados no Intelligent Services devem estar dentro do período mínimo de quatro meses de dados, além do número de dias planejado como um período de pesquisa.
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 schema e assimilá-los ao serviço.
Se você tiver uma Adobe Experience Platform subscrição e quiser mapear e assimilar os dados, siga as etapas descritas na seção abaixo.

Uso do Adobe Experience Platform

As etapas abaixo exigem uma subscrição. Se você não tiver acesso ao Platform, pule para a próxima seção de etapas .
Esta seção descreve o fluxo de trabalho para mapear e assimilar dados no 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:
Após a criação do conjunto de dados, é possível encontrá-lo na interface do usuário do Platform na área de trabalho Conjuntos de dados.

Adicionar uma tag de namespace de identidade primária ao conjunto de dados

As versões futuras dos Serviços inteligentes integrarão o Serviço de identificação de Adobe Experience Platform nos recursos de identificação do cliente. Assim, as etapas descritas abaixo estão sujeitas a alterações.
Se você estiver trazendo dados de Adobe Audience Manager, Adobe Analyticsou outra fonte externa, é necessário adicionar uma primaryIdentityNameSpace tag ao conjunto de dados. Isso pode ser feito fazendo uma solicitação PATCH para a API do serviço de catálogo.
Se você estiver assimilando dados de um arquivo CSV local, poderá pular para a próxima seção sobre mapeamento e assimilação de dados .
Antes de seguir com a chamada de API de exemplo abaixo, consulte a seção Guia do desenvolvedor do serviço de catálogo Introdução no guia do desenvolvedor do Catálogo para obter informações importantes sobre os cabeçalhos necessários.
Formato da API
PATCH /dataSets/{DATASET_ID}

Parâmetro
Descrição
{DATASET_ID}
A ID do conjunto de dados criado anteriormente.
Solicitação
Dependendo da fonte de onde você está assimilando dados, é necessário fornecer valores apropriados primaryIdentityNamespace e de sourceConnectorId tag na carga da solicitação.
A solicitação a seguir adiciona os valores de tag apropriados para Audience Manager:
curl -X PATCH \
  https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
        "tags": {
          "primaryIdentityNameSpace": ["mcid"],
          "sourceConnectorId": ["audiencemanager"],
        }
      }'

A solicitação a seguir adiciona os valores de tag apropriados para o Analytics:
curl -X PATCH \
  https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
        "tags": {
          "primaryIdentityNameSpace": ["aaid"],
          "sourceConnectorId": ["analytics"],
        }
      }'

Para obter mais informações sobre como trabalhar com namespaces de identidade no Platform, consulte a visão geral da namespace de identidade.
Resposta
Uma resposta bem-sucedida retorna uma matriz que contém a ID do conjunto de dados atualizado. Essa ID deve corresponder àquela enviada na solicitação PATCH.
[
    "@/dataSets/5ba9452f7de80400007fc52a"
]

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 no Platform. 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.
Se seus dados forem armazenados em um aplicativo de terceiros suportado, você também poderá optar por criar um conector de origem para assimilar seus dados de eventos de marketing ao Platform em tempo real.

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: