Configurar SDK móvil v3.x para Chromecast set-up-chromecast

En esta sección se describen los requisitos previos para configurar una instalación de Chromecast para el complemento de recopilación de medios de streaming.

Requisitos previos

  • Obtener parámetros de configuración válidos

    Puede solicitar estos parámetros a un representante de Adobe después de configurar su cuenta de análisis de medios.

  • Incluya las siguientes API en su reproductor multimedia

    • Una API para suscribirse a eventos del reproductor: Media SDK requiere que llame a un conjunto de API simples cuando se produzcan eventos en el reproductor.
    • Una API que proporciona información del reproductor: Esta información incluye detalles como el nombre del medio 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.

Adobe Mobile Library para Chromecast v3.x para Experience Cloud Solutions le permite medir las aplicaciones de Chromecast escritas en JavaScript, aprovechar y recopilar datos de audiencia mediante la gestión de público y medir la participación en los vídeos.

Biblioteca móvil / Implementación SDK

  1. Añada la biblioteca de Chromecast descargada al proyecto.

    1. El archivo AdobeMobileLibrary-Chromecast-[version] zip consta de los siguientes componentes de software:

      • adbmobile-chromecast.min.js:

        Este archivo de biblioteca se incluirá en la carpeta de origen de la aplicación Chromecast.

      • Configuración ADBMobileConfig

        Este archivo de configuración del SDK se personaliza en función de la aplicación. Con el SDK se proporciona una implementación de muestra de ADBMobileConfig (en samples/). Consulte con un representante de Adobe la configuración adecuada.

    2. Añada el archivo de biblioteca a su archivo index.html y cree la variable global ADBMobileConfig del siguiente modo (la variable global utilizada para configurar Adobe Mobile para Media Analytics tiene una clave exclusiva denominada mediaHeartbeat):

      code language-js
      <script>
          var ADBMobileConfig = {
            "marketingCloud": {
              "org": "972C898555E9F7BC7F000101@AdobeOrg"
            },
            "target": {
              "clientCode": "",
              "timeout": 5
            },
            "audienceManager": {
              "server": "obumobile5.demdex.net"
            },
            "analytics": {
              "rsids": "example.sample.player",
              "server": "example.sc.omtrc.net",
              "ssl": true,
              "offlineEnabled": false,
              "charset": "UTF-8",
              "lifecycleTimeout": 300,
              "privacyDefault": "optedin",
              "batchLimit": 0,
              "timezone": "MDT",
              "timezoneOffset": -360,
              "referrerTimeout": 0,
              "poi": []
            },
            "mediaHeartbeat": {
              "server": "example.hb-api.omtrdc.net",
              "publisher": "972C898555E9F7BC7F000101@AdobeOrg",
              "channel": "test-channel-chromecast",
              "ssl": true,
              "ovp": "chromecast-player",
              "sdkVersion": "chromecast-sdk",
              "playerName": "Chromecast"
            }
          };
        </script>
      <script type="text/javascript" src="script/lib/adbmobile-chromecast.min.js"></script>
      
      note important
      IMPORTANT
      Si mediaHeartbeat está mal configurado, el módulo multimedia entra en estado de error y dejará de enviar llamadas de seguimiento.

      Parámetros de configuración de ADBMobile para la clave de mediaHeartbeat:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2
    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 único 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.
  2. Configure el ID de visitante de Experience Cloud.

    El servicio de ID de visitante de Experience Cloud ofrece un ID de visitante universal para las soluciones de Experience Cloud. El servicio ID de visitante es necesario para Media Analytics y otras integraciones de Marketing Cloud.

    Verifique que su configuración de ADBMobileConfig contenga su ID de empresa de marketingCloud.

    code language-none
    "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.

    note important
    IMPORTANT
    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

    note tip
    TIP
    Los métodos de ID de los visitantes de Experience Cloud cuentan con el prefijo visitor.
    table 0-row-2 1-row-2 2-row-2
    Método Descripción
    getMarketingCloudID() Recupera el ID del visitante de Experience Cloud del servicio de ID del visitante.

    ADBMobile.visitor.getMarketingCloudID();
    syncIdentifiers() Con el ID de Visitante de Experience Cloud, puede establecer ID de cliente adicionales que se pueden asociar con cada visitante. La API de visitante acepta varios 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() en la biblioteca de JavaScript. Por ejemplo:

    var identifiers = {};

    identifiers["idType"] = "idValue";

    ADBMobile.visitor.syncIdentifiers(identifiers);
  3. Para el seguimiento de los medios, aplique el protocolo MediaDelegate

    code language-js
     var delegate = {
       // Replace <currentPlaybackTime> with the video player current playback time
       getCurrentPlaybackTime = function() {
         return <currentPlaybackTime>;
       },
       // Replace <bitrate>, <startuptime>, <fps> and <droppeFrames> with the current playback QoS values.
       getQoSObject = function() {
          return ADBMobile.media.createQoSObject(<bitrate>, <startupTime>, <fps>, <droppedFrames>);
       }
     }
    
     ADBMobile.media.setDelegate(delegate);
    }
    
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb