흐름 단계 서비스 flow-step-service
셀프서비스 흐름 단계는 웹 서비스를 작성, 게시 및 Adobe Marketo Engage 스마트 캠페인에 통합하기 위한 프레임워크 및 기능 세트입니다. 이 안내서는 이미 생성되어 게시된 서비스를 설치하고 사용하려는 Marketo Engage 최종 사용자를 위한 것입니다. 자체 서비스 작성 및 게시에 대한 자세한 내용은 서비스 공급자 인터페이스에 대한 GitHub 저장소. A Proof-of-Concept Lookup Table implementation may be found here.
온보딩 및 서비스 관리 onboarding-and-managing-services
사용자 지정 흐름 단계를 설치하려면 Marketo에서 관리자 권한이 필요합니다. 설치 URL과는 별도로, 서비스 공급자 그리드에서 서비스 세부 정보 화면으로 드릴다운하여 초기 온보딩을 완료한 후 서비스의 다른 모든 측면을 편집할 수 있습니다.
설치 URL installation-url
설치를 시작하려면 먼저 서비스를 정의하는 OpenAPI 문서의 URL을 가져와야 합니다. 서비스 공급업체는 이를 제공할 수 있어야 하며 일반적으로 다음으로 끝나는 URL을 갖게 됩니다. /openapi.json. 전체 URL은 다음과 같이 표시됩니다. https://www.example.com/OpenAPI.json. 이 URL이 있으면 관리 섹션의 서비스 공급자 메뉴로 이동합니다.
클릭 다음 서비스 자격 증명 입력 섹션으로 이동합니다.
서비스 자격 증명 입력 enter-service-credentials
설치 중인 서비스에 액세스하려면 Marketo에 유효한 API 자격 증명이 있어야 합니다. 이러한 자격 증명은 서비스 공급자가 제공해야 합니다. 서비스에는 세 가지 서로 다른 인증 옵션이 있으므로 자격 증명에 대한 세 가지 프롬프트 중 하나가 표시될 수 있습니다. API 키 입력 필드가 하나뿐인 경우 기본 인증 사용자 이름과 암호가 필요하고 영역 이라는 필드가 필요할 수 있습니다. OAuth2 사용 클라이언트 자격 증명 grant, 즉 클라이언트 ID 및 클라이언트 암호.
자격 증명을 저장할 때 Marketo은 서비스의 상태 끝점을 호출하여 해당 상태가 유효한지 확인합니다. 제공된 자격 증명이 유효하지 않은 경우 이를 나타내는 오류가 표시됩니다.
온보딩 안내서 (선택 사항) onboarding-guide
일부 서비스 공급업체는 선택적 온보딩 안내서 단계를 포함합니다. 이 단계에는 해당 서비스와 관련된 서비스 온보딩을 완료하기 위한 추가 지침이 포함됩니다.
필드 매핑 field-mapping
특정 리드 필드에서 데이터를 받거나 반환하려면 해당 필드를 매핑해야 합니다. 매핑은 온보딩 중 필요한 단계이지만 나중에 언제든지 돌아가서 매핑을 변경할 수 있습니다. 별도의 화면에 구성된 두 가지 유형의 매핑이 있습니다. 발신 필드: Marketo이 흐름 단계를 호출할 때 서비스로 전송됩니다. 수신 필드 : Marketo으로 데이터를 반환할 때 서비스에서 데이터를 받을 수 있는 필드입니다.
옵션 필드 매핑은 서비스 중단 없이 비활성화될 수 있지만 필수 매핑은 완전히 제거되거나 비활성화되지 않을 수 있습니다.
서비스 중심 매핑 service-driven-mappings
이벤트 등록 흐름 단계와 같이 입력 및 출력 세트가 고정된 서비스는 서비스 중심 매핑. 이 유형의 매핑의 경우 서비스 공급자는 데이터 유형과 힌트를 모두 API 이름 형태로 제공합니다. 힌트가 기존 잠재 고객 필드의 API 이름과 일치하는 경우 매핑 섹션에서 해당 필드가 자동으로 채워집니다. 일치하는 힌트가 없는 필드의 경우 필드 목록에서 매핑을 일치하는 데이터 유형으로 수동으로 채워야 합니다. 온보딩을 완료하려면 필요한 매핑을 채워야 합니다.
사용자 기반 매핑 user-driven-mappings
날짜 서식 지정 서비스와 같이 입력 및 출력 세트가 고정되어 있지 않은 서비스는 사용자 기반 매핑. 즉, 관리자가 각 수신 및 발신 필드를 구성해야 합니다.
발신 필드 outgoing-fields
발신 필드는 스마트 캠페인에서 흐름 단계가 사용될 때 흐름 단계 서비스로 전송되는 필드입니다.
수신 필드 incoming-fields
들어오는 필드는 흐름 단계 서비스에서에 데이터를 쓸 수 있도록 허용된 필드입니다.
구성 옵션(선택 사항) configuration-options
일부 서비스에는 선택 사항이나 필수 글로벌 구성 옵션이 있습니다. 옵션이 필요한 경우 온보딩을 저장하거나 완료하기 전에 모든 필수 옵션에 대해 값을 설정해야 합니다. 이름이 기울임꼴인 매개 변수는 호출된 서비스에 헤더로 전송됩니다.
서비스 중단 retiring-a-service
활성 사용을 중단하지 않고 새로운 버전 또는 대체 버전의 서비스로 쉽게 전환할 수 있도록 서비스 공급자 메뉴에서 서비스를 중단할 수 있습니다. 서비스 중단 스마트 캠페인 흐름 팔레트에서 해당 흐름 단계를 제거하여 새로운 사용법을 만들 수 없습니다. 대부분의 경우 서비스를 폐기하기로 선택할 때 기존 서비스를 교체할 준비가 된 교체 서비스가 있어야 합니다.
서비스 중단 service-deprecation
경우에 따라 서비스 공급업체는 소프트웨어 수명 주기의 일반적인 일부로 플로우 단계 서비스를 사용하지 않아야 합니다. 서비스 공급자가 이를 발표하면 서비스 공급자 표 보기에서 사용 중단 날짜 및 메시지가 채워집니다. 더 이상 사용되지 않는 서비스를 계속 사용하면 예상대로 더 이상 응답하지 않거나 Marketo 스마트 캠페인의 요청 수신을 중단하는 경우 서비스가 중단될 수 있으므로 수신하는 서비스 중단 알림에 주의를 기울이고 아직 사용 중인 서비스를 중단하거나 교체하기 위한 적절한 단계를 수행해야 합니다.
서드파티 및 사용자 정의 흐름 단계 사용 using-third-party-and-custom-flow-steps
설치된 유동 단계들은 표준 유동 단계들과 대체로 동일한 방식으로 사용될 수 있다. 서비스에서 정의한 모든 흐름 매개 변수가 최종 사용자에게 표시됩니다.
선택 목록을 새로 고치는 중 refreshing-picklists
Marketo은 매일 밤 서비스에 대한 선택 항목을 새로 고치지만, 캠페인 생성과 같은 새로운 선택 항목을 사용할 필요가 있는 경우가 있습니다. 새로 고침 버튼을 사용하거나 관리 > 서비스 공급자 메뉴로 이동하여 서비스를 선택한 후 선택 목록 새로 고침을 클릭하여 흐름 단계의 모든 인스턴스에서 이러한 선택 사항을 쉽게 새로 고칠 수 있습니다.
수신 필드 확인 checking-incoming-fields
해당 툴팁 아이콘 위로 마우스를 가져가면 주어진 흐름 단계에 대해 구성된 수신 필드를 확인할 수 있습니다. 이 기능은 잠재 고객이 해당 필드를 통해 이동할 때 변경될 수 있는 필드를 결정하는 데 유용하므로 해당 필드를 사용하여 후속 단계에서 선택 사항을 구성할 수 있습니다.
들어오는 필드 및 데이터 값 변경 incoming-fields-and-data-value-changes
다른 대부분의 흐름 단계와 달리 SSFS 프레임워크를 사용하여 구현된 단계는 관리자가 매핑한 리드 필드에 데이터를 다시 쓰고 이러한 변경 사항을 데이터 값 변경 활동으로 기록할 수 있습니다. 흐름 단계에서 이러한 방식으로 데이터를 쓰는 경우, 스마트 캠페인이 후속 단계로 이동하기 전에 이러한 모든 변경 사항이 완료되므로 기록된 모든 데이터가 후속 흐름 단계 선택 사항에 의존할 수 있습니다.
서비스 로그 및 통계 service-logs-and-statistics
각 플로우 단계 서비스에는 상태를 모니터링하고 통합과 관련된 문제를 해결하는 데 도움이 되는 몇 가지 유형의 로깅이 연결되어 있습니다.
서비스 통계 service-statistics
서비스 통계 로그는 각 서비스에 대한 호출 및 콜백 결과를 집계합니다. 시간, 레벨(청크 또는 레코드) 및 코드별로 그룹화되고, 수신된 각 코드에 대한 카운트 및 가장 최근 로그 메시지를 제공합니다. 이 대시보드는 주로 서비스 상태를 모니터링하는 데 도움이 되도록 설계되었습니다.