외부 작업 구성
외부 작업을 사용하면 Journey Optimizer B2B edition의 계정 여정이 여정 캔버스에서 직접 외부 시스템과 연결할 수 있습니다. 계정 대상이 외부 작업 노드에 도달하면 시스템에서 구성된 외부 서비스에 대한 비동기 아웃바운드 호출을 수행하여 계정, 사용자 또는 둘 다에 대한 대상 속성 데이터를 전달합니다. 외부 서비스는 데이터를 처리하고 콜백을 사용하여 응답하며, 여정 실행을 안내하는 데 사용할 수 있는 대상 데이터와 메타데이터를 반환합니다.
이 기능은 다음 두 가지 여정 노드 유형을 지원합니다.
- 외부 작업 - 외부 서비스를 호출하고 하나의 송신 경로를 따라 계속합니다. CRM 레코드 업데이트 또는 다운스트림 알림 트리거와 같은 실행 후 삭제 통합에 이상적입니다.
- 외부 분할 경로 - 외부 서비스를 호출하고 응답을 평가하여 여러 정의된 경로 중 하나를 따라 계정을 라우팅합니다.
구현 개요
외부 작업을 설정하려면 세 가지 역할에 대해 순서대로 조정해야 합니다.
외부 서비스 구현 implement-service
개발자는 Adobe Journey Optimizer B2B edition 외부 작업 서비스 공급자 인터페이스를 준수하는 공개 웹 서비스를 만들고 게시해야 합니다.
서비스가 활성 상태가 되면 OpenAPI 사양에 대한 URL을 제공하고 작업을 구성하는 제품 관리자에게 인증 자격 증명을 제공합니다.
작업 구성 configure-action
마케터가 여정에서 작업을 사용하려면 먼저 작업을 구성하고 활성화해야 합니다. 작업이 초안 상태에서 만들어지며 변경 사항이 자동으로 저장됩니다. 활성화하기 전까지는 초안으로 유지됩니다.
-
관리 > 구성(으)로 이동합니다.
-
중간 패널에서 외부 작업을 클릭합니다.
{width="800" modal="regular"}
-
오른쪽 상단의 작업 만들기를 클릭합니다.
-
외부 서비스에 대한 OpenAPI 사양의 URL을 입력하고 만들기를 클릭합니다.
{width="500"}
이 단계를 수행하려면 외부 서비스가 활성화되어 있어야 하며 연결 가능해야 합니다. 유효성 검사 오류가 있는 경우 대화 상자에 오류를 설명하는 메시지와 해결 방법이 표시됩니다. 자세한 내용은 문제 해결을 참조하세요.
-
URL이 정상적으로 확인되면 서비스 세부 정보를 검토하십시오.
서비스 세부 사항은 작업을 만들 때 OpenAPI 사양과 직접 읽습니다. 생성 후에는 구성에서 이러한 속성을 변경할 수 없습니다.
table 0-row-3 1-row-3 2-row-3 3-row-3 속성 설명 OpenAPI 사양 속성 이름 작업 이름 info.title설명 작업에 대한 설명 info.descriptionURL 외부 서비스를 정의하는 OpenAPI 사양의 URL servers.url -
외부 서비스(
components.securitySchemes)에 대한 인증 자격 증명을 입력하십시오.note NOTE 표시되는 자격 증명 필드는 외부 서비스에 정의된 인증 메커니즘에 따라 다릅니다. 지원되는 유형은 API 키, OAuth2 및 HTTP 기본 인증입니다. {width="600" modal="regular"}
구성된 작업이 초안 또는 활성 상태일 때 필요에 따라 자격 증명을 변경할 수 있습니다.
-
다음을 클릭합니다.
-
작업이 외부 서비스와 데이터를 교환하는 방법을 정의하려면 구성 속성을 설정하십시오.
note NOTE 정적(으)로 표시된 속성은 구성 시 업데이트할 수 없으며 서비스 정의를 기반으로 합니다. -
작업 유형(정적) - 지원되는 여정 노드 유형:
- 외부 작업(
enableSplitPath= false) - 외부 작업 분할 경로(
enableSplitPath= true)
작업 구성을 만든 후에는 작업 유형을 변경할 수 없습니다.
- 외부 작업(
-
접근자(정적) - (외부 작업 분할 경로만 해당) 외부 분할 경로 노드에서 경로 조건으로 사용할 수 있도록 외부 서비스에서 반환하는 변수입니다. (
invocationPayloadDef.accessorsMetadata) -
여정 컨텍스트(정적) - 요청에서 보낸 대상 데이터의 범위(
supportedEntityType):-
계정 - 계정만 보냅니다.
-
사람 - 사람만 보냅니다.
-
계정의 사용자 - 계정 및 계정 관련 사용자를 보냅니다.
-
-
보내는 필드 - 테이블의 각 필드를 XDM 필드에 매핑합니다. 이러한 필드는 요청 본문에서 외부 서비스로 전송됩니다. 서비스 정의 속성:
invocationPayloadDef.accountFields,invocationPayloadDef.fields. {width="600" modal="regular"}
-
들어오는 필드 - 테이블의 각 필드를 업데이트할 수 있는 XDM 필드에 매핑합니다. 이러한 필드는 외부 서비스 응답에서 채워집니다. 서비스 정의 속성:
callbackPayloadDef.accountFields,callbackPayloadDef.fields. 생성 후 업데이트할 수 있습니다. -
헤더 매개 변수 - 각 행에 대한 값을 입력하여 요청에서 HTTP 헤더로 전달합니다. 서비스 정의 속성:
invocationPayloadDef.headers. -
시간 초과 - 요청이 실패한 것으로 간주되기 전에 외부 서비스에서 콜백을 호출할 때까지 기다리는 시간(분)을 입력합니다. 서비스 정의 속성:
timeout. -
전역 특성 - 요청 본문에 정적 필드로 포함할 각 행의 값을 입력하십시오. 서비스 정의 속성:
invocationPayloadDef.globalAttributes. {width="600" modal="regular"}
-
-
목록으로 돌아가서 작업을 초안 상태로 유지하려면 뒤로 화살표를 클릭하십시오.
또는 활성화를 클릭하여 작업 구성을 활성 상태로 변경합니다. 계정 여정에서 사용할 수 있도록 구성된 외부 작업이 활성화되어 있어야 합니다.
문제 해결 troubleshooting
외부 서비스에 대한 OpenAPI 사양에 대한 URL을 입력하고 만들기를 클릭하면 시스템에서 서비스 유효성 검사를 수행합니다. 오류가 발생하면 대화 상자에 오류를 설명하는 메시지가 표시됩니다.
유효성 검사 오류 세부 정보
This URL is already used by another external actionAn action with this name already existsinfo.title은(는) 이미 있는 작업과 일치합니다.info.title 필드에 있는 제목을 고유하게 변경합니다.Duplicate operation ID found in the specificationoperationId을(를) 공유합니다.operationId을(를) 지정합니다.Field in the specification exceeds the maximum allowed lengthThe entity type value is invalidx- 확장에 인식할 수 없는 값이 있습니다.The provided document is not a valid OpenAPI specificationRequired OpenAPI field is missinginfo 또는 paths).Required endpoint is missing from the specificationRequired extension field is missingx- 확장 필드가 사양에 없습니다.Security schemes are missing from the specificationcomponents에 정의된 securitySchemes이(가) 없습니다.Multiple authentication types are not supportedThe authentication type is not supportedoauth2 또는 openIdConnect)은 지원되지 않습니다.The OpenAPI version is not supportedAn unexpected error occurred여정에 외부 노드 추가 add-journey-node
작업이 활성화되면 마케터는 계정 여정에 외부 작업 또는 외부 분할 경로 노드를 추가할 수 있습니다. 계정 여정 캔버스에서 이러한 노드를 추가하고 사용하는 방법에 대한 자세한 내용은 외부 노드를 참조하십시오.