Show Menu
TOPICS×

Configurar Chromecast

Perguntas frequentes

Devo usar o SDK de JavaScript do Chromecast ou posso usar o SDK do JavaScript padrão?
A resposta correta é "Chromecast", pelos seguintes motivos:
  • As bibliotecas AppMeasurement e VisitorAPI no SDK JS padrão não estão certificadas para funcionar em plataformas OTT. No SDK JS do Chromecast, a Biblioteca de vídeo Heartbeats (VHL), o Analytics e a VisitorAPI são integrados ao SDK único, unificado e certificado para Chromecast.
  • O SDK do Chromecast é muito mais leve que o SDK JS padrão. Isso é muito importante para o hardware de ponta usado pelas plataformas OTT.

Pré-requisitos

  • Obter parâmetros de configuração válidos para Heartbeats
    Esses parâmetros podem ser obtidos de um representante da Adobe após a configuração da sua conta do Media Analytics.
  • Forneça os seguintes recursos no player de mídia:
    • Uma API para assinar eventos do player
      - O SDK de mídia exige que você chame um conjunto de APIs simples quando eventos ocorrem no player.
    • Uma API que fornece informações sobre o player
      - Essas informações incluem detalhes como o nome da mídia e a posição do indicador de reprodução.
O Adobe Mobile Services fornece uma nova interface do usuário que reúne recursos de marketing móvel para aplicativos móveis de toda a Adobe Experience Cloud. Inicialmente, o Mobile Service fornece integração perfeita entre os recursos de análise e segmentação de aplicativos para as soluções do Adobe Analytics e do Adobe Target. Saiba mais pela documentação do Adobe Mobile Services.
O SDK do Chromecast 2.x para soluções da Experience Cloud permite avaliar aplicativos Chromecast criados com JavaScript, dimensionar e coletar dados de público-alvo por meio do gerenciamento de público-alvo e medir o envolvimento com o vídeo pelos heartbeats de vídeo.

Implementação do SDK

  1. Adicione a biblioteca baixada do Chromecast ao projeto.
    1. O arquivo
      AdobeMobileLibrary-Chromecast-[version]
      zip consiste nos seguintes componentes de software:
      • adbmobile-chromecast.min.js
        :
        Esse arquivo de biblioteca será incluído na pasta de origem do aplicativo Chromecast.
      • Configuração
        ADBMobileConfig
        Esse arquivo de configuração do SDK foi personalizado para o aplicativo. Um exemplo de implementação de
        ADBMobileConfig
        é fornecido com o SDK (em
        samples/
        ). Obtenha as configurações apropriadas de um representante da Adobe.
    2. Adicione o arquivo de biblioteca ao seu arquivo
      index.html
      e crie a variável global
      ADBMobileConfig
      da seguinte maneira (a variável global usada para configurar o Adobe Mobile para Heartbeats tem uma chave exclusiva denominada
      mediaHeartbeat
      ):
      <script> var ADBMobileConfig = { "marketingCloud": { "org": "972C898555E9F7BC7F000101@AdobeOrg" }, "target": { "clientCode": "", "timeout": 5 }, "audienceManager": { "server": "obumobile5.demdex.net" }, "analytics": { "rsids": "mobile5vhl.sample.player", "server": "obumobile5.sc.omtrdc.net", "ssl": false, "offlineEnabled": false, "charset": "UTF-8", "lifecycleTimeout": 300, "privacyDefault": "optedin", "batchLimit": 0, "timezone": "MDT", "timezoneOffset": -360, "referrerTimeout": 0, "poi": [] }, "mediaHeartbeat": { "server": "obumobile5.hb.omtrdc.net", "publisher": "972C898555E9F7BC7F000101@AdobeOrg", "channel": "test-channel-chromecast", "ssl": false, "ovp": "chromecast-player", "sdkVersion": "chromecast-sdk", "playerName": "Chromecast" } }; </script> <script type="text/javascript" src="script/lib/adbmobile-chromecast.min.js"></script>
      Se
      mediaHeartbeat
      for configurado incorretamente, o módulo de mídia (VHL) entrará em um estado de erro e deixará de enviar chamadas de rastreamento.
      Parâmetros de configuração do ADBMobile para a chave mediaHeartbeat: | Parâmetro de configuração | Descrição     | | --- | --- | |
      server
      | Sequência de caracteres que representa o URL do endpoint de rastreamento no back-end. | |
      publisher
      | Sequência de caracteres que representa o identificador exclusivo do publicador de conteúdo. | |
      channel
      | Sequência de caracteres que representa o nome do canal de distribuição de conteúdo. | |
      ssl
      | Booleano que representa se o SSL deve ser usado para chamadas de rastreamento. | |
      ovp
      | Sequência de caracteres que representa o nome do provedor do reprodutor de vídeo. | |
      sdkversion
      | Sequência de caracteres que representa a versão atual do aplicativo/SDK. | |
      playerName
      | Sequência de caracteres que representa o nome do reprodutor. |
  2. Configurar a ID de visitante da Experience Cloud.
    O serviço de ID de visitante da Experience Cloud fornece uma ID de visitante universal nas soluções da Experience Cloud. O serviço de ID de visitante é exigido pela pulsação de vídeo e outras integrações da Experience Cloud.
    Verifique se a sua configuração
    ADBMobileConfig
    contém a ID da organização da
    marketingCloud
    .
    "marketingCloud": { "org": YOUR-MCORG-ID" }
    As IDs de organização da Experience Cloud identificam de forma exclusiva cada empresa de clientes na Adobe Experience Cloud e são semelhantes ao seguinte valor:
    016D5C175213CCA80A490D05@AdobeOrg
    .
    Certifique-se de incluir
    @AdobeOrg
    .
    Após a configuração ser concluída, uma ID de visitante da Experience Cloud é gerada e incluída em todas as ocorrências. Outras IDs de visitante, como
    custom
    e
    automatically-generated
    , continuam a ser enviadas com cada ocorrência.
    Métodos do Serviço de ID de visitante da Experience Cloud.
    Os métodos de ID de visitante da Experience Cloud apresentam o prefixo
    visitor
    .
    Método
    Descrição
    getMarketingCloudID()
    Recupera a ID de visitante da Experience Cloud do serviço de ID de visitante.
    ADBMobile.visitor.getMarketingCloudID();
    syncIdentifiers()
    Com a ID de visitante da Experience Cloud, é possível definir outras IDs do cliente que podem ser associadas a cada visitante. A API de visitante aceita várias IDs de cliente para o mesmo visitante e um identificador de tipo de cliente para separar o escopo das diferentes IDs de clientes. Este método corresponde a
    setCustomerIDs()
    na biblioteca do JavaScript. Por exemplo:
    var identifiers = {};
    identifiers["idType"] = "idValue";
    ADBMobile.visitor.syncIdentifiers(identifiers);