부분 일괄 처리

부분 일괄 처리란 오류가 포함된 데이터를 특정 임계값까지 인제스트하는 기능입니다. 이 기능을 사용하면 모든 정확한 데이터를 Adobe Experience Platform으로 성공적으로 인제스트할 수 있으며 모든 잘못된 데이터가 잘못된 이유에 대한 세부 정보와 함께 별도로 일괄적으로 묶을 수 있습니다.

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

시작하기

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

  • 일괄 처리:CSV 및 Platform Portable과 같은 데이터 파일의 데이터를 인제스트하고 저장하는 방법입니다.
  • Experience Data Model (XDM):고객 경험 데이터를 Platform 구성하는 표준화된 프레임워크

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

샘플 API 호출 읽기

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

필수 헤더에 대한 값 수집

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

  • 인증:Bearer {ACCESS_TOKEN}
  • x-api-key:{API_KEY}
  • x-gw-ims-org-id:{IMS_ORG}

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

  • x-sandbox-name:{SANDBOX_NAME}
노트

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

API에서 부분 일괄 처리를 활성화합니다.

노트

이 섹션에서는 API를 사용하여 부분 일괄 처리를 위한 일괄 처리를 활성화하는 방법에 대해 설명합니다. UI 사용에 대한 지침은 UI](#enable-ui) 단계에서 부분 일괄 처리를 위한 일괄 처리 활성화를 참조하십시오.[

부분 처리가 활성화된 새 배치를 만들 수 있습니다.

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

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercentage": 5
}
속성 설명
enableErrorDiagnostics Platform이(가) 일괄 처리에 대한 자세한 오류 메시지를 생성할 수 있도록 하는 플래그.
partialIngestionPercentage 전체 배치가 실패하기 전에 허용되는 오류 비율. 따라서 이 예에서는 일괄 처리가 실패하기 전에 최대 5%의 일괄 처리가 오류일 수 있습니다.

UI에서 부분 일괄 처리를 활성화합니다.

노트

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

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

새 소스 연결만들기

새 소스 연결을 만들려면 소스 개요에 나열된 단계를 수행합니다. 데이터 흐름 세부 정보 단계에 도달하면 부분 통합오류 진단 필드를 참고합니다.

부분 통합 토글을 사용하면 부분 일괄 처리 통합 사용을 활성화 또는 비활성화할 수 있습니다.

오류 진단 토글은 부분 통합 토글이 꺼져 있을 때만 나타납니다. 이 기능을 사용하면 Platform에서 인제스트된 배치에 대한 자세한 오류 메시지를 생성할 수 있습니다. 부분 통합 토글이 켜져 있으면 향상된 오류 진단이 자동으로 적용됩니다.

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

기존 데이터 집합사용

기존 데이터 세트를 사용하려면 먼저 데이터 세트를 선택합니다. 오른쪽의 세로 막대는 데이터 세트에 대한 정보를 채웁니다.

부분 통합 토글을 사용하면 부분 일괄 처리 통합 사용을 활성화 또는 비활성화할 수 있습니다.

오류 진단 토글은 부분 통합 토글이 꺼져 있을 때만 나타납니다. 이 기능을 사용하면 Platform에서 인제스트된 배치에 대한 자세한 오류 메시지를 생성할 수 있습니다. 부분 통합 토글이 켜져 있으면 향상된 오류 진단이 자동으로 적용됩니다.

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

이제 데이터 추가 단추를 사용하여 데이터를 업로드할 수 있으며 부분 섭취를 사용하여 인제스트됩니다.

"CSV를 XDM 스키마" 흐름사용

"CSV를 XDM 스키마" 흐름을 사용하려면 CSV 파일 매핑 자습서에 나열된 단계를 따르십시오. 데이터 추가 단계에 도달하면 부분 통합오류 진단 필드에 주의하십시오.

부분 통합 토글을 사용하면 부분 일괄 처리 통합 사용을 활성화 또는 비활성화할 수 있습니다.

오류 진단 토글은 부분 통합 토글이 꺼져 있을 때만 나타납니다. 이 기능을 사용하면 Platform에서 인제스트된 배치에 대한 자세한 오류 메시지를 생성할 수 있습니다. 부분 통합 토글이 켜져 있으면 향상된 오류 진단이 자동으로 적용됩니다.

오류 임계값을 사용하면 전체 배치가 실패하기 전에 허용되는 오류 비율을 설정할 수 있습니다. 기본적으로 이 값은 5%로 설정됩니다.

다음 단계

이 자습서에서는 데이터 세트를 만들거나 수정하여 부분 일괄 처리를 활성화하는 방법에 대해 다룹니다. 일괄 처리에 대한 자세한 내용은 일괄 처리 통합 개발자 가이드를 참조하십시오.

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

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free