Integrazione dei dati lato server di autenticazione di Adobe Pass in Adobe Analytics
NOTE
Il 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.
I clienti di Adobe Pass Authentication desiderano visualizzare i dati lato server di Adobe Pass Authentication (Adobe Pass) nel dashboard di Adobe Analytics per semplificarne l’utilizzo.
I dati serviranno a tenere traccia di metriche TVE importanti, come i tassi di conversione dell’autenticazione per MVPD, gli utenti univoci in base all’ID utente di MVPD e altro ancora.
Non intende sostituire un’implementazione lato client se ne esiste già una, in quanto l’attività utente non può essere tracciata oltre gli eventi specifici riportati di seguito in assenza di un ID visitatore. Se i clienti forniscono un ID visitatore nelle chiamate Pass, possiamo sbloccare un altro tipo di integrazione Analytics (in tempo reale) che può unire tutti gli eventi Pass ai dati esistenti del cliente. Ulteriori dettagli su questo nuovo tipo di possibile integrazione qui: "Utilizzo di Experience Cloud ID nell'autenticazione di Adobe Pass"
Metriche incluse metrics-included-int-authn-analyt
Evento
Descrizione
AuthN richiesta
Numero di flussi di autenticazione avviati
AuthN in sospeso
Numero di token di autenticazione generati correttamente (a prescindere dal fatto che il client lo abbia effettivamente ottenuto o meno)
AuthN OK
Numero di token di autenticazione ottenuti correttamente dagli utenti
AuthZ richiesta
Numero di tentativi di autorizzazione
AuthZ OK
Numero di autorizzazioni riuscite
AuthZ non riuscito
Numero di autorizzazioni negate dagli MVPD a livello di applicazione
Riproduci richiesta
Numero di token multimediali brevi generati (assimilati al numero di richieste di riproduzione)
Disconnessione richiesta
Numero di flussi di disconnessione avviati
Disconnessione completata
Numero di flussi di logout completati con successo
Disconnessione non riuscita
Numero di flussi di disconnessione non riusciti
Preautorizzazione richiesta
Numero di flussi di pre-autorizzazione avviati
Preautorizzazione OK
Numero di eventi di preautorizzazione riusciti con le risorse preautorizzate
Preautorizzazione negata
Numero di eventi di preautorizzazione con le risorse a cui è stata negata la preautorizzazione
Preautorizzazione non riuscita
Numero di eventi di preautorizzazione non riusciti
Nome Adobe Analytics
Descrizione
Canale
ID richiedente utilizzato per eseguire la richiesta di adesione
MVPD
MVPD responsabile della concessione dell'autorizzazione all'utente
Proxy
Il proxy MVPD (che sarà "Direct" (Diretto) per le integrazioni dirette)
Tipo di SDK
Il SDK client utilizzato (Flash, HTML5, Android nativo, iOS, Clientless, ecc.)
Versione SDK
Versione del SDK client di autenticazione di Adobe Pass
ID risorsa
Titolo effettivo della risorsa coinvolto nella richiesta di autorizzazione (estratto dal payload MRSS come articolo/titolo se fornito)
Tipo di errore AuthZ
Motivo degli errori, come segnalato dall'autenticazione Adobe Pass
Di seguito sono riportati i valori più comuni
noAuthZ = MVPD ha risposto che l'utente non ha il canale nel pacchetto
rete = impossibile raggiungere MVPD (MVPD ha un problema al momento della chiamata e non ha risposto)
norefreshtoken = strettamente per le implementazioni OAuth e potrebbe verificarsi se l'utente ha cambiato la password o se MVPD l'ha negata per qualche motivo. Generalmente genera una nuova autenticazione
mancata corrispondenza = se la richiesta viene effettuata da un dispositivo diverso da quello che aveva il token di autenticazione. Può verificarsi se gli utenti tentano di ingannare il sistema, ma la maggior parte di queste si è verificata nel contesto del nostro vecchio SDK JavaScript, in cui l’ID dispositivo utilizzava l’indirizzo IP come parte del calcolo. Se un utente guardava TVE a casa e poi al lavoro, questo errore veniva attivato e doveva autenticarsi di nuovo
non valido = richiesta non valida, parametri mancanti o non validi
authzNone = I programmatori possono negare le autorizzazioni per una specifica combinazione channelxMVPD. Attivato da un'API di back-end a cui i programmatori hanno accesso
frode = è un meccanismo di protezione dalla nostra parte. Se l’utente non riesce a ottenere l’autorizzazione e successivamente la richiede nuovamente un numero di volte in un breve intervallo (secondi), la chiamata viene negata direttamente. In genere si verifica quando un programmatore presenta un bug nell’implementazione che richiede costantemente l’autorizzazione in caso di errore.
Di seguito sono riportati i valori più comuni
noAuthZ = MVPD ha risposto che l'utente non ha il canale nel pacchetto
rete = impossibile raggiungere MVPD (MVPD ha un problema al momento della chiamata e non ha risposto)
norefreshtoken = strettamente per le implementazioni OAuth e potrebbe verificarsi se l'utente ha cambiato la password o se MVPD l'ha negata per qualche motivo. Generalmente genera una nuova autenticazione
mancata corrispondenza = se la richiesta viene effettuata da un dispositivo diverso da quello che aveva il token di autenticazione. Può verificarsi se gli utenti tentano di ingannare il sistema, ma la maggior parte di queste si è verificata nel contesto del nostro vecchio SDK JavaScript, in cui l’ID dispositivo utilizzava l’indirizzo IP come parte del calcolo. Se un utente guardava TVE a casa e poi al lavoro, questo errore veniva attivato e doveva autenticarsi di nuovo
non valido = richiesta non valida, parametri mancanti o non validi
authzNone = I programmatori possono negare le autorizzazioni per una specifica combinazione channelxMVPD. Attivato da un'API di back-end a cui i programmatori hanno accesso
frode = è un meccanismo di protezione dalla nostra parte. Se l’utente non riesce a ottenere l’autorizzazione e successivamente la richiede nuovamente un numero di volte in un breve intervallo (secondi), la chiamata viene negata direttamente. In genere si verifica quando un programmatore presenta un bug nell’implementazione che richiede costantemente l’autorizzazione in caso di errore.
Tipo di token
Quando i token vengono creati a causa di AuthZ All e AuthN All, dobbiamo sapere cosa viene fatto a causa di una misura di degradazione.
Sono:
"normal" = Caso normale
"authnall" = Quando AuthN All è abilitato
"authzall" = Quando AuthZ All è abilitato
"hba" = Quando HBA è abilitato
Sono:
"normal" = Caso normale
"authnall" = Quando AuthN All è abilitato
"authzall" = Quando AuthZ All è abilitato
"hba" = Quando HBA è abilitato
Tipo di dispositivo senza client
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 API senza client. Ad esempio, xbox, appletv e roku.
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 API senza client. Ad esempio, xbox, appletv e roku.
ID utente MVPD
Sostituisce l'ID visitatore basato su cookie
Dettagli details-int-authn-analyt
- Le metriche verranno inserite, evento per evento, nella suite di rapporti specifica tramite l’API di inserimento dati di Adobe Analytics
- L’inserimento verrà inserito in batch e inviato ogni 30 minuti. Per questo motivo, il rapporto deve essere contrassegnato con la data e l’ora
- Ogni cliente avrà una o più suite di rapporti. Un ID richiedente (canale) verrà mappato solo su una suite di rapporti. Più ID richiedente possono essere mappati su una sola suite di rapporti.
- È possibile fornire dati storici, ma sarà necessario prestare particolare attenzione a causa di problemi di traffico/prestazioni.
- La variabile visitatore univoco è impostata sull’ID utente di MVPD
- La mappatura di eventi ed eVar non è configurabile.
SLA sla-int-authn-serv-anal
Poiché non si tratta di un componente fondamentale, SLA non garantisce l'integrazione del sistema.
Configurazione suite di rapporti report-suite-config
Il rapporto deve avere una marca temporale in quanto gli eventi verranno inviati in batch.
Eventi report-suite-config-events
NOTE
Tutti devono essere impostati con:
- Contatore (nessuna relazione secondaria)
Evento
Evento Adobe Analytics
AuthN richiesta
event1
AuthN in sospeso
event2
AuthN OK
event3
AuthZ richiesta
event4
AuthZ OK
event5
AuthZ non riuscito
event6
Riproduci richiesta
event7
AuthN non riuscito
event8
Richiesta token di autenticazione senza client OK
event9
Richiesta token di autenticazione senza client non riuscita
event10
Richiesta di riproduzione non riuscita
event11
Richiesta di disconnessione
event12
Disconnessione completata
event13
Disconnessione non riuscita
event14
Richiesta di verifica preliminare
event15
Verifica preliminare non riuscita
event16
Verifica preliminare concessa
event17
Verifica preliminare negata
event18
eVar evars
NOTE
Tutti devono essere impostati con:
- Allocazione: più recente (ultimo)
- Scadenza dopo: hit
- Tipo: Stringa di testo
Proprietà
eVar
Canale
EVAR1
MVPD
EVAR2
Proxy
EVAR3
Tipo di SDK
EVAR4
Versione SDK
EVAR5
ID risorsa
EVAR6
Tipo di errore AuthZ
EVAR7
Tipo di token
EVAR8
Tipo di dispositivo senza client
EVAR9
ID utente MVPD
visitorID (completato automaticamente)
ID utente MVPD
eVar10
Tipo di dispositivo
eVar11
Sistema operativo
eVar12
Tipo di hardware principale
eVar13
TTL
eVar14
Tipo di autenticazione
eVar15
Versione dell'architettura del server
eVar16
Provider di autenticazione esterno
eVar17
Latenza
eVar18
ID visitatore
eVar19
Meccanismo SSO
eVar20
Modello dispositivo
eVar21
Versione dispositivo
eVar22
Modello hardware del dispositivo
eVar23
Fornitore hardware dispositivo
eVar24
Produttore hardware del dispositivo
eVar25
Versione hardware del dispositivo
eVar26
Nome SO dispositivo
eVar27
Famiglia SO dispositivo
eVar28
Fornitore SO dispositivo
eVar29
Versione SO dispositivo
eVar30
Nome browser dispositivi
eVar31
Fornitore browser dispositivi
eVar32
Versione browser dispositivi
eVar33
Tipo di dispositivo senza client normalizzato
eVar34
Prezzi pricing
Contatta il tuo TAM per ulteriori informazioni.
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b