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

이 페이지에서: SDK, 이벤트 스트리밍, 사용자 지정 작업 끝점 및 응용 프로그램을 Adobe Journey Optimizer에 연결하는 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의 지침을 전달합니다. 이 기능이 없으면 Journey Optimizer에서 앱 사용자가 수행하는 작업을 볼 수 없으며 앱 사용자에게 연결할 방법도 없습니다.

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

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

코드 기반 경험을 사용하면 새로운 앱 릴리스 없이도 온보딩 화면 및 제품 세부 사항 페이지에서 인앱 배너 및 기능 플래그에 이르기까지 기본 모바일 앱의 모든 표면에 개인화된 콘텐츠를 전달할 수 있습니다. 모바일 SDK을 사용하여 런타임 시 개인화된 콘텐츠를 가져오고 렌더링하여 팀이 배치 및 프레젠테이션을 완전히 제어할 수 있도록 합니다.

웹 경험 구현 web-implementation

Adobe Experience Platform Web SDK 설정

웹 SDK(alloy.js)는 사이트에서 필요로 할 수 있는 별도의 Adobe 태그의 패치 작업을 대체하는 단일 JavaScript 라이브러리입니다. 동작 데이터를 수집하고, 사용자가 구성한 데이터 스트림을 통해 Adobe Experience Platform으로 스트리밍하고, 개인화 지침을 다시 수신합니다(모두 한 네트워크 왕복). 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 엔드포인트를 노출합니다. 예를 들어, 데이터 가져오기 후 주소 일괄 억제 또는 외부 콘텐츠 파이프라인에서 템플릿 동기화 등 UI에서 수동 단계가 필요한 작업을 자동화해야 할 때 사용합니다.

추가 리소스 additional-resources

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

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

구현 시작

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

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

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

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