設定廣告插入中繼資料

使用協助程式類別AuditudeSettings (會擴充MetadataNode類別)來設定Adobe Primetime ad decisioning中繼資料。

秘訣

Adobe Primetime ad decisioning先前稱為Auditude。

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

  1. 建置 AuditudeSettings 執行個體。

    AuditudeSettings auditudeSettings = new AuditudeSettings();
    
  2. 設定Adobe Primetime ad decisioning 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值,並用於 u Primetime廣告決策URL請求中的值。 例如:

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

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

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

    MediaPlayer 開始載入及處理媒體資料流資訊清單。

  5. MediaPlayer 轉換為INITIALIZED狀態,以格式取得媒體資料流特性 MediaPlayerItem 執行個體透過 MediaPlayer.CurrentItem 方法。

  6. (選用)查詢 MediaPlayerItem 執行個體以檢視資料流是否為即時,無論是否有替代音軌或資料流受到保護。

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

  7. 呼叫 MediaPlayer.prepareToPlay 以開始廣告工作流程。

    解析廣告並放置在時間軸上後, MediaPlayer 轉換至 PREPARED 州別。

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

TVSDK現在會在您的媒體播放時包含廣告。

本頁內容