설명서Experience Platform소스 커넥터 안내서

[Beta]{class="badge informative"}

RainFocus

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

작성 대상:

  • 개발자
NOTE
RainFocus 원본이 Beta 버전입니다. 베타 레이블 소스를 사용하는 방법에 대한 자세한 내용은 소스 개요를 참조하십시오.

RainFocus은(는) 이벤트를 홍보하고 대상을 만드는 데 사용할 수 있는 플랫폼입니다. RainFocus을(를) 사용하여 멋진 홍보 페이지를 만들고, 캠페인 성과를 추적하고, 등록 전환을 최적화할 수 있습니다.

Adobe Experience Platform 및 Real-time Customer Data Platform의 RainFocus 소스를 사용하여 실시간으로 참석자 경험 이벤트로 고객 데이터 프로필을 자동으로 보강합니다. 활성화되면 경험 여정이 자동으로 Real-Time CDP으로 스트리밍되어 강력한 대상 세분화, 데이터 분석 및 Customer Journey Analytics 및 Adobe Journey Optimizer과 같은 다운스트림 대상 및 애플리케이션으로 참석자 이벤트를 활성화할 수 있습니다.

IMPORTANT
이 원본 커넥터 및 문서 페이지는 RainFocus 팀에서 만들고 유지 관리합니다. 문의 사항이나 업데이트 요청은 Clientcare@rainfocus.com에서 직접 문의하거나 RainFocus 도움말 센터를 방문하십시오

전제 조건

Experience Platform에서 RainFocus 통합을 활성화하려면 먼저 다음 사전 요구 사항을 완료해야 합니다.

Adobe Developer 포털에서 JWT(Adobe 서비스 계정) 만들기

IMPORTANT
Adobe은 최근 OAuth를 위해 JWT 토큰의 사용 중단을 발표했습니다. 이 변경 사항을 수용하기 위해 RainFocus 원본은 가까운 미래에 OAuth로 마이그레이션됩니다.

필요한 자격 증명 수집

RainFocus을(를) Experience Platform에 연결하려면 RainFocus에 다음 연결 속성에 대한 값을 제공해야 합니다.

자격 증명
설명
예
클라이언트 ID
클라이언트 ID는 Adobe Developer 포털의 Adobe 서비스 계정에서 가져올 수 있습니다.
b9c32a63e7d41a0f87d3e8b52a16e7a2
클라이언트 암호
클라이언트 암호는 Adobe Developer 포털의 Adobe 서비스 계정에서 가져올 수 있습니다.
k1b-p-umplcjtg_arnw-R-Bx44bybu
기술 계정 ID
기술 계정 ID는 Adobe Developer 포털의 Adobe 서비스 계정에서 가져올 수 있습니다.
B3F9D2E8A64C573D21ABFE97@techacct.adobe.com
조직 ID
조직 ID는 Adobe Developer 포털의 Adobe 서비스 계정에서 가져올 수 있습니다
D9A6F3BCE82FD147C50E3A19@techacct.adobe.com

XDM 스키마 만들기 및 ID 필드 정의 create-an-xdm-schema-and-define-the-identity-field

RainFocus의 경험 이벤트를 Experience Platform에 저장하려면 RainFocus에서 전송될 수 있는 필드 및 데이터 형식을 저장할 수 있는 데이터 집합을 설명하는 XDM(경험 데이터 모델) 스키마를 만들어야 합니다.

RainFocus은(는) 기본적으로 전송되는 모든 가능한 데이터를 다루는 다음 필드를 권장합니다.

또한 다음 필드 그룹이 권장됩니다(접두사로 표시).

  • 참석자
  • 전시자
  • 리드
  • Session
  • 세션 시간

스키마에 다음 필드가 있어야 합니다.

