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

이 페이지의 내용: 애플리케이션을 Adobe Journey Optimizer에 연결하여 실시간 데이터에서 여정을 실행할 수 있도록 SDK, 이벤트 스트리밍, 사용자 정의 액션 엔드포인트 및 API를 구현합니다.

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

Journey Optimizer 생태계에서의 역할

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

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

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

사전 요구 사항 prerequisites

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

기술적 기반 이해 technical-foundation

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

모바일 앱 통합 설정 mobile-integration

Adobe Experience Platform Mobile SDK 구성

모바일 SDK는 iOS 또는 Android 앱에 직접 임베드하는 라이브러리 컬렉션입니다. 앱과 Adobe Experience Platform 간의 커뮤니케이션 레이어 역할을 합니다. 사용자를 식별하고, 행동 이벤트를 수집하며, Journey Optimizer의 지침(푸시 알림, 인앱 메시지 및 개인화된 콘텐츠 포함)을 전달합니다. 모바일 SDK가 없으면 Journey Optimizer는 앱 사용자의 활동을 파악할 수 없고 사용자에게 도달할 방법도 없습니다.

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

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

코드 기반 경험을 통해 새 앱을 출시하지 않고도 온보딩 화면, 제품 상세 페이지, 인앱 배너, 기능 플래그 등 기본 모바일 앱의 모든 영역에 개인화된 콘텐츠를 제공할 수 있습니다. 모바일 SDK를 사용하여 런타임에 개인화된 콘텐츠를 가져오고 렌더링하면 팀에서 배치 및 표시 방식을 충분히 제어할 수 있습니다.

웹 경험 구현 web-implementation

Adobe Experience Platform Web SDK 설정

Web SDK(alloy.js)는 사이트에 필요한 여러 개의 개별 Adobe 태그를 대체하는 단일 JavaScript 라이브러리입니다. 이 라이브러리는 행동 데이터를 수집하고, 사용자가 구성한 데이터 스트림을 통해 Adobe Experience Platform으로 스트리밍하고, 개인화 지침을 다시 수신합니다. 이 모든 과정이 단 한 번의 네트워크 왕복으로 이루어집니다. Web SDK가 구축되면 Journey Optimizer는 방문자를 식별하고, 방문자의 행동에 따라 여정을 트리거하며, 맞춤형 콘텐츠를 페이지에 즉시 게재할 수 있습니다.

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

마케터가 레이아웃을 완전히 제어하는 시각적 채널과 달리, 코드 기반 경험에서는 페이지에 개인화된 콘텐츠가 표시되는 방식을 완벽하게 제어할 수 있습니다. Journey Optimizer는 개인화 데이터가 포함된 JSON 페이로드를 반환하며, 사용자는 코드에서 해당 데이터를 어디에 어떻게 표시할지 결정합니다. 이 모델은 시각적 편집기나 페이지 게시 워크플로 없이도 히어로 배너, 추천 캐러셀, 검색 결과 순위, A/B 테스트 변형 등 모든 웹 영역에서 작동합니다.

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

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

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

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

여정은 사용자 로그인, 장바구니 추가, 구매 완료, 양식 이탈 등의 이벤트에 따라 실행됩니다. 사용자는 애플리케이션에서 이러한 이벤트를 정확한 시점에 발생시키기만 하면 됩니다. 각 이벤트는 Experience Platform 스트리밍 수집 API로 전송되는 XDM 구조의 JSON 페이로드입니다. Journey Optimizer는 해당 이벤트를 밀리초 단위로 수신하여 프로필을 일치하는 여정으로 라우팅합니다. 이벤트 스키마 및 페이로드 구조는 데이터 엔지니어가 정의합니다. 코딩을 시작하기 전에 데이터 엔지니어와 협의합니다.

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

여정이 사용자 정의 액션 단계에 도달하면 Journey Optimizer는 사용자가 제공한 URL(백엔드, CRM, 충성도 플랫폼, REST 엔드포인트 등)로 HTTP 호출을 수행합니다. 사용자의 역할은 해당 엔드포인트를 구축하고 노출하는 것입니다. 요청 계약(페이로드 형태, 인증 방법, 응답 형식)을 정의하고, 관련 비즈니스 로직을 구현하며, Journey Optimizer가 생성할 호출량을 처리할 수 있도록 해야 합니다. 관리자가 Journey Optimizer에 엔드포인트를 등록하면 마케터는 해당 엔드포인트를 여정의 단계로 사용할 수 있습니다.

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

Journey Optimizer API 작업 apis

모든 작업을 Journey Optimizer UI를 통해 수행할 필요는 없습니다. 때로는 자체 백엔드에서 캠페인을 트리거하거나, 개인 정보 요청 후 이메일 주소를 차단하거나, 외부 CMS에서 콘텐츠 템플릿을 동기화해야 할 수도 있습니다. Journey Optimizer의 REST API를 사용하면 플랫폼의 핵심 기능에 프로그래밍 방식으로 액세스할 수 있습니다. 모든 호출은 OAuth 서버 간 인증을 사용하며, 기존 JWT 방식은 더 이상 사용되지 않습니다.

테스트 및 디버깅 testing

