권한 부여 서비스 모니터링 개요 entitlement-service-monitoring-overview

NOTE
이 페이지의 컨텐츠는 정보용으로만 제공됩니다. 이 API를 사용하려면 Adobe의 현재 라이선스가 필요합니다. 허가되지 않은 사용은 허용되지 않습니다.

소개 introduction

TVE 사이트 및 앱은 연중무휴 24시간 사용 가능해야 하므로 고객은 문제를 가능한 한 빨리 감지하고 수정하기 위해 자격 부여 이벤트에 실시간 insight을 사용해야 합니다. 또한 대량의 트래픽을 제공하는 플랫폼과 구현이 잘못되고 전환율이 낮은 플랫폼을 파악하기 위해 월별 데이터를 분석해야 합니다.

ESM(자격 서비스 모니터링)은 프로그래머 및 MVPD에게 인증 및 권한 부여 이벤트를 실시간으로 볼 수 있는 데이터 피드를 제공합니다. 데이터는 Adobe Pass 인증 시스템에서 수집되며 RESTful API를 통해 제공됩니다. 고객은 직접 방식으로 또는 맞춤형 작성 운영 대시보드 내에서 데이터를 사용할 수 있습니다.

ESM 시스템의 핵심 요소는 지표와 차원입니다. ESM은 차원 선택에 따라 집계된 지표가 포함된 보고서를 생성합니다. Adobe Pass 이벤트가 PST 시간대에 기록되므로 ESM 보고서를 PST 시간대에서도 사용할 수 있습니다.

ESM API는 일반적으로 사용할 수 없습니다. 가용성에 대한 질문이 있는 경우 Adobe 담당자에게 문의하십시오.

프로그래머를 위한 ESM esm-for-programmers

프로그래머는 다음 지표를 모니터링할 수 있습니다. programmers-monitor-metrics

지표 이름
설명
작성 시도 횟수
시작된 인증 흐름 수
작성 성공
클라이언트가 성공적으로 획득한 인증 토큰 수
작성 보류 중
성공적으로 생성된 인증 토큰 수(클라이언트가 실제로 획득했는지 여부에 상관없이)
작성 실패
외부 시스템을 통해 수행된 실패한 인증 수입니다.
클라이언트 없는 토큰
내보내기에 성공한 클라이언트 없는 토큰 수
clientless-failures
Clientless API에서 토큰 받기에 실패한 횟수
인증 시도 횟수
시도된 승인 수
작성 성공
성공한 승인 수
작성 실패
응용 프로그램 수준에서 MVPD에 의해 거부된 승인 수
작성 거부됨
Adobe 서비스 공급자가 악의적으로 간주하여 DoS 공격 방지로 인해 거부된 승인 횟수
인증 대기 시간
MVPD 엔드포인트에서 보낸 총 시간(밀리초)
미디어 토큰
생성된 짧은 미디어 토큰 수(재생 요청 수와 동종)
고유 계정
선택한 시간 간격에서 권한 부여(AuthN/AuthZ) 작업을 수행한 고유 사용자 수입니다. (이 지표는 일일 값을 요청한 경우에만 표시됩니다.)
이는 각 개별 데이터 센터에 대해 계산됩니다. "dc" 차원이 요청되지 않으면 이 지표가 표시되지 않습니다.
고유 세션
선택한 시간 간격 내에 Adobe Pass 인증 서비스에 대한 인증 흐름 호출을 수행한 고유 세션 수입니다. (이 지표는 일일 값을 요청한 경우에만 표시됩니다.)
이는 각 개별 데이터 센터에 대해 계산됩니다. "dc" 차원이 요청되지 않으면 이 지표가 표시되지 않습니다.
count
이벤트 지향 보고서에 사용되는 간단한 카운터입니다

프로그래머는 다음 차원별로 위에 나열된 지표를 필터링할 수 있습니다. progr-filter-metrics

