設定廣告插入中繼資料

使用輔助類AuditudeSettings(可擴充MetadataNode類別)來設定Adobe Primetime廣告決策中繼資料。

秘訣

Adobe Primetime廣告決策之前稱為Auditude。

廣告中繼資料位於MediaResource.Metadata屬性中。 當開始播放新視訊時,您的應用程式負責設定正確的廣告中繼資料。

  1. 建立AuditudeSettings例項。

    AuditudeSettings auditudeSettings = new AuditudeSettings();
    
  2. 設定Adobe Primetime廣告決策mediaIDzoneID<ph conkeyref="phrases/primetime-sdk-name"/>和選用定位參數。

    auditudeSettings.setZoneId("yourZoneId");
    auditudeSettings.setMediaId("yourVideoId");
    auditudeSettings.setDefaultMediaId("defVideoId");
    auditudeSettings.setDomain("yourAuditudeDomain");
    
    // Optionally set user agent
    auditudeSettings.setUserAgent("yourUserAgent");
    
    Metadata targetingParameters = new Metadata();
    targetingParameters.setValue("desired_param", "desired_value");
    auditudeSettings.setTargetingParameters(targetingParameters);
    
    秘訣

    媒體ID由TVSDK使用為字串,並轉換為md5值,用於Primetime廣告決策URL請求中的u值。 例如:

    https://ad.auditude.com/adserver? **u**=c76d04ee31c91c4ce5c8cee41006c97d &z=114100&l=20150206141527&of=1.4&tm=15&g=1000002

  3. 使用媒體串流URL和先前建立的廣告中繼資料,建立MediaResource例項。

    MediaResource mediaResource = new MediaResource(
    "https://example.com/media/test_media.m3u8", MediaResource.Type.HLS, Metadata);
    
  4. 通過MediaPlayer.replaceCurrentResource方法載入MediaResource對象。

    MediaPlayer開始載入並處理媒體串流資訊清單。

  5. MediaPlayer轉換為「已初始化」狀態時,通過MediaPlayer.CurrentItem方法以MediaPlayerItem實例的形式獲得媒體流特性。

  6. (選擇性)查詢MediaPlayerItem例項,以查看串流是否為即時,不論串流是否有替代的音軌或串流受到保護。

    這些資訊可協助您準備播放的UI。 例如,如果您知道有兩個音軌,則可加入UI控制項,以在這些音軌之間切換。

  7. 呼叫MediaPlayer.prepareToPlay以啟動廣告工作流程。

    廣告解析並置於時間軸上後,MediaPlayer會轉換為PREPARED狀態。

  8. 呼叫MediaPlayer.play以開始播放。

TVSDK現在會在您的媒體播放時加入廣告。

本頁內容