필드
유형
예
설명
attendee.registered
문자열
예
참석자가 등록된 것으로 간주되는지 여부를 결정하는 플래그입니다.
attendee.attendeeId
문자열
1619119968857001fvLB
RainFocus의 참석자 ID.
attendee.externalId
문자열
1666809456617001wyPj
조직에서 지정한 외부 ID.
attendee.clientId
문자열
8EFC1F57631CAFE70A495ECB@8f3f1f5c631caf3e495fd8.e
참석자 SSO 클라이언트 ID.
attendee.email
문자열
사용자@company.com
참석자의 이메일 주소입니다.
transmissionId
문자열
1680309557133001YHhz
데이터 푸시에 사용되는 고유 식별자입니다.
eventType
문자열
세션 예약됨
참석자 경험 이벤트의 이름입니다.
timestamp
날짜/시간
2023-04-01T00:41:57.000Z
데이터 푸시의 타임스탬프입니다.
event.name
문자열
2023년 Adobe Summit
전송이 발생한 이벤트의 이름입니다.
exhibitor.exhibitorId
문자열
1680309557133001YHhz
표시자의 RainFocus 식별자입니다.
exhibitor.externalId
문자열
1666809514105001lSJN
클라이언트 시스템의 전시자에 대한 식별자.
exhibitor.name
문자열
IBM
전시자의 이름.
lead.leadId
문자열
1666809456617001wyPj
잠재 고객의 RainFocus 식별자입니다.
lead.note
문자열
session.sessionId
문자열
1666809373585001t4aV
세션의 RainFocus 식별자입니다.
session.externalId
문자열
1666809456617001wyPj
클라이언트 시스템의 세션에 대한 식별자입니다.
session.code
문자열
GS3
세션에 대한 코드입니다.
session.title
문자열
Inspiration Keynote
세션의 제목입니다.
session.length
정수
90
세션 길이입니다.
sessiontime.sessiontimeId
문자열
1673033149739001OJLZ
세션 시간의 RainFocus 식별자입니다.
sessiontime.startTime
문자열
2023-03-22 10:00:00
세션의 시작 시간입니다.
sessiontime.endTime
문자열
2023-03-22 10:00:00
세션의 종료 시간입니다.
sessiontime.room
문자열
B32
세션에 사용되는 룸입니다.

RainFocus 데이터에 대한 스키마를 만들려면 다음 설명서에서 API 또는 UI를 사용하여 스키마를 만드는 방법에 대한 단계를 확인하십시오.

IMPORTANT
  • 스키마는 XDM ExperienceEvent 클래스를 확장해야 합니다.
  • 스키마에 기본 ID ​이(가) 포함되어 있고 프로필에 대해 활성화됨 ​인지 확인해야 합니다. 자세한 내용은 UI에서 ID 필드 정의에 대한 안내서를 참조하십시오.
  • sha256 이메일 또는 ECID와 같은 다른 적절한 식별자로 예제 ID(이메일)를 대체할 수 있습니다.

RainFocus에서 통합 프로필 만들기 create-an-integration-profile-in-rainfocus

서비스 계정 및 XDM 스키마가 준비되면 이제 RainFocus 플랫폼을 통해 Integration Profile을(를) 활성화할 수 있습니다. Integration Profile은(는) Experience Platform으로 데이터를 스트리밍합니다.

RainFocus platform에 로그인합니다. 기본 탐색에서 Libraries ​을(를) 선택한 다음 Integration Profiles ​을(를) 선택합니다.

라이브러리 및 통합 프로필이 선택된 RainFocus UI입니다.

새 프로필을 만들려면 (+) 아이콘을 선택합니다. Adobe Real-time Customer Data Platform ​을(를) 선택한 다음 확인 ​을(를) 선택합니다.

RainFocus UI의 통합 프로필 만들기 창

그런 다음 Adobe Developer 포털 프로젝트에서 검색한 자격 증명을 제공합니다.

  • 클라이언트 ID
  • 클라이언트 암호
  • 기술 계정 ID
  • 조직 ID

자격 증명을 제공한 후 Save ​을(를) 선택하십시오. 이제 RainFocus 대시보드에 새 Integration Profile이(가) 표시됩니다.

미리 정의된 푸시 형식 목록을 이미 구성한 경우 지금 만든 Integration Profile을(를) 선택하십시오. 이러한 이벤트가 발생할 때 Experience Platform에게 전송되는 경험 이벤트입니다.

RainFocus 대시보드에 미리 정의된 푸시 형식 목록입니다.

샘플 JSON 페이로드의 복사본을 검색하려면 Sample JSON Payload ​을(를) 선택하십시오. 그런 다음 샘플 JSON 페이로드를 강조 표시하여 복사하고 확장명이 .json인 새 파일에 저장 ​합니다. 나중에 매핑 구성에 대한 Experience Platform에서 사용됩니다.

RainFocus 대시보드의 샘플 JSON 페이로드입니다.

TIP
설정이 아직 완료되지 않았습니다: 데이터 흐름이 만들어지면 RainFocus 대시보드로 돌아가서 스트리밍 끝점 URL 및 데이터 흐름 ID ​를 제공하여 Integration Profile을(를) 완료해야 합니다.

다음 단계

이 문서를 읽고 RainFocus 계정에서 Experience Platform으로 데이터를 스트리밍하는 데 필요한 필수 구성 요소 설정을 완료했습니다. 이제 사용자 인터페이스를 사용하여 연결 RainFocus Experience Platform에 연결에 대한 안내서로 진행할 수 있습니다.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089