IMS를 사용하여 Adobe Analytics과 통합

마지막 업데이트: 2023-09-14

Analytics Standard API를 통해 Adobe Analytics과 AEM을 통합하려면 Adobe Developer 콘솔을 사용하여 Adobe IMS(Identity Management 시스템)를 구성해야 합니다.

노트

Adobe Analytics Standard API 2.0 지원은 AEM 6.5.12.0의 새로운 기능입니다. 이 API 버전은 IMS 인증을 지원합니다.

이전 버전과의 호환성을 위해 AEM에서 Adobe Analytics Classic API 1.4 사용이 여전히 지원됩니다. 다음 Analytics Classic API는 사용자 자격 증명 인증을 사용합니다.

API 선택은 AEM/Analytics 통합에 사용되는 인증 방법에 따라 결정됩니다.

자세한 내용은 2.0 API로 마이그레이션에서도 찾을 수 있습니다.

사전 요구 사항

이 절차를 시작하기 전에:

  • Adobe 지원 팀은 다음에 대한 계정을 프로비저닝해야 합니다.

    • Adobe Console
    • Adobe Developer Console
    • Adobe Analytics 및
    • Adobe IMS(ID 관리 시스템)
  • 귀사의 시스템 관리자는 Admin Console을 사용하여 필요한 개발자를 관련 제품 프로필에 추가해야 합니다.

    • 이렇게 하면 특정 개발자에게 Adobe Developer 콘솔 내에서 통합을 활성화할 수 있는 권한이 제공됩니다.
    • 다음을 참조하십시오 개발자 관리.

IMS 구성 - 공개 키 생성

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

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

  2. 다음에서 보안 섹션, 선택 Adobe IMS 구성.

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

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

  5. 새 인증서 만들기​를 활성화한 다음 새 별칭을 입력합니다.

  6. 인증서 만들기​를 사용하여 확인합니다.

    Adobe IMS 기술 계정 구성 마법사

  7. 다운로드(또는 공개 키 다운로드)를 선택하여 AEM과의 Adobe Analytics 통합에 대해 IMS를 구성할 때 사용할 수 있도록 파일을 로컬 드라이브에 다운로드합니다.

    주의

    이 구성을 열어 두십시오. 다음 경우에 다시 필요합니다. AEM에서 IMS 구성 완료.

    Adobe I/O 키를 추가하는 정보 대화 상자

AEM과의 Adobe Analytics 통합에 대해 IMS 구성

Adobe Developer 콘솔을 사용하여 AEM에서 사용할 Adobe Analytics으로 프로젝트(통합)를 만든 다음 필요한 권한을 할당합니다.

프로젝트 만들기

AEM에서 사용할 수 있는 Adobe Analytics을 사용하여 프로젝트를 만들려면 Adobe Developer 콘솔을 엽니다.

주의

현재 Adobe은 Adobe Developer 콘솔만 지원합니다. 서비스 계정(JWT) 자격 증명 유형.

OAuth 서버 간 자격 증명 유형은 향후 지원될 예정이니 사용하지 마십시오.

  1. 프로젝트용 Adobe Developer Console을 엽니다.

    https://developer.adobe.com/console/projects

  2. 보유 중인 모든 프로젝트가 표시됩니다. 선택 새 프로젝트 만들기 - 위치 및 사용량은 다음에 따라 다릅니다.

    • 보유 중인 프로젝트가 없는 경우, 새 프로젝트 만들기​는 중앙 하단에 표시됩니다.

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

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

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

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

    새 프로젝트 시작하기

  4. Adobe Analytics​를 선택하고 다음​을 선택합니다.

    노트

    Adobe Analytics를 구독하지만 나열되지 않는 경우 사전 요구 사항을 확인해야 합니다.

    API 추가

  5. 선택 서비스 계정(JWT) 인증 유형으로 을(를) 계속합니다. 다음:

    인증 유형 선택

  6. 공개 키를 업로드​한 다음 완료되면 다음​을 사용하여 계속합니다.

    공개 키 업로드

  7. 자격 증명을 검토하고 다음​을 사용하여 계속합니다.

    자격 증명 검토

  8. 필요한 제품 프로필을 선택한 다음 구성된 API 저장​을 사용하여 계속합니다.

    필요한 제품 프로필 선택

  9. 구성이 확인됩니다.

통합에 권한 할당

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

  1. Adobe Admin Console​을 엽니다.

  2. 제품​으로 이동한 다음(상단 도구 모음) 왼쪽 패널에서 Adobe Analytics - <테넌트 ID>​을(를) 선택합니다.

  3. 제품 프로필​을 선택한 다음 표시되는 목록에서 필요한 작업 영역을 선택합니다. (예: 기본 작업 영역)

  4. API 자격 증명​을 선택한 다음 필요한 통합 구성을 선택합니다.

  5. 제품 역할​을 관찰자​가 아닌 편집자​로 선택합니다.

저장된 Adobe Developer Console 통합 프로젝트 세부 정보

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

구성에 대한 세부 정보를 표시하려면 특정 프로젝트 항목을 선택합니다. 여기에는 다음이 포함됩니다.

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

이 중 일부는 AEM에서 Adobe Analytics에 대한 통합을 완료해야 합니다.

AEM에서 IMS 구성 완료

AEM으로 돌아가면 Analytics에 대한 통합 프로젝트에서 필요한 값을 추가하여 IMS 구성을 완료할 수 있습니다.

  1. AEM에서 열려 있는 IMS 구성으로 돌아갑니다.

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

  3. 여기에서 Adobe Developer 콘솔 통합 프로젝트에 대해 저장된 세부 정보:

    AEM IMS 구성 세부 정

  4. 만들기​를 사용하여 확인합니다.

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

    IMS 구성

IMS 구성 확인

구성이 예상대로 작동하는지 확인하려면 다음 작업을 수행하십시오.

  1. 열기:

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

    예:

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

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

    IMS 구성 - 상태 확인

  4. 성공하면 확인 메시지가 표시됩니다.

Adobe Analytics Cloud 서비스 구성

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

  1. 를 엽니다. 도구 메뉴 아래의 제품에서 사용할 수 있습니다. 그런 다음 Cloud Service 섹션, 선택 이전 Cloud Service.

  2. 아래로 스크롤하여 Adobe Analytics 및 선택 지금 구성.

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

  3. 입력 제목 그리고, 원한다면 이름 (비워 두면 제목에서 생성됩니다.)

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

  4. 만들기​를 사용하여 확인합니다.

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

  5. 다음에 세부 정보를 입력합니다. Analytics 설정 탭:

    • 인증: IMS

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

  6. Adobe Analytics 연결을 초기화하려면 Analytics에 연결.

    정상적으로 연결되면 연결 성공​이라는 메시지가 표시됩니다.

  7. 선택 확인 메시지를 표시합니다.

  8. 필요에 따라 다른 매개 변수를 완료하고 다음을 수행합니다. 확인 대화 상자에서 구성을 확인할 수 있습니다.

  9. 이제 다음으로 진행할 수 있습니다. Analytics 프레임워크 추가 Adobe Analytics으로 전송되는 매개 변수를 구성합니다.

이 페이지에서는