Troca de metadados de usuário MVPD

NOTE
O conteúdo desta página é fornecido apenas para fins informativos. O uso desta API requer uma licença atual da Adobe. Não é permitida nenhuma utilização não autorizada.

Introdução intro-user-metadata-exchange

Os MVPDs mantêm metadados específicos do usuário sobre seus clientes que, em alguns casos, são compartilhados com Programadores. O objetivo da autenticação da Adobe Pass é intermediar uma troca desses "metadados do usuário", mas não impor nenhum tipo de regra relacionada à troca. As regras de troca são para os MVPDs para trabalhar com seus parceiros Programadores.

Os tipos de metadados de usuário disponíveis para o Exchange atualmente incluem o seguinte:

  • Código postal
  • Classificação máxima (VChip ou MPAA)
  • ID de usuário
  • ID da família
  • ID do canal

Usando esse recurso, os MVPDs e Programadores podem implementar casos de uso especiais, como o controle dos pais. Por exemplo, uma MVPD pode enviar dados de classificação dos pais para um Programador, que os usa para filtrar as opções de exibição disponíveis para um usuário.

Pontos principais dos metadados do usuário:

  • O MVPD transmite os metadados do usuário para o aplicativo do programador durante os fluxos de autenticação e autorização
  • A Autenticação Adobe Pass salva os valores de metadados nos tokens AuthN e AuthZ
  • A Autenticação do Adobe Pass pode normalizar valores para MVPDs que fornecem metadados do usuário em diferentes formatos
  • Alguns parâmetros podem ser criptografados usando a chave do programador
  • Valores específicos são disponibilizados pela Adobe, por meio de uma alteração de configuração
NOTE
Os metadados do usuário são uma extensão para os metadados estáticos (TTL do token de autenticação, TTL do token de autorização e ID do dispositivo) disponíveis anteriormente na autenticação do Adobe Pass.

Exemplos example-mvpd-user-metadata-exch

Controle dos Pais example-parental-control

Este exemplo mostra a troca do seguinte:

Programador para o MVPD Metadata Exchange progr-mvpd-metadata-exch

Atualmente, a API do programador, a Autenticação do Adobe Pass e os Autorizadores da MVPD são compatíveis apenas com a autorização no nível do canal. O canal é especificado como uma cadeia de texto sem formatação na chamada da API getAuthorization() do programador. Essa cadeia de caracteres é propagada todo o caminho para o back-end de autorização do MVPD:

No aplicativo ou site do Programador, o usuário escolhe um MVPD compatível com XACML (neste exemplo, "TNT"). Para obter informações sobre XACML, consulte eXtensible Access Control Markup Language.
O aplicativo do Programador forma uma solicitação AuthZ que inclui o recurso e seus metadados. Este exemplo inclui uma classificação MPAA de "pg" no atributo de mídia do elemento de canal:

var resource = '<rss version="2.0" xmlns:media="http://video.search.yahoo.com/mrss/">
                    <channel>
                        <title>TNT</title>
                        <media:rating scheme="urn:mpaa">pg</media:rating>
                    </channel>
                </rss>';
getAuthorization(resource);

A Autenticação do Adobe Pass realmente oferece suporte a autorizações mais granulares, até o nível do ativo, quando suportado pela MVPD e pelo Programador. O recurso e seus metadados são opacos para o Adobe; a intenção é estabelecer um formato padrão para especificar a ID do recurso e os metadados de forma normalizada, a fim de enviar IDs de recurso para MVPDs diferentes.

NOTE
Se o usuário escolher um MVPD compatível somente com canais, a Autenticação Adobe Pass extrairá SOMENTE o título do canal ("TNT" no exemplo acima) e transmitirá somente o título para o MVPD.

Fluxo de troca de metadados do MVPD para o programador mvpd-progr-exchange-flow

A Autenticação Adobe Pass assume as seguintes premissas:

  • O MVPD envia a classificação máxima como parte da resposta SAML
  • Essas informações são salvas como parte do token de autenticação
  • Uma API é fornecida pela autenticação da Adobe Pass para permitir que os programadores recuperem essas informações
  • Os programadores implementam esse recurso no site ou aplicativo (por exemplo, para ocultar vídeos acima da classificação máxima para o usuário)
