스트리밍 통합 문제 해결 가이드

이 문서에서는 Adobe Experience Platform에서의 스트리밍 회수에 대한 질문과 답변을 제공합니다. 모든 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 보안 데이터 수집을 지원합니다. 인증된 데이터 수집이 활성화되면 클라이언트는 JWT(JSON Web Token) 및 IMS 조직 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 Lake에 도달하지 못하는 이유는 여러 가지가 있습니다. 배치가 실패한 이유를 확인하려면 Data Ingestion Service API을 사용하여 배치를 검색하고 세부 정보를 확인해야 합니다. 실패한 배치를 검색하는 방법에 대한 자세한 내용은 실패한 배치 검색의 안내서를 참조하십시오.

API 요청에 대해 반환된 응답을 어떻게 분석합니까?

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

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

다음 JSON은 2개의 메시지가 있는 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: [{IMS_ORG}] 
                Message has unknown xdm format"
        }
    ]
}

Real-time Customer Profile이(가) 보낸 메시지를 수신하지 못하는 이유는 무엇입니까?

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

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

메시지를 수집하지 못한 이유에 대한 자세한 내용을 보려면 Experience Platform UI을 사용할 수 있습니다. 왼쪽 탐색 창에서 모니터링​을 클릭한 다음 스트리밍 종단간 탭을 확인하여 선택한 기간 동안 스트리밍된 메시지 배치를 확인합니다.

이 페이지에서는

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