B2B 네임스페이스 및 스키마

이 문서에서는 B2B 소스에서 사용할 네임스페이스 및 스키마에 대한 기본 설정에 대한 정보를 제공합니다. 또한 이 문서에서는 B2B 네임스페이스 및 스키마를 생성하는 데 필요한 Postman 자동화 유틸리티 설정에 대한 세부 사항을 제공합니다.

중요

액세스 권한이 있어야 합니다. Real-time Customer Data Platform B2B 에디션 B2B 스키마가 실시간 고객 프로필.

B2B 네임스페이스 및 스키마 자동 생성 유틸리티를 설정합니다

B2B 네임스페이스 및 스키마 자동 생성 유틸리티를 사용하는 첫 번째 단계는 플랫폼 개발자 콘솔을 설정하고 Postman 환경.

  • 여기에서 네임스페이스 및 스키마 자동 생성 유틸리티 컬렉션 및 환경을 다운로드할 수 있습니다 GitHub 리포지토리.
  • 필수 헤더에 대한 값을 수집하고 샘플 API 호출을 읽는 방법에 대한 자세한 내용을 포함하여 플랫폼 API 사용에 대한 자세한 내용은 다음 안내서를 참조하십시오 플랫폼 API 시작.
  • Platform API용 자격 증명을 생성하는 방법에 대한 자세한 내용은 Experience Platform API 인증 및 액세스.
  • 설정 방법에 대한 자세한 내용 Postman 플랫폼 API의 경우 다음 위치에서 자습서를 참조하십시오. 개발자 콘솔 설정 및 Postman.

플랫폼 개발자 콘솔 사용 및 Postman 을 설정하고, 이제 적절한 환경 값을 Postman 환경.

다음 표에는 예제 값과 Postman 환경:

변수 설명
CLIENT_SECRET 를 생성하는 데 사용되는 고유 식별자입니다 {ACCESS_TOKEN}. 다음에서 자습서를 참조하십시오. Experience Platform API 인증 및 액세스 을 검색하는 방법에 대한 자세한 내용은 {CLIENT_SECRET}. {CLIENT_SECRET}
JWT_TOKEN JSON 웹 토큰(JWT)은 {ACCESS_TOKEN}을 생성하는 데 사용되는 인증 자격 증명입니다. 다음에서 자습서를 참조하십시오. Experience Platform API 인증 및 액세스 를 생성하는 방법에 대한 자세한 내용을 {JWT_TOKEN}. {JWT_TOKEN}
API_KEY Experience Platform API에 대한 호출을 인증하는 데 사용되는 고유 식별자입니다. 다음에서 자습서를 참조하십시오. Experience Platform API 인증 및 액세스 을 검색하는 방법에 대한 자세한 내용은 {API_KEY}. c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN Experience Platform API 호출을 완료하는 데 필요한 인증 토큰. 다음에서 자습서를 참조하십시오. Experience Platform API 인증 및 액세스 을 검색하는 방법에 대한 자세한 내용은 {ACCESS_TOKEN}. Bearer {ACCESS_TOKEN}
META_SCOPE 와 관련하여 Marketo로 설정되면 이 값은 고정되며 항상 다음으로 설정됩니다. ent_dataservices_sdk. ent_dataservices_sdk
CONTAINER_ID 다음 global 컨테이너에는 모든 표준 Adobe 및 Experience Platform 파트너가 제공하는 클래스, 스키마 필드 그룹, 데이터 유형 및 스키마가 있습니다. 와 관련하여 Marketo이면 이 값이 고정되고 항상 로 설정됩니다 global. global
PRIVATE_KEY 인증을 위해 사용되는 자격 증명 Postman Experience Platform API에 대한 인스턴스. 개발자 콘솔 설정에 대한 튜토리얼 및 개발자 콘솔 설정 및 Postman {PRIVATE_KEY}을(를) 검색하는 방법에 대한 지침은 {PRIVATE_KEY}
TECHNICAL_ACCOUNT_ID Adobe I/O에 통합하는 데 사용되는 자격 증명입니다. D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.com
IMS IMS(Identity Management 시스템)는 Adobe 서비스에 대한 인증을 위한 프레임워크를 제공합니다. 와 관련하여 Marketo로 설정되면 이 값은 고정되며 항상 다음으로 설정됩니다. ims-na1.adobelogin.com. ims-na1.adobelogin.com
IMS_ORG 제품 및 서비스를 소유하거나 라이센스를 부여하고 해당 구성원에 대한 액세스를 허용할 수 있는 법인. 다음에서 자습서를 참조하십시오. 개발자 콘솔 설정 및 Postman 을 검색하는 방법에 대한 지침 {IMS_ORG} 정보. ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME 사용 중인 가상 샌드박스 파티션의 이름입니다. prod
TENANT_ID 사용자가 만드는 리소스가 제대로 식별되고 IMS 조직 내에 포함되어 있는지 확인하는 데 사용되는 ID입니다. b2bcdpproductiontest
PLATFORM_URL API를 호출하는 URL 끝점입니다. 이 값은 고정되며 항상 다음으로 설정됩니다. http://platform.adobe.io/. http://platform.adobe.io/

