Funzione TempPass temp-pass-feature
TempPass è una funzione versatile che consente ai programmatori di offrire accesso temporaneo ai loro contenuti protetti per gli utenti senza credenziali di account MVPD valide. Funge da strumento efficace per coinvolgere gli spettatori, sia attraverso scenari di accesso di base che attraverso campagne promozionali mirate.
TempPass è una soluzione potente che consente ai programmatori di:
- Coinvolgi i visualizzatori: offri un assaggio di contenuti premium per attrarre nuovi abbonati.
- Promozioni per le unità: esegui campagne mirate per aumentare l'esposizione dei contenuti e fidelizzare il brand.
- Mantieni controllo: Gestisci i periodi di accesso, applica limiti e reimposta l'accesso in base alle esigenze per allinearlo agli obiettivi aziendali.
La funzione TempPass viene fornita introducendo uno pseudo-MVPD (denominato ulteriormente "Temp Pass") nella configurazione del server di autenticazione di Adobe Pass come integrazione con il programmatore partecipante. La funzione TempPass è disponibile in due configurazioni:
- TempPass di base per l'accesso basato sul tempo.
- Passaggio temporaneo promozionale per un accesso flessibile basato su campagne.
Nella tabella seguente viene fornito un breve confronto tra le funzioni TempPass di base e promozionale:
- Basato su tempo
- Basato su tempo
- Limitato al numero massimo di risorse
- ID dispositivo
- ID dispositivo
- Hash delle informazioni sull’identificatore utente fornite (ad esempio, e-mail)
TempPass ti offre gli strumenti per espandere il pubblico e al contempo mantenere il controllo sull’accesso, sia che tu stia fornendo una panoramica della tua libreria di contenuti o promuovendo un evento di perimetro di selezione.
TempPass di base basic-temp-pass
La funzione TempPass di base consente ai programmatori di fornire un accesso limitato nel tempo ai contenuti, in base a vari scenari:
- Anteprime brevi: anteprime brevi delle offerte, ad esempio un periodo di accesso giornaliero di 10 minuti, per attirare potenziali abbonati.
- Accesso basato su eventi: Abilita l'accesso più lungo per gli eventi principali, ad esempio una sessione di 4 ore.
- Accesso combinato: combinare e abbinare le durate, ad esempio un periodo di visualizzazione esteso iniziale seguito da anteprime giornaliere più brevi nell'arco di diversi giorni.
Alcuni eventi possono richiedere un accesso graduale gratuito ai contenuti, ad esempio un periodo iniziale di libero accesso esteso (ad esempio, 4 ore), seguito da intervalli giornalieri più brevi di libero accesso (ad esempio, 10 minuti al giorno). Per implementare questo scenario, i programmatori devono coordinarsi con il proprio rappresentante Adobe per configurare due MVPD TempPass personalizzati in base alle loro esigenze.
Ad esempio, per fornire una sessione gratuita iniziale di 4 ore seguita da sessioni gratuite giornaliere di 10 minuti, Adobe può configurare per il programmatore:
- TempPass1: configurato con un valore TTL (Time-To-Live) di 4 ore per coprire il periodo di accesso libero iniziale.
- TempPass2: configurato con un valore TTL (Time-To-Live) di 10 minuti per i successivi intervalli giornalieri di accesso libero.
Per garantire la funzionalità dell'accesso giornaliero, è necessario reimpostare TempPass2 per tutti i dispositivi alle 00:00 ogni giorno.
Dettagli delle funzioni basic-temp-pass-feature-details
Parametri di configurazione:
- TTL (Time-To-Live): I programmatori possono specificare la durata dell'accesso. Questo TTL basato su orologio scade indipendentemente dall’ora di visualizzazione effettiva.
Identificazione utente:
La funzione TempPass di base utilizza l'identificatore del dispositivo come parametro di identificazione utente.
La tabella seguente consente di comprendere in che modo i parametri di identificazione dell’utente influenzano l’esperienza di prova dell’utente:
Calcolo ora di visualizzazione:
Il TTL rappresenta la durata dal tempo della richiesta di autorizzazione iniziale al tempo di scadenza, indipendentemente dal tempo effettivo impiegato per visualizzare il contenuto. Ogni richiesta futura controlla l’ora del server corrente rispetto all’ora di scadenza memorizzata per autorizzare l’accesso.
Autenticazione:
L'autenticazione non è necessaria per Basic TempPass, consentendo di procedere direttamente al passaggio di autorizzazione.
Autorizzazione:
Poiché non vi è alcuna interazione con un MVPD effettivo, il MVPD "Temp Pass" di base autorizzerà qualsiasi risorsa dato che il TempPass è valido. In caso di autorizzazione riuscita, la libreria Media Token Verifier rimane applicabile per la verifica del token multimediale e per garantire la convalida delle risorse prima di avviare la riproduzione del contenuto.
La decisione di autorizzazione si basa sui parametri di identificazione dell’utente e sul TTL configurato. Per ottenere un’autorizzazione corretta per una risorsa, una richiesta valida deve soddisfare le seguenti condizioni:
- Durata non utilizzata: Il tempo di scadenza viene calcolato aggiungendo il tempo della richiesta di autorizzazione iniziale (salvato nei nostri database) al TTL configurato. L'ora corrente del server viene confrontata con l'ora di scadenza per determinare se TempPass è ancora valido.
Nel caso in cui un utente superi il TTL configurato, non potrà più visualizzare il contenuto sullo stesso dispositivo a meno che il suo TempPass non venga reimpostato.
Preautorizzazione:
Quando viene effettuata una richiesta di preautorizzazione per un MVPD "Temp Pass" di base, la risposta restituisce l’intero elenco di risorse dalla richiesta come preautorizzato correttamente. Questo comportamento riflette la logica di autorizzazione, dato che le condizioni di autorizzazione si basano su limiti di tempo, anziché su risorse specifiche. Finché il vincolo di tempo è valido, le risorse richieste verranno autorizzate.
Disconnessione:
La disconnessione non è richiesta per Basic TempPass, consentendo di passare direttamente al passaggio di autenticazione utilizzando un utente effettivo MVPD.
Dati di tracciamento e analisi:
Durante il flusso TempPass di base, i dati di tracciamento utilizzano una versione con hash dell'identificatore del dispositivo, con l'identificatore MVPD impostato su "Temp Pass". I programmatori devono distinguere le metriche TempPass dalle metriche MVPD standard nelle loro implementazioni di analisi.
TempPass promozionale promotional-temp-pass
La funzione TempPass promozionale estende le funzionalità del TempPass di base, progettato appositamente per l'esecuzione di campagne promozionali. Questa funzione consente ai programmatori di coinvolgere gli utenti consentendo l’accesso a un numero predefinito di titoli VOD per un periodo di tempo specificato dopo la raccolta di un’identificazione utente valida, ad esempio un indirizzo e-mail.
Il TempPass promozionale include tutte le funzionalità del TempPass di base, con una maggiore flessibilità per:
- Definizione del numero massimo di titoli VOD accessibili durante il periodo promozionale.
- Impostazione del periodo di tempo durante il quale l'accesso promozionale è valido.
Quando un utente supera i limiti di accesso predefiniti (numero di titoli VOD o durata), non può più visualizzare contenuti sullo stesso dispositivo o con lo stesso identificatore utente, a meno che il suo TempPass non venga reimpostato.
Dettagli delle funzioni promotional-temp-pass-feature-details
Parametri di configurazione:
- Chiave informazioni utente: Chiave utilizzata per comunicare l'identificatore fornito dall'utente, ad esempio un indirizzo di posta elettronica (ad esempio, chiave è posta elettronica).
- Numero di risorse: definisce il numero di titoli VOD a cui un utente può accedere.
- TTL (Time-To-Live): la durata durante la quale l'utente può utilizzare le risorse consentite.
Identificazione utente:
La funzione Promotional TempPass utilizza l’hash dell’identificatore fornito dall’utente sopra l’identificatore del dispositivo come parametri di identificazione dell’utente.
Adobe consiglia di utilizzare la famiglia SHA-2 o le funzioni specifiche SHA-256, SHA-512 nei dati prima di inviarli ad Adobe. Ad esempio, SHA-256 su "user@domain.com" è "f7ee5ec7312165148b69fcca1d29075b14b8aef0b5048a332b18b88d09069fb7".
La tabella seguente consente di comprendere in che modo i parametri di identificazione dell’utente influenzano l’esperienza di prova dell’utente:
Calcolo ora di visualizzazione:
Il TTL rappresenta la durata dal tempo della richiesta di autorizzazione iniziale al tempo di scadenza, indipendentemente dal tempo effettivo impiegato per visualizzare il contenuto. Ogni richiesta futura controlla l’ora del server corrente rispetto all’ora di scadenza memorizzata per autorizzare l’accesso.
Autenticazione:
L'autenticazione non è necessaria per il passaggio TempPass promozionale, che consente di procedere direttamente al passaggio di autorizzazione.
Per supportare l'implementazione dell'applicazione del programmatore, il Promotional TempPass espone le seguenti informazioni sui metadati dell'utente, accessibili attraverso le chiavi corrispondenti:
remaining_resources: indica il numero di risorse che l'utente ha ancora il diritto di utilizzare.used_assets: fornisce un elenco delle risorse già utilizzate dall'utente.expiration_date: visualizza la data di scadenza del passaggio temporaneo promozionale dell'utente.
Autorizzazione:
Poiché non vi è alcuna interazione con un MVPD effettivo, il MVPD Promozionale "Temp Pass" autorizzerà qualsiasi risorsa dato che il TempPass è valido. In caso di autorizzazione riuscita, la libreria Media Token Verifier rimane applicabile per la verifica del token multimediale e per garantire la convalida delle risorse prima di avviare la riproduzione del contenuto.
La decisione di autorizzazione si basa sui parametri di identificazione dell’utente e sul numero configurato di risorse e TTL. Per ottenere un’autorizzazione corretta per una risorsa, una richiesta valida deve soddisfare le seguenti condizioni:
- Durata non utilizzata: Il tempo di scadenza viene calcolato aggiungendo il tempo della richiesta di autorizzazione iniziale (salvato nei nostri database) al TTL configurato. L'ora corrente del server viene confrontata con l'ora di scadenza per determinare se TempPass è ancora valido.
- Risorse non utilizzate: Il numero di risorse utilizzate viene registrato (salvato nei database). Il numero di risorse utilizzate viene confrontato con il numero di risorse configurato per determinare se TempPass è ancora valido.
Se un utente supera il TTL configurato o il numero di risorse, non potrà più visualizzare il contenuto sullo stesso dispositivo o con lo stesso identificatore fornito dall’utente, a meno che il suo TempPass non venga reimpostato.
Preautorizzazione:
Quando viene effettuata una richiesta di preautorizzazione per un MVPD "Temp Pass" promozionale, la risposta restituisce l’intero elenco di risorse dalla richiesta come preautorizzato correttamente. Questo comportamento riflette la logica di autorizzazione, dato che le condizioni di autorizzazione si basano sui limiti di tempo e sul numero totale di risorse a cui si accede, anziché su risorse specifiche. Se il vincolo di tempo è valido e il limite di risorse non è stato superato, le risorse richieste verranno autorizzate.
Disconnessione:
La disconnessione non è richiesta per il passaggio al passaggio di autenticazione Promozionale, che consente di passare direttamente al passaggio di autenticazione utilizzando un utente effettivo MVPD.
Dati di tracciamento e analisi:
Durante il flusso TempPass promozionale, i dati di tracciamento utilizzano una versione con hash dell'identificatore del dispositivo, con l'identificatore MVPD impostato su "Temp Pass". I programmatori devono distinguere le metriche TempPass dalle metriche MVPD standard nelle loro implementazioni di analisi.
Ripristina accesso API TempPass reset-tempass-api-access
Prima di accedere all’API Reset TempPass, devi completare i passaggi richiesti nel processo di registrazione client dinamica (DCR). Questo processo obbligatorio garantisce che tu disponga del token di accesso necessario per interagire con l’API Reset TempPass.
Per istruzioni complete, consulta la documentazione Panoramica registrazione client dinamico.
Ripristina API TempPass - DELETE /reset-tempass/v3/reset reset-tempass-v3-reset
Per reimpostare un TempPass specifico per un dispositivo o per tutti i dispositivi, l'autenticazione Adobe Pass fornisce ai programmatori un'API che funziona sia per il TempPass di base che per quello promozionale.
Richiesta reset-tempass-v3-reset-request
Risposta reset-tempass-v3-reset-response
Esempi reset-tempass-v3-reset-samples
Ripristina TempPass per un dispositivo specifico reset-tempass-v3-reset-specific-device
$ curl -H "Authorization: Bearer <access_token_here>" -X DELETE -v "https://mgmt.auth.adobe.com/reset-tempass/v3/reset?requestor_id=REF30&mvpd_id=TempPass&device_id=ba23d141-d715-561c-94f4-e9e4c966b1eb"
Reimposta TempPass per tutti i dispositivi reset-tempass-v3-reset-all-devices
$ curl -H "Authorization: Bearer <access_token_here>" -X DELETE -v "https://mgmt.auth.adobe.com/reset-tempass/v3/reset?requestor_id=REF30&mvpd_id=TempPass&device_id=all"
Ripristina API TempPass - DELETE /reset-tempass/v3/reset/generic reset-tempass-v3-reset-generic
Per reimpostare un TempPass specifico per una chiave generica (hash dell'identificatore fornito dall'utente) o per tutte le chiavi, l'autenticazione Adobe Pass fornisce ai programmatori un'API che funziona per il TempPass promozionale.
Richiesta reset-tempass-v3-reset-generic-request
Risposta reset-tempass-v3-reset-generic-response
Esempi reset-tempass-v3-reset-generic-samples
Reimposta TempPass per una chiave specifica reset-tempass-v3-reset-specific-key
$ curl -H "Authorization: Bearer <access_token_here>" -X DELETE -v "https://mgmt.auth.adobe.com/reset-tempass/v3/reset/generic?requestor_id=REF30&mvpd_id=TempPass&key=f7ee5ec7312165148b69fcca1d29075b14b8aef0b5048a332b18b88d09069fb7"
Reimposta TempPass per tutte le chiavi reset-tempass-v3-reset-all-keys
$ curl -H "Authorization: Bearer <access_token_here>" -X DELETE -v "https://mgmt.auth.adobe.com/reset-tempass/v3/reset/generic?requestor_id=REF30&mvpd_id=TempPass&key=all"
API REST V2 rest-api-v2
Per utilizzare la funzione TempPass è necessario implementare aggiornamenti del codice per modificare l'interazione dell'applicazione TV Everywhere (TVE) con l'autenticazione Adobe Pass REST API V2.
Per una guida completa su questi aggiornamenti e sui flussi di lavoro associati, consulta la documentazione Flussi di accesso temporanei.