설명서Journey OptimizerJourney Optimizer 안내서

개발자를 위한 시작 get-started-developers

Last update: Tue Jan 06 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 경험
  • 개발자

개발자​로서 Adobe Journey Optimizer를 구현하고 응용 프로그램 및 시스템에 통합해야 합니다. 시스템 관리자 및 데이터 엔지니어에 액세스 권한을 부여하고 환경을 준비하면 Adobe Journey Optimizer로 작업을 시작할 수 있습니다.

Journey Optimizer 생태계에서의 역할

다른 팀원이 사용자 인터페이스를 통해 Journey Optimizer를 구성하는 동안 다음 사항에 집중할 수 있습니다.

  • 모바일 및 웹 애플리케이션에서 SDK 구현
  • 여정을 트리거하기 위해 응용 프로그램에서 이벤트 보내기
  • Journey Optimizer에서 사용자 지정 작업을 통해 호출할 수 있는 API 엔드포인트 빌드
  • 기존 시스템 및 인프라와 Journey Optimizer 통합
  • 구현 테스트 및 디버깅

데이터 엔지니어가 데이터 스키마, 이벤트 구성 및 데이터 원본을 처리합니다. 관리자가 권한 및 채널 구성을 설정합니다. 마케터가 구현을 사용하는 여정 및 콘텐츠를 디자인합니다.

이 안내서에서는 Journey Optimizer를 시작하는 데 필요한 기술 구현 단계를 다룹니다. 모바일 앱, 웹 경험 또는 API 통합 중 어느 것을 구축하든 아래 섹션에 따라 구현을 설정하세요.

전제 조건 prerequisites

구현을 시작하기 전에 다음을 확인하세요.

카테고리
요구 사항
보유 기술
* JavaScript(웹 SDK) 또는 Swift/Kotlin(모바일 SDK)에 대한 경험
* RESTful API 및 JSON에 대한 이해
* 비동기 프로그래밍 및 이벤트 기반 아키텍처 알아보기
* 조직의 애플리케이션 아키텍처에 대한 지식
액세스 및 도구
* API 자격 증명에 대한 Adobe Developer Console에 액세스
* 응용 프로그램의 코드베이스에 액세스할 수 있는 개발 환경
* API 테스트를 위한 Postman과 같은 테스트 도구
* 브라우저 개발자 도구 또는 모바일 디버깅 도구
다른 팀원의
* 관리자
가 부여한 환경 액세스 권한* 데이터 엔지니어
*의 XDM 스키마 및 이벤트 정의 *마케터의 요구 사항 및 사용 사례

기술적 기반 이해 technical-foundation

구현으로 이동하기 전에 핵심 기술 개념을 숙지하세요.

  1. Adobe Experience Platform 통합: Journey Optimizer는 기본적으로 Adobe Experience Platform에 빌드되어 있습니다. 기본 아키텍처를 이해하면 보다 효과적인 구현을 구축하는 데 도움이 됩니다. Journey Optimizer 작동 방식에 대해 자세히 알아보세요.

  2. XDM 데이터 모델: Journey Optimizer는 XDM(경험 데이터 모델)을 사용하여 이벤트 및 프로필 데이터를 구조화합니다. 개발자는 데이터 엔지니어가 구성한 스키마를 준수하는 데이터를 보내는 방법을 이해해야 합니다. XDM 스키마에 대해 알아보세요.

  3. 인증 및 보안: 모든 구현에는 적절한 인증이 필요합니다. SDK 및 API에 대한 인증을 설정하는 방법을 이해합니다. API 인증에 대해 알아봅니다.

모바일 앱 통합 설정 mobile-integration

Adobe Experience Platform Mobile SDK 구성

푸시 알림, 인앱 메시지 및 기타 모바일 기능을 사용하려면 Adobe Experience Platform Mobile SDK를 모바일 애플리케이션에 통합합니다.

  1. Mobile SDK 설치 및 구성: SDK 통합을 시작하려면 Adobe Experience Platform Mobile SDK 문서를 따르세요.

  2. 모바일 속성 생성: Adobe Experience Platform Data Collection에서 모바일 속성을 설정합니다. 모바일 속성을 생성하고 구성하는 방법을 알아보세요.

  3. 푸시 알림 구성:

    • iOS 앱​의 경우: APNs(Apple Push Notification service)에 앱을 등록합니다. 자세한 내용은 Apple 문서에서 확인하세요.
    • Android 앱​의 경우: Android 앱에 Firebase 클라우드 메시징을 설정합니다. 자세한 내용은 Google 문서에서 확인하세요.

  4. 모바일 통합 테스트: 모바일 온보딩 빠른 시작 워크플로를 사용하여 모바일 설정을 신속하게 구성하고 테스트합니다.