스크립트 실행

사용 Postman 이제 를 통해 스크립트를 실행할 수 있습니다 Postman 인터페이스.

에서 Postman 인터페이스를 사용하여 자동 생성 유틸리티의 루트 폴더를 선택한 다음 Run 상단 헤더에서

루트 폴더

다음 Runner 인터페이스가 표시됩니다. 여기에서 모든 확인란을 선택한 다음 선택합니다 Run Namespaces and Schemas Autogeneration Utility.

실행 생성기

요청이 성공하면 B2B에 필요한 네임스페이스 및 스키마를 만듭니다.

B2B 네임스페이스

ID 네임스페이스는 Identity Service ID의 컨텍스트 또는 유형을 구분하는 데 사용됩니다. 정규화된 ID에는 ID 값과 네임스페이스가 포함됩니다. 자세한 내용은 네임스페이스 개요 추가 정보.

B2B 네임스페이스는 엔터티의 기본 ID에서 사용됩니다.

다음 표에는 B2B 네임스페이스에 대한 기본 설정 정보에 대한 정보가 포함되어 있습니다.

노트

표의 전체 내용을 보려면 왼쪽/오른쪽으로 스크롤하십시오.

표시 이름 ID 기호 ID 유형
B2B 사람 b2b_person CROSS_DEVICE
B2B 계정 b2b_account B2B_ACCOUNT
B2B 기회 b2b_opportunity B2B_OPPORTUNITY
B2B 기회 개인 관계 b2b_opportunity_person_relation B2B_OPPORTUNITY_PERSON
B2B 캠페인 b2b_campaign B2B_CAMPAIGN
B2B 캠페인 구성원 b2b_campaign_member B2B_CAMPAIGN_MEMBER
B2B 마케팅 목록 b2b_marketing_list B2B_MARKETING_LIST
B2B 마케팅 목록 구성원 b2b_marketing_list_member B2B_MARKETING_LIST_MEMBER
B2B 계정 개인 관계 b2b_account_person_relation B2B_ACCOUNT_PERSON

B2B 스키마

Experience Platform은 스키마를 사용하여 데이터의 구조를 일관되고 재사용 가능한 방식으로 설명합니다. 여러 시스템에서 데이터를 일관되게 정의하면 의미를 쉽게 유지할 수 있으므로 데이터의 가치를 얻을 수 있습니다.

데이터를 Platform에 수집하려면 먼저 데이터 구조를 설명하고 각 필드 내에 포함할 수 있는 데이터 유형에 제한을 제공하도록 스키마를 구성해야 합니다. 스키마는 기본 클래스와 0개 이상의 스키마 필드 그룹으로 구성됩니다.

디자인 원칙 및 모범 사례를 포함한 스키마 구성 모델에 대한 자세한 내용은 다음을 참조하십시오. 스키마 구성 기본 사항.

다음 표에는 B2B 스키마의 기본 설정에 대한 정보가 포함되어 있습니다.

노트

표의 전체 내용을 보려면 왼쪽/오른쪽으로 스크롤하십시오.

