Adobe I/O을(를) 사용하여 Adobe Target과 통합

Target Standard API를 통해 Adobe Target과 AEM을 통합하려면 Adobe IMS(Identity Management System) 및 Adobe I/O을 구성해야 합니다.

노트

Adobe Target Standard API에 대한 지원은 AEM 6.5에서 새로운 기능으로, Target Standard API는 IMS 인증을 사용합니다.

AEM에서 Adobe Target Classic API를 사용하는 것은 이전 버전과의 호환성을 위해 계속 지원됩니다. Target Classic API는 사용자 자격 증명 인증을 사용합니다.

API 선택은 AEM/Target 통합에 사용되는 인증 방법에 의해 결정됩니다.
테넌트 ID 및 클라이언트 코드 섹션도 참조하십시오.

전제 조건

이 절차를 시작하기 전:

  • Adobe 지원계정 제공:

    • Adobe 콘솔
    • Adobe I/O
    • Adobe Target 및
    • Adobe IMS(Identity Management 시스템)
  • 조직의 시스템 관리자는 Admin Console을 사용하여 조직의 필수 개발자를 관련 제품 프로필에 추가해야 합니다.

    • 이렇게 하면 특정 개발자에게 Adobe I/O 내 통합을 활성화할 수 있는 권한이 제공됩니다.
    • 자세한 내용은 개발자 관리를 참조하십시오.

IMS 구성 구성 - 공개 키 생성

구성의 첫 번째 단계는 AEM에서 IMS 구성을 만들고 공개 키를 생성하는 것입니다.

  1. AEM에서 도구 메뉴를 엽니다.

  2. 보안 섹션에서 Adobe IMS 구성​을 선택합니다.

  3. 만들기​를 선택하여 Adobe IMS를 엽니다. 기술 계정 구성.

  4. 클라우드 구성 아래의 드롭다운을 사용하여 Adobe Target​을 선택합니다.

  5. 새 인증서​를 만들고 새 별칭을 입력합니다.

  6. 인증서​를(를) 만들어 확인합니다.

  7. 다운로드(또는 공개 키 다운로드)를 선택하여 파일을 로컬 드라이브에 다운로드합니다. 이렇게 하면 가 AEM와 Adobe Target 통합을 위한 Adobe I/O을 구성할 때 사용할 수 있습니다.

    주의

    이 구성을 열어 두십시오. AEM🔗에서 IMS 구성을 완료하면 이 구성이 다시 필요합니다.

AEM과(와) Adobe Target 통합을 위한 Adobe I/O 구성

AEM에서 사용할 Adobe Target과 Adobe I/O 프로젝트(통합)를 만든 다음 필요한 권한을 할당해야 합니다.

프로젝트 만들기

Adobe I/O 콘솔을 열어 AEM에서 사용할 Adobe Target으로 I/O 프로젝트를 만듭니다.

노트

Adobe I/O 자습서도 참조하십시오.

  1. 프로젝트에 대한 Adobe I/O 콘솔을 엽니다.

    https://console.adobe.io/projects

  2. 보유한 모든 프로젝트가 표시됩니다. 새 프로젝트 만들기​를 선택합니다. 위치 및 사용량은 다음에 따라 달라집니다.

    • 아직 프로젝트가 없는 경우 새 프로젝트 만들기​는 가운데, 아래쪽에 있습니다.

      새 프로젝트 만들기 - 첫 번째 프로젝트

    • 이미 기존 프로젝트가 있는 경우 이러한 프로젝트가 나열되며 새 프로젝트 만들기​가 오른쪽 상단에 있습니다.

      새 프로젝트 만들기 - 여러 프로젝트

  3. 프로젝트에 추가 뒤에 API​를 선택합니다.

  4. Adobe Target​을 선택한 다음 다음:

    노트

    Adobe Target에 가입했지만 목록에 표시되지 않은 경우에는 Prerequires를 확인해야 합니다.

  5. 공개 키를 업로드하고 완료되면 다음을 계속 진행합니다.

  6. 자격 증명을 검토하고 다음​으로 계속 진행합니다.

  7. 필요한 제품 프로필을 선택하고 구성된 API 저장​으로 계속 진행합니다.

    노트

    표시되는 제품 프로필은 다음 항목에 따라 다릅니다.

    • Adobe Target Standard - 기본 작업 영역​만 사용할 수 있습니다.
    • Adobe Target Premium - 사용 가능한 모든 작업 영역이 아래에 나와 있습니다.

  8. 창조는 확인될 것이다.