푸시 알림을 구성하는 자세한 단계는 이 페이지에서 확인할 수 있습니다.

코드 기반 경험 구현(Mobile SDK)

코드 기반 경험을 사용하는 기본 모바일 앱 개인화:

웹 경험 구현 web-implementation

Adobe Experience Platform Web SDK 설정

웹 기반 구현의 경우 Web SDK는 기본 통합 지점입니다.

  1. Web SDK 설치: Web SDK 구현 안내서를 따라 웹 사이트에 SDK를 설정합니다.

  2. 데이터 스트림 구성: Journey Optimizer가 활성화된 Adobe Experience Platform Data Collection에서 데이터 스트림을 생성하고 구성합니다. 자세한 내용은 데이터 스트림 문서에서 확인하세요.

  3. 웹 푸시 알림 활성화(선택 사항): 웹 SDK 구성에서 pushNotifications 속성을 구성하고 sendPushSubscription 명령을 사용하여 푸시 구독을 등록합니다.

코드 기반 경험 구현(Web SDK)

코드 기반 경험을 통해 모든 디지털 접점을 개인화할 수 있습니다.

  1. 구현 방법 선택: 클라이언트측, 서버측 또는 하이브리드입니다. 각 접근 방식에 대한 구현 샘플을 검토하십시오.

  2. 표면 정의: 애플리케이션에서 개인화된 콘텐츠를 제공하려는 위치를 식별합니다. 표면 구성에 대해 알아보세요.

  3. 콘텐츠 렌더링 구현: Web SDK를 사용하여 개인화 콘텐츠를 가져오고 적용합니다. 코드 기반 구현 자습서를 참조하세요.

  4. 표시 및 상호 작용 이벤트 전송: 분석 및 최적화를 위해 콘텐츠가 표시되는 시점과 사용자가 콘텐츠와 상호 작용하는 시점을 추적합니다.

GitHub에서 샘플 구현을 탐색하여 코드 기반 경험이 실제로 어떻게 작동하는지 확인하세요.

코드 기반 경험을 시작하는 방법에 대해 자세히 알아보세요.

이벤트 스트리밍 구현 event-streaming

여정을 트리거할 이벤트 보내기

개발자로서 사용자는 여정을 트리거하는 이벤트를 전송하는 코드를 구현하게 됩니다. 데이터 엔지니어가 Journey Optimizer에서 이벤트 스키마와 정의를 구성합니다.

  1. 이벤트 페이로드 이해: 데이터 엔지니어와 협력하여 이벤트 스키마와 필요한 페이로드 구조를 확보합니다. 페이로드는 구성한 XDM 스키마를 준수해야 합니다. 이벤트 스키마 요구 사항에 대해 알아봅니다.

  2. 이벤트 스트리밍 구현: 스트리밍 수집 API를 사용하여 Adobe Experience Platform으로 이벤트를 전송합니다. 이벤트 전송 단계를 알아보세요.

  3. 이벤트 유형 처리:

    • 단일 이벤트: 사용자별 특정 작업(예: 버튼 클릭, 구매 완료)에 대한 이벤트 전송을 구현합니다.
    • 비즈니스 이벤트: 재고 업데이트, 가격 변경 등 비즈니스 관련 이벤트를 전송합니다.

  4. 테스트 이벤트 게재: 이벤트가 제대로 수신되고 예상대로 여정이 트리거되는지 확인합니다. 이벤트 문제 해결에 대해 알아보세요.

API를 통해 이벤트를 전송하는 구현 예시:

POST https://{DATACOLLECTION_ENDPOINT}/collection/{DATASTREAM_ID}
Content-Type: application/json

{
  "header": {
    "datasetId": "{DATASET_ID}",
    "imsOrgId": "{ORG_ID}",
    "source": {
      "name": "Web SDK"
    }
  },
  "body": {
    "xdmMeta": {
      "schemaRef": {
        "id": "{SCHEMA_ID}"
      }
    },
    "xdmEntity": {
      "_id": "unique-event-id",
      "eventType": "purchase",
      "timestamp": "2024-01-01T12:00:00Z",
      // ... your event data
    }
  }
}

여정 이벤트 작업에 대해 자세히 알아보세요.

사용자 정의 액션 엔드포인트 개발 custom-actions

