설명서 Experience Platform Data Ingestion 안내서

스트리밍 수집 문제 해결 안내서

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

주제:
데이터 수집

작성 대상:

개발자

이 문서에서는 Adobe Experience Platform의 스트리밍 수집에 대한 FAQ에 대한 답변을 제공합니다. 모든 Platform API에서 발생하는 문제를 포함하여 다른 Platform 서비스와 관련된 질문 및 문제 해결은 Experience Platform 문제 해결 가이드를 참조하십시오.

Adobe Experience Platform Data Ingestion은(는) 데이터를 Experience Platform (으)로 수집하는 데 사용할 수 있는 RESTful API를 제공합니다. 수집된 데이터는 거의 실시간으로 개별 고객 프로필을 업데이트하는 데 사용되므로 여러 채널에 걸쳐 개인화되고 관련성 있는 경험을 제공할 수 있습니다. 서비스 및 다양한 수집 방법에 대한 자세한 내용은 데이터 수집 개요를 참조하십시오. 스트리밍 수집 API 사용 방법에 대한 단계는 스트리밍 수집 개요를 참조하십시오.

FAQ

다음은 스트리밍 수집에 대한 FAQ에 대한 답변 목록입니다.

보내는 페이로드의 형식이 제대로 지정되었는지 어떻게 알 수 있습니까?

Data Ingestion은(는) Experience Data Model (XDM) 스키마를 사용하여 들어오는 데이터의 형식을 확인합니다. 사전 정의된 XDM 스키마의 구조를 준수하지 않는 데이터를 보내면 수집이 실패합니다. XDM 및 Experience Platform에서의 사용에 대한 자세한 내용은 XDM 시스템 개요를 참조하십시오.

스트리밍 수집은 동기와 비동기라는 두 가지 유효성 검사 모드를 지원합니다. 각 유효성 검사 방법은 실패한 데이터를 다르게 처리합니다.

개발 프로세스 중에 동기 유효성 검사 를 사용해야 합니다. 유효성 검사에 실패한 레코드가 삭제되고 실패한 이유에 대한 오류 메시지가 반환됩니다(예: "잘못된 XDM 메시지 형식").

비동기 유효성 검사 는 프로덕션에서 사용해야 합니다. 유효성 검사를 통과하지 못한 잘못된 형식의 데이터는 실패한 일괄 처리 파일로 Data Lake에 보내집니다. 이 파일은 나중에 추가 분석을 위해 검색할 수 있습니다.

동기 및 비동기 유효성 검사에 대한 자세한 내용은 스트리밍 유효성 검사 개요를 참조하십시오. 유효성 검사에 실패한 일괄 처리를 보는 방법에 대한 단계는 실패한 일괄 처리 검색에 대한 안내서를 참조하십시오.

Platform에 보내기 전에 요청 페이로드의 유효성을 검사할 수 있습니까?

요청 페이로드는 Platform (으)로 전송된 후에만 평가할 수 있습니다. 동기 유효성 검사를 수행할 때 유효한 페이로드는 채워진 JSON 개체를 반환하고 잘못된 페이로드는 오류 메시지를 반환합니다. 비동기 유효성 검사 중에 서비스는 형식이 잘못된 데이터를 감지하여 나중에 분석을 위해 검색할 수 있는 Data Lake (으)로 보냅니다. 자세한 내용은 스트리밍 유효성 검사 개요를 참조하십시오.

이를 지원하지 않는 에지에서 동기 유효성 검사가 요청되면 어떻게 됩니까?

요청된 위치에 대해 동기 유효성 검사가 지원되지 않으면 501 오류 응답이 반환됩니다. 동기 유효성 검사에 대한 자세한 내용은 스트리밍 유효성 검사 개요를 참조하십시오.

신뢰할 수 있는 소스에서만 데이터가 수집되도록 하려면 어떻게 해야 합니까?

Experience Platform에서 보안 데이터 수집을 지원합니다. 인증된 데이터 수집이 활성화되면 클라이언트는 JSON 웹 토큰(JWT) 및 조직 ID를 요청 헤더로 보내야 합니다. 인증된 데이터를 Platform (으)로 보내는 방법에 대한 자세한 내용은 인증된 데이터 수집에 대한 안내서를 참조하십시오.

Real-Time Customer Profile (으)로 데이터를 스트리밍하는 데 얼마나 걸립니까?

스트리밍된 이벤트는 일반적으로 60초 이내에 Real-Time Customer Profile에 반영됩니다. 실제 대기 시간은 데이터 볼륨, 메시지 크기 및 대역폭 제한으로 인해 달라질 수 있습니다.

동일한 API 요청에 여러 메시지를 포함할 수 있습니까?

