Recurso TempPass temp-pass-feature
O TempPass é um recurso versátil que permite que programadores ofereçam acesso temporário a seu conteúdo protegido para usuários sem credenciais de conta válidas do MVPD. Ele serve como uma ferramenta eficaz para envolver os visualizadores, seja por meio de cenários de acesso básicos ou campanhas promocionais direcionadas.
O TempPass é uma solução avançada para os programadores:
- Envolva os visualizadores: Experimente um conteúdo premium para atrair novos assinantes.
- Impulsione promoções: execute campanhas direcionadas para aumentar a exposição do conteúdo e criar fidelidade à marca.
- Manter Controle: gerencie períodos de acesso, imponha limites e redefina o acesso conforme necessário para alinhar-se às metas comerciais.
O recurso TempPass é fornecido introduzindo um pseudo-MVPD (chamado de "Temp Pass") na configuração do servidor de Autenticação da Adobe Pass como uma integração com o Programador participante. O recurso TempPass está disponível em duas configurações:
- Basic TempPass para acesso baseado em tempo.
- TempPass promocional para acesso flexível orientado por campanha.
A tabela a seguir fornece uma breve comparação dos recursos Básico e Promocional do TempPass:
- Baseado em tempo
- Baseado em tempo
- Limitado a um número máximo de recursos
- ID do dispositivo
- ID do dispositivo
- Hash de informações do identificador de usuário fornecido (por exemplo, email)
Esteja você fornecendo uma prévia da sua biblioteca de conteúdo ou promovendo um evento de letreiro, o TempPass oferece as ferramentas para expandir seu público enquanto mantém o controle sobre o acesso.
TempPass básico basic-temp-pass
O recurso básico TempPass permite que programadores forneçam acesso limitado no tempo ao conteúdo, atendendo a vários cenários:
- Visualizações curtas: ofereça visualizações breves, como um período de acesso diário de 10 minutos, para atrair assinantes em potencial.
- Acesso Baseado em Eventos: Habilite o acesso mais longo para eventos importantes, como uma sessão de 4 horas.
- Acesso de Combinação: durações de mixagem e correspondência, como um período de exibição estendido inicial seguido de visualizações diárias mais curtas durante vários dias.
Certos eventos podem exigir acesso livre em fases ao conteúdo, como um período inicial de acesso livre estendido (por exemplo, 4 horas), seguido por intervalos diários de acesso livre mais curtos (por exemplo, 10 minutos por dia). Para implementar esse cenário, os Programadores devem coordenar com seu representante de Adobe para configurar dois MVPDs TempPass personalizados para suas necessidades.
Por exemplo, para fornecer uma sessão gratuita inicial de 4 horas seguida de sessões gratuitas diárias de 10 minutos, o Adobe pode configurar para o Programador:
- TempPass1: configurado com um TTL (Time-To-Live) de 4 horas para cobrir o período inicial de acesso livre.
- TempPass2: configurado com um TTL (Time-To-Live) de 10 minutos para os intervalos de acesso gratuito diário subsequentes.
Para garantir a funcionalidade adequada para o acesso diário, o TempPass2 deve ser redefinido para todos os dispositivos às 00:00 horas todos os dias.
Detalhes do recurso basic-temp-pass-feature-details
Parâmetros de configuração:
- TTL (Tempo de Vida Útil): Programadores podem especificar a duração do acesso. Esse TTL baseado em relógio expira independentemente do tempo de exibição real.
Identificação de usuário:
O recurso básico TempPass usa o identificador do dispositivo como um parâmetro de identificação do usuário.
A tabela a seguir ajuda você a entender como os parâmetros de identificação de usuário influenciam a experiência de avaliação do usuário:
Exibir cálculo de tempo:
O TTL representa a duração do tempo de solicitação de autorização inicial até o tempo de expiração, independentemente do tempo real gasto na exibição do conteúdo. Cada solicitação futura verifica a hora atual do servidor em relação à hora de expiração armazenada para autorizar o acesso.
Autenticação:
A autenticação não é necessária para o Basic TempPass, permitindo que você prossiga diretamente para a etapa de autorização.
Autorização:
Como não há interação com uma MVPD real, o MVPD básico "Aprovação temporária" autorizará qualquer recurso, pois a Aprovação temporária é válida. No caso de uma autorização bem-sucedida, a biblioteca Verificador de token de mídia permanece aplicável para verificar o token de mídia e garantir a validação de recursos antes de iniciar a reprodução do conteúdo.
A decisão de autorização é baseada nos parâmetros de identificação do usuário e no TTL configurado. Para obter uma autorização bem-sucedida para um recurso, as seguintes condições devem ser atendidas por uma solicitação válida:
- Duração não consumida: a hora de expiração é calculada adicionando-se a hora de solicitação de autorização inicial (salva em nossos bancos de dados) ao TTL configurado. A hora atual do servidor é comparada com essa hora de expiração para determinar se o TempPass ainda é válido.
No caso de um usuário exceder o TTL configurado, não será mais possível visualizar o conteúdo no mesmo dispositivo, a menos que o TempPass seja redefinido.
Pré-autorização:
Quando uma solicitação de pré-autorização é feita para um MVPD básico "Aprovação temporária", a resposta retornará toda a lista de recursos da solicitação como pré-autorizados com sucesso. Esse comportamento reflete a lógica de autorização, já que as condições de autorização se baseiam em limites de tempo, em vez de recursos específicos. Enquanto a restrição de tempo for válida, os recursos solicitados serão autorizados.
Logout:
O logout não é necessário para o Basic TempPass, permitindo alternar diretamente para a etapa de autenticação usando um MVPD de usuário real.
Dados e análises de rastreamento:
Durante o fluxo TempPass básico, os dados de rastreamento usam uma versão com hash do identificador do dispositivo, com o identificador do MVPD definido como "Temp Pass". Os programadores devem diferenciar as métricas TempPass das métricas padrão do MVPD em suas implementações de análise.
TempPass Promocional promotional-temp-pass
O recurso TempPass promocional expande os recursos do TempPass básico, projetado especificamente para executar campanhas promocionais. Esse recurso permite que os programadores envolvam os usuários, permitindo o acesso a um número predefinido de títulos do VOD por um período específico após coletar a identificação válida do usuário, como um endereço de email.
O TempPass Promocional inclui toda a funcionalidade do TempPass básico, com flexibilidade adicional para:
- Definição do número máximo de títulos do VOD acessíveis durante o período promocional.
- Definindo o período durante o qual o acesso promocional é válido.
Depois que um usuário excede os limites de acesso predefinidos (número de títulos ou duração do VOD), ele não poderá mais visualizar o conteúdo no mesmo dispositivo ou com o mesmo identificador de usuário, a menos que o TempPass seja redefinido.
Detalhes do recurso promotional-temp-pass-feature-details
Parâmetros de configuração:
- Chave de Informações do Usuário: a chave usada para comunicar o identificador fornecido pelo usuário, como um endereço de email (ou seja, a chave é o email).
- Número de Recursos: Define quantos títulos do VOD um usuário pode acessar.
- TTL (Tempo de Vida Útil): A duração durante a qual o usuário pode consumir os recursos permitidos.
Identificação de usuário:
O recurso TempPass promocional usa o hash do identificador fornecido pelo usuário na parte superior do identificador do dispositivo como parâmetros de identificação do usuário.
O Adobe recomenda usar a família SHA-2 ou suas funções SHA-256 e SHA-512 específicas nos dados antes de enviá-los para o Adobe. Por exemplo, SHA-256 sobre "user@domain.com" é "f7ee5ec7312165148b69fcca1d29075b14b8aef0b5048a332b88b88d09069fb7".
A tabela a seguir ajuda você a entender como os parâmetros de identificação de usuário influenciam a experiência de avaliação do usuário:
Exibir cálculo de tempo:
O TTL representa a duração do tempo de solicitação de autorização inicial até o tempo de expiração, independentemente do tempo real gasto na exibição do conteúdo. Cada solicitação futura verifica a hora atual do servidor em relação à hora de expiração armazenada para autorizar o acesso.
Autenticação:
A autenticação não é necessária para o TempPass Promocional, permitindo que você prossiga diretamente para a etapa de autorização.
Para apoiar a implementação do aplicativo do Programador, o TempPass Promocional expõe as seguintes informações de metadados do usuário, acessíveis através das chaves correspondentes:
remaining_resources: indica o número de recursos que o usuário ainda está autorizado a consumir.used_assets: fornece uma lista de recursos que o usuário já consumiu.expiration_date: exibe a data de expiração do passe temporário promocional do usuário.
Autorização:
Como não há interação com uma MVPD real, o MVPD "Temp Pass" promocional autorizará qualquer recurso, pois o TempPass é válido. No caso de uma autorização bem-sucedida, a biblioteca Verificador de token de mídia permanece aplicável para verificar o token de mídia e garantir a validação de recursos antes de iniciar a reprodução do conteúdo.
A decisão de autorização baseia-se nos parâmetros de identificação do usuário e no número configurado de recursos e TTL. Para obter uma autorização bem-sucedida para um recurso, as seguintes condições devem ser atendidas por uma solicitação válida:
- Duração não consumida: a hora de expiração é calculada adicionando-se a hora de solicitação de autorização inicial (salva em nossos bancos de dados) ao TTL configurado. A hora atual do servidor é comparada com essa hora de expiração para determinar se o TempPass ainda é válido.
- Recursos não consumidos: o número de recursos consumidos é rastreado (salvo em nossos bancos de dados). O número de recursos consumidos é comparado ao número configurado de recursos para determinar se o TempPass ainda é válido.
No caso de um usuário que exceda o TTL ou o número de recursos configurados, ele não poderá mais visualizar o conteúdo no mesmo dispositivo ou com o mesmo identificador fornecido pelo usuário, a menos que o TempPass seja redefinido.
Pré-autorização:
Quando uma solicitação de pré-autorização é feita para um MVPD Promocional "Aprovação temporária", a resposta retornará toda a lista de recursos da solicitação como pré-autorizados com êxito. Esse comportamento reflete a lógica de autorização, considerando que as condições de autorização se baseiam em limites de tempo e no número total de recursos acessados, em vez de recursos específicos. Enquanto a restrição de tempo for válida e o limite de recursos não for excedido, os recursos solicitados serão autorizados.
Logout:
O logout não é necessário para o TempPass promocional, permitindo alternar diretamente para a etapa de autenticação usando um MVPD de usuário real.
Dados e análises de rastreamento:
Durante o fluxo promocional do TempPass, os dados de rastreamento usam uma versão com hash do identificador do dispositivo, com o identificador do MVPD definido como "Temp Pass". Os programadores devem diferenciar as métricas TempPass das métricas padrão do MVPD em suas implementações de análise.
Redefinir o acesso à API TempPass reset-tempass-api-access
Antes de acessar a API Reset TempPass, você deve concluir as etapas necessárias no processo de Registro de Cliente Dinâmico (DCR). Esse processo obrigatório garante que você tenha o token de acesso necessário para interagir com a API Reset TempPass.
Para obter instruções abrangentes, consulte a documentação Visão geral do registro dinâmico do cliente.
Redefinir API TempPass - DELETE /reset-tempass/v3/reset reset-tempass-v3-reset
Para redefinir um TempPass específico para um dispositivo ou para todos os dispositivos, a Autenticação Adobe Pass fornece aos programadores uma API que funciona para o TempPass básico e promocional.
Solicitação reset-tempass-v3-reset-request
Resposta reset-tempass-v3-reset-response
Amostras reset-tempass-v3-reset-samples
Redefinir TempPass para um 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"
Redefinir TempPass para todos os 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"
Redefinir API TempPass - DELETE /reset-tempass/v3/reset/generic reset-tempass-v3-reset-generic
Para redefinir um TempPass específico para uma chave genérica (hash de identificador fornecido pelo usuário) ou todas as chaves, a Autenticação Adobe Pass fornece aos Programadores uma API que funciona para o TempPass Promocional.
Solicitação reset-tempass-v3-reset-generic-request
Resposta reset-tempass-v3-reset-generic-response
Amostras reset-tempass-v3-reset-generic-samples
Redefinir TempPass para uma chave 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"
Redefinir TempPass para todas as chaves 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
Para aproveitar o recurso TempPass, é necessário implementar atualizações de código para modificar a forma como o aplicativo TVE (TV Everywhere) interage com a REST API V2 da Adobe Pass Authentication.
Para obter um guia abrangente sobre essas atualizações e os fluxos de trabalho associados, consulte a documentação dos Fluxos de Acesso Temporário.