Show Menu
TOPICS×

Configurar Roku

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 reprodutor de mídia:
    • Uma API para assinar os eventos do reprodutor
      - O SDK do Media exige a chamada de um conjunto de APIs simples quando ocorrerem eventos no reprodutor.
    • Uma API que fornece informações sobre o reprodutor
      - Essas informações incluem detalhes como o nome da mídia e a posição do indicador de reprodução.
O Adobe Mobile Services apresenta uma nova interface do usuário que reúne recursos de marketing móvel para aplicativos móveis na Adobe Experience Cloud. Inicialmente, o Mobile Service fornece uma integração simples de recursos de análise e segmentação de aplicativos para as soluções do Adobe Analytics e do Adobe Target.
O SDK do Roku 2.x para soluções da Experience Cloud permite avaliar aplicativos Roku criados com BrightScript, dimensionar e coletar dados de público por meio do gerenciamento de público-alvo e medir o envolvimento com o vídeo pelas pulsações de vídeo.

Implementação do SDK

  1. Adicione a biblioteca baixada do Roku ao projeto.
    1. O arquivo de download
      AdobeMobileLibrary-2.*-Roku.zip
      consiste nos seguintes componentes de software:
      • adbmobile.brs
        : Esse arquivo de biblioteca será incluído na pasta de origem do aplicativo Roku.
      • ADBMobileConfig.json
        : Esse arquivo de configuração do SDK foi personalizado para o aplicativo.
    2. Adicione o arquivo da biblioteca e o arquivo de configuração JSON à origem do projeto.
      O JSON usado para configurar o Adobe Mobile tem uma chave exclusiva para o Media Heartbeats chamada
      mediaHeartbeat
      . Os parâmetros de configuração do Media Heartbeats pertencem a essa chave.
      Um exemplo de arquivo JSON
      ADBMobileConfig
      é fornecido com o pacote. Entre em contato com seu representante da Adobe para obter as configurações.
      Por exemplo:
      { "version":"1.0", "analytics":{ "rsids":"", "server":"", "charset":"UTF-8", "ssl":false, "offlineEnabled":false, "lifecycleTimeout":30, "batchLimit":50, "privacyDefault":"optedin", "poi":[ ] }, "marketingCloud":{ "org":"" }, "target":{ "clientCode":"", "timeout":5 }, "audienceManager":{ "server":"" }, "acquisition":{ "server":"example.com", "appid":"sample-app-id" }, "mediaHeartbeat":{ "server":"example.com", "publisher":"sample-publisher", "channel":"sample-channel", "ssl":false, "ovp":"sample-ovp", "sdkVersion":"sample-sdk", "playerName":"roku" } }
      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.
      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.
  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 em todas as soluções da Experience Cloud. O serviço de ID de visitante é exigido pelo Video Heartbeat e por 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
    visitorMarketingCloudID
    Recupera a ID de visitante da Experience Cloud do serviço de ID de visitante.
    ADBMobile().visitorMarketingCloudID()
    visitorSyncIdentifiers
    Com a ID de visitante da Experience Cloud, é possível definir IDs adicionais de clientes que podem ser associadas a cada visitante. A API de visitante aceita várias IDs do cliente para o mesmo visitante e um identificador de tipo de cliente para separar o escopo de diferentes IDs do cliente. Este método corresponde a
    setCustomerIDs
    . Por exemplo:
    identifiers={}
    identifiers["idType"]="idValue"
    ADBMobile().visitorSyncIdentifiers(identifiers)
    setAdvertisingIdentifier
    Usado para definir a ID do Roku para publicidade (RIDA) no SDK. Por exemplo:
    ADBMobile().setAdvertisingIdentifier(
      
    "<sample_roku_identifier_for_advertising>")
    Obtenha a ID do Roku para publicidade (RIDA) usando a API getRIDA() do SDK do Roku.