이 페이지에서는 서버 SDK sendEvent 메서드의 xdm에 대해 설명합니다. 웹 SDK에 대해서는 xdm.을(를) 참조하십시오.
xdm 개체에는 XDM(Experience Data Model) 스키마와 일치하는 구조로 Adobe에 보내는 데이터가 포함되어 있습니다. 이 개체에 설정한 필드는 데이터 스트림에서 데이터를 보내는 데이터 집합 스키마의 필드에 직접 매핑됩니다.
이 개체의 계층 구조가 구성된 데이터 세트의 스키마와 일치하는지 확인하십시오. 동일한 sendEvent 호출에 xdm 개체와 data 개체를 모두 포함할 수 있습니다.
다음 예제에서는 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" }
]
}
});
기본 ID 포함 primary-identity
서버 SDK에서 전송하는 각 이벤트에는 xdm.identityMap에 기본 ID가 포함되어야 합니다. 브라우저에서 Edge Network은 쿠키에서 방문자를 식별할 수 있습니다. 서버 간 요청에서 이벤트 자체에 ID가 필요합니다. 이벤트에 기본 ID로 표시된 ID가 없으면 Edge Network에서 이벤트를 거부하며 오류 코드는 EXEG-0306-400이고 sendEvent이(가) 거부합니다.
정확히 하나의 ID에 primary: true을(를) 설정합니다.
xdm: {
identityMap: {
Email: [
{ id: "visitor@example.com", primary: true }
],
CRMID: [
{ id: "1234567" }
]
}
}
identityMap의 각 키는 조직에 정의된 ID 네임스페이스이며 각 값은 해당 네임스페이스의 ID 배열입니다. 자세한 내용은 identityMap 사용을 참조하십시오.
SDK이 추가하는 데이터 automatic
SDK은 모든 이벤트에 xdm.implementationDetails을(를) 추가하며 요청의 Referer 헤더에서 xdm.web.webPageDetails.URL을(를) 추가할 수 있습니다. xdm.web.webPageDetails.URL도 설정하면 해당 값이 사용됩니다. 컨텍스트 및 전달된 헤더를 참조하십시오.
xdm.eventType과(와) type 옵션을 모두 설정하면 xdm.eventType의 값이 사용됩니다.