Dimension 이름
설명
4자리 연도
개월
월 (1-12)
날짜(1-31)
시간
시간
분(시)
미디어 회사
사용자에 대한 권한 부여 프로세스를 시작한 웹 사이트를 소유한 미디어 회사
dc
(데이터 센터) 요청을 받은 홈 지역입니다.
프록시
프록시 MVPD(직접 통합을 위해 "직접" 필요)
mvpd
사용자에게 자격을 부여할 책임이 있는 MVPD
요청자-id
권한 부여 요청을 수행하는 데 사용되는 요청자 ID
channel
리소스 필드에서 추출된 채널 웹 사이트(제공된 경우 MRSS 페이로드에서 채널/제목으로 추출되거나 RSS 형식이 아닌 경우 리소스 값에 매핑됨).
resource-id
인증 요청에 포함된 실제 리소스 제목(제공된 경우 MRSS 페이로드에서 항목/제목으로 추출)
장치
장치 플랫폼(PC, 모바일, 콘솔 등)
eap
외부 시스템을 통해 인증 흐름이 수행되는 경우 외부 인증 공급자.
값은 다음과 같습니다.
- N/A - Adobe Pass에서 제공한 인증
- Apple - 인증을 제공한 외부 시스템: Apple
제품군
장치에서 실행 중인 운영 체제
browser-family
Adobe Pass 인증 액세스에 사용되는 사용자 에이전트
cdt
현재 Clientless에 사용되는 디바이스 플랫폼(대체 요소)입니다.
값은 다음과 같습니다.
- N/A - 이벤트가 Clientless SDK에서 발생하지 않음
- 알 수 없음 - Clientless API의 deviceType 매개 변수는 선택 사항이므로 값을 포함하지 않는 호출이 있습니다.
- Clientless API를 통해 전송된 다른 값(예: xbox, appletv, roku 등)
platform-version
클라이언트 없는 SDK 버전
os-type
장치에서 실행 중인 운영 체제, 대안(현재 사용되지 않음)
browser-version
사용자 에이전트 버전
nsdk
사용된 클라이언트 SDK(android, fireTV, js, iOS, tvOS, 비 sdk)
nsdk-version
Adobe Pass 인증 클라이언트 SDK 버전
이벤트
Adobe Pass 인증 이벤트 이름
이유
Adobe Pass 인증에서 보고된 실패 이유
sso 유형
기본 SSO 메커니즘: platform/passive/adobe. 인증 토큰이 다른 애플리케이션에서 AuthN을 재사용하여 전송되었음을 나타냅니다.
platform
장치가 플랫폼을 확인했습니다. 가능한 값:
- Android
- FireTV
- Roku
- iOS
- tvOS
application-name
TVE Dashboard에서 사용하도록 구성된 DCR 등록 애플리케이션에 대해 구성된 애플리케이션 이름.
application-version
TVE Dashboard에서 사용하도록 구성된 DCR 등록 애플리케이션에 대해 구성된 애플리케이션 버전.
customer-app
장치 정보를 통해 전달된 사용자 지정 응용 프로그램 ID입니다.
content-category
애플리케이션이 요청한 콘텐츠의 범주입니다.

MVPD용 ESM esm-for-mvpds

MVPD는 다음 지표를 모니터링할 수 있습니다.

지표 이름
설명
작성 시도 횟수
시작된 인증 흐름 수
작성 성공
클라이언트가 성공적으로 획득한 인증 토큰 수
작성 보류 중
성공적으로 생성된 인증 토큰 수(클라이언트가 실제로 획득했는지 여부에 상관없이)
작성 실패
외부 시스템을 통해 수행된 실패한 인증 수입니다.
인증 시도 횟수
시도된 승인 수
작성 성공
성공한 승인 수
작성 실패
응용 프로그램 수준에서 MVPD에 의해 거부된 승인 수
작성 거부됨
Adobe 서비스 공급자가 악의적으로 간주하여 DoS 공격 방지로 인해 거부된 승인 횟수
인증 대기 시간
MVPD 엔드포인트에서 보낸 총 시간(밀리초)

MVPD는 다음 차원으로 위에 나열된 지표를 필터링할 수 있습니다.

Dimension 이름
설명
4자리 연도
개월
월 (1-12)
날짜(1-31)
시간
시간
분(시)
mvpd
권한 요청을 수행하는 데 사용되는 mvpd ID
요청자-id
권한 부여 요청을 수행하는 데 사용되는 요청자 ID
eap
외부 시스템을 통해 인증 흐름이 수행되는 경우 외부 인증 공급자.
값은 다음과 같습니다.
- N/A - Adobe Pass에서 제공한 인증
- Apple - 인증을 제공한 외부 시스템: Apple
cdt
현재 Clientless에 사용되는 디바이스 플랫폼(대체 요소)입니다.
값은 다음과 같습니다.
- N/A - 이벤트가 Clientless SDK에서 발생하지 않음
- 알 수 없음 - Clientless API의 deviceType 매개 변수는 선택 사항이므로 값을 포함하지 않는 호출이 있습니다.
- Clientless API를 통해 전송된 다른 값(예: xbox, appletv, roku 등)
sdk-type
사용된 클라이언트 SDK(Flash, HTML5, Android 기본, iOS, Clientless 등)
platform
장치가 플랫폼을 확인했습니다. 가능한 값:
- Android
- FireTV
- Roku
- iOS
- tvOS
nsdk
사용된 클라이언트 SDK(android, fireTV, js, iOS, tvOS, 비 sdk)
nsdk-version
Adobe Pass 인증 클라이언트 SDK 버전

사용 사례 use-cases

다음 사용 사례에 ESM 데이터를 사용할 수 있습니다.

  • 모니터링 - 운영 또는 모니터링 팀이 매 분마다 API를 호출하는 대시보드 또는 차트를 만들 수 있습니다. 표시되는 정보를 사용하여 문제가 나타나는 즉시 (Adobe Pass 인증 사용 또는 MVPD 사용) 문제를 감지할 수 있습니다.

  • 디버깅/품질 테스트 - 데이터는 플랫폼, 장치, 브라우저 및 OS별로 분류되므로 사용 패턴을 분석하면 특정 조합(예: OSX의 Safari)에 대한 문제를 정확하게 파악할 수 있습니다.

  • Analytics - 제공된 데이터는 Adobe Analytics 또는 다른 분석 도구를 통해 수집되는 클라이언트측 데이터를 보완/감사하는 데 사용할 수 있습니다.

recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b