스키마 이름 기본 클래스 필드 그룹 Profile 스키마 내 기본 ID 기본 ID 네임스페이스 보조 ID 보조 ID 네임스페이스 관계 참고
B2B 계정 XDM 비즈니스 계정 XDM 비즈니스 계정 세부 정보 활성화됨 accountKey.sourceKey 기본 클래스에서 B2B 계정 extSourceSystemAudit.externalKey.sourceKey 기본 클래스에서 B2B 계정
  • accountParentKey.sourceKey XDM 비즈니스 계정 세부 정보 필드 그룹에서
  • 대상 속성: /accountKey/sourceKey
  • 유형: 일대일
  • 참조 스키마: B2B 계정
  • 네임스페이스: B2B 계정
B2B 사람 XDM 개별 프로필
  • XDM 비즈니스 개인 세부 정보
  • XDM 비즈니스 개인 구성 요소
  • IdentityMap
  • 동의 및 기본 설정 세부 사항
활성화됨 b2b.personKey.sourceKey XDM 비즈니스 개인 세부 정보 필드 그룹에서 B2B 사람
  1. extSourceSystemAudit.externalKey.sourceKey XDM 비즈니스 개인 세부 정보 필드 그룹
  2. workEmail.address XDM 비즈니스 개인 세부 정보 필드 그룹
  1. B2B 사람
  2. 이메일
  • personComponents.sourceAccountKey.sourceKey XDM 비즈니스 개인 구성 요소 필드 그룹
  • 유형: 다대다
  • 참조 스키마: B2B 계정
  • 네임스페이스: B2B 계정
  • 대상 속성: accountKey.sourceKey
  • 현재 스키마의 관계 이름: 계정
  • 참조 스키마의 관계 이름: 사람
B2B 기회 XDM 비즈니스 기회 XDM 비즈니스 기회 세부 정보 활성화됨 opportunityKey.sourceKey 기본 클래스에서 B2B 기회 extSourceSystemAudit.externalKey.sourceKey 기본 클래스에서 B2B 기회
  • accountKey.sourceKey 기본 클래스에서
  • 유형: 다대다
  • 참조 스키마: B2B 계정
  • 네임스페이스: B2B 계정
  • 대상 속성: accountKey.sourceKey
  • 현재 스키마의 관계 이름: 계정
  • 참조 스키마의 관계 이름: 기회
B2B 기회 개인 관계 XDM 비즈니스 기회 개인 관계 None 활성화됨 opportunityPersonKey.sourceKey 기본 클래스에서 B2B 기회 개인 관계 extSourceSystemAudit.externalKey.sourceKey 기본 클래스에서 B2B 기회 개인 관계 첫 번째 관계
  • personKey.sourceKey 기본 클래스에서
  • 유형: 다대다
  • 참조 스키마: B2B 사람
  • 네임스페이스: B2B 사람
  • 대상 속성: b2b.personKey.sourceKey
  • 현재 스키마의 관계 이름: 개인
  • 참조 스키마의 관계 이름: 기회
두 번째 관계
  • opportunityKey.sourceKey 기본 클래스에서
  • 유형: 다대다
  • 참조 스키마: B2B 기회
  • 네임스페이스: B2B 기회
  • 대상 속성: opportunityKey.sourceKey
  • 현재 스키마의 관계 이름: 기회
  • 참조 스키마의 관계 이름: 사람
B2B 캠페인 XDM 비즈니스 캠페인 XDM 비즈니스 캠페인 세부 사항 활성화됨 campaignKey.sourceKey 기본 클래스에서 B2B 캠페인 extSourceSystemAudit.externalKey.sourceKey 기본 클래스에서 B2B 캠페인
B2B 캠페인 구성원 XDM 비즈니스 캠페인 구성원 XDM 비즈니스 캠페인 구성원 세부 정보 활성화됨 ccampaignMemberKey.sourceKey 기본 클래스에서 B2B 캠페인 구성원 extSourceSystemAudit.externalKey.sourceKey 기본 클래스에서 B2B 캠페인 구성원 첫 번째 관계
  • personKey.sourceKey 기본 클래스에서
  • 유형: 다대다
  • 참조 스키마: B2B 사람
  • 네임스페이스: B2B 사람
  • 대상 속성: b2b.personKey.sourceKey
  • 현재 스키마의 관계 이름: 개인
  • 참조 스키마의 관계 이름: 캠페인