단일 요청 페이로드 내에서 여러 메시지를 그룹화하여 Platform에 스트리밍할 수 있습니다. 올바르게 사용하는 경우 단일 요청 내에서 여러 메시지를 그룹화하는 것은 데이터 작업을 최적화하는 훌륭한 방법입니다. 자세한 내용은 요청에서 여러 메시지 보내기에 대한 자습서를 참조하십시오.

보내는 데이터가 수신되는지 어떻게 알 수 있습니까?

Platform (또는 다른 방식으로)로 전송된 모든 데이터는 데이터 세트에서 유지되기 전에 배치 파일로 저장됩니다. 배치의 처리 상태는 배치가 전송된 데이터 세트 내에 나타납니다.

Experience Platform 사용자 인터페이스를 사용하여 데이터 집합 활동을 검사하여 데이터가 성공적으로 수집되었는지 확인할 수 있습니다. 데이터 세트 목록을 표시하려면 왼쪽 탐색에서 데이터 세트 를 클릭하십시오. 표시된 목록에서 스트리밍 중인 데이터 세트를 선택하여 데이터 세트 활동 페이지를 열고 선택한 기간 동안 보낸 모든 배치를 표시합니다. Experience Platform을(를) 사용하여 데이터 스트림을 모니터링하는 방법에 대한 자세한 내용은 스트리밍 데이터 흐름 모니터링에 대한 안내서를 참조하십시오.

데이터를 수집하지 못한 경우 Platform에서 복구하려면 실패한 일괄 처리의 ID를 Data Access API (으)로 보내어 검색할 수 있습니다. 자세한 내용은 실패한 일괄 처리 검색에 대한 안내서를 참조하십시오.

데이터 레이크에서 스트리밍 데이터를 사용할 수 없는 이유는 무엇입니까?

잘못된 서식, 데이터 누락 또는 시스템 오류 등 일괄 처리 수집이 Data Lake에 도달하지 못하는 이유는 다양합니다. 일괄 처리가 실패한 이유를 확인하려면 Data Ingestion Service API을(를) 사용하여 일괄 처리를 검색하고 세부 정보를 확인해야 합니다. 실패한 일괄 처리 검색에 대한 자세한 단계는 실패한 일괄 처리 검색에 대한 안내서를 참조하십시오.

API 요청에 대해 반환된 응답을 구문 분석하려면 어떻게 해야 합니까?

먼저 서버 응답 코드를 확인하여 응답을 구문 분석하여 요청이 수락되었는지 여부를 확인할 수 있습니다. 성공적인 응답 코드가 반환되면 responses 배열 개체를 검토하여 수집 작업의 상태를 확인할 수 있습니다.

성공적인 단일 메시지 API 요청은 상태 코드 200을 반환합니다. 성공한(또는 부분적으로 성공한) 일괄 처리된 메시지 API 요청은 상태 코드 207을 반환합니다.

다음 JSON은 두 개의 메시지(한 개의 성공 및 한 개의 실패)가 있는 API 요청에 대한 예제 응답 개체입니다. 스트리밍에 성공한 메시지는 xactionId 속성을 반환합니다. 스트리밍에 실패한 메시지는 statusCode 속성과 자세한 정보가 포함된 응답 message을(를) 반환합니다.

{
    "inletId": "9b0cb233972f3b0092992284c7353f5eead496218e8441a79b25e9421ea127f5",
    "batchId": "1565638336649:1750:244",
    "receivedTimeMs": 1565638336705,
    "responses": [
        {
            "xactionId": "1565650704337:2124:92:3"
        },
        {
            "statusCode": 400,
            "message": "inletId: [9b0cb233972f3b0092992284c7353f5eead496218e8441a
                79b25e9421ea127f5]
                imsOrgId: [{ORG_ID}]
                Message has unknown xdm format"
        }
    ]
}

Real-Time Customer Profile에서 보낸 메시지를 받지 못하는 이유는 무엇입니까?

Real-Time Customer Profile이(가) 메시지를 거부하는 경우 잘못된 ID 정보 때문일 수 있습니다. ID에 대해 잘못된 값 또는 네임스페이스를 제공한 결과일 수 있습니다.

ID 네임스페이스에는 기본 및 사용자 지정의 두 가지 유형이 있습니다. 사용자 지정 네임스페이스를 사용하는 경우 Identity Service 내에 네임스페이스가 등록되었는지 확인하십시오. 기본 및 사용자 지정 네임스페이스 사용에 대한 자세한 내용은 ID 네임스페이스 개요를 참조하십시오.

Experience Platform UI을(를) 사용하여 메시지가 수집되지 않은 이유에 대한 자세한 정보를 볼 수 있습니다. 왼쪽 탐색에서 모니터링 을 클릭한 다음 전체 스트리밍 탭을 보고 선택한 기간 동안 스트리밍된 메시지 배치를 확인합니다.

recommendation-more-help

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