設定廣告插入中繼資料

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

秘訣

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

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

  1. 建立AuditudeSettings例項。

    AuditudeSettings auditudeSettings = new AuditudeSettings();
    
  2. 設定Adobe Primetime廣告決策mediaIDzoneIDdomain和選用定位參數。

    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轉換為INITIALIZED狀態時,請透過MediaPlayer.CurrentItem方法以MediaPlayerItem例項形式取得媒體串流特性。

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

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

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

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

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

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

本頁內容