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

B2B 네임스페이스 및 스키마

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

작성 대상:

  • 개발자
NOTE
Adobe Experience Platform UI의 템플릿을 사용하여 B2B 및 B2C 데이터에 대한 에셋을 신속하게 만들 수 있습니다. 자세한 내용은 Platform UI에서 템플릿 사용에 대한 안내서를 참조하십시오.

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

IMPORTANT
B2B 스키마가 실시간 고객 프로필에 참여하려면 Adobe Real-time Customer Data Platform B2B 에디션에 액세스할 수 있어야 합니다.

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

run-generator

요청이 성공하면 B2B에 필요한 네임스페이스와 스키마가 만들어집니다.

B2B 네임스페이스

ID 네임스페이스는 ID의 컨텍스트를 구분하는 역할을 하는 Identity Service의 구성 요소입니다. 정규화된 ID에는 ID 값과 네임스페이스가 포함됩니다. 자세한 내용은 네임스페이스 개요를 참조하십시오.

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

다음 표에는 B2B 네임스페이스에 대한 기본 설정에 대한 정보가 나와 있습니다.

NOTE
표의 전체 내용을 보려면 왼쪽/오른쪽으로 스크롤하십시오.
표시 이름
신원 기호
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 스키마의 기본 설정에 대한 정보가 포함되어 있습니다.

NOTE
표의 전체 내용을 보려면 왼쪽/오른쪽으로 스크롤하십시오.
스키마 이름
기본 클래스
필드 그룹
스키마의 Profile
기본 ID
기본 ID 네임스페이스
보조 ID
보조 ID 네임스페이스
관계
참고
B2B 계정
XDM 비즈니스 계정
XDM 비즈니스 계정 세부 정보
활성화됨
기본 클래스의 accountKey.sourceKey
B2B 계정
기본 클래스의 extSourceSystemAudit.externalKey.sourceKey
B2B 계정
  • XDM 비즈니스 계정 세부 정보 필드 그룹의 accountParentKey.sourceKey
  • 대상 속성: /accountKey/sourceKey
  • 유형: 일대일
  • 참조 스키마: B2B 계정
  • 네임스페이스: B2B 계정
B2B 개인
XDM 개별 프로필
  • XDM 비즈니스 사용자 세부 정보
  • XDM 비즈니스 사용자 구성 요소
  • IdentityMap
  • 동의 및 환경 설정 세부 정보
활성화됨
XDM 비즈니스 사용자 세부 정보 필드 그룹의 b2b.personKey.sourceKey
B2B 개인
  1. XDM 비즈니스 사용자 세부 정보 필드 그룹의 extSourceSystemAudit.externalKey.sourceKey
  2. XDM 비즈니스 사용자 세부 정보 필드 그룹의 workEmail.address
  1. B2B 개인
  2. 이메일
  • XDM 비즈니스 사용자 구성 요소 필드 그룹의 personComponents.sourceAccountKey.sourceKey
  • 유형: 다대일
  • 참조 스키마: 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
  • 현재 스키마의 관계 이름: Opportunity
  • 참조 스키마의 관계 이름: 사람
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 비즈니스 마케팅 목록
None
활성화됨
기본 클래스의 marketingListKey.sourceKey
B2B 마케팅 목록
None
None
None
정적 목록이 Salesforce에서 동기화되지 않았으므로 보조 ID가 없습니다.
B2B 마케팅 목록 멤버
XDM 비즈니스 마케팅 목록 구성원
None
활성화됨
기본 클래스의 marketingListMemberKey.sourceKey
B2B 마케팅 목록 멤버
None
None

첫 번째 관계

  • 기본 클래스의 PersonKey.sourceKey
  • 유형: 다대일
  • 참조 스키마: B2B 개인
  • 네임스페이스: B2B 개인
  • 대상 속성: b2b.personKey.sourceKey
  • 현재 스키마의 관계 이름: 개인
  • 참조 스키마의 관계 이름: 마케팅 목록

두 번째 관계

  • 기본 클래스의 marketingListKey.sourceKey
  • 유형: 다대일
  • 참조 스키마: B2B 마케팅 목록
  • 네임스페이스: B2B 마케팅 목록
  • 대상 속성: marketingListKey.sourceKey
  • 현재 스키마의 관계 이름: 마케팅 목록
  • 참조 스키마의 관계 이름: 사람
정적 목록 멤버가 Salesforce에서 동기화되지 않았으므로 보조 ID가 없습니다.
B2B 활동
XDM ExperienceEvent
  • WebPage 방문
  • 새 잠재 고객
  • 잠재 고객 전환
  • 목록에 추가
  • 목록에서 제거
  • 영업 기회에 추가
  • 영업 기회에서 제거
  • 작성된 양식
  • 링크 클릭수
  • 이메일 전달됨
  • 이메일 열림
  • 이메일 클릭됨
  • 반송된 이메일
  • 가볍게 반송된 이메일
  • 이메일 구독 취소됨
  • 스코어 변경됨
  • 영업 기회 업데이트됨
  • 캠페인 진행률 상태 변경됨
  • 개인 식별자
  • Marketo 웹 URL
  • 즐거운 순간
  • Webhook 호출
  • 캠페인 케이던스 변경
  • 수익 단계 변경됨
  • 잠재 고객 병합
  • 이메일 전송 완료
  • 캠페인 스트림 변경
  • Campaign에 추가
활성화됨
개인 식별자 필드 그룹의 personKey.sourceKey
B2B 개인
None
None

첫 번째 관계

  • listOperations.listKey.sourceKey 필드
  • 유형: 일대일
  • 참조 스키마: B2B 마케팅 목록
  • 네임스페이스: B2B 마케팅 목록

두 번째 관계

  • opportunityEvent.opportunityKey.sourceKey 필드
  • 유형: 일대일
  • 참조 스키마: B2B 영업 기회
  • 네임스페이스: B2B 영업 기회

세 번째 관계

  • leadOperation.campaignProgression.campaignKey.sourceKey 필드
  • 유형: 일대일
  • 참조 스키마: B2B 캠페인
  • 네임스페이스: B2B 캠페인
ExperienceEvent이(가) 엔터티와 다릅니다. 경험 이벤트 ID는 활동을 수행한 사용자입니다.
B2B 계정 사용자 관계
XDM 비즈니스 계정 사용자 관계
ID 맵
활성화됨
기본 클래스의 accountPersonKey.sourceKey
B2B 계정 사용자 관계
None
None

첫 번째 관계

  • 기본 클래스의 personKey.sourceKey
  • 유형: 다대일
  • 참조 스키마: B2B 개인
  • 네임스페이스: B2B 개인
  • 대상 속성: b2b.personKey.SourceKey
  • 현재 스키마의 관계 이름: 사람
  • 참조 스키마의 관계 이름: 계정

두 번째 관계

  • 기본 클래스의 accountKey.sourceKey
  • 유형: 다대일
  • 참조 스키마: B2B 계정
  • 네임스페이스: B2B 계정
  • 대상 속성: accountKey.sourceKey
  • 현재 스키마의 관계 이름: 계정
  • 참조 스키마의 관계 이름: 사람

다음 단계

Marketo 데이터를 플랫폼에 연결하는 방법은 UI에서 Marketo 소스 커넥터 만들기에 대한 자습서를 참조하십시오.

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