실제 구현을 시작하기 전에 이벤트가 적절한 시점에 발생하고, 여정이 예상대로 트리거되며, 사용자 정의 액션이 실제 부하에서 제대로 작동하고, 개인화된 콘텐츠가 올바르게 렌더링되는지 확인해야 합니다. 이 섹션에서는 SDK 로깅과 같은 저수준 도구부터 실제 프로필을 사용한 엔드투엔드 여정 테스트 실행에 이르기까지 문제를 조기에 발견하는 데 필요한 도구와 기술을 다룹니다.

고급 개발자 항목 advanced-topics

핵심 SDK, 이벤트 및 API가 구축되면 다음 항목을 통해 프로필 크기를 늘리지 않고 런타임에 여정 데이터를 보강하고, 동의 신호를 처리하여 옵트아웃이 모든 통합에 반영되도록 하며, 프로덕션 규모에 필요한 처리량과 안정성을 위해 구현을 최적화하는 방법을 알아볼 수 있습니다.

상황별 데이터 및 보강 작업

여정에는 트리거 이벤트에 전달되는 데이터(제품 이름, 충성도 등급, 주문 품목 목록 등)보다 더 많은 데이터가 필요한 경우가 많습니다. 이 모든 정보를 모든 프로필에 미리 로딩하는 대신, 컨텍스트 보강 기능을 통해 여정은 런타임에 AEP 데이터 세트에서 해당 정보를 찾아보거나 사용자 정의 액션 응답에서 정보를 가져올 수 있습니다. 그러면 메시지와 분기 조건에서 해당 데이터를 참조할 수 있으며, 이 경우 데이터는 프로필에 영구적으로 저장되지 않습니다.

동의 및 거버넌스 작업

Journey Optimizer는 플랫폼 수준에서 데이터 거버넌스 및 동의 정책을 시행하지만, 통합 과정에서도 이러한 정책을 준수해야 합니다. 고객이 마케팅 커뮤니케이션 수신을 거부하거나 데이터 사용 레이블로 인해 필드 사용 방식이 제한되는 경우, 이러한 규칙은 UI에서 작업을 차단하는 것뿐만 아니라 사용자 정의 액션 및 데이터 세트 조회에도 반영되어야 합니다.

최적화 및 모범 사례

프로덕션 환경에서 Journey Optimizer를 구현하면 초당 수백만 건의 이벤트와 수천 건의 여정 실행이 정기적으로 처리됩니다. 이러한 리소스는 해당 규모에 맞춰 통합 기능을 최적화하는 데 도움이 됩니다. 예를 들어, 속도 제한에 도달하기 전에 이를 파악하고, 프로필이 자동으로 삭제되는 일반적인 여정 디자인 오류를 방지하며, 오류 발생 시 눈에 띄지 않게 처리되는 대신 정상적으로 작동하는 오류 처리를 구축하는 방법을 안내합니다.

Journey Optimizer REST API 호출 rest-apis

SDK 및 이벤트 스트리밍 구현 외에도 자체 시스템에서 Journey Optimizer를 프로그래밍 방식으로 실행할 수 있습니다. 전체 API 참조, OpenAPI 사양 및 코드 샘플은 Journey Optimizer 개발자 포털에서 확인할 수 있습니다.

API 트리거 캠페인 실행 api-triggered

대화형 메시지 실행 REST API를 사용하여 외부 시스템에서 트랜잭션 또는 마케팅 메시지를 트리거할 수 있습니다. 엔드포인트를 호출하기 전에 다음 사항을 확인하세요.

API 참조 · 코드 샘플 · API 트리거 캠페인 작업

외부 엔드포인트에 대한 상한 설정 및 스로틀링 capping-throttling

여정이 사용자 정의 액션 또는 데이터 소스를 통해 외부 시스템을 호출할 때, 상한 설정 및 스로틀링 API는 해당 시스템의 과부하를 방지합니다. 상한 설정은 구성된 제한을 초과하는 호출을 거부하고, 스로틀링은 최대 6시간 동안 대기열에 저장합니다(프로덕션 샌드박스, 사용자 정의 액션에만 해당).

상한 설정 API 참조 · 상한 설정 API 사용 · 스로틀링 API 사용

추가 REST API more-rest-apis

메시지 및 상한 설정 외에도 Journey Optimizer는 금지 목록 관리, 콘텐츠 템플릿, 캠페인 검색, 교정 및 오케스트레이션된 캠페인 실행을 위한 REST 엔드포인트를 제공합니다. 이러한 API는 UI에서 수동으로 처리해야 하는 작업을 자동화하는 데 유용합니다. 예를 들어 데이터 가져오기 후 주소를 일괄적으로 수신 거부하거나 외부 콘텐츠 파이프라인에서 템플릿을 동기화하는 경우에 사용할 수 있습니다.

| 데이터 세트 유효성 검사 및 오케스트레이션된 캠페인 실행 트리거 | 데이터 세트 유효성 검사 · 트리거 · 데이터 세트 활성화 |

추가 리소스 additional-resources

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

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

구현 시작

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

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

기타 역할 안내서 other-role-guides

역할 및 책임 개요로 돌아가기 · 시작으로 돌아가기