사용자 정의 액션을 사용하면 여정에서 API를 호출할 수 있습니다. 개발자는 사용자 정의 액션에서 호출하는 API 엔드포인트를 작성합니다.

  1. API 엔드포인트 작성: Journey Optimizer가 여정 실행 중에 호출할 RESTful API 엔드포인트를 생성합니다. 엔드포인트는 다음과 같아야 합니다.

    • JSON 페이로드 수락
    • 요청 인증(OAuth, API 키 또는 JWT)
    • 적절한 시간 제한 내에 요청 처리
    • 예상된 형식의 응답 반환

  2. 사용자 정의 액션 기능 이해: 사용자 정의 액션은 Epsilon, Slack, Firebase와 같은 타사 시스템이나 자체 서비스에 연결할 수 있습니다. 사용자 지정 작업에 대해 자세히 알아보세요.

  3. 액션 구성 작업: 관리자 또는 데이터 엔지니어가 Journey Optimizer에서 사용자 정의 액션을 구성하여 API 엔드포인트 URL, 인증 방법 및 매개 변수를 정의합니다. API 사양을 제공해야 합니다. 사용자 정의 액션 구성에 대해 알아보세요.

  4. 실행 가능한 데이터 반환: 후속 여정 단계에서 사용할 수 있는 데이터를 반환하도록 API를 디자인합니다. 액션 응답에 대해 알아보세요.

  5. 속도 제한 구현: 엔드포인트가 예상되는 볼륨을 처리할 수 있는지 확인합니다. Journey Optimizer는 초당 5000회 호출 제한을 적용하지만, 시스템은 충분한 복원력을 갖추어야 합니다. 캡핑 및 스로틀링에 대해 알아보세요.

사용 사례 예시: 사용자 정의 액션을 사용하여 Experience Platform에 여정 이벤트를 작성합니다.

Journey Optimizer API 작업 apis

Journey Optimizer는 프로그래밍 방식으로 액세스할 수 있는 포괄적인 REST API를 제공합니다.

  1. API 기능 이해: Journey Optimizer API를 사용하면 다양한 리소스를 프로그래밍 방식으로 생성하고 읽고 업데이트 및 삭제할 수 있습니다. Journey Optimizer API에 대해 알아보세요.

  2. 인증: Adobe Developer Console을 사용하여 API 인증을 설정하려면 이 튜토리얼을 따르세요.

  3. API 참조 살펴보기: 전체 API 문서를 찾아보고 Adobe Journey Optimizer API 참조에서 API를 직접 사용해 보세요.

  4. API 트리거 캠페인: API 트리거 캠페인을 사용하여 트랜잭션 메시지를 작성합니다. 대용량 시나리오(최대 5000TPS)의 경우 높은 처리량 모드를 살펴보세요(추가 라이선스 필요).

  5. 의사 결정 관리 API: 오퍼 관리 및 의사 결정에 특수 API를 사용합니다. 자세한 내용은 의사 결정 관리 API 안내서에서 확인하세요.

테스트 및 디버깅 testing

  1. SDK 구현 디버깅: Adobe Experience Platform Assurance를 사용하여 SDK 이벤트를 검사하고, 데이터 수집을 검증하며, 통합 문제를 실시간으로 해결할 수 있습니다. Assurance에 대해 자세히 알아보세요.

  2. 테스트 이벤트 게재: 애플리케이션의 이벤트가 Adobe Experience Platform에서 올바르게 수신되고 예상대로 여정이 트리거되는지 확인합니다. 이벤트 수집을 모니터링하고 페이로드 구조를 검증합니다.

  3. API 통합 유효성 검사: 사용자 정의 액션 엔드포인트가 Journey Optimizer 요청을 올바르게 처리하고, 시간 제한 내에 응답하며, 예상되는 데이터 형식을 반환하는지 확인하기 위해 테스트합니다.

  4. 테스트 프로필을 사용하여 테스트 모드 사용: 데이터 엔지니어와 협력하여 테스트 프로필에 액세스한 다음 여정 테스트 모드를 사용하여 구현을 검증합니다. 여정을 테스트하는 방법을 알아보세요.

  5. SDK 로그 모니터링: 개발 중 발생하는 문제를 해결하기 위해 SDK 구현에서 디버그 로깅을 활성화합니다.

    • Mobile SDK: SDK 이벤트와 API 호출을 확인하려면 로깅을 활성화합니다.
    • Web SDK: 브라우저 콘솔을 사용하여 SDK 활동을 모니터링합니다.

  6. 데이터 스트림 구성 확인: Journey Optimizer로 데이터를 전송하도록 데이터 스트림이 올바르게 구성되어 있는지 확인합니다. 이벤트가 데이터 스트림을 통해 올바른 대상으로 전달되는지 확인합니다.

  7. 분석을 위한 여정 데이터 쿼리: 데이터 레이크에서 SQL 쿼리를 사용하여 여정 단계 이벤트를 분석하고, 문제를 디버깅하고, 사용자 정의 액션 성능을 모니터링합니다. 다음과 같은 여정 분석 쿼리 예시를 살펴보세요.

    • 프로필 시작/종료 추적 및 삭제 이유
    • 사용자 정의 액션 성능 지표(지연, 처리량, 오류)
    • 이벤트 게재 및 오류 패턴
    • 여정 인스턴스 상태

