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

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

소개 introduction

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

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에 사용되는 디바이스 플랫폼(대체 요소)입니다.
값은 다음과 같습니다.
- 해당 사항 없음 - 이벤트가 클라이언트 없는 SDK에서 발생하지 않음
- 알 수 없음 - 클라이언트 없는 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에 사용되는 디바이스 플랫폼(대체 요소)입니다.
값은 다음과 같습니다.
- 해당 사항 없음 - 이벤트가 클라이언트 없는 SDK에서 발생하지 않음
- 알 수 없음 - 클라이언트 없는 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