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

이 문서에서는 Adobe Experience Platform의 스트리밍 수집에 대한 FAQ에 대한 답변을 제공합니다. 기타 관련 질문 및 문제 해결 Platform 모든 상황에서 발생하는 서비스를 포함한 서비스 Platform API, 다음을 참조하십시오. Experience Platform 문제 해결 안내서.

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

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

동일한 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?

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

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

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

recommendation-more-help
2ee14710-6ba4-4feb-9f79-0aad73102a9a