<saml:Assertion ID="pfxec5f92e0-8589-3fc3-c708-f4fb8e2fad59"
                 IssueInstant="2010-07-20T10:05:41Z" Version="2.0"
                 xmlns:xs="http://www.w3.org/2001/XMLSchema"
                 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <saml:AttributeStatement>
        <saml:Attribute
                Name="MaxTVRating"
                NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic">
            <saml:AttributeValue xsi:type="xs:string">tv-ma</saml:AttributeValue>
        </saml:Attribute>
        <saml:Attribute
                Name="MaxMovieRating"
                NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic">
            <saml:AttributeValue xsi:type="xs:string">nc-17</saml:AttributeValue>
        </saml:Attribute>
    </saml:AttributeStatement>
</saml:Assertion>

Notas notes-mvpd-progr-metadata-exch-flow

Validação e Normalização de Recursos. As IDs de recursos podem ser passadas como uma cadeia de caracteres simples ou uma cadeia de caracteres MRSS. Um Programador pode decidir usar o formato de string simples ou o MRSS, mas precisará de um acordo prévio com o MVPD para que o MVPD saiba como tratar esse recurso.

Especificação de Metadados e ID de Recursos.A Autenticação do Adobe Pass usa o padrão RSS com a extensão RSS de Mídia para especificar um recurso e seus metadados. Juntamente com a extensão RSS de Mídia, a Autenticação da Adobe Pass oferece suporte a uma grande variedade de metadados, como controles dos pais (via <media:rating>) ou geolocalização (<media:location>).

A Autenticação do Adobe Pass também pode oferecer suporte à conversão transparente da cadeia de caracteres do canal herdado para o recurso RSS correspondente para MVPDs que exigem RSS. Na outra direção, a Autenticação do Adobe Pass oferece suporte à conversão de RSS+MRSS em título de canal simples, para MVPDs somente de canal.

A Autenticação do Adobe Pass garante total compatibilidade com versões anteriores de integrações existentes. Ou seja, para programadores que usam autenticação no nível do canal, a Autenticação da Adobe Pass cuida de disponibilizar a ID do canal no formato necessário antes de enviá-la para uma MVPD que entenda esse formato. O inverso também se aplica: se um Programador especificar todos os seus recursos em um novo formato, a Autenticação do Adobe Pass converterá o novo formato em uma string de canal simples se autorizar em uma MVPD que apenas faz autorização no nível do canal.

Casos de uso de metadados do usuário user-metadata-use-cases

Os casos de uso estão em constante mudança e expansão à medida que mais MVPDs fazem acordos legais e adicionam funcionalidade. Veja a seguir exemplos de para que os metadados do usuário podem ser usados.

ID de usuário do MVPD mvpd-user-id

  • Conforme fornecido pela MVPD
  • Não as informações de logon reais do usuário, pois são transformadas em hash pelo MVPD
  • Pode ser usado para indicar problemas com ou para usuários específicos
  • Criptografado
  • Suporte ao MVPD: todos os MVPDs

ID de Usuário Doméstico household-user-id

  • Permite informações de boa métrica
  • Criptografado
  • Suporte ao MVPD: alguns MVPDs

Código postal zip-code

  • O CEP de faturamento do usuário
  • Usado principalmente para aplicar regras de período de congelamento de evento esportivo
  • Pode ser fornecido com a resposta AuthZ para atualizações rápidas
  • Suporte ao MVPD: alguns MVPDs

Classificação máxima (controle dos pais) max-rating-parental-control

  • AuthN inicialmente, mais atualização AuthZ
  • Filtrar conteúdo por meio da interface
  • Classificações de MPAA ou VChip
  • Suporte ao MVPD: alguns MVPDs

Alinhamento de canais channel-line-up

  • Os MVPDs podem fornecer uma lista de canais que o usuário tem direito a visualizar
  • Permite uma pintura rápida da interface
  • A especificação OLCA permite isso como uma Instrução de Atributo na resposta AuthN
  • MVPDs compatíveis: alguns MVPDs
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b