B2B 네임스페이스 및 스키마
B2B 소스에서 사용할 네임스페이스 및 스키마의 기본 설정에 대한 자세한 내용은 이 문서를 참조하십시오. 이 문서에서는 B2B 네임스페이스 및 스키마를 생성하는 데 필요한 Postman 자동화 유틸리티 설정에 대한 세부 정보도 제공합니다.
B2B 네임스페이스 및 스키마 자동 생성 유틸리티 설정
B2B 네임스페이스 및 스키마 자동 생성 유틸리티를 지원하도록 Postman 환경을 설정하는 방법에 대한 필수 구성 요소 정보는 다음 설명서를 참조하십시오.
- 이 GitHub 저장소에서 네임스페이스와 스키마 자동 생성 유틸리티 컬렉션 및 환경을 다운로드할 수 있습니다.
- 필요한 헤더에 대한 값을 수집하고 샘플 API 호출을 읽는 방법에 대한 세부 정보를 포함하여 Platform API 사용에 대한 자세한 내용은 Platform API 시작하기에 대한 안내서를 참조하십시오.
- Platform API에 대한 자격 증명을 생성하는 방법에 대한 자세한 내용은 Experience Platform API 인증 및 액세스에 대한 자습서를 참조하십시오.
- 플랫폼 API용 Postman을(를) 설정하는 방법에 대한 자세한 내용은 개발자 콘솔 설정 및 Postman에 대한 자습서를 참조하십시오.
Platform 개발자 콘솔과 Postman을(를) 설정하면 이제 Postman 환경에 적절한 환경 값을 적용할 수 있습니다.
다음 표에는 예제 값과 Postman 환경 채우기에 대한 추가 정보가 포함되어 있습니다.
CLIENT_SECRET
{ACCESS_TOKEN}
을(를) 생성하는 데 사용되는 고유 식별자입니다. {CLIENT_SECRET}
을(를) 검색하는 방법에 대한 자세한 내용은 Experience Platform API 인증 및 액세스에 대한 자습서를 참조하십시오.{CLIENT_SECRET}
API_KEY
{API_KEY}
을(를) 검색하는 방법에 대한 자세한 내용은 Experience Platform API 인증 및 액세스에 대한 자습서를 참조하십시오.c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN
{ACCESS_TOKEN}
을(를) 검색하는 방법에 대한 자세한 내용은 Experience Platform API 인증 및 액세스에 대한 자습서를 참조하십시오.Bearer {ACCESS_TOKEN}
META_SCOPE
ent_dataservices_sdk
(으)로 설정되어 있습니다.ent_dataservices_sdk
CONTAINER_ID
global
컨테이너에는 모든 표준 Adobe 및 Experience Platform 파트너가 제공한 클래스, 스키마 필드 그룹, 데이터 형식 및 스키마가 들어 있습니다. Marketo과(와) 관련하여 이 값은 고정되어 있으며 항상 global
(으)로 설정됩니다.global
TECHNICAL_ACCOUNT_ID
D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.com
IMS
ims-na1.adobelogin.com
(으)로 설정됩니다.ims-na1.adobelogin.com
IMS_ORG
{ORG_ID}
정보를 검색하는 방법에 대한 지침은 개발자 콘솔 설정 및 Postman에 대한 자습서를 참조하십시오.ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME
prod
TENANT_ID
b2bcdpproductiontest
PLATFORM_URL
http://platform.adobe.io/
(으)로 설정됩니다.http://platform.adobe.io/
스크립트 실행
Postman 컬렉션 및 환경이 설정되면 이제 Postman 인터페이스를 통해 스크립트를 실행할 수 있습니다.
Postman 인터페이스에서 자동 생성기 유틸리티의 루트 폴더를 선택한 다음 상단 헤더에서 Run 을(를) 선택합니다.
Runner 인터페이스가 나타납니다. 여기에서 모든 확인란이 선택되었는지 확인한 다음 Run Namespaces and Schemas Autogeneration Utility 을(를) 선택하십시오.
요청이 성공하면 B2B에 필요한 네임스페이스와 스키마가 만들어집니다.
B2B 네임스페이스
ID 네임스페이스는 ID의 컨텍스트를 구분하는 역할을 하는 Identity Service의 구성 요소입니다. 정규화된 ID에는 ID 값과 네임스페이스가 포함됩니다. 자세한 내용은 네임스페이스 개요를 참조하십시오.
B2B 네임스페이스는 엔티티의 기본 ID에서 사용됩니다.
다음 표에는 B2B 네임스페이스에 대한 기본 설정에 대한 정보가 나와 있습니다.
b2b_person
CROSS_DEVICE
b2b_account
B2B_ACCOUNT
b2b_opportunity
B2B_OPPORTUNITY
b2b_opportunity_person_relation
B2B_OPPORTUNITY_PERSON
b2b_campaign
B2B_CAMPAIGN
b2b_campaign_member
B2B_CAMPAIGN_MEMBER
b2b_marketing_list
B2B_MARKETING_LIST
b2b_marketing_list_member
B2B_MARKETING_LIST_MEMBER
b2b_account_person_relation
B2B_ACCOUNT_PERSON
B2B 스키마
Experience Platform은 스키마를 사용하여 데이터의 구조를 일관되고 재사용 가능한 방식으로 설명합니다. 여러 시스템에서 데이터를 일관되게 정의하면 의미를 쉽게 유지할 수 있으므로 데이터의 가치를 얻을 수 있습니다.
데이터를 Platform에 수집하려면 먼저 데이터의 구조를 설명하고 각 필드 내에 포함할 수 있는 데이터 유형에 제약 조건을 제공하는 스키마를 구성해야 합니다. 스키마는 기본 클래스와 0개 이상의 스키마 필드 그룹으로 구성됩니다.
디자인 원칙 및 모범 사례를 포함하여 스키마 구성 모델에 대한 자세한 내용은 스키마 구성 기본 사항을 참조하십시오.
다음 표에는 B2B 스키마의 기본 설정에 대한 정보가 포함되어 있습니다.
accountKey.sourceKey
extSourceSystemAudit.externalKey.sourceKey
- XDM 비즈니스 계정 세부 정보 필드 그룹의
accountParentKey.sourceKey
- 대상 속성:
/accountKey/sourceKey
- 유형: 일대일
- 참조 스키마: B2B 계정
- 네임스페이스: B2B 계정
- XDM 비즈니스 사용자 세부 정보
- XDM 비즈니스 사용자 구성 요소
- IdentityMap
- 동의 및 환경 설정 세부 정보
b2b.personKey.sourceKey
- XDM 비즈니스 사용자 세부 정보 필드 그룹의
extSourceSystemAudit.externalKey.sourceKey
- XDM 비즈니스 사용자 세부 정보 필드 그룹의
workEmail.address
- B2B 개인
- 이메일
- XDM 비즈니스 사용자 구성 요소 필드 그룹의
personComponents.sourceAccountKey.sourceKey
- 유형: 다대일
- 참조 스키마: B2B 계정
- 네임스페이스: B2B 계정
- 대상 속성: accountKey.sourceKey
- 현재 스키마의 관계 이름: 계정
- 참조 스키마의 관계 이름: 사람
opportunityKey.sourceKey
extSourceSystemAudit.externalKey.sourceKey
- 기본 클래스의
accountKey.sourceKey
- 유형: 다대일
- 참조 스키마: B2B 계정
- 네임스페이스: B2B 계정
- 대상 속성:
accountKey.sourceKey
- 현재 스키마의 관계 이름: 계정
- 참조 스키마의 관계 이름: 기회
opportunityPersonKey.sourceKey
extSourceSystemAudit.externalKey.sourceKey
첫 번째 관계
- 기본 클래스의
personKey.sourceKey
- 유형: 다대일
- 참조 스키마: B2B 개인
- 네임스페이스: B2B 개인
- 대상 속성: b2b.personKey.sourceKey
- 현재 스키마의 관계 이름: 개인
- 참조 스키마의 관계 이름: 기회
두 번째 관계
- 기본 클래스의
opportunityKey.sourceKey
- 유형: 다대일
- 참조 스키마: B2B 영업 기회
- 네임스페이스: B2B 영업 기회
- 대상 속성:
opportunityKey.sourceKey
- 현재 스키마의 관계 이름: Opportunity
- 참조 스키마의 관계 이름: 사람
campaignKey.sourceKey
extSourceSystemAudit.externalKey.sourceKey
ccampaignMemberKey.sourceKey
extSourceSystemAudit.externalKey.sourceKey
첫 번째 관계
- 기본 클래스의
personKey.sourceKey
- 유형: 다대일
- 참조 스키마: B2B 개인
- 네임스페이스: B2B 개인
- 대상 속성:
b2b.personKey.sourceKey
- 현재 스키마의 관계 이름: 개인
- 참조 스키마의 관계 이름: 캠페인
두 번째 관계
- 기본 클래스의
campaignKey.sourceKey
- 유형: 다대일
- 참조 스키마: B2B 캠페인
- 네임스페이스: B2B 캠페인
- 대상 속성:
campaignKey.sourceKey
- 현재 스키마의 관계 이름: 캠페인
- 참조 스키마의 관계 이름: 사람
marketingListKey.sourceKey
marketingListMemberKey.sourceKey
첫 번째 관계
- 기본 클래스의
PersonKey.sourceKey
- 유형: 다대일
- 참조 스키마: B2B 개인
- 네임스페이스: B2B 개인
- 대상 속성:
b2b.personKey.sourceKey
- 현재 스키마의 관계 이름: 개인
- 참조 스키마의 관계 이름: 마케팅 목록
두 번째 관계
- 기본 클래스의
marketingListKey.sourceKey
- 유형: 다대일
- 참조 스키마: B2B 마케팅 목록
- 네임스페이스: B2B 마케팅 목록
- 대상 속성:
marketingListKey.sourceKey
- 현재 스키마의 관계 이름: 마케팅 목록
- 참조 스키마의 관계 이름: 사람
- WebPage 방문
- 새 잠재 고객
- 잠재 고객 전환
- 목록에 추가
- 목록에서 제거
- 영업 기회에 추가
- 영업 기회에서 제거
- 작성된 양식
- 링크 클릭수
- 이메일 전달됨
- 이메일 열림
- 이메일 클릭됨
- 반송된 이메일
- 가볍게 반송된 이메일
- 이메일 구독 취소됨
- 스코어 변경됨
- 영업 기회 업데이트됨
- 캠페인 진행률 상태 변경됨
- 개인 식별자
- Marketo 웹 URL
- 즐거운 순간
- Webhook 호출
- 캠페인 케이던스 변경
- 수익 단계 변경됨
- 잠재 고객 병합
- 이메일 전송 완료
- 캠페인 스트림 변경
- Campaign에 추가
personKey.sourceKey
첫 번째 관계
listOperations.listKey.sourceKey
필드- 유형: 일대일
- 참조 스키마: B2B 마케팅 목록
- 네임스페이스: B2B 마케팅 목록
두 번째 관계
opportunityEvent.opportunityKey.sourceKey
필드- 유형: 일대일
- 참조 스키마: B2B 영업 기회
- 네임스페이스: B2B 영업 기회
세 번째 관계
leadOperation.campaignProgression.campaignKey.sourceKey
필드- 유형: 일대일
- 참조 스키마: B2B 캠페인
- 네임스페이스: B2B 캠페인
ExperienceEvent
이(가) 엔터티와 다릅니다. 경험 이벤트 ID는 활동을 수행한 사용자입니다.accountPersonKey.sourceKey
첫 번째 관계
- 기본 클래스의
personKey.sourceKey
- 유형: 다대일
- 참조 스키마: B2B 개인
- 네임스페이스: B2B 개인
- 대상 속성:
b2b.personKey.SourceKey
- 현재 스키마의 관계 이름: 사람
- 참조 스키마의 관계 이름: 계정
두 번째 관계
- 기본 클래스의
accountKey.sourceKey
- 유형: 다대일
- 참조 스키마: B2B 계정
- 네임스페이스: B2B 계정
- 대상 속성:
accountKey.sourceKey
- 현재 스키마의 관계 이름: 계정
- 참조 스키마의 관계 이름: 사람