Función TempPass temp-pass-feature
TempPass es una función versátil que permite a los programadores ofrecer acceso temporal a su contenido protegido para usuarios sin credenciales de cuenta de MVPD válidas. Sirve como una herramienta eficaz para atraer a los espectadores, ya sea a través de escenarios de acceso básicos o campañas promocionales dirigidas.
TempPass es una potente solución para que los programadores:
- Visualizadores atractivos: Ofrezca una muestra de contenido premium para atraer nuevos suscriptores.
- Promociones de unidad: Ejecute campañas dirigidas para aumentar la exposición al contenido y generar lealtad a la marca.
- Conservar el control: Administrar períodos de acceso, aplicar límites y restablecer el acceso según sea necesario para alinearlo con los objetivos de la empresa.
La función TempPass se entrega mediante la introducción de un pseudo-MVPD (denominado además "Temp Pass") dentro de la configuración del servidor de autenticación de Adobe Pass como una integración con el programador participante. La función TempPass está disponible en dos configuraciones:
- TempPass básico para acceso basado en el tiempo.
- Pase temporal promocional para obtener acceso flexible impulsado por campañas.
En la tabla siguiente se proporciona una breve comparación de las características Básicas y Promocionales de TempPass:
- Basado en el tiempo
- Basado en el tiempo
- Limitado a un número máximo de recursos
- ID de dispositivo
- ID de dispositivo
- Hash de la información de identificador de usuario proporcionada (por ejemplo, correo electrónico)
Tanto si desea dar un vistazo a su biblioteca de contenido como promocionar un evento marquesina, TempPass le ofrece las herramientas para ampliar su audiencia mientras mantiene el control sobre el acceso.
TempPass básico basic-temp-pass
La función básica TempPass permite a los programadores proporcionar acceso al contenido por tiempo limitado, teniendo en cuenta varios escenarios:
- Vistas previas cortas: Ofrezca vistas previas breves, como un período de acceso diario de 10 minutos, para atraer a posibles suscriptores.
- Acceso basado en eventos: Habilite el acceso de mayor duración para eventos principales, como una sesión de 4 horas.
- Acceso combinado: Mezcle duraciones y combine, como un período de visualización inicial extendido seguido de vistas previas diarias más cortas en varios días.
Determinados eventos pueden requerir un acceso gratuito por fases al contenido, como un período inicial de acceso gratuito ampliado (por ejemplo, 4 horas), seguido de intervalos diarios de acceso gratuito más cortos (por ejemplo, 10 minutos cada día). Para implementar este escenario, los programadores deben coordinarse con su representante de Adobe para configurar dos MVPD TempPass adaptadas a sus necesidades.
Por ejemplo, para proporcionar una sesión inicial gratuita de 4 horas seguida de sesiones gratuitas diarias de 10 minutos, el Adobe puede configurar para el programador:
- TempPass1: configurado con un tiempo de vida (TTL) de 4 horas para cubrir el período inicial de acceso libre.
- TempPass2: configurado con un tiempo de vida (TTL) de 10 minutos para los siguientes intervalos diarios de acceso libre.
Para garantizar la funcionalidad adecuada para el acceso diario, TempPass2 debe restablecerse para todos los dispositivos a las 00:00 horas cada día.
Detalles de funciones basic-temp-pass-feature-details
Parámetros de configuración:
- TTL (Tiempo de vida): Los programadores pueden especificar la duración del acceso. Este TTL basado en reloj caduca independientemente de la hora de visualización real.
Identificación de usuario:
La función básica TempPass utiliza el identificador del dispositivo como parámetro de identificación del usuario.
La siguiente tabla le ayuda a comprender cómo los parámetros de identificación del usuario influyen en la experiencia de prueba del usuario:
Ver cálculo de tiempo:
El TTL representa la duración desde el tiempo de la solicitud de autorización inicial hasta el tiempo de caducidad, independientemente del tiempo real empleado en ver contenido. Cada solicitud futura compara la hora actual del servidor con la hora de caducidad almacenada para autorizar el acceso.
Autenticación:
No se requiere autenticación para Basic TempPass, lo que le permite continuar directamente con el paso de autorización.
Autorización:
Como no hay interacción con un MVPD real, el MVPD básico "Temp Pass" autorizará cualquier recurso dado que el TempPass es válido. En caso de que la autorización se realice correctamente, la biblioteca del verificador de tokens de medios sigue siendo aplicable para verificar el token de medios y garantizar la validación de recursos antes de iniciar la reproducción del contenido.
La decisión de autorización se basa en los parámetros de identificación del usuario y el TTL configurado. Para obtener una autorización correcta para un recurso, una solicitud válida debe cumplir las siguientes condiciones:
- Duración sin consumir: La hora de caducidad se calcula agregando la hora de solicitud de autorización inicial (guardada en nuestras bases de datos) al TTL configurado. La hora actual del servidor se compara con esta hora de caducidad para determinar si TempPass sigue siendo válido.
Si un usuario supera el TTL configurado, ya no podrá ver el contenido en el mismo dispositivo a menos que se restablezca su TempPass.
Autorización previa:
Cuando se realiza una solicitud de preautorización para una MVPD "Temp Pass" básica, la respuesta devuelve la lista completa de recursos de la solicitud con la autorización previa correcta. Este comportamiento refleja la lógica de autorización, ya que las condiciones de autorización se basan en límites de tiempo y no en recursos específicos. Siempre que la restricción de tiempo sea válida, se autorizarán los recursos solicitados.
Cerrar sesión:
No se requiere el cierre de sesión para el TempPass básico, lo que le permite cambiar directamente al paso de autenticación mediante un MVPD de usuario real.
Datos de seguimiento y análisis:
Durante el flujo TempPass básico, los datos de seguimiento utilizan una versión con hash del identificador del dispositivo, con el identificador de MVPD establecido en "Temp Pass". Los programadores deben diferenciar las métricas de TempPass de las métricas estándar de MVPD en sus implementaciones de análisis.
TempPass promocional promotional-temp-pass
La función promocional TempPass amplía las capacidades del TempPass básico, diseñado específicamente para ejecutar campañas promocionales. Esta función permite a los programadores atraer usuarios permitiendo el acceso a un número predefinido de títulos de VOD durante un periodo de tiempo especificado después de recopilar una identificación de usuario válida, como una dirección de correo electrónico.
TempPass promocional incluye todas las funcionalidades del TempPass básico, con flexibilidad añadida para:
- Definición del número máximo de títulos de VOD accesibles durante el periodo promocional.
- Configuración del período de tiempo durante el cual el acceso promocional es válido.
Una vez que un usuario supera los límites de acceso predefinidos (número de títulos de VOD o duración), ya no podrá ver contenido en el mismo dispositivo o con el mismo identificador de usuario a menos que se restablezca su TempPass.
Detalles de funciones promotional-temp-pass-feature-details
Parámetros de configuración:
- Clave de información del usuario: La clave utilizada para comunicar el identificador proporcionado por el usuario, como una dirección de correo electrónico (por ejemplo, la clave es correo electrónico).
- Cantidad de recursos: Define cuántos títulos de VOD puede tener acceso un usuario.
- TTL (Tiempo de vida): Duración durante la cual el usuario puede consumir los recursos permitidos.
Identificación de usuario:
La función Promotional TempPass utiliza el hash del identificador proporcionado por el usuario sobre el identificador del dispositivo como parámetros de identificación del usuario.
El Adobe recomienda usar las funciones SHA-2 de la familia SHA-256, SHA-512 en los datos antes de enviarlos al Adobe. Por ejemplo, SHA-256 sobre "user@domain.com" es "f7ee5ec7312165148b69fcca1d29075b14b8aef0b5048a332b18b88d09069fb7".
La siguiente tabla le ayuda a comprender cómo los parámetros de identificación del usuario influyen en la experiencia de prueba del usuario:
Ver cálculo de tiempo:
El TTL representa la duración desde el tiempo de la solicitud de autorización inicial hasta el tiempo de caducidad, independientemente del tiempo real empleado en ver contenido. Cada solicitud futura compara la hora actual del servidor con la hora de caducidad almacenada para autorizar el acceso.
Autenticación:
No se requiere autenticación para Promotional TempPass, lo que le permite continuar directamente con el paso de autorización.
Para admitir la implementación de la aplicación del programador, Promotional TempPass expone la siguiente información de metadatos de usuario, accesible a través de las claves correspondientes:
remaining_resources: indica la cantidad de recursos que el usuario aún tiene derecho a consumir.used_assets: proporciona una lista de los recursos que el usuario ya ha consumido.expiration_date: muestra la fecha de caducidad del pase temporal promocional del usuario.
Autorización:
Como no hay interacción con un MVPD real, el MVPD Promocional "Temp Pass" autorizará cualquier recurso dado que el TempPass es válido. En caso de que la autorización se realice correctamente, la biblioteca del verificador de tokens de medios sigue siendo aplicable para verificar el token de medios y garantizar la validación de recursos antes de iniciar la reproducción del contenido.
La decisión de autorización se basa en los parámetros de identificación del usuario y en el número configurado de recursos y el TTL. Para obtener una autorización correcta para un recurso, una solicitud válida debe cumplir las siguientes condiciones:
- Duración sin consumir: La hora de caducidad se calcula agregando la hora de solicitud de autorización inicial (guardada en nuestras bases de datos) al TTL configurado. La hora actual del servidor se compara con esta hora de caducidad para determinar si TempPass sigue siendo válido.
- Recursos no consumidos: Se realiza un seguimiento del número de recursos consumidos (guardados en nuestras bases de datos). El número de recursos consumidos se compara con el número configurado de recursos para determinar si TempPass sigue siendo válido.
Si un usuario supera el TTL configurado o el número de recursos, ya no podrá ver el contenido en el mismo dispositivo o con el mismo identificador proporcionado por el usuario a menos que se restablezca su TempPass.
Autorización previa:
Cuando se realiza una solicitud de preautorización para una MVPD promocional "Temp Pass", la respuesta devuelve la lista completa de recursos de la solicitud como autorizados previamente con éxito. Este comportamiento refleja la lógica de autorización, dado que las condiciones de autorización se basan en límites de tiempo y en el número total de recursos a los que se accede, en lugar de en recursos específicos. Siempre que la restricción de tiempo sea válida y no se haya superado el límite de recursos, se autorizarán los recursos solicitados.
Cerrar sesión:
No es necesario cerrar la sesión de Promotional TempPass, lo que le permite cambiar directamente al paso de autenticación con un MVPD de usuario real.
Datos de seguimiento y análisis:
Durante el flujo promocional de TempPass, los datos de seguimiento utilizan una versión con hash del identificador del dispositivo, con el identificador de MVPD establecido en "Temp Pass". Los programadores deben diferenciar las métricas de TempPass de las métricas estándar de MVPD en sus implementaciones de análisis.
Restablecer acceso a la API TempPass reset-tempass-api-access
Antes de acceder a la API Reset TempPass, debe completar los pasos necesarios en el proceso de registro de cliente dinámico (DCR). Este proceso obligatorio garantiza que tenga el token de acceso necesario para interactuar con la API Reset TempPass.
Para obtener instrucciones detalladas, consulte la Documentación general sobre el registro de clientes dinámicos.
Restablecer API de TempPass: DELETE /reset-tempass/v3/reset reset-tempass-v3-reset
Para restablecer un TempPass específico para un dispositivo o todos los dispositivos, la autenticación de Adobe Pass proporciona a los programadores una API que funciona tanto para el TempPass básico como para el promocional.
Solicitud reset-tempass-v3-reset-request
Respuesta reset-tempass-v3-reset-response
Muestras reset-tempass-v3-reset-samples
Restablecer TempPass para un dispositivo específico 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"
Restablecer TempPass para todos los dispositivos 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"
Restablecer API de TempPass: DELETE /reset-tempass/v3/reset/generic reset-tempass-v3-reset-generic
Para restablecer una TempPass específica para una clave genérica (hash de identificador proporcionado por el usuario) o todas las claves, la autenticación de Adobe Pass proporciona a los programadores una API que funciona para la TempPass promocional.
Solicitud reset-tempass-v3-reset-generic-request
Respuesta reset-tempass-v3-reset-generic-response
Muestras reset-tempass-v3-reset-generic-samples
Restablecer TempPass para una clave específica 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"
Restablecer TempPass para todas las claves 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 DE REST V2 rest-api-v2
El uso de la función TempPass requiere implementar actualizaciones de código para modificar la forma en que la aplicación TV Everywhere (TVE) interactúa con la autenticación de Adobe Pass API REST V2.
Para obtener una guía completa sobre estas actualizaciones y los flujos de trabajo asociados, consulte la documentación de Flujos de acceso temporales.