Show Menu
TOPICS×

Configuración de Roku

Requisitos previos

  • Obtenga parámetros de configuración válidos para Heartbeat
    : Estos parámetros se pueden obtener de un representante de Adobe una vez creada la cuenta de Media Analytics.
  • Proporcione las siguientes capacidades en su reproductor de contenidos
    :
    • Una API para suscribirse a eventos del reproductor
      : el Media SDK requiere que se invoquen varias API sencillas cuando se producen eventos en el reproductor.
    • Una API que proporcione información del reproductor
      : esta información incluye detalles como el nombre del contenido y la posición del cabezal de reproducción.
Adobe Mobile Services proporciona una nueva interfaz de usuario que aúna las capacidades de marketing móvil para aplicaciones móviles desde Adobe Experience Cloud. Inicialmente, el servicio Mobile ofrece una integración perfecta de las prestaciones de orientación y análisis de aplicaciones de las soluciones Adobe Analytics y Adobe Target.
Para obtener más información, consulte la documentación de Adobe Mobile Services.
El SDK 2.x de Roku para las soluciones de Experience Cloud le permite medir aplicaciones Roku escritas en BrightScript, aprovechar y recopilar datos de audiencia mediante la gestión de público y medir la interacción de vídeo a través de latidos de vídeo.

Implementación del SDK

  1. Añada la biblioteca de Roku descargada al proyecto.
    1. El archivo de descarga
      AdobeMobileLibrary-2.*-Roku.zip
      consta de los siguientes componentes de software:
      • adbmobile.brs
        : Este archivo de biblioteca se incluirá en la carpeta de origen de la aplicación Roku.
      • ADBMobileConfig.json
        : Este archivo de configuración del SDK se personaliza en función de la aplicación.
    2. Añada el archivo de biblioteca y el archivo de configuración JSON al origen del proyecto.
      El JSON utilizado para configurar Adobe Mobile tiene una clave exclusiva para los latidos multimedia denominada
      mediaHeartbeat
      . Es allí donde actúan los parámetros de configuración de los latidos multimedia.
      Se suministra un archivo JSON
      ADBMobileConfig
      de muestra con el paquete. Póngase en contacto con los representantes de Adobe para la configuración.
      Por ejemplo:
      { "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 configuración
      Descripción    
      server
      Cadena que representa la URL del punto final de seguimiento en el servidor.
      publisher
      Cadena que representa el identificador exclusivo del editor de contenido.
      channel
      Cadena que representa el nombre del canal de distribución de contenido.
      ssl
      Booleano que representa si SSL debe utilizarse para rastrear llamadas.
      ovp
      Cadena que representa el nombre del proveedor del reproductor de vídeo.
      sdkversion
      Cadena que representa la versión actual de la aplicación/SDK.
      playerName
      Cadena que representa el nombre del reproductor.
      Si
      mediaHeartbeat
      se configura incorrectamente, el módulo multimedia (VHL) entrará en un estado de error y dejará de enviar llamadas de seguimiento.
  2. Configure el ID de visitante de Experience Cloud.
    El servicio de identificación de visitantes de Experience Cloud proporciona un ID de visitante universal en las soluciones de Experience Cloud. El servicio de medición de vídeos y otras integraciones de Experience Cloud requieren el servicio de ID del visitante.
    Verifique que su configuración de
    ADBMobileConfig
    contenga su ID de empresa de
    marketingCloud
    .
    "marketingCloud": { "org": YOUR-MCORG-ID" }
    Los ID de empresa de Experience Cloud identifican exclusivamente cada empresa de los clientes en Adobe Experience Cloud y aparecen similares al siguiente valor:
    016D5C175213CCA80A490D05@AdobeOrg
    .
    Asegúrese de incluir
    @AdobeOrg
    .
    Una vez completada la configuración, se genera un ID de visitante de Experience Cloud que se incluye en todas las visitas. Otros ID de visitante, como
    custom
    y
    automatically-generated
    , se siguen enviando con cada visita.
    Métodos de servicio de ID de visitantes de Experience Cloud
    Los métodos de ID de los visitantes de Experience Cloud cuentan con el prefijo
    visitor
    .
     Método  
    Descripción
    visitorMarketingCloudID
    Recupera el ID del visitante de Experience Cloud del servicio de ID del visitante.
    ADBMobile().visitorMarketingCloudID()
    visitorSyncIdentifiers
    Con el ID de visitantes de Experience Cloud puede configurar ID adicionales de clientes que se pueden asociar a cada visitante. La API de visitante acepta múltiples ID de cliente para el mismo visitante y un identificador de tipo de cliente para separar el ámbito de los distintos ID de cliente. Este método corresponde a
    setCustomerIDs
    . Por ejemplo:
    identifiers={}
    identifiers["idType"]="idValue"
    ADBMobile().visitorSyncIdentifiers(identifiers)
    setAdvertisingIdentifier
    Se utiliza para establecer el ID de Roku para publicidad (RIDA) en el SDK. Por ejemplo:
    ADBMobile().setAdvertisingIdentifier(
      
    "<sample_roku_identifier_for_advertising>")
    Obtenga el ID de Roku para publicidad (RIDA) mediante la API de SDK de Roku getRIDA() .