[Alpha]{class="badge informative"}

xdm (SDK do Servidor)

Esta página descreve xdm no método sendEvent do SDK do Servidor. Para o Web SDK, consulte xdm.

O objeto xdm contém os dados enviados à Adobe em uma estrutura que corresponde ao esquema Experience Data Model (XDM). Os campos definidos neste objeto são mapeados diretamente para campos no esquema do conjunto de dados para o qual o fluxo de dados envia dados.

Verifique se a hierarquia nesse objeto corresponde ao esquema do conjunto de dados configurado. Você pode incluir os objetos xdm e data na mesma chamada sendEvent.

O exemplo a seguir usa o grupo de campos de esquema de Detalhes do Commerce:

await visitor.sendEvent({
  xdm: {
    eventType: "commerce.productViews",
    identityMap: {
      Email: [{ id: "visitor@example.com", primary: true }]
    },
    commerce: {
      productViews: { value: 1 }
    },
    productListItems: [
      { SKU: "HT105", name: "Large field hat" },
      { SKU: "HT104", name: "Small field hat" }
    ]
  }
});

Incluir uma identidade principal primary-identity

Cada evento enviado pelo SDK do Servidor deve incluir uma identidade principal em xdm.identityMap. Em um navegador, o Edge Network pode identificar o visitante por meio de seus cookies. Em uma solicitação de servidor para servidor, é necessária uma identidade no próprio evento. Se nenhuma identidade no evento estiver marcada como primária, o Edge Network rejeitará o evento com o código de erro EXEG-0306-400 e sendEvent rejeitará.

Defina primary: true em exatamente uma identidade:

xdm: {
  identityMap: {
    Email: [
      { id: "visitor@example.com", primary: true }
    ],
    CRMID: [
      { id: "1234567" }
    ]
  }
}

Cada chave em identityMap é um namespace de identidade definido em sua organização, e cada valor é uma matriz de identidades nesse namespace. Consulte Using identityMap para obter mais informações.

Dados adicionados pela SDK automatic

O SDK adiciona xdm.implementationDetails a cada evento e pode adicionar xdm.web.webPageDetails.URL a partir do cabeçalho Referer da solicitação. Se você também definir xdm.web.webPageDetails.URL, seu valor será usado. Consulte Contexto e cabeçalhos encaminhados.

Se você definir as opções xdm.eventType e type, o valor em xdm.eventType será usado.

recommendation-more-help
experience-platform-help-collection