통합에 권한 할당

이제 필요한 권한을 통합에 할당해야 합니다.

  1. Adobe Admin Console​을 엽니다.

  2. 제품(위쪽 도구 모음)으로 이동한 다음 Adobe Target - <your-tenant-id(왼쪽 패널)을 선택합니다.

  3. 제품 프로필​을 선택한 다음 목록의 필수 작업 공간을 선택합니다. 예: 기본 작업 공간.

  4. 통합​을 선택한 다음 필요한 통합 구성을 선택합니다.

  5. 편집기​를 제품 역할;대신 Observer.

Adobe I/O 통합 프로젝트에 대해 저장된 세부 정보

Adobe I/O 프로젝트 콘솔에서 모든 통합 프로젝트의 목록을 볼 수 있습니다.

구성에 대한 자세한 내용을 보려면 특정 프로젝트 항목의 오른쪽에 있는 보기​를 선택합니다. 이러한 쿠키에는 다음이 포함됩니다.

  • 프로젝트 개요
  • 인사이트
  • 자격 증명
    • 서비스 계정(JWT)
      • 자격 증명 세부 정보
      • JWT 생성
  • APIS
    • 예: Adobe Target

이러한 기능 중 일부는 AEM의 Target에 대한 Adobe I/O 통합을 완료해야 합니다.

AEM에서 IMS 구성 완료

AEM으로 돌아가면 Target에 대한 Adobe I/O 통합에서 필요한 값을 추가하여 IMS 구성을 완료할 수 있습니다.

  1. AEM🔗에서 열린 IMS 구성으로 돌아갑니다.

  2. 다음​을 선택합니다.

  3. 여기에서 Adobe I/O🔗의 세부 정보를 사용할 수 있습니다.

    • 제목:텍스트.
    • 인증 서버:아래 Payloadsection "aud"​행에서 복사/붙여넣기(예: 아래 "https://ims-na1.adobelogin.com" 예)
    • API 키:Target에 대한 Adobe I/O 🔗 통합의 개요 섹션에서 이 항목을 복사합니다.
    • 클라이언트 암호:Target에 대한 🔗 Adobe I/O 통합의 개요 섹션에서 이 항목을 생성하고 복사합니다.
    • 페이로드:Target에 대한 Adobe I/O 통합의 JWTrich 생성 섹션에서 이 항목을 복사합니다.

  4. 만들기​로 확인합니다.

  5. Adobe Target 구성이 AEM 콘솔에 표시됩니다.

IMS 구성 확인

구성이 예상대로 작동하는지 확인하려면:

  1. 열기:

    • https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html

    예:

    • https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html
  2. 구성을 선택합니다.

  3. 도구 모음에서 상태 확인​을 선택하고 확인​을 선택합니다.

  4. 성공하면 다음과 같은 메시지가 표시됩니다.

Adobe Target Cloud Service 구성

