[Beta]{class="badge informative"}

Pendo 원본 연결 데이터 흐름을 만들고 UI에

이 자습서에서는 Adobe Experience Platform 사용자 인터페이스를 사용하여 Pendo 소스 연결 및 데이터 흐름을 만드는 단계를 제공합니다.

시작하기 getting-started

이 자습서에서는 다음 Experience Platform 구성 요소를 이해하고 있어야 합니다.

전제 조건 prerequisites

다음 섹션에서는 Pendo 원본 연결을 만들기 전에 완료해야 하는 필수 구성 요소에 대해 설명합니다.

Pendo에 대한 소스 스키마를 정의하는 샘플 JSON prerequisites-json-schema

Pendo 원본 연결을 만들기 전에 원본 스키마를 제공해야 합니다. 아래 JSON을 사용할 수 있습니다.

{
  "accountId": "58f79ee324d3f",
  "timestamp": 1673372516,
  "visitorId": "test@test.com",
  "uniqueId": "166e50cdf40930fe1367e4d44795c9c74d88b83a",
  "properties": {
    "guideProperties": {
  "name": "Guide Conversion Test"
  }
}
}

자세한 내용은 Pendo Webhooks의 안내서를 참조하십시오.

Pendo에 대한 플랫폼 스키마 만들기 create-platform-schema

또한 먼저 소스에 사용할 Platform 스키마를 만들어야 합니다. 스키마를 만드는 방법에 대한 포괄적인 단계를 보려면 플랫폼 스키마 만들기에 대한 자습서를 참조하십시오.

Pendo 계정 연결 connect-account

Platform UI의 왼쪽 탐색에서 소스 ​를 선택하여 소스 작업 영역에 액세스하고 Experience Platform에서 사용할 수 있는 소스 카탈로그를 확인합니다.

범주 메뉴를 사용하여 범주별로 원본을 필터링하세요. 또는 검색 막대에 소스 이름을 입력하여 카탈로그에서 특정 소스를 찾습니다.

Analytics 범주로 이동하여 Pendo 원본 카드를 확인합니다. 시작하려면 데이터 추가 ​를 선택하세요.

데이터 선택 select-data

플랫폼으로 가져올 데이터를 선택할 수 있는 인터페이스를 제공하는 데이터 선택 단계가 나타납니다.

로컬 시스템에서 JSON 파일을 업로드하려면 파일 업로드 ​를 선택하십시오. 또는 업로드할 JSON 파일을 파일 끌어다 놓기 패널로 끌어다 놓을 수 있습니다.

파일이 업로드되면 미리보기 인터페이스가 업데이트되어 업로드한 스키마의 미리보기가 표시됩니다. 미리보기 인터페이스를 사용하여 파일의 내용과 구조를 검사할 수 있습니다. 검색 필드 유틸리티를 사용하여 스키마 내의 특정 항목에 액세스할 수도 있습니다.

완료되면 다음 ​을 선택합니다.

데이터 흐름 세부 정보 dataflow-detail

데이터 흐름 세부 정보 단계가 표시되어 기존 데이터 집합을 사용하거나 데이터 흐름의 새 데이터 집합을 설정하는 옵션을 제공하고 데이터 흐름의 이름과 설명을 제공할 수 있습니다. 이 단계에서는 프로필 수집, 오류 진단, 부분 수집 및 경고에 대한 설정을 구성할 수도 있습니다.

완료되면 다음 ​을 선택합니다.

매핑 mapping

소스 스키마의 소스 필드를 대상 스키마의 해당 대상 XDM 필드에 매핑할 수 있는 인터페이스를 제공하는 매핑 단계가 나타납니다.

Platform은 선택한 대상 스키마 또는 데이터 세트를 기반으로 자동 매핑된 필드에 대한 지능형 권장 사항을 제공합니다. 사용 사례에 맞게 매핑 규칙을 수동으로 조정할 수 있습니다. 필요에 따라 필드를 직접 매핑하도록 선택하거나 데이터 준비 함수를 사용하여 소스 데이터를 변환하여 계산된 값 또는 계산된 값을 파생할 수 있습니다. 매퍼 인터페이스 및 계산된 필드 사용에 대한 포괄적인 단계는 데이터 준비 UI 안내서를 참조하십시오.

아래 나열된 매핑은 필수이며 검토 단계로 진행하기 전에 설정해야 합니다.

원본 데이터가 성공적으로 매핑되면 다음 ​을(를) 선택하십시오.

검토 review

새 데이터 흐름을 만들기 전에 검토할 수 있는 검토 단계가 나타납니다. 세부 사항은 다음 범주 내에서 그룹화됩니다.

데이터 흐름을 검토한 후 완료 ​를 선택하고 데이터 흐름이 만들어지도록 잠시 기다립니다.

스트리밍 끝점 URL 가져오기 get-streaming-endpoint-url

스트리밍 데이터 흐름이 만들어지면 이제 스트리밍 끝점 URL을 검색할 수 있습니다. 이 끝점은 Webhook에 가입하는 데 사용되며 스트리밍 소스에서 Experience Platform과 통신할 수 있습니다.

Pendo에서 Webhook를 구성하는 데 사용되는 URL을 만들려면 다음을 검색해야 합니다.

데이터 흐름 ID 및 스트리밍 끝점 ​을 검색하려면 방금 만든 데이터 흐름의 데이터 흐름 활동 페이지로 이동하여 속성 패널 아래쪽에서 세부 정보를 복사합니다.

스트리밍 끝점 및 데이터 흐름 ID를 검색한 후에는 {STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID} 패턴을 기반으로 URL을 빌드합니다. 예를 들어 구성된 웹후크 URL의 형태는 다음과 같습니다. https://dcs.adobedc.net/collection/0c61859cc71939a0caf01123f91b2fc52589018800ad46b6c76c2dff3595ee95

Pendo에서 Webhook 설정 set-up-webhook

그런 다음 Pendo에서 계정에 로그인하고 웹후크를 만듭니다. Pendo 사용자 인터페이스를 사용하여 웹후크를 만드는 방법에 대한 단계는 Pendo 웹후크 만들기에 대한 안내서를 참조하십시오.

웹후크가 만들어지면 Pendo 웹후크의 설정 페이지로 이동하여 URL 필드에 웹후크 URL을 입력합니다.

다음 단계 next-steps

이 자습서를 따라 Pendo 데이터를 Experience Platform 상태로 전환하기 위한 스트리밍 데이터 흐름을 구성했습니다. 수집 중인 데이터를 모니터링하려면 플랫폼 UI를 사용하여 스트리밍 데이터 흐름 모니터링에 대한 안내서를 참조하세요.

추가 리소스 additional-resources

아래 섹션에서는 Pendo 소스를 사용할 때 참조할 수 있는 추가 리소스를 제공합니다.

유효성 검사 validation

원본을 올바르게 설정했는지 확인하고 Pendo개의 메시지가 수집되고 있는지 확인하려면 아래 단계를 수행하십시오.

오류 및 문제 해결 errors-and-troubleshooting

데이터 흐름 실행을 확인할 때 다음 오류 메시지가 표시될 수 있습니다. The message can't be validated ... uniqueID:expected minLength:1, actual 0].

이 오류를 해결하려면 uniqueID 매핑이 설정되었는지 확인해야 합니다. 추가 지침은 Mmpping 섹션을 참조하십시오.

자세한 내용은 Pendo 도움말 센터를 참조하세요.