외부 작업 구성
외부 작업을 사용하면 Journey Optimizer B2B edition의 계정 여정이 여정 캔버스에서 직접 외부 시스템과 연결할 수 있습니다. 계정 대상이 외부 작업 노드에 도달하면 시스템에서 구성된 외부 서비스에 대한 비동기 아웃바운드 호출을 수행하여 계정, 사용자 또는 둘 다에 대한 대상 속성 데이터를 전달합니다. 외부 서비스는 데이터를 처리하고 콜백을 사용하여 응답하며, 여정 실행을 안내하는 데 사용할 수 있는 대상 데이터와 메타데이터를 반환합니다.
이 기능은 다음 두 가지 여정 노드 유형을 지원합니다.
- 외부 작업 - 외부 서비스를 호출하고 하나의 송신 경로를 따라 계속합니다. CRM 레코드 업데이트 또는 다운스트림 알림 트리거와 같은 실행 후 삭제 통합에 이상적입니다.
- 외부 분할 경로 - 외부 서비스를 호출하고 응답을 평가하여 여러 정의된 경로 중 하나를 따라 계정을 라우팅합니다.
구현 개요
외부 작업을 설정하려면 세 가지 역할에 대해 순서대로 조정해야 합니다.
외부 서비스 구현 implement-service
개발자는 Adobe Journey Optimizer B2B edition 외부 작업 서비스 공급자 인터페이스를 준수하는 공개 웹 서비스를 만들고 게시해야 합니다.
서비스가 활성 상태가 되면 OpenAPI 사양에 대한 URL을 제공하고 작업을 구성하는 제품 관리자에게 인증 자격 증명을 제공합니다.
작업 구성 configure-action
마케터가 여정에서 작업을 사용하려면 먼저 작업을 구성하고 활성화해야 합니다. 작업이 초안 상태에서 만들어지며 변경 사항이 자동으로 저장됩니다. 활성화하기 전까지는 초안으로 유지됩니다.
-
관리 > 구성(으)로 이동합니다.
-
중간 패널에서 외부 작업을 클릭합니다.
{width="800" modal="regular"}
-
오른쪽 상단의 작업 만들기를 클릭합니다.
-
외부 서비스에 대한 OpenAPI 사양의 URL을 입력하고 만들기를 클릭합니다.
{width="500"}
note note NOTE 이 단계를 수행하려면 외부 서비스가 활성화되어 있어야 하며 연결 가능해야 합니다. -
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 NOTE 표시되는 자격 증명 필드는 외부 서비스에 정의된 인증 메커니즘에 따라 다릅니다. 지원되는 유형은 API 키, OAuth2 및 HTTP 기본 인증입니다. {width="600" modal="regular"}
구성된 작업이 초안 또는 활성 상태일 때 필요에 따라 자격 증명을 변경할 수 있습니다.
-
다음을 클릭합니다.
-
작업이 외부 서비스와 데이터를 교환하는 방법을 정의하려면 구성 속성을 설정하십시오.
note 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"}
-
-
목록으로 돌아가서 작업을 초안 상태로 유지하려면 뒤로 화살표를 클릭하십시오.
또는 활성화를 클릭하여 작업 구성을 활성 상태로 변경합니다. 계정 여정에서 사용할 수 있도록 구성된 외부 작업이 활성화되어 있어야 합니다.
여정에 외부 노드 추가 add-journey-node
작업이 활성화되면 마케터는 계정 여정에 외부 작업 또는 외부 분할 경로 노드를 추가할 수 있습니다. 계정 여정 캔버스에서 이러한 노드를 추가하고 사용하는 방법에 대한 자세한 내용은 외부 노드를 참조하십시오.