Panoramica sul monitoraggio dei servizi di adesione
NOTEIl contenuto di questa pagina viene fornito solo a scopo informativo. L’utilizzo di questa API richiede una licenza corrente da Adobe. Non è consentito alcun uso non autorizzato.
Introduzione
I siti e le app TVE devono essere disponibili 24 ore su 24, 7 giorni su 7; pertanto, i clienti devono essere informati in tempo reale sugli eventi di adesione per poter rilevare e correggere i problemi il più rapidamente possibile. Inoltre, devono analizzare i dati mensili per determinare quali piattaforme forniscono la maggior parte del traffico, e quali piattaforme potrebbero avere una cattiva implementazione e tassi di conversione insoddisfacenti.
Entitlement Service Monitoring (ESM) fornisce a programmatori e MVPD un feed di dati che offre visibilità in tempo reale sui loro eventi di autenticazione e autorizzazione. I dati vengono raccolti dai sistemi di autenticazione di Adobe Pass e forniti tramite un’API RESTful. I clienti possono utilizzare i dati in modo diretto o dall’interno delle proprie dashboard operative personalizzate.
Gli elementi principali del sistema ESM sono le metriche e le dimensioni. ESM genera rapporti che contengono metriche aggregate in base alla selezione della dimensione. Poiché gli eventi Adobe Pass vengono registrati nel fuso orario PST, i rapporti ESM sono disponibili anche nel fuso orario PST.
L’API ESM non è generalmente disponibile. Per domande sulla disponibilità, contatta il rappresentante di Adobe.
ESM per programmatori
I programmatori possono monitorare le metriche seguenti:
| Nome metrica | Descrizione |
|---|---|
| authn-try | Numero di flussi di autenticazione avviati |
| author-success | Numero di token di autenticazione ottenuti correttamente dai client |
| in attesa di autenticazione | Numero di token di autenticazione generati correttamente (a prescindere dal fatto che il client lo abbia effettivamente ottenuto o meno) |
| author-failed | Numero di autenticazione non riuscita eseguita tramite un sistema esterno. |
| clientless-tokens | Numero di token senza client emessi correttamente |
| clientless-failures | Numero di tentativi non riusciti di ricevere token dall’API senza client |
| authz-try | Numero di tentativi di autorizzazione |
| autenticazione riuscita | Numero di autorizzazioni riuscite |
| autorizzazione non riuscita | Numero di autorizzazioni negate dagli MVPD a livello di applicazione |
| Autore-rifiutato | Numero di tentativi di autorizzazione considerati dannosi da Adobe Service Provider e rifiutati in seguito alla prevenzione di attacchi DoS |
| autentz-latenza | Numero totale di millisecondi trascorsi sull’endpoint di MVPD |
| media-token | Numero di token multimediali brevi generati (assimilati al numero di richieste di riproduzione) |
| account univoci | Numero di utenti univoci che hanno eseguito azioni di adesione (AuthN/AuthZ) nell’intervallo di tempo selezionato. Questa metrica verrà visualizzata solo se sono richiesti valori giornalieri. Questo valore viene calcolato per ogni singolo datacenter. Quando non è richiesta la dimensione "dc", questa metrica non viene visualizzata. |
| sessioni univoche | Numero di sessioni univoche che hanno eseguito chiamate del flusso di autenticazione al servizio di autenticazione di Adobe Pass entro l’intervallo di tempo selezionato. Questa metrica verrà visualizzata solo se sono richiesti valori giornalieri. Questo valore viene calcolato per ogni singolo datacenter. Quando non è richiesta la dimensione "dc", questa metrica non viene visualizzata. |
| count | Contatore semplice utilizzato nei rapporti orientati agli eventi |
I programmatori possono filtrare le metriche elencate sopra in base alle seguenti dimensioni:
| Nome Dimension | Descrizione |
|---|---|
| anno | Anno a 4 cifre |
| mese | Il mese dell'anno (1-12) |
| giorno | Il giorno del mese (1-31) |
| ora | L'ora del giorno |
| minuto | Il minuto dell'ora |
| media-company | Società di media proprietaria del sito web che ha avviato il processo di adesione per l’utente |
| dc | (Centro dati) L’area geografica principale in cui è stata ricevuta la richiesta. |
| proxy | Il proxy MVPD (che sarà "Direct" (Diretto) per le integrazioni dirette) |
| mvpd | MVPD responsabile della concessione dell'autorizzazione all'utente |
| requestor-id | ID richiedente utilizzato per eseguire la richiesta di adesione |
| channel | Il sito web del canale, estratto dal campo della risorsa (estratto dal payload MRSS come canale/titolo, se fornito, o mappato al valore della risorsa, se non in formato RSS). |
| resource-id | Titolo effettivo della risorsa coinvolto nella richiesta di autorizzazione (estratto dal payload MRSS come articolo/titolo se fornito) |
| dispositivo | La piattaforma del dispositivo (PC, dispositivi mobili, console, ecc.) |
| eap | Il provider di autenticazione esterno quando il flusso di autenticazione viene eseguito tramite un sistema esterno. I valori possono essere: - N/D - Autenticazione Adobe Pass - Apple - Sistema esterno che ha fornito l'autenticazione Apple |
| famiglia di sistemi operativi | Sistema operativo in esecuzione sul dispositivo |
| famiglia di browser | Agente utente utilizzato per accedere all’autenticazione di Adobe Pass |
| cdt | La piattaforma del dispositivo (alternativa), attualmente utilizzata per Clientless. I valori possono essere: - N/D - l'evento non ha avuto origine da un SDK senza client - Sconosciuto - Poiché il parametro deviceType di un'API senza client è facoltativo, esistono chiamate che non contengono alcun valore. - qualsiasi altro valore inviato tramite l'API senza client, ad esempio xbox, appletv, roku ecc. |
| platform-version | Versione di Clientless SDK |
| tipo di sistema operativo | Sistema operativo in esecuzione sul dispositivo, alternativo (non attualmente utilizzato) |
| versione browser | Versione agente utente |
| nsdk | Il SDK client utilizzato (android, fireTV, js, iOS, tvOS, non sdk) |
| nsdk-version | Versione del SDK client di autenticazione di Adobe Pass |
| evento | Nome dell’evento di autenticazione Adobe Pass |
| motivo | Motivo degli errori, segnalato dall’autenticazione di Adobe Pass |
| sso-type | Il meccanismo SSO sottostante: platform/passive/adobe. Indica che il token di autorizzazione è stato emesso riutilizzando l’AuthN in un’altra applicazione |
| piattaforma | La piattaforma identificata dal dispositivo. Valori possibili: - Android - FireTV - Roku - iOS - tvOS - ecc |
| application-name | Il nome dell’applicazione configurata, in Dashboard TVE, per l’applicazione registrata DCR configurata per essere utilizzata. |
| application-version | Versione dell’applicazione configurata, in Dashboard TVE, per l’applicazione registrata DCR configurata per l’utilizzo. |
| customer-app | ID applicazione personalizzato passato tramite Informazioni dispositivo. |
| content-category | La categoria del contenuto richiesto dall’applicazione. |
ESM per MVPD
Gli MVPD possono monitorare le metriche seguenti:
| Nome metrica | Descrizione |
|---|---|
| authn-try | Numero di flussi di autenticazione avviati |
| author-success | Numero di token di autenticazione ottenuti correttamente dai client |
| in attesa di autenticazione | Numero di token di autenticazione generati correttamente (a prescindere dal fatto che il client lo abbia effettivamente ottenuto o meno) |
| author-failed | Numero di autenticazione non riuscita eseguita tramite un sistema esterno. |
| authz-try | Numero di tentativi di autorizzazione |
| autenticazione riuscita | Numero di autorizzazioni riuscite |
| autorizzazione non riuscita | Numero di autorizzazioni negate dagli MVPD a livello di applicazione |
| Autore-rifiutato | Numero di tentativi di autorizzazione considerati dannosi da Adobe Service Provider e rifiutati in seguito alla prevenzione di attacchi DoS |
| autentz-latenza | Numero totale di millisecondi trascorsi sull’endpoint di MVPD |
Gli MVPD possono filtrare le metriche elencate in precedenza in base alle seguenti dimensioni:
| Nome Dimension | Descrizione |
|---|---|
| anno | Anno a 4 cifre |
| mese | Il mese dell'anno (1-12) |
| giorno | Il giorno del mese (1-31) |
| ora | L'ora del giorno |
| minuto | Il minuto dell'ora |
| mvpd | ID mvpd utilizzato per eseguire la richiesta di adesione |
| requestor-id | ID richiedente utilizzato per eseguire la richiesta di adesione |
| eap | Il provider di autenticazione esterno quando il flusso di autenticazione viene eseguito tramite un sistema esterno. I valori possono essere: - N/D - Autenticazione Adobe Pass - Apple - Sistema esterno che ha fornito l'autenticazione Apple |
| cdt | La piattaforma del dispositivo (alternativa), attualmente utilizzata per Clientless. I valori possono essere: - N/D - l'evento non ha avuto origine da un SDK senza client - Sconosciuto - Poiché il parametro deviceType di un'API senza client è facoltativo, esistono chiamate che non contengono alcun valore. - qualsiasi altro valore inviato tramite l'API senza client, ad esempio xbox, appletv, roku ecc. |
| tipo sdk | Il client SDK utilizzato (Flash, HTML5, Android nativo, iOS, Clientless, ecc.) |
| piattaforma | La piattaforma identificata dal dispositivo. Valori possibili: - Android - FireTV - Roku - iOS - tvOS - ecc |
| nsdk | Il SDK client utilizzato (android, fireTV, js, iOS, tvOS, non sdk) |
| nsdk-version | Versione del SDK client di autenticazione di Adobe Pass |