두 번째 관계
  • campaignKey.sourceKey 기본 클래스에서
  • 유형: 다대다
  • 참조 스키마: B2B 캠페인
  • 네임스페이스: B2B 캠페인
  • 대상 속성: campaignKey.sourceKey
  • 현재 스키마의 관계 이름: 캠페인
  • 참조 스키마의 관계 이름: 사람
B2B 마케팅 목록 XDM 비즈니스 마케팅 목록 없음 활성화됨 marketingListKey.sourceKey 기본 클래스에서 B2B 마케팅 목록 없음 없음 없음 정적 목록이 다음에서 동기화되지 않습니다. Salesforce 따라서 에는 보조 ID가 없습니다.
B2B 마케팅 목록 구성원 XDM 비즈니스 마케팅 목록 구성원 없음 활성화됨 marketingListMemberKey.sourceKey 기본 클래스에서 B2B 마케팅 목록 구성원 없음 없음 첫 번째 관계
  • PersonKey.sourceKey 기본 클래스에서
  • 유형: 다대다
  • 참조 스키마: B2B 사람
  • 네임스페이스: B2B 사람
  • 대상 속성: b2b.personKey.sourceKey
  • 현재 스키마의 관계 이름: 개인
  • 참조 스키마의 관계 이름: 마케팅 목록
두 번째 관계
  • marketingListKey.sourceKey 기본 클래스에서
  • 유형: 다대다
  • 참조 스키마: B2B 마케팅 목록
  • 네임스페이스: B2B 마케팅 목록
  • 대상 속성: marketingListKey.sourceKey
  • 현재 스키마의 관계 이름: 마케팅 목록
  • 참조 스키마의 관계 이름: 사람
정적 목록 멤버가 Salesforce 따라서 에는 보조 ID가 없습니다.
B2B 활동 XDM ExperienceEvent
  • 웹 페이지 방문
  • 새 리드
  • 리드 변환
  • 목록에 추가
  • 목록에서 제거
  • Add To Opportunity
  • Opportunity에서 제거
  • 채워진 양식
  • 링크 클릭 수
  • 배달된 이메일
  • 전자 메일 열림
  • 클릭한 이메일
  • 이메일 바운스됨
  • 이메일 바운스된 소프트
  • 이메일 가입 해지됨
  • 점수 변경됨
  • 영업 기회 업데이트
  • 캠페인 진행 상태가 변경됨
  • 개인 식별자
  • Marketo 웹 URL
  • 흥미로운 순간
활성화됨 personKey.sourceKey 개인 식별자 필드 그룹 B2B 사람 없음 없음 첫 번째 관계
  • listOperations.listKey.sourceKey 필드
  • 유형: 일대일
  • 참조 스키마: B2B 마케팅 목록
  • 네임스페이스: B2B 마케팅 목록
두 번째 관계
  • opportunityEvent.opportunityKey.sourceKey 필드
  • 유형: 일대일
  • 참조 스키마: B2B 기회
  • 네임스페이스: B2B 기회
세 번째 관계
  • leadOperation.campaignProgression.campaignKey.sourceKey 필드
  • 유형: 일대일
  • 참조 스키마: B2B 캠페인
  • 네임스페이스: B2B 캠페인
ExperienceEvent 은 엔티티와 다릅니다. 경험 이벤트의 ID는 활동을 수행한 사용자입니다.
B2B 계정 개인 관계 XDM 비즈니스 계정 담당자 관계 ID 맵 활성화됨 accountPersonKey.sourceKey 기본 클래스에서 B2B 계정 개인 관계 없음 없음 첫 번째 관계
  • personKey.sourceKey 기본 클래스에서
  • 유형: 다대다
  • 참조 스키마: B2B 사람
  • 네임스페이스: B2B 사람
  • 대상 속성: b2b.personKey.SourceKey
  • 현재 스키마의 관계 이름: 사람
  • 참조 스키마의 관계 이름: 계정
두 번째 관계
  • accountKey.sourceKey 기본 클래스에서
  • 유형: 다대다
  • 참조 스키마: B2B 계정
  • 네임스페이스: B2B 계정
  • 대상 속성: accountKey.sourceKey
  • 현재 스키마의 관계 이름: 계정
  • 참조 스키마의 관계 이름: 사람

다음 단계

연결 방법을 배우려면 Marketo 데이터를 Platform으로 변환하려면 UI에서 Marketo 소스 커넥터 만들기.

이 페이지에서는