데이터 수집 알림

데이터를 Adobe Experience Platform에 수집하는 프로세스는 여러 단계로 구성됩니다. Platform에 수집해야 하는 데이터 파일을 식별하면 수집 프로세스가 시작되고 데이터가 성공적으로 수집되거나 실패할 때까지 각 단계가 연속적으로 발생합니다. 수집 프로세스는 Adobe Experience Platform 데이터 수집 API 또는 Experience Platform 사용자 인터페이스를 사용하여 시작할 수 있습니다.

Platform에 로드된 데이터는 대상, Data Lake 또는 Real-time Customer Profile 데이터 저장소에 도달하기 위해 여러 단계를 거쳐야 합니다. 각 단계에는 데이터를 처리하고, 데이터를 확인한 다음, 다음 단계로 전달하기 전에 데이터를 저장하는 작업이 포함됩니다. 수집되는 데이터의 양에 따라 시간이 많이 소요되는 프로세스가 될 수 있으며 유효성 검사, 의미 체계 또는 처리 오류로 인해 프로세스가 실패할 가능성이 항상 있습니다. 오류가 발생하는 경우 데이터 문제를 수정한 후 수정된 데이터 파일을 사용하여 전체 수집 프로세스를 다시 시작해야 합니다.

수집 프로세스 모니터링을 지원하기 위해 Experience Platform을(를) 통해 프로세스의 각 단계에서 게시되는 이벤트 세트에 가입할 수 있으며, 수집된 데이터의 상태와 가능한 실패를 알려줍니다.

데이터 수집 알림에 웹 후크 등록

데이터 수집 알림을 수신하려면 Adobe 개발자 콘솔을 사용하여 Experience Platform 통합에 웹 후크를 등록해야 합니다.

이 작업을 수행하는 방법에 대한 자세한 단계는 Adobe I/O Event notifications🔗에 가입하는 의 자습서를 따르십시오.

중요

구독 프로세스 중에 플랫폼 알림​을 이벤트 공급자로 선택하고 메시지가 표시되면 데이터 수집 알림 이벤트 구독을 선택합니다.

데이터 수집 알림 수신

웹 후크를 등록했고 새 데이터를 수집하면 이벤트 알림 수신을 시작할 수 있습니다. 이러한 이벤트는 웹 후크 자체를 사용하거나 Adobe 개발자 콘솔에서 프로젝트의 이벤트 등록 개요에서 디버그 추적 탭을 선택하여 볼 수 있습니다.

다음 JSON은 실패한 배치 수집 이벤트의 경우 웹 후크에 전송되는 알림 페이로드의 예입니다.

{
  "event_id": "93a5b11a-b0e6-4b29-ad82-81b1499cb4f2",
  "event": {
    "xdm:ingestionId": "01EGK8H8HF9JGFKNDCABHGA24G",
    "xdm:customerIngestionId": "01EGK8H8HF9JGFKNDCABHGA24G",
    "xdm:imsOrg": "{IMS_ORG}",
    "xdm:completed": 1598374341560,
    "xdm:datasetId": "5e55b556c2ae4418a8446037",
    "xdm:eventCode": "ing_load_failure",
    "xdm:sandboxName": "prod",
    "sentTime": "1598374341595",
    "processStartTime": 1598374342614,
    "transformedTime": 1598374342621,
    "header": {
      "_adobeio": {
        "imsOrgId": "{IMS_ORG}",
        "providerMetadata": "aep_observability_catalog_events",
        "eventCode": "platform_event"
      }
    }
  }
}
속성 설명
event_id 알림에 대한 고유한 시스템 생성 ID입니다.
event 알림을 트리거한 이벤트의 세부 정보가 포함된 객체입니다.
event.xdm:datasetId 수집 이벤트가 적용되는 데이터 세트의 ID입니다.
event.xdm:eventCode 데이터 집합에 대해 트리거된 이벤트 유형을 나타내는 상태 코드입니다. 특정 값과 해당 정의에 대해서는 부록을 참조하십시오.

이벤트 알림에 대한 전체 스키마를 보려면 공용 GitHub 저장소를 참조하십시오.

다음 단계

프로젝트에 Platform 알림을 등록했으면 프로젝트 개요에서 받은 이벤트를 볼 수 있습니다. 이벤트를 추적하는 방법에 대한 자세한 지침은 추적 Adobe I/O 이벤트에서 안내서를 참조하십시오.

부록

다음 섹션에는 데이터 수집 알림 페이로드 해석에 대한 추가 정보가 포함되어 있습니다.

사용 가능한 상태 알림 이벤트

다음 표에는 구독할 수 있는 사용 가능한 데이터 수집 상태 알림이 나열되어 있습니다.

이벤트 코드 플랫폼 서비스 상태 이벤트 설명
ing_load_success Data Ingestion success 일괄 처리를 Data Lake 내의 데이터 세트에 수집했습니다.
ing_load_failure Data Ingestion 실패 일괄 처리를 Data Lake 내의 데이터 세트에 수집하지 못했습니다.
ps_load_success Real-time Customer Profile 성공 일괄 처리를 Profile 데이터 저장소에 수집했습니다.
ps_load_failure Real-time Customer Profile 실패 일괄 처리를 Profile 데이터 저장소에 수집하지 못했습니다.
ig_load_success Identity Service 성공 데이터가 ID 그래프에 로드되었습니다.
ig_load_failure Identity Service 실패 데이터를 ID 그래프에 로드하지 못했습니다.
노트

모든 데이터 수집 알림에 대해 제공되는 이벤트 항목은 하나뿐입니다. 서로 다른 상태를 구분하기 위해 이벤트 코드를 사용할 수 있습니다.

이 페이지에서는