TempPass-Funktion temp-pass-feature
TempPass ist eine vielseitige Funktion, die es Programmierern ermöglicht, Benutzern ohne gültige MVPD-Kontoanmeldeinformationen temporären Zugriff auf ihre geschützten Inhalte anzubieten. Es dient als wirksames Instrument zur Interaktion mit Zuschauern, sei es über einfache Zugriffsszenarien oder zielgerichtete Werbekampagnen.
TempPass ist eine leistungsstarke Lösung für Programmierer, um:
- Interagieren Sie Zuschauer Bieten Sie einen Vorgeschmack auf Premium-Inhalte, um neue AbonnentInnen zu gewinnen.
- Werbeaktionen fördern Führen Sie zielgerichtete Kampagnen durch, um die Offenlegung von Inhalten zu erhöhen und die Markentreue aufzubauen.
- Kontrolle behalten: Verwalten Sie Zugriffszeiträume, setzen Sie Einschränkungen durch und setzen Sie den Zugriff nach Bedarf zurück, um ihn an Ihre Geschäftsziele anzupassen.
Die TempPass-Funktion wird bereitgestellt, indem eine Pseudo-MVPD (weiter „Temp Pass“ genannt) in die Adobe Pass-Authentifizierungs-Server-Konfiguration als Integration mit dem teilnehmenden Programmierer eingeführt wird. Die TempPass-Funktion ist in zwei Konfigurationen verfügbar:
- Basic TempPass für zeitbasierten Zugriff.
- Werbe-TempPass für flexiblen kampagnengesteuerten Zugriff.
Die folgende Tabelle bietet einen kurzen Vergleich der Funktionen von Basic und Promotional TempPass:
- Zeitbasiert
- Zeitbasiert
- Auf eine maximale Anzahl von Ressourcen beschränkt
- Geräte-ID
- Geräte-ID
- Hash der angegebenen Benutzerkennung-Informationen (z. B. E-Mail)
Unabhängig davon, ob Sie eine Vorschau Ihrer Inhaltsbibliothek anzeigen oder ein Marquee-Ereignis bewerben, stellt TempPass Ihnen die Tools zur Verfügung, mit denen Sie Ihre Zielgruppe erweitern und gleichzeitig die Zugriffskontrolle behalten.
Einfache TempPass basic-temp-pass
Die grundlegende TempPass-Funktion ermöglicht es Programmierern, zeitlich begrenzten Zugriff auf Inhalte bereitzustellen, wobei verschiedene Szenarien berücksichtigt werden:
- Kurze Vorschauen: Bieten Sie kurze Vorschauen an, z. B. einen täglichen 10-minütigen Zugriffszeitraum, um potenzielle Abonnenten zu gewinnen.
- Ereignisbasierter Zugriff: Aktivieren Sie den längeren Zugriff für große Ereignisse, z. B. eine 4-stündige Sitzung.
- Kombinationszugriff Dauer kombinieren und abgleichen, z. B. einen anfangs verlängerten Anzeigezeitraum und dann kürzere tägliche Vorschauen über mehrere Tage.
Bestimmte Ereignisse erfordern möglicherweise einen stufenweisen freien Zugang zu Inhalten, z. B. eine zunächst verlängerte kostenlose Zugangsdauer (z. B. 4 Stunden), gefolgt von kürzeren täglichen kostenlosen Zugangsintervallen (z. B. 10 Minuten pro Tag). Um dieses Szenario zu implementieren, müssen sich Programmierer mit ihrem Adobe-Repräsentanten abstimmen, um zwei TempPass-MVPDs zu konfigurieren, die auf ihre Bedürfnisse zugeschnitten sind.
Um beispielsweise eine erste kostenlose 4-stündige Sitzung und anschließend täglich 10-minütige kostenlose Sitzungen anzubieten, kann Adobe für den Programmierer Folgendes konfigurieren:
- TempPass1: Wird mit einer TTL (Time-to-Live) von 4 Stunden konfiguriert, um den anfänglichen Zeitraum für den freien Zugriff abzudecken.
- TempPass2: Konfiguriert mit einer Time-to-Live (TTL) von 10 Minuten für die nachfolgenden täglichen freien Zugriffsintervalle.
Um eine ordnungsgemäße Funktionalität für den täglichen Zugriff sicherzustellen, muss TempPass2 für alle Geräte jeden Tag um 00:00 Uhr zurückgesetzt werden.
Funktionsdetails basic-temp-pass-feature-details
Konfigurationsparameter:
- TTL (Time-To-Live): können die Dauer des Zugriffs festlegen. Diese zeitbasierte TTL läuft unabhängig von der tatsächlichen Anzeigezeit ab.
Benutzeridentifizierung:
Die einfache TempPass-Funktion verwendet die Gerätekennung als Benutzeridentifizierungsparameter.
Die folgende Tabelle zeigt, wie Benutzeridentifizierungsparameter das Testerlebnis für Benutzende beeinflussen:
Zeitberechnung anzeigen:
Die TTL stellt die Dauer von der ersten Autorisierungsanforderungszeit bis zur Ablaufzeit dar, unabhängig von der tatsächlichen Zeit, die mit der Anzeige von Inhalten verbracht wurde. Bei jeder zukünftigen Anfrage wird die aktuelle Serverzeit mit der gespeicherten Ablaufzeit verglichen, um den Zugriff zu autorisieren.
Authentifizierung:
Für Basic TempPass ist keine Authentifizierung erforderlich, sodass Sie direkt mit dem Autorisierungsschritt fortfahren können.
Autorisierung:
Da keine Interaktion mit einem tatsächlichen MVPD stattfindet, autorisiert der einfache „Temp Pass“-MVPD jede Ressource, sofern der TempPass gültig ist. Im Falle einer erfolgreichen Autorisierung bleibt die Media Token Verifier-Bibliothek anwendbar, um das Medien-Token zu überprüfen und eine Ressourcenvalidierung sicherzustellen, bevor die Inhaltswiedergabe gestartet wird.
Die Autorisierungsentscheidung basiert auf den Benutzeridentifizierungsparametern und der konfigurierten TTL. Um eine erfolgreiche Autorisierung für eine Ressource zu erhalten, müssen die folgenden Bedingungen von einer gültigen Anfrage erfüllt werden:
- Nicht genutzte Dauer: Die Ablaufzeit wird berechnet, indem die (in unseren Datenbanken gespeicherte) anfängliche Autorisierungsanforderungszeit zur konfigurierten TTL hinzugefügt wird. Die aktuelle Serverzeit wird mit dieser Ablaufzeit verglichen, um zu ermitteln, ob der TempPass noch gültig ist.
Wenn ein Benutzer die konfigurierte TTL überschreitet, kann er Inhalte nicht mehr auf demselben Gerät anzeigen, es sei denn, sein TempPass wird zurückgesetzt.
Vorautorisierung:
Wenn eine Vorautorisierungsanfrage für eine einfache „Temp Pass“-MVPD gestellt wird, gibt die Antwort die gesamte Liste der Ressourcen aus der Anfrage als erfolgreich vorautorisiert zurück. Dieses Verhalten spiegelt die Autorisierungslogik wider, da die Autorisierungsbedingungen auf Zeitlimits und nicht auf bestimmten Ressourcen basieren. Solange die Zeitbeschränkung gültig ist, werden die angeforderten Ressourcen autorisiert.
Abmelden:
Eine Abmeldung ist für Basic TempPass nicht erforderlich, sodass Sie direkt zum Authentifizierungsschritt wechseln können, indem Sie eine tatsächliche MVPD des Benutzers verwenden.
Tracking von Daten und Analysen:
Während des einfachen TempPass-Flusses verwenden Tracking-Daten eine Hash-Version der Geräte-ID, wobei die MVPD-ID auf „Temp Pass“ gesetzt ist. Programmierer sollten in ihren Analytics-Implementierungen zwischen TempPass-Metriken und standardmäßigen MVPD-Metriken unterscheiden.
Werbe-TempPass promotional-temp-pass
Die Werbe-TempPass-Funktion erweitert die Funktionen des einfachen TempPass, der speziell für die Ausführung von Werbekampagnen entwickelt wurde. Mit dieser Funktion können Programmierer Benutzerinnen und Benutzer ansprechen, indem sie den Zugriff auf eine vordefinierte Anzahl von VOD-Titeln für einen bestimmten Zeitraum nach dem Erfassen einer gültigen Benutzeridentifizierung, z. B. einer E-Mail-Adresse, ermöglichen.
Der Werbe-TempPass enthält alle Funktionen des grundlegenden TempPass, mit zusätzlicher Flexibilität für:
- Maximale Anzahl von VOD-Titeln definieren, auf die während des Aktionszeitraums zugegriffen werden kann.
- Festlegen des Zeitraums, in dem der Zugriff auf die Werbeaktion gültig ist.
Sobald ein Benutzer die vordefinierten Zugriffsbeschränkungen (Anzahl der VOD-Titel oder Dauer) überschreitet, kann er keine Inhalte mehr auf demselben Gerät oder mit derselben Benutzerkennung anzeigen, es sei denn, sein TempPass wird zurückgesetzt.
Funktionsdetails promotional-temp-pass-feature-details
Konfigurationsparameter:
- Benutzerinformationsschlüssel: Der Schlüssel, der verwendet wird, um die vom Benutzer bereitgestellte Kennung zu übermitteln, z. B. eine E-Mail-Adresse (d. h., der Schlüssel ist E-Mail).
- Anzahl der Ressourcen: Definiert, auf wie viele VOD-Titel eine Benutzerin oder ein Benutzer zugreifen kann.
- TTL (Time-To-Live): Die Dauer, während der Benutzende die zulässigen Ressourcen nutzen können.
Benutzeridentifizierung:
Die Funktion „Promotion TempPass“ verwendet den Hash der von Benutzenden bereitgestellten Kennung zusätzlich zur Gerätekennung als Benutzeridentifizierungsparameter.
Adobe empfiehlt die Verwendung der SHA-2-Familie oder ihrer spezifischen SHA-, SHA-512-Funktionen für Daten, bevor diese an Adobe gesendet werden. Zum Beispiel ist SHA-256 über "user@domain.com" „f7ee5ec7312165148b69fcca1d29075b14b8aef0b5048a332b18b88d09069fb7“.
Die folgende Tabelle zeigt, wie Benutzeridentifizierungsparameter das Testerlebnis für Benutzende beeinflussen:
Zeitberechnung anzeigen:
Die TTL stellt die Dauer von der ersten Autorisierungsanforderungszeit bis zur Ablaufzeit dar, unabhängig von der tatsächlichen Zeit, die mit der Anzeige von Inhalten verbracht wurde. Bei jeder zukünftigen Anfrage wird die aktuelle Serverzeit mit der gespeicherten Ablaufzeit verglichen, um den Zugriff zu autorisieren.
Authentifizierung:
Für den Werbe-TempPass ist keine Authentifizierung erforderlich, sodass Sie direkt mit dem Autorisierungsschritt fortfahren können.
Um die Implementierung der Programmieranwendung zu unterstützen, stellt der Promotion-TempPass die folgenden Benutzermetadaten-Informationen bereit, auf die über entsprechende Schlüssel zugegriffen werden kann:
remaining_resources: Gibt die Anzahl der Ressourcen an, die der Benutzer noch nutzen darf.used_assets: Stellt eine Liste der Ressourcen bereit, die der Benutzer bereits verbraucht hat.expiration_date: Zeigt das Ablaufdatum der vorübergehenden Prüfung für Werbeangebote durch den Benutzer an.
Autorisierung:
Da keine Interaktion mit einer tatsächlichen MVPD stattfindet, autorisiert die Promotion-MVPD „Temp Pass“ jede Ressource, sofern der TempPass gültig ist. Im Falle einer erfolgreichen Autorisierung bleibt die Media Token Verifier-Bibliothek anwendbar, um das Medien-Token zu überprüfen und eine Ressourcenvalidierung sicherzustellen, bevor die Inhaltswiedergabe gestartet wird.
Die Autorisierungsentscheidung basiert auf Benutzeridentifizierungsparametern sowie der konfigurierten Anzahl von Ressourcen und TTL. Um eine erfolgreiche Autorisierung für eine Ressource zu erhalten, müssen die folgenden Bedingungen von einer gültigen Anfrage erfüllt werden:
- Nicht genutzte Dauer: Die Ablaufzeit wird berechnet, indem die (in unseren Datenbanken gespeicherte) anfängliche Autorisierungsanforderungszeit zur konfigurierten TTL hinzugefügt wird. Die aktuelle Serverzeit wird mit dieser Ablaufzeit verglichen, um zu ermitteln, ob der TempPass noch gültig ist.
- Nicht genutzte Ressourcen: Die Anzahl der verbrauchten Ressourcen wird verfolgt (in unseren Datenbanken gespeichert). Die Anzahl der verbrauchten Ressourcen wird mit der konfigurierten Anzahl der Ressourcen verglichen, um zu ermitteln, ob der TempPass noch gültig ist.
Wenn ein Benutzer die konfigurierte TTL oder die Anzahl der Ressourcen überschreitet, kann er Inhalte nicht mehr auf demselben Gerät oder mit derselben vom Benutzer bereitgestellten Kennung anzeigen, es sei denn, sein TempPass wird zurückgesetzt.
Vorautorisierung:
Wenn eine Vorautorisierungsanfrage für eine MVPD mit „temporärem Pass“ für Werbeaktionen gestellt wird, gibt die Antwort die gesamte Liste der Ressourcen aus der Anfrage als erfolgreich vorautorisiert zurück. Dieses Verhalten spiegelt die Autorisierungslogik wider, da die Autorisierungsbedingungen auf Zeitlimits und der Gesamtzahl der aufgerufenen Ressourcen und nicht auf bestimmten Ressourcen basieren. Solange die Zeitbeschränkung gültig ist und das Ressourcenlimit nicht überschritten wurde, werden die angeforderten Ressourcen autorisiert.
Abmelden:
Eine Abmeldung ist für den Werbe-TempPass nicht erforderlich, sodass Sie direkt zum Authentifizierungsschritt wechseln können, indem Sie eine tatsächliche MVPD-Benutzerin bzw. einen tatsächlichen Benutzer verwenden.
Tracking von Daten und Analysen:
Während des temporären Flusses zu Werbezwecken verwenden Tracking-Daten eine Hash-Version der Geräte-ID, wobei die MVPD-ID auf „Temp Pass“ (Temporärer Pass) gesetzt ist. Programmierer sollten in ihren Analytics-Implementierungen zwischen TempPass-Metriken und standardmäßigen MVPD-Metriken unterscheiden.
TempPass-API-Zugriff zurücksetzen reset-tempass-api-access
Bevor Sie auf die API zum Zurücksetzen von TempPass zugreifen können, müssen Sie die erforderlichen Schritte im Prozess zur dynamischen Client-Registrierung (DCR) ausführen. Dieser obligatorische Prozess stellt sicher, dass Sie über das erforderliche Zugriffstoken für die Interaktion mit der Reset TempPass-API verfügen.
Umfassende Anweisungen finden Sie in der Dokumentation Übersicht über die Dynamic Client-Registrierung.
TempPass-API zurücksetzen - DELETE /reset-tempass/v3/reset reset-tempass-v3-reset
Um einen bestimmten TempPass für ein Gerät oder alle Geräte zurückzusetzen, stellt die Adobe Pass-Authentifizierung Programmierern eine API bereit, die sowohl für Standard- als auch für Werbe-TempPass funktioniert.
Anfrage reset-tempass-v3-reset-request
Antwort reset-tempass-v3-reset-response
Beispiele reset-tempass-v3-reset-samples
TempPass für ein bestimmtes Gerät zurücksetzen 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"
TempPass für alle Geräte zurücksetzen 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"
TempPass-API zurücksetzen - DELETE /reset-tempass/v3/reset/generic reset-tempass-v3-reset-generic
Um einen bestimmten TempPass für einen generischen Schlüssel (vom Benutzer bereitgestellter Kennungs-Hash) oder alle Schlüssel zurückzusetzen, stellt die Adobe Pass-Authentifizierung Programmierern eine API bereit, die für den Werbe-TempPass funktioniert.
Anfrage reset-tempass-v3-reset-generic-request
Antwort reset-tempass-v3-reset-generic-response
Beispiele reset-tempass-v3-reset-generic-samples
TempPass für einen bestimmten Schlüssel zurücksetzen 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"
TempPass für alle Schlüssel zurücksetzen 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"
REST-API V2 rest-api-v2
Für die Nutzung der TempPass-Funktion ist die Implementierung von Code-Aktualisierungen erforderlich, um die Interaktion der TV Everywhere-Anwendung (TVE) mit der Adobe Pass-Authentifizierung (-API V2)ändern.
Eine umfassende Anleitung zu diesen Aktualisierungen und den zugehörigen Workflows finden Sie in der Dokumentation Temporäre".