使用権限サービスの監視の概要 entitlement-service-monitoring-overview
NOTE
このページのコンテンツは、情報提供のみを目的として提供されています。 このAPIを使用するには、Adobeの現在のライセンスが必要です。 無断使用は認められません。
概要 introduction
TVEのサイトやアプリは24時間365日利用可能である必要があるため、お客様は問題をできるだけ迅速に検出して修正するために、insightをリアルタイムでエンタイトルメントイベントに利用する必要があります。 また、月間データを分析して、どのプラットフォームがトラフィックの大部分を提供しているか、どのプラットフォームの実装が悪く、コンバージョン率が低い可能性があるかを判断する必要もあります。
エンタイトルメントサービスモニタリング（ESM）は、プログラマーとMVPDに、認証イベントと認証イベントをリアルタイムで可視化するデータフィードを提供します。 データはAdobe Pass認証システムから収集され、RESTful APIを通じて提供されます。 顧客は、データを直接的に、または独自のカスタム構築された運用ダッシュボードの中から利用できます。
ESM システムの中核的な要素は、その指標と寸法です。 ESMは、ディメンション選択に従って、集計指標を含むレポートを生成します。 Adobe Pass イベントはPST タイムゾーンで記録されるため、ESM レポートはPST タイムゾーンでも使用できます。
ESM APIは一般には使用できません。 ご利用に関するご質問は、Adobeの担当者までお問い合わせください。
プログラマー向けESM esm-for-programmers
プログラマは次の指標を監視できます。 programmers-monitor-metrics
指標の名前
説明
試行の許可
開始された認証フローの数
Authn-successful
クライアントが正常に取得した認証トークンの数
オーサリング保留
正常に生成された認証トークンの数（クライアントが実際に取得したかどうかを無視します）
authn-failed
外部システムを介して実行された失敗した認証の数。
clientless-tokens
正常に発行されたクライアントレス トークンの数
clientless-failures
クライアントレス APIからトークンを受信するために失敗した試行の数
authz-attempts
認証の試行回数
authz-successful
成功した承認の数
authz-failed
アプリケーションレベルでのMVPDによる拒否された承認の数
authz-rejected
Adobe サービスプロバイダーによって悪意があると見なされ、DoS攻撃防止の結果として拒否された認証の試みの数
authz-latency
MVPDのエンドポイントに費やした合計時間（ミリ秒）
media-tokens
生成されたショートメディアトークンの数（再生リクエストの数と同義）
unique-accounts
選択した時間間隔で使用権限（AuthN / AuthZ）アクションを実行したユニークユーザーの数。 （この指標は、1日の値が要求された場合にのみ表示されます。）
これは個々のデータセンターごとに計算されます。 「dc」ディメンションが要求されない場合、この指標は表示されません。
これは個々のデータセンターごとに計算されます。 「dc」ディメンションが要求されない場合、この指標は表示されません。
unique-sessions
選択した時間間隔でAdobe Pass Authentication サービスへの認証フロー呼び出しを実行した一意のセッションの数。 （この指標は、1日の値が要求された場合にのみ表示されます。）
これは個々のデータセンターごとに計算されます。 「dc」ディメンションが要求されない場合、この指標は表示されません。
これは個々のデータセンターごとに計算されます。 「dc」ディメンションが要求されない場合、この指標は表示されません。
カウント
イベント指向レポートで使用される単純なカウンター
プログラマーは、上記の指標を次のディメンションでフィルタリングできます。 progr-filter-metrics
Dimension名
説明
年
4桁の年
月
月（1-12）
日
月の日（1-31）
時間
時間帯
分
時間の分
media-company
ユーザーの使用権限プロセスを開始したweb サイトを所有するメディア会社
dc
（データセンター）リクエストを受信したホーム領域。
プロキシ
プロキシ MVPD（ダイレクト統合の場合は「ダイレクト」になります）
mvpd
ユーザーに使用権限を付与するMVPD
requestor-id
使用権限リクエストの実行に使用される要求者ID
チャネル
リソースフィールドから抽出されたチャネルウェブサイト（指定された場合はMRSS ペイロードからチャネル/タイトルとして抽出するか、RSS形式ではない場合はリソース値にマッピング）。
resource-id
認証リクエストに含まれる実際のリソースタイトル（指定されている場合は、MRSS ペイロードからアイテム/タイトルとして抽出されます）
デバイス
デバイスプラットフォーム（PC、モバイル、コンソールなど）
eap
外部システムを介して認証フローを実行する場合の外部認証プロバイダー。
値は次のとおりです。
- N/A – 認証はAdobe Pass Authentication
- Apple – 認証を提供した外部システムはAppleです
値は次のとおりです。
- N/A – 認証はAdobe Pass Authentication
- Apple – 認証を提供した外部システムはAppleです
os ファミリー
デバイス上で実行されているオペレーティングシステム
browser-family
Adobe Pass認証へのアクセスに使用されるユーザーエージェント
cdt
現在クライアントレスに使用されているデバイスプラットフォーム（代替）。
値は次のとおりです。
- N/A - イベントがクライアントレス SDK
– 不明 – クライアントレス APIのdeviceType パラメーターはオプションなので、値を含まない呼び出しがあります。
- クライアントレス APIを介して送信されたその他の値（例：xbox、appletv、rokuなど）
値は次のとおりです。
- N/A - イベントがクライアントレス SDK
– 不明 – クライアントレス APIのdeviceType パラメーターはオプションなので、値を含まない呼び出しがあります。
- クライアントレス APIを介して送信されたその他の値（例：xbox、appletv、rokuなど）
platform-version
クライアントレス SDKのバージョン
os タイプ
デバイス上で実行されているオペレーティングシステム、代替（現在使用されていない）
browser-version
ユーザーエージェントのバージョン
nsdk
SDKが使用するクライアント（android、fireTV、js、iOS、tvOS、非sdk）
nsdk-version
Adobe Pass Authentication client SDKのバージョン
イベント
Adobe Pass認証イベント名
理由
失敗の理由（Adobe Pass Authenticationによる報告）
sso タイプ
基礎となるSSO メカニズム：platform/passive/adobe。 認証トークンが、別のアプリケーションでAuthNを再利用することによって発行されたことを示します
platform
デバイスはプラットフォームを識別しました。 可能な値：
- Android
- FireTV
- Roku
- iOS
- tvOS
– など
- Android
- FireTV
- Roku
- iOS
- tvOS
– など
application-name
使用するように設定されたDCR登録済みアプリケーションに対して、TVE ダッシュボードで設定されたアプリケーション名。
application-version
使用するように設定されたDCR登録済みアプリケーションに対して、TVE ダッシュボードで設定されたアプリケーションバージョン。
customer-app
デバイス情報を介して渡されたカスタムアプリケーション ID。
content-category
アプリケーションによって要求されたコンテンツのカテゴリ。
MVPD向けESM esm-for-mvpds
MVPDは、次の指標を監視できます。
指標の名前
説明
試行の許可
開始された認証フローの数
Authn-successful
クライアントが正常に取得した認証トークンの数
オーサリング保留
正常に生成された認証トークンの数（クライアントが実際に取得したかどうかを無視します）
authn-failed
外部システムを介して実行された失敗した認証の数。
authz-attempts
認証の試行回数
authz-successful
成功した承認の数
authz-failed
アプリケーションレベルでのMVPDによる拒否された承認の数
authz-rejected
Adobe サービスプロバイダーによって悪意があると見なされ、DoS攻撃防止の結果として拒否された認証の試みの数
authz-latency
MVPDのエンドポイントに費やした合計時間（ミリ秒）
MVPDは、上記の指標を次のディメンションでフィルタリングできます。
Dimension名
説明
年
4桁の年
月
月（1-12）
日
月の日（1-31）
時間
時間帯
分
時間の分
mvpd
使用権限リクエストの実行に使用されるmvpd ID
requestor-id
使用権限リクエストの実行に使用される要求者ID
eap
外部システムを介して認証フローを実行する場合の外部認証プロバイダー。
値は次のとおりです。
- N/A – 認証はAdobe Pass Authentication
- Apple – 認証を提供した外部システムはAppleです
値は次のとおりです。
- N/A – 認証はAdobe Pass Authentication
- Apple – 認証を提供した外部システムはAppleです
cdt
現在クライアントレスに使用されているデバイスプラットフォーム（代替）。
値は次のとおりです。
- N/A - イベントがクライアントレス SDK
– 不明 – クライアントレス APIのdeviceType パラメーターはオプションなので、値を含まない呼び出しがあります。
- クライアントレス APIを介して送信されたその他の値（例：xbox、appletv、rokuなど）
値は次のとおりです。
- N/A - イベントがクライアントレス SDK
– 不明 – クライアントレス APIのdeviceType パラメーターはオプションなので、値を含まない呼び出しがあります。
- クライアントレス APIを介して送信されたその他の値（例：xbox、appletv、rokuなど）
sdk タイプ
使用するクライアント SDK（Flash、HTML5、Android ネイティブ、iOS、クライアントレスなど）
platform
デバイスはプラットフォームを識別しました。 可能な値：
- Android
- FireTV
- Roku
- iOS
- tvOS
– など
- Android
- FireTV
- Roku
- iOS
- tvOS
– など
nsdk
SDKが使用するクライアント（android、fireTV、js、iOS、tvOS、非sdk）
nsdk-version
Adobe Pass Authentication client SDKのバージョン
ユースケース use-cases
ESM データは、次のユースケースで使用できます。
-
監視 - オペレーション チームまたは監視チームは、APIを毎分呼び出すダッシュボードまたはグラフを作成できます。 表示された情報を使用すると、表示された瞬間に（Adobe Pass認証またはMVPDで）問題を検出できます。
-
デバッグ/品質テスト - データもプラットフォーム、デバイス、ブラウザー、OSごとに分割されているため、使用パターンを分析すると、特定の組み合わせ（OSXのSafariなど）に関する問題を特定できます。
-
Analytics – 提供されたデータは、Adobe Analyticsまたは他の分析ツールを通じて収集されるクライアントサイドデータを補完または監査するために使用できます。
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b