고급 개발자 항목 advanced-topics

상황별 데이터 및 보강 작업

  • 배열 반복: Handlebars 구문을 사용하여 메시지에서 이벤트, 사용자 정의 액션 응답 및 데이터 세트 조회의 동적 목록을 표시합니다. 상황별 데이터 반복에 대해 알아보세요.
  • 데이터 집합 조회: Adobe Experience Platform 데이터 세트에서 여정 데이터를 보강하기 위해 데이터 세트 조회 기능을 구현합니다. 데이터 엔지니어와 협력하여 구성을 진행합니다. 데이터 세트 조회에 대해 알아보세요.

동의 및 거버넌스 작업

데이터 통합에 데이터 거버넌스 및 동의 정책을 구현합니다.

  • 데이터 거버넌스: 사용자 정의 액션에 데이터 사용 정책을 적용합니다. 데이터 거버넌스에 대해 자세히 알아보세요.
  • 동의 관리: 구현에서 고객 동의 환경 설정을 처리합니다. 동의에 대해 알아보세요.

최적화 및 모범 사례

  • 캡핑 및 스로틀링: 속도 제한을 이해하고 적절한 스로틀링을 구현합니다. 외부 시스템에 대해 알아보세요.
  • 여정 최적화: 여정 최적화에 대한 모범 사례를 따릅니다.
  • 오류 처리: 강력한 오류 처리를 구현합니다. 오류 코드 및 문제 해결 안내서를 검토합니다.

추가 리소스 additional-resources

  • Developer Console: 통합을 생성하고 API 자격 증명을 관리하기 위해 Adobe Developer Console에 액세스합니다.
  • 샘플 코드: GitHub에서 샘플 구현을 살펴봅니다.
  • 튜토리얼 비디오: Experience League에서 실습 튜토리얼을 통해 학습합니다.
  • 개발자 커뮤니티: Adobe 커뮤니티 포럼에서 다른 개발자들과 소통하고 지원을 받습니다.

다양한 역할 간의 협업 next-steps

구현 작업은 다른 팀원들과 협업하여 진행됩니다.

데이터 엔지니어와 협력

데이터 및 이벤트 구성에 대해 데이터 엔지니어와 협업합니다.

  • 구현에 필요한 XDM 스키마 및 이벤트 구조 가져오기

  • 전송해야 하는 이벤트와 해당 페이로드 형식 이해

  • 데이터 수집 요구 사항과 데이터 품질 표준에 맞게 조정

  • 테스트 이벤트 게재 및 데이터 수집을 함께 수행

관리자와 협력

액세스와 구성에 대해 관리자와 협업합니다.

  • 사용자가 구성할 사용자 정의 액션에 대한 API 사양 제공

  • 필요한 권한과 API 자격 증명 요청

  • 채널 구성 요구 사항(예: 푸시 인증서) 조정

  • 테스트 환경과 샌드박스 전략에 맞게 조정

마케터와 협력

여정 요구 사항과 테스트에 대해 마케터와 협업합니다.

  • 이벤트를 트리거해야 하는 사용자 상호 작용 이해

  • 콘텐츠 성과 및 사용자 참여 추적 기능 구현

  • 구현한 기능을 사용하여 여정 테스트 지원

  • 메시지 게재 또는 개인화 관련 문제 해결

구현 시작

빌드를 시작할 준비가 되셨나요? 위의 섹션에서 첫 번째 구현 영역을 선택합니다.

  1. 모바일 앱? Mobile SDK 통합으로 시작
  2. 웹 사이트? Web SDK 설정부터 시작
  3. API 통합? API 작업으로 이동
  4. 사용자 정의 시스템? 사용자 정의 액션 확인

각 섹션에는 구현을 안내하는 자세한 기술 문서, 코드 샘플 및 튜토리얼 링크가 포함되어 있습니다.

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76