(베타) Marketo Engage 네임스페이스 및 스키마

중요

Marketo Engage 소스는 현재 베타 상태입니다. 기능 및 설명서는 변경될 수 있습니다.

이 문서에서는 Marketo Engage (이하 "Marketo"이라 함)에 사용되는 B2B 네임스페이스 및 스키마(이하 "기본 설정"이라 함)에 대한 정보를 제공합니다. 또한 이 문서에서는 Marketo B2B 네임스페이스 및 스키마를 생성하는 데 필요한 Postman 자동화 유틸리티 설정에 대한 세부 정보를 제공합니다.

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

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

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

이제 플랫폼 개발자 콘솔과 Postman 설정을 통해 Postman 환경에 적절한 환경 값을 적용할 수 있습니다.

다음 표에는 Postman 환경 채우기에 대한 추가 정보와 예제 값이 포함되어 있습니다.

변수 설명
CLIENT_SECRET {ACCESS_TOKEN}을(를) 생성하는 데 사용되는 고유 식별자입니다. {CLIENT_SECRET}의 검색 방법에 대한 자세한 내용은 Experience Platform API를 인증하고 액세스하는 방법에 대한 자습서를 참조하십시오. {CLIENT_SECRET}
JWT_TOKEN JWT(JSON 웹 토큰)는 {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 제품 및 서비스를 소유 또는 라이센스하고 해당 구성원에 대한 액세스를 허용할 수 있는 법인. {IMS_ORG} 정보를 검색하는 방법에 대한 지침은 개발자 콘솔 설정 및 Postman에 대한 자습서를 참조하십시오. ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME 사용 중인 가상 샌드박스 파티션의 이름입니다. prod
TENANT_ID 만든 리소스가 적절하게 지정되어 IMS 조직 내에 들어 있는지 확인하는 데 사용되는 ID입니다. b2bcdpproductiontest
PLATFORM_URL API 호출을 수행하는 URL 끝점입니다. 이 값은 고정되고 항상 다음과 같이 설정됩니다.http://platform.adobe.io/. http://platform.adobe.io/
munchkinId Marketo 계정에 대한 고유 ID. munchkinId을(를) 검색하는 방법에 대한 자세한 내용은 인스턴스 Marketo 인스턴스를 인증하는 방법에 대한 자습서를 참조하십시오. 123-ABC-456
sfdc_org_id Salesforce 계정의 조직 ID. Salesforce 조직 ID를 취득하는 방법에 대한 자세한 내용은 다음 Salesforce 안내서를 참조하십시오. 00D4W000000FgYJUA0
msd_org_id Dynamics 계정의 조직 ID. Dynamics 조직 ID를 취득하는 방법에 대한 자세한 내용은 다음 Microsoft Dynamics 안내서를 참조하십시오. f6438fab-67e8-4814-a6b5-8c8dcdf7a98f
has_abm Marketo Account-Based Marketing에 가입했는지 여부를 나타내는 부울 값입니다. false
has_msi Marketo Sales Insight에 속하는지 여부를 나타내는 부울 값입니다. false

스크립트 실행

Postman 컬렉션 및 환경이 설정되면 이제 Postman 인터페이스를 통해 스크립트를 실행할 수 있습니다.

Postman 인터페이스에서 자동 생성기 유틸리티의 루트 폴더를 선택한 다음 상단 헤더에서 Run​을 선택합니다.

루트 폴더

Runner 인터페이스가 나타납니다. 여기서 모든 확인란을 선택한 다음 Run Adobe I/O Access Token Generation + Automate Namespace creation​을 선택합니다.

run-generator

요청이 성공하면 베타 사양에 따라 B2B 네임스페이스 및 스키마가 만들어집니다.

Marketo 네임스페이스

ID 네임스페이스는 ID와 관련된 컨텍스트의 표시기 역할을 하는 Identity Service의 구성 요소입니다.

정규화된 ID에는 ID 값과 네임스페이스가 포함됩니다. 모든 새로운 Marketo 인스턴스와 데이터 집합 조합에 대해 새 사용자 지정 네임스페이스가 필요합니다. 예를 들어 programs 데이터 세트를 인제스트하는 소스 커넥터에는 고유한 사용자 정의 네임스페이스가 필요하며, 동일한 데이터 세트를 인제스트하는 다른 Marketo 소스 커넥터에도 고유한 사용자 정의 네임스페이스가 필요합니다. Marketo 자세한 내용은 네임스페이스 개요를 참조하십시오.

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

다음 표는 Marketo 네임스페이스에 대해 설정된 기본 설정에 대한 정보를 포함합니다.

노트

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

디스플레이 이름 ID 기호 ID 유형 발급자 유형 발급자 엔티티 유형 Munchkin ID 예
marketo_person_{MUNCHKIN_ID} 자동 생성 CROSS_DEVICE Marketo person 123-ABC-789
marketo_company_{MUNCHKIN_ID} 자동 생성 B2B_ACCOUNT Marketo company 123-ABC-789
marketo_opportunity_{MUNCHKIN_ID} 자동 생성 B2B_OPPORTUNITY Marketo opportunity 123-ABC-789
marketo_opportunity_contact_role_{MUNCHKIN_ID} 자동 생성 B2B_OPPORTUNITY_PERSON Marketo opportunity contact role 123-ABC-789
marketo_program_{MUNCHKIN_ID} 자동 생성 B2B_CAMPAIGN Marketo program 123-ABC-789
marketo_program_member_{MUNCHKIN_ID} 자동 생성 B2B_CAMPAIGN_MEMBER Marketo program member 123-ABC-789
marketo_static_list_{MUNCHKIN_ID} 자동 생성 B2B_MARKETING_LIST Marketo static list 123-ABC-789
marketo_static_list_member_{MUNCHKIN_ID} 자동 생성 B2B_MARKETING_LIST_MEMBER Marketo static list member 123-ABC-789
marketo_named_account_{MUNCHKIN_ID} 자동 생성 B2B_ACCOUNT Marketo named account 123-ABC-789

Salesforce 네임스페이스

Salesforce 통합을 구독하는 경우 엔티티의 보조 ID에 Salesforce 네임스페이스가 사용됩니다.

다음 표는 Salesforce 네임스페이스에 대해 설정된 기본 설정에 대한 정보를 포함합니다.

노트

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

디스플레이 이름 ID 기호 ID 유형 발급자 유형 발급자 엔티티 유형 Salesforce 구독 조직 ID 예
salesforce_lead_{SALESFORCE_ORGANIZATION_ID} 자동 생성 CROSS_DEVICE Salesforce lead 00DA0000000Hz79
salesforce_account_{SALESFORCE_ORGANIZATION_ID} 자동 생성 B2B_ACCOUNT Salesforce account 00DA0000000Hz79
salesforce_opportunity_{SALESFORCE_ORGANIZATION_ID} 자동 생성 B2B_OPPORTUNITY Salesforce opportunity 00DA0000000Hz79
salesforce_opportunity_contact_role_{SALESFORCE_ORGANIZATION_ID} 자동 생성 B2B_OPPORTUNITY_PERSON Salesforce opportunity contact role 00DA0000000Hz79
salesforce_campaign_{SALESFORCE_ORGANIZATION_ID} 자동 생성 B2B_CAMPAIGN Salesforce campaign 00DA0000000Hz79
salesforce_campaign_member_{SALESFORCE_ORGANIZATION_ID} 자동 생성 B2B_CAMPAIGN_MEMBER Salesforce campaign member 00DA0000000Hz79

Microsoft Dynamics 네임스페이스

Dynamics 통합을 구독하는 경우 Dynamics 네임스페이스가 엔티티의 보조 ID로 사용됩니다.

다음 표는 Dynamics 네임스페이스에 대해 설정된 기본 설정에 대한 정보를 포함합니다.

노트

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

디스플레이 이름 ID 기호 ID 유형 발급자 유형 발급자 엔티티 유형 Dynamics 구독 조직 ID 예
microsoft_person_{DYNAMICS_ID} 자동 생성 CROSS_DEVICE Microsoft person 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_account_{DYNAMICS_ID} 자동 생성 B2B_ACCOUNT Microsoft account 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_opportunity_{DYNAMICS_ID} 자동 생성 B2B_OPPORTUNITY Microsoft opportunity 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_opportunity_contact_connection_{DYNAMICS_ID} 자동 생성 B2B_OPPORTUNITY_PERSON Microsoft opportunity relationship 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_campaign_{DYNAMICS_ID} 자동 생성 B2B_CAMPAIGN Microsoft campaign 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_campaign_member_{DYNAMICS_ID} 자동 생성 B2B_CAMPAIGN_MEMBER Microsoft campaign member 94cahe38-e51h-3d57-a9c6-2edklb7184mh

Marketo 스키마

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

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

디자인 원칙 및 우수 사례를 포함하여 스키마 구성 모델에 대한 자세한 내용은 스키마 컴포지션🔗의 기본 사항을 참조하십시오.

다음 표는 Marketo 스키마의 기본 설정에 대한 정보를 포함합니다.

노트

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

스키마 이름 기본 클래스 필드 그룹 Profile 스키마에서 기본 ID 기본 ID 네임스페이스 보조 ID 보조 ID 네임스페이스 관계 참고
Marketo Company {MUNCHKIN_ID} XDM 비즈니스 계정 XDM 비즈니스 계정 세부 정보 활성화됨 accountID 기본 클래스에서 marketo_company_{MUNCHKIN_ID} extSourceSystemAudit.externalID 기본 클래스에서 salesforce_account_{SALESFORCE_ORGANIZATION_ID}
  • accountParentID XDM 비즈니스 계정 세부 정보 필드 그룹에서
  • 유형:1대1
  • 참조 스키마:Marketo Company {MUNCHKIN_ID}
  • 네임스페이스: marketo_company_{MUNCHKIN_ID}
Marketo Person {MUNCHKIN_ID} XDM 개별 프로필
  • XDM 비즈니스 담당자 세부 정보
  • XDM 비즈니스 담당자 구성 요소
  • IdentityMap
활성화됨 personID 기본 클래스에서 marketo_person_{MUNCHKIN_ID}
  1. extSourceSystemAudit.externalID XDM Business Person Details 필드 그룹
  2. workEmail.address XDM Business Person Details 필드 그룹
  3. identityMap ID 맵 필드 그룹
  1. salesforce_lead_{SALESFORCE_ORGANIZATION_ID}
  2. 이메일
  3. ECID
  • personComponents.sourceAccountID XDM Business Person Components 필드 그룹
  • 유형:다대다
  • 참조 스키마:Marketo Company {MUNCHKIN_ID}
  • 네임스페이스: marketo_company_{MUNCHKIN_ID}
  • 대상 속성:accountID
  • 현재 스키마의 관계 이름:계정
  • 참조 스키마의 관계 이름:People
Marketo Opportunity {MUNCHKIN_ID} XDM 비즈니스 기회 XDM 비즈니스 기회 세부 정보 활성화됨 opportunityID 기본 클래스에서 marketo_opportunity_{MUNCHKIN_ID} extSourceSystemAudit.externalID 기본 클래스에서 salesforce_opportunity_{SALESFORCE_ORGANIZATION_ID}
  • accountID 기본 클래스에서
  • 유형:다대다
  • 참조 스키마:Marketo Company {MUNCHKIN_ID}
  • 네임스페이스: marketo_company_{MUNCHKIN_ID}
  • 대상 속성:accountID
  • 현재 스키마의 관계 이름:계정
  • 참조 스키마의 관계 이름:기회
Marketo Opportunity Contact Role {MUNCHKIN_ID} XDM 사업 기회 담당자 관계 None 활성화됨 opportunityPersonID 기본 클래스에서 marketo_opportunity_contact_role_{MUNCHKIN_ID} extSourceSystemAudit.externalID 기본 클래스에서 salesforce_opportunity_contact_role_{SALESFORCE_ORGANIZATION_ID} 첫 번째 관계
  • personID 기본 클래스에서
  • 유형:다대다
  • 참조 스키마:Marketo Person {MUNCHKIN_ID}
  • 네임스페이스: marketo_person_{MUNCHKIN_ID}
  • 대상 속성:personID
  • 현재 스키마의 관계 이름:Person
  • 참조 스키마의 관계 이름:기회
두 번째 관계
  • opportunityID 기본 클래스에서
  • 유형:다대다
  • 참조 스키마:Marketo Opportunity {MUNCHKIN_ID}
  • 네임스페이스: marketo_opportunity_{MUNCHKIN_ID}
  • 대상 속성:opportunityID
  • 현재 스키마의 관계 이름:기회
  • 참조 스키마의 관계 이름:People
Marketo Program {MUNCHKIN_ID} XDM 비즈니스 캠페인 XDM 비즈니스 캠페인 세부 사항 활성화됨 campaignID 기본 클래스에서 marketo_program_{MUNCHKIN_ID} extSourceSystemAudit.externalID 기본 클래스에서 salesforce_campaign_{SALESFORCE_ORGANIZATION_ID}
Marketo Program Member {MUNCHKIN_ID} XDM 비즈니스 캠페인 구성원 XDM 비즈니스 캠페인 멤버 세부 사항 활성화됨 campaignMemberID 기본 클래스에서 marketo_program_member_{MUNCHKIN_ID} 없음 없음 첫 번째 관계
  • personID 기본 클래스에서
  • 유형:다대다
  • 참조 스키마:Marketo Person {MUNCHKIN_ID}
  • 네임스페이스: marketo_person_{MUNCHKIN_ID}
  • 대상 속성:personID
  • 현재 스키마의 관계 이름:Person
  • 참조 스키마의 관계 이름:프로그램
두 번째 관계
  • campaignID 기본 클래스에서
  • 유형:다대다
  • 참조 스키마:Marketo Program {MUNCHKIN_ID}
  • 네임스페이스: marketo_program_{MUNCHKIN_ID}
  • 대상 속성:campaignID
  • 현재 스키마의 관계 이름:프로그램
  • 참조 스키마의 관계 이름:People
Marketo Static List {MUNCHKIN_ID} XDM 비즈니스 마케팅 목록 없음 활성화됨 marketingListID 기본 클래스에서 marketo_static_list_{MUNCHKIN_ID} 없음 없음 없음 정적 목록은 Salesforce에서 동기화되지 않으므로 보조 ID가 없습니다.
Marketo Static List Member {MUNCHKIN_ID} XDM 비즈니스 마케팅 목록 구성원 없음 활성화됨 marketingListMemberID 기본 클래스에서 marketo_static_list_member_{MUNCHKIN_ID} 없음 없음 첫 번째 관계
  • personID 기본 클래스에서
  • 유형:다대다
  • 참조 스키마:Marketo Person {MUNCHKIN_ID}
  • 네임스페이스: marketo_person_{MUNCHKIN_ID}
  • 대상 속성:personID
  • 현재 스키마의 관계 이름:Person
  • 참조 스키마의 관계 이름:목록
두 번째 관계
  • marketingListID 기본 클래스에서
  • 유형:다대다
  • 참조 스키마:Marketo Static List {MUNCHKIN_ID}
  • 네임스페이스: marketo_static_list_{MUNCHKIN_ID}
  • 대상 속성:marketingListID
  • 현재 스키마의 관계 이름:목록
  • 참조 스키마의 관계 이름:People
정적 목록 멤버는 Salesforce에서 동기화되지 않으므로 보조 ID가 없습니다.
Marketo Named Account {MUNCHKIN_ID} XDM 비즈니스 계정 XDM 비즈니스 계정 세부 정보 활성화됨 accountID 기본 클래스에서 marketo_named_account_{MUNCHKIN_ID} extSourceSystemAudit.externalID 기본 클래스에서 salesforce_account_{SALESFORCE_ORGANIZATION_ID}
  • accountParentID XDM 비즈니스 계정 세부 정보 필드 그룹에서
  • 유형:1대1
  • 참조 스키마:Marketo Named Account {MUNCHKIN_ID}
  • 네임스페이스: marketo_named_account_{MUNCHKIN_ID}
Marketo 활동 {MUNCHKIN ID} XDM ExperienceEvent
  • 웹 페이지 방문
  • 새 리드
  • 리드 변환
  • 목록에 추가
  • 목록에서 제거
  • 기회에 추가
  • 기회에서 제거
  • 양식 작성됨
  • 링크 클릭 수
  • 배달된 이메일
  • 연 이메일
  • 클릭한 이메일
  • 바운스된 이메일
  • 바운스된 이메일 소프트
  • 구독 취소된 이메일
  • 점수 변경됨
  • 기회 업데이트됨
  • 캠페인 진행 상태의 상태가 변경됨
  • 개인 식별자
  • Marketo 웹 URL
활성화됨 personID 의 사람 식별자 필드 그룹 marketo_person_{MUNCHKIN_ID} 없음 없음 첫 번째 관계
  • listOperations.listID 필드
  • 유형:1대1
  • 참조 스키마:Marketo Static List {MUNCHKIN_ID}
  • 네임스페이스: marketo_static_list_{MUNCHKIN_ID}
두 번째 관계
  • opportunityEvent.opportunityID 필드
  • 유형:1대1
  • 참조 스키마:Marketo Opportunity {MUNCHKIN_ID}
  • 네임스페이스: marketo_opportunity_{MUNCHKIN_ID}
제3의 관계
  • leadOperation.campaignProgression.campaignID 필드
  • 유형:1대1
  • 참조 스키마:Marketo Program {MUNCHKIN_ID}
  • 네임스페이스: marketo_program_{MUNCHKIN_ID}
Marketo Activity {MUNCHKIN_ID} 스키마의 기본 ID는 personID이며 [!DNL Marketo] Person {MUNCHKIN_ID} 스키마의 기본 ID와 같습니다.

다음 단계

Marketo 데이터를 플랫폼에 연결하는 방법을 알아보려면 UI🔗에서 Marketo 소스 커넥터 만들기에서 자습서를 참조하십시오.

이 페이지에서는