廣告插入中繼資料

為了讓廣告解析程式運作，廣告提供者(例如Adobe Primetime廣告決策)需要設定值才能啟用您與提供者的連線。

TVSDK包含Primetime廣告決策程式庫。 您的內容若要包含來自Primetime廣告決策伺服器的廣告，您的應用程式必須提供下列必要的AuditudeSettings資訊：

• mediaID，這是要播放視訊的唯一識別碼。

  發佈者在將視訊內容和廣告資訊送出至Adobe Primetime廣告決策伺服器時，會指派mediaID。 Primetime廣告決策會使用此ID，從伺服器擷取視訊的相關廣告資訊。

• 由Adobe指派的zoneID可識別您的公司或網站。

• 您指派的廣告伺服器的網域。

• 其他定位參數。

  您可以根據您的需求和廣告提供者的需求，加入這些參數。

設定廣告插入中繼資料

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

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

1. 建立AuditudeSettings例項。

   var auditudeSettings:AuditudeSettings = new AuditudeSettings();
   

2. 設定Adobe Primetime廣告決策媒體ID、zoneID、網域和選用的定位參數。

   auditudeSettings.zoneId = "yourZoneID"; 
   auditudeSettings.mediaId = "media_identifier"; 
   auditudeSettings.domain = "yourAuditudeDomain"; 
   var targetingInfo:Metadata = new Metadata(); 
   targetingInfo.setValue("yourParamName", "yourParamValue"); 
   auditudeSettings.targetingInfo = targetingInfo;
   

   秘訣

   媒體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例項。

   var mediaResourceMetadata:MetadataNode = new MetadataNode(); 
   mediaResourceMetadata.setNode(DefaultMetadataKeys.AUDITUDE_METADATA_KEY, auditudeSettings); 
   var mediaResource:MediaResource = new MediaResource( 
         "www.example.com/video/test.m3u8", 
         MediaResourceType.HLS,  
         mediaResourceMetadata);
   

4. 通過MediaPlayer.replaceCurrentResource方法載入MediaResource對象。

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

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

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

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

   廣告解析並置於時間軸上後，MediaPlayer會轉換為「已準備」狀態。

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

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