외부 작업 구성

외부 작업을 사용하면 Journey Optimizer B2B edition의 계정 여정이 여정 캔버스에서 직접 외부 시스템과 연결할 수 있습니다. 계정 대상이 외부 작업 노드에 도달하면 시스템에서 구성된 외부 서비스에 대한 비동기 아웃바운드 호출을 수행하여 계정, 사용자 또는 둘 다에 대한 대상 속성 데이터를 전달합니다. 외부 서비스는 데이터를 처리하고 콜백을 사용하여 응답하며, 여정 실행을 안내하는 데 사용할 수 있는 대상 데이터와 메타데이터를 반환합니다.

이 기능은 다음 두 가지 여정 노드 유형을 지원합니다.

  • 외부 작업 - 외부 서비스를 호출하고 하나의 송신 경로를 따라 계속합니다. CRM 레코드 업데이트 또는 다운스트림 알림 트리거와 같은 실행 후 삭제 통합에 이상적입니다.
  • 외부 분할 경로 - 외부 서비스를 호출하고 응답을 평가하여 여러 정의된 경로 중 하나를 따라 계정을 라우팅합니다.
NOTE
외부 작업 서비스는 계정 여정에 대해서만 지원됩니다. 이러한 노드 유형은 개인 여정에 사용할 수 없습니다.

구현 개요

외부 작업을 설정하려면 세 가지 역할에 대해 순서대로 조정해야 합니다.

외부 서비스 구현 implement-service

개발자는 Adobe Journey Optimizer B2B edition 외부 작업 서비스 공급자 인터페이스를 준수하는 공개 웹 서비스를 만들고 게시해야 합니다.

NOTE
콜백 함수에는 전달자 토큰이 필요합니다. IMS 조직에 대해 Adobe Developer Console에서 OAuth 서버 간 자격 증명을(를) 설정하여 이를 검색하십시오.

서비스가 활성 상태가 되면 OpenAPI 사양에 대한 URL을 제공하고 작업을 구성하는 제품 관리자에게 인증 자격 증명을 제공합니다.

작업 구성 configure-action

마케터가 여정에서 작업을 사용하려면 먼저 작업을 구성하고 활성화해야 합니다. 작업이 초안 상태에서 만들어지며 변경 사항이 자동으로 저장됩니다. 활성화하기 전까지는 초안으로 유지됩니다.

PREREQUISITES
구성을 추가하기 전에 개발자로부터 OpenAPI 사양 및 인증 자격 증명에 대한 URL을 얻습니다.
외부 작업을 정의하고 활성화하려면 B2B 관리 구성 관리 제품 권한이 있어야 합니다.
  1. 관리 > 구성(으)로 이동합니다.

  2. 중간 패널에서 외부 작업​을 클릭합니다.

    외부 작업 구성 공간에 액세스 {width="800" modal="regular"}

  3. 오른쪽 상단의 작업 만들기​를 클릭합니다.

  4. 외부 서비스에 대한 OpenAPI 사양의 URL을 입력하고 만들기​를 클릭합니다.

    서비스 URL 입력 {width="500"}

    note note
    NOTE
    이 단계를 수행하려면 외부 서비스가 활성화되어 있어야 하며 연결 가능해야 합니다.
  5. URL이 정상적으로 확인되면 서비스 세부 정보​를 검토하십시오.

    서비스 세부 사항은 작업을 만들 때 OpenAPI 사양과 직접 읽습니다. 생성 후에는 구성에서 이러한 속성을 변경할 수 없습니다.

    table 0-row-3 1-row-3 2-row-3 3-row-3
    속성 설명 OpenAPI 사양 속성
    이름 작업 이름 info.title
    설명 작업에 대한 설명 info.description
    URL 외부 서비스를 정의하는 OpenAPI 사양의 URL servers.url
  6. 외부 서비스(components.securitySchemes)에 대한 인증 자격 증명을 입력하십시오.

    note note
    NOTE
    표시되는 자격 증명 필드는 외부 서비스에 정의된 인증 메커니즘에 따라 다릅니다. 지원되는 유형은 API 키, OAuth2 및 HTTP 기본 인증입니다.

    인증 자격 증명 추가 {width="600" modal="regular"}

    구성된 작업이 초안 또는 활성 상태일 때 필요에 따라 자격 증명을 변경할 수 있습니다.

  7. 다음​을 클릭합니다.

  8. 작업이 외부 서비스와 데이터를 교환하는 방법을 정의하려면 구성 속성을 설정하십시오.

    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"}

  9. 목록으로 돌아가서 작업을 초안 상태로 유지하려면 뒤로 화살표​를 클릭하십시오.

    또는 활성화​를 클릭하여 작업 구성을 활성 상태로 변경합니다. 계정 여정에서 사용할 수 있도록 구성된 외부 작업이 활성화되어 있어야 합니다.

여정에 외부 노드 추가 add-journey-node

작업이 활성화되면 마케터는 계정 여정에 외부 작업 또는 외부 분할 경로 노드를 추가할 수 있습니다. 계정 여정 캔버스에서 이러한 노드를 추가하고 사용하는 방법에 대한 자세한 내용은 외부 노드를 참조하십시오.

recommendation-more-help
6ef00091-a233-4243-8773-0da8461f7ef0