GenStudio용 Marketo
동일한 IMS 조직에서 Marketo Engage 및 GenStudio for Performance Marketing을(를) 사용하는 조직은 Adobe Exchange에서 GenStudio용 Marketo 앱을 설치할 수 있습니다. 시스템 관리자가 앱을 승인하고 배포를 완료한 후 작성자가 Content에 직접 업로드된 템플릿 옆에 있는 Marketo에서 이메일 경험을 만들면서 GenStudio 템플릿을 선택할 수 있습니다.
이 항목은 앱을 설치하고, Marketo에서 자격 증명을 수집하고, Exchange에서 앱을 배포하는 관리자를 위한 항목입니다. AJO 및 Marketo 템플릿 구문이 GenStudio에서 작동하는 방법은 AJO 및 Marketo의 템플릿을 참조하십시오.
사전 요구 사항
- 확장을 배포하는 조직에서 Marketo Engage을(를) 프로비저닝해야 합니다.
- 응용 프로그램을 배포하는 사용자는 Marketo 자격 증명이 필요합니다. 이러한 자격 증명을 만들고 검색하려면 Marketo 제품 관리자 액세스 권한이 있어야 합니다(Marketo을 열 때 관리자 영역을 사용할 수 있어야 함).
Adobe Exchange에서 앱 설치
- Adobe Exchange을 열고 Experience Cloud(으)로 이동합니다.
- GenStudio용 Marketo 목록을 엽니다.
- 조직에 대한 앱을 요청하려면 무료를 선택하세요.
- 조직에서 요청을 검토 및 승인한 후 Marketo 자격 증명 가져오기 및 Exchange에서 응용 프로그램을 배포합니다.
Marketo 자격 증명 가져오기
Marketo 인스턴스(Adobe Developer Console 아님)의 자격 증명을 사용합니다. Exchange에서 배포하기 전에 아래 단계를 사용하여 다음 자격 증명을 수집합니다.
API 전용 사용자 만들기(기존 API 사용자를 재사용하는 경우 선택 사항)
- Marketo에서 관리자(으)로 이동합니다.
- 보안에서 사용자 및 역할을 열고 역할 탭으로 이동합니다.
- 다음 권한을 추가하여 새 역할을 만들거나 기존 역할을 편집합니다. API 액세스 및 Design Studio 액세스.
- 새 API 사용자의 경우 API 전용 사용자 만들기를 클릭합니다(각 API 사용자에 대해 고유한 이메일 사용).
- 역할 확인란을 선택하고 만든 새 역할을 할당합니다. 사용할 API 사용자가 이미 있는 경우 LaunchPoint 서비스 만들기 또는 선택으로 건너뛰십시오.
LaunchPoint 서비스 만들기 또는 선택
- 관리자의 통합에서 LaunchPoint를 엽니다.
- 새 서비스를 만들거나 기존 사용자 지정 서비스를 사용하려면 만들기를 클릭하십시오.
- 서비스에 대해 세부 정보 보기를 클릭하고 클라이언트 ID 및 클라이언트 암호를 복사합니다. Adobe Exchange 구성에 입력하게 됩니다.
Marketo REST API 기본 URL 참고
- 관리자의 통합에서 웹 서비스를 엽니다.
- REST API 끝점을 찾습니다.
https://###-XXX-###.mktorest.com형식으로 기본 URL(호스트)만 복사합니다. not에/rest또는/identity과(와) 같은 경로 세그먼트를 포함하지 마십시오. 이 값은 Marketo 인스턴스별로 고유합니다.
Exchange 배포 화면에서 요청하는 Marketo Engage ID URL과(와) LaunchPoint의 REST 기본 URL, 클라이언트 ID 및 클라이언트 암호가 필요합니다.
Exchange에서 애플리케이션 배포
GenStudio에서 확장을 사용할 수 있도록 하려면 Adobe Exchange에서 앱을 배포합니다.
- Adobe Exchange(으)로 돌아갑니다.
- 관리를 선택하고 GenStudio용 Marketo 앱(예: App Builder 응용 프로그램 또는 조직의 관리 앱)을 엽니다.
- 환경에서 드롭다운에서 기존 환경을 선택하거나 환경 추가를 선택하여 환경을 만듭니다.
- 선택한 환경에 대해 구성을 엽니다.
- Marketo Engage ID URL 및 Marketo Engage REST API 기본 URL 모두에 대해 LaunchPoint의 클라이언트 ID 및 클라이언트 암호, Marketo Engage ID URL 및 Marketo Engage REST API 기본 URL(웹 서비스의 기본 호스트)을 입력합니다.
- 배포를 클릭합니다. 배포가 성공하면 작업이 배포 취소(으)로 변경됩니다.
구성 업데이트
환경에 대한 구성 값을 변경하려면 먼저 배포 취소하고 필드를 업데이트한 다음 다시 배포하십시오.
Workspace 구성(선택 사항)
기본 작업 영역을 사용하려면 이 단계를 건너뛸 수 있습니다. 기본적으로 Workspace ID 및 템플릿 목록 페이지 크기 필드는 미리 구성되어 있습니다.
그러나 다른 작업 영역에서 템플릿을 가져와야 하는 경우:
- Marketo에서 관리 → 보안 → 작업 공간 및 파티션으로 이동합니다.
- Workspace ID 열은 기본적으로 숨겨져 있습니다. 활성화하려면 머리글 행(열 이름이 표시되는 위치)을 마우스 오른쪽 단추로 클릭합니다.
- 열을(를) 선택하십시오.
- 목록에서 ID 사용
표시되면 구성에 적절한 Workspace ID을(를) 사용합니다.
GenStudio에서 Marketo 템플릿 액세스
GenStudio용 Marketo이 설치 및 구성된 후 GenStudio에서 이메일 경험을 만들 때 Marketo 템플릿 탭이 나타납니다. 이 탭을 사용하여 Marketo Engage에서 템플릿을 검색할 수 있습니다.
문제 해결
Marketo 템플릿 탭이 표시되지 않음
- 앱이 Exchange에서 승인됨이고 환경이 올바른 클라이언트 ID, 클라이언트 암호 및 Marketo 기본 URL을 사용하여 배포됨인지 확인하십시오.
- 자격 증명을 만들 때 Marketo 제품 관리자 액세스가 사용되었는지 확인하도록 관리자에게 요청하십시오.
템플릿이 로드되지 않음
- 페이지를 다시 로드하거나 로그아웃한 후 GenStudio으로 다시 로그인합니다.
- 브라우저 개발자 도구 네트워크 패널에서 Marketo 인스턴스에 대해 실패한 API 호출을 찾고 REST 기본 URL이 Marketo의 웹 서비스와(호스트 뒤에 추가 경로가 없음) 일치하는지 확인합니다.
“템플릿을 찾을 수 없음” 오류
확장이 성공적으로 설치되고 Marketo 템플릿 탭이 표시되지만 "템플릿을 찾을 수 없음"을 표시하는 경우 템플릿을 렌더링하는 동안 애플리케이션에서 크기 제한을 초과하여 충돌이 발생할 수 있습니다.
이 문제를 해결하려면
- Exchange에서 애플리케이션 배포를 취소합니다.
- 템플릿 목록 페이지 크기를 줄입니다(예: 1 또는 2로 설정).
- 응용 프로그램을 다시 배포합니다.