설명서 Experience Platform Data Ingestion 안내서

부분 일괄 처리 수집

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
데이터 수집

작성 대상:

개발자

부분 일괄 처리 수집은 특정 임계값까지 오류가 포함된 데이터를 수집하는 기능입니다. 이 기능을 사용하면 잘못된 데이터가 있는 이유와 함께, 모든 잘못된 데이터가 따로 일괄 처리되는 동안 모든 올바른 데이터를 Adobe Experience Platform에 성공적으로 수집할 수 있습니다.

이 문서에서는 부분 일괄 처리 수집 관리에 대한 자습서를 제공합니다.

시작하기

이 자습서에서는 부분 일괄 처리 수집과 관련된 다양한 Adobe Experience Platform 서비스에 대한 작업 지식이 필요합니다. 이 자습서를 시작하기 전에 다음 서비스에 대한 설명서를 검토하십시오.

일괄 처리 수집: Platform에서 CSV 및 Parquet와 같은 데이터 파일에서 데이터를 수집하고 저장하는 메서드입니다.
Experience Data Model (XDM): Platform에서 고객 경험 데이터를 구성하는 표준화된 프레임워크입니다.

다음 섹션에서는 Platform API를 성공적으로 호출하기 위해 알아야 하는 추가 정보를 제공합니다.

샘플 API 호출 읽기

이 안내서에서는 요청 형식을 지정하는 방법을 보여 주는 예제 API 호출을 제공합니다. 여기에는 경로, 필수 헤더 및 적절한 형식의 요청 페이로드가 포함됩니다. API 응답에서 반환되는 샘플 JSON도 제공됩니다. 샘플 API 호출에 대한 설명서에 사용된 규칙에 대한 자세한 내용은 Experience Platform 문제 해결 안내서의 예제 API 호출을 읽는 방법에 대한 섹션을 참조하십시오.

필수 헤더에 대한 값 수집

Platform API를 호출하려면 먼저 인증 자습서를 완료해야 합니다. 인증 튜토리얼을 완료하면 아래와 같이 모든 Experience Platform API 호출의 필수 헤더 각각에 대한 값이 제공됩니다.

인증: 전달자 {ACCESS_TOKEN}
x-api 키: {API_KEY}
x-gw-ims-org-id: {ORG_ID}

Experience Platform의 모든 리소스는 특정 가상 샌드박스로 격리되어 있습니다. Platform API에 대한 모든 요청에는 작업이 수행될 샌드박스의 이름을 지정하는 헤더가 필요합니다.

x-sandbox-name: {SANDBOX_NAME}

NOTE

Platform의 샌드박스에 대한 자세한 내용은 샌드박스 개요 설명서를 참조하십시오.

API에서 부분 일괄 처리 수집에 대한 일괄 처리 활성화 enable-api

NOTE

이 섹션에서는 API를 사용하여 부분 일괄 처리 수집에 대한 일괄 처리를 활성화하는 방법에 대해 설명합니다. UI 사용에 대한 지침은 UI에서 부분 일괄 처리 수집에 대한 일괄 처리 활성화 단계를 참조하십시오.

부분 수집이 활성화된 새 배치를 생성할 수 있습니다.

새 일괄 처리를 만들려면 일괄 처리 수집 개발자 안내서의 단계를 따릅니다. 일괄 처리 만들기 단계에 도달하면 다음 필드를 요청 본문에 추가합니다.

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercent": 5
}

속성

설명

enableErrorDiagnostics

Platform에서 일괄 처리에 대한 자세한 오류 메시지를 생성할 수 있는 플래그입니다.

partialIngestionPercent

전체 일괄 처리 전에 허용되는 오류의 백분율입니다. 따라서 이 예에서 최대 5%의 배치가 오류일 수 있지만 실패하게 됩니다.

UI에서 부분 일괄 처리 수집에 대한 일괄 처리 활성화 enable-ui

NOTE

이 섹션에서는 UI를 사용하여 부분 일괄 처리 수집에 대한 일괄 처리를 활성화하는 방법에 대해 설명합니다. API를 사용하여 부분 일괄 처리 수집에 대한 일괄 처리를 이미 활성화한 경우 다음 섹션으로 건너뛸 수 있습니다.

Platform UI를 통해 부분 수집에 대한 일괄 처리를 활성화하려면 소스 연결을 통해 새 일괄 처리를 만들거나 기존 데이터 세트에서 새 일괄 처리를 만들거나 "CSV를 XDM 흐름에 매핑"을 통해 새 일괄 처리를 만들 수 있습니다.

새 소스 연결 만들기 new-source

새 원본 연결을 만들려면 원본 개요에 나열된 단계를 따릅니다. 데이터 흐름 세부 정보 단계에 도달하면 부분 수집 및 오류 진단 필드를 참고하십시오.

부분 수집 전환을 사용하면 부분 일괄 처리 수집을 사용하거나 사용하지 않도록 설정할 수 있습니다.

오류 진단 전환은 부분 수집 전환이 꺼진 경우에만 나타납니다. 이 기능을 사용하면 Platform에서 수집된 일괄 처리에 대한 자세한 오류 메시지를 생성할 수 있습니다. 부분 수집 토글이 켜져 있으면 향상된 오류 진단이 자동으로 적용됩니다.

오류 임계값 을(를) 사용하면 전체 일괄 처리가 실패하기 전에 허용되는 오류의 백분율을 설정할 수 있습니다. 기본적으로 이 값은 5%로 설정됩니다.

기존 데이터 세트 사용 existing-dataset

기존 데이터 세트를 사용하려면 데이터 세트를 선택하여 시작합니다. 오른쪽의 사이드바는 데이터 세트에 대한 정보로 채워집니다.

부분 수집 전환을 사용하면 부분 일괄 처리 수집을 사용하거나 사용하지 않도록 설정할 수 있습니다.

이제 데이터 추가 단추를 사용하여 데이터를 업로드할 수 있으며 부분 수집을 사용하여 수집됩니다.

"XDM 스키마에 CSV 매핑" 흐름 사용 map-flow

"CSV를 XDM 스키마에 매핑" 흐름을 사용하려면 CSV 파일 매핑 자습서의 나열된 단계를 따릅니다. 데이터 추가 단계에 도달하면 부분 수집 및 오류 진단 필드를 참고하십시오.

부분 수집 전환을 사용하면 부분 일괄 처리 수집을 사용하거나 사용하지 않도록 설정할 수 있습니다.

다음 단계 next-steps

이 튜토리얼에서는 부분 일괄 처리 수집을 활성화하기 위해 데이터 세트를 만들거나 수정하는 방법을 다룹니다. 일괄 처리 수집에 대한 자세한 내용은 일괄 처리 수집 개발자 안내서를 참조하십시오.

부분 수집 오류 모니터링에 대한 자세한 내용은 일괄 처리 수집 오류 진단 안내서를 참조하십시오.

recommendation-more-help

2ee14710-6ba4-4feb-9f79-0aad73102a9a