이제 Cloud Service에서 Target Standard API를 사용하도록 구성을 참조할 수 있습니다.

  1. 도구 메뉴를 엽니다. 그런 다음 Cloud Services 섹션 내에서 기존 Cloud Services​을 선택합니다.

  2. Adobe Target​으로 스크롤하고 지금 구성​을 선택합니다.

    구성 만들기 대화 상자가 열립니다.

  3. 제목​을 입력하고 필요한 경우 이름(비워 두면 제목에서 생성됩니다).

    필요한 템플릿을 선택할 수도 있습니다(하나 이상의 템플릿을 사용할 수 있는 경우).

  4. 만들기​로 확인합니다.

    구성 요소 편집 대화 상자가 열립니다.

  5. Adobe Target 설정 탭에 세부 정보를 입력합니다.

    • 인증:IMS.

    • 테넌트 ID:Adobe IMS 테넌트 ID. 테넌트 ID 및 클라이언트 코드 섹션도 참조하십시오.

      노트

      IMS의 경우 이 값은 Target 자체에서 가져와야 합니다. Target에 로그인하여 URL에서 테넌트 ID를 추출할 수 있습니다.

      예를 들어 URL이 다음과 같은 경우:

      https://experience.adobe.com/#/@yourtenantid/target/activities

      그런 다음 yourtenantid을 사용합니다.

    • 클라이언트 코드:테넌트 ID 및 클라이언트 선택 항목을 참조하십시오.

    • IMS 구성:IMS 구성 이름을 선택합니다.

    • API 유형:REST

    • A4T Analytics Cloud 구성:타겟 활동 목표 및 지표에 사용되는 Analytics 클라우드 구성을 선택합니다. 컨텐츠를 타깃팅할 때 보고 소스로 Adobe Analytics을 사용하는 경우 이 옵션이 필요합니다. 클라우드 구성이 표시되지 않는 경우 A4T Analytics Cloud 구성의 참고 사항을 참조하십시오.

    • 정확한 타깃팅 사용:기본적으로 이 확인란이 선택되어 있습니다. 이 옵션을 선택하면 클라우드 서비스 구성이 내용을 로드하기 전에 컨텍스트가 로드될 때까지 대기합니다. 다음 사항에 주의하십시오.

    • Adobe Target에서 세그먼트 동기화:AEM에서 사용할 Target에 정의된 세그먼트를 다운로드하려면 이 옵션을 선택합니다. 인라인 세그먼트는 지원되지 않으며 항상 Target의 세그먼트를 사용해야 하므로 API 유형 속성이 REST인 경우 이 옵션을 선택해야 합니다. ('segment'의 AEM 용어는 'audience' Target과 같습니다.)

    • 클라이언트 라이브러리:AT.js 클라이언트 라이브러리 또는 mbox.js(더 이상 사용되지 않음) 중 어느 것을 원하는지 선택합니다.

    • 태그 관리 시스템을 사용하여 클라이언트 라이브러리를 제공합니다.DTM(더 이상 사용되지 않음), Adobe 실행 또는 기타 태그 관리 시스템을 사용합니다.

    • 사용자 지정 AT.js:태그 관리 상자를 선택하거나 기본 AT.js를 사용하려면 비워 두십시오. 또는 사용자 지정 AT.js를 업로드합니다. AT.js를 선택한 경우에만 나타납니다.

    노트

    Target Classic API를 사용하기 위한 Cloud Service 의 구성은 더 이상 사용되지 않습니다(Adobe Recommendations 설정 탭 사용).

  6. Target 연결​을 클릭하여 Adobe Target와의 연결을 초기화합니다.

    연결이 성공하면 연결 성공 메시지가 표시됩니다.

  7. 메시지에서 확인​을 선택하고 대화 상자에서 확인​을 선택하여 구성을 확인합니다.

  8. 이제 Target 프레임워크 추가로 이동하여 Target으로 보낼 ContextHub 또는 ClientContext 매개 변수를 구성할 수 있습니다. AEM 경험 조각을 Target으로 내보내는 데 필요하지 않을 수 있습니다.

테넌트 ID 및 클라이언트 코드

Adobe Experience Manager 6.5.8.0에서는 클라이언트 코드 필드가 Target 구성 창에 추가되었습니다.

테넌트 ID 및 클라이언트 코드 필드를 구성할 때 다음 사항을 주의하십시오.

  1. 대부분의 고객에게 테넌트 ID와 클라이언트 코드가 동일합니다. 즉, 두 필드 모두 동일한 정보를 포함하고 있으며 동일합니다. 두 필드 모두에 테넌트 ID를 입력해야 합니다.
  2. 기존 목적으로 테넌트 ID 및 클라이언트 코드 필드에 다른 값을 입력할 수도 있습니다.

두 경우 모두 다음 사항에 유의하십시오.

  • 기본적으로 클라이언트 코드(처음 추가된 경우)도 테넌트 ID 필드에 자동으로 복사됩니다.
  • 기본 테넌트 ID 세트를 변경할 수 있는 옵션이 있습니다.
  • 따라서 Target에 대한 백엔드 호출은 테넌트 ID를 기반으로 하며 Target에 대한 클라이언트 측 호출은 클라이언트 코드를 기반으로 합니다.

앞에서 설명한 바와 같이 첫 번째 사례는 AEM 6.5에서 가장 일반적으로 사용됩니다. 어떤 방식으로든 요구 사항에 따라 모두 필드에 올바른 정보가 들어 있는지 확인하십시오.

노트

기존 Target 구성을 변경하려는 경우:

  1. 테넌트 ID를 다시 입력합니다.
  2. Target에 다시 연결합니다.
  3. 구성을 저장합니다.

이 페이지에서는

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now