feat: Expose Vast ad ID (#8477)

Media Tailor ads have a property called "vastAdId". This PR exposes it
in the same way as the rest of the ads' properties, so it's available
for use e.g. in analytics reporting.

Closes #8474

---------

Co-authored-by: Jose Torres <[email protected]>

Author: jose-torres-marin

externs/mediatailor.js

@@ -69,7 +69,8 @@ mediaTailor.AdBreak;
  *   skipOffset: ?string,
  *   startTimeInSeconds: number,
  *   nonLinearAdList: !Array<mediaTailor.NonLinearAd>,
- *   trackingEvents: !Array<mediaTailor.TrackingEvent>
+ *   trackingEvents: !Array<mediaTailor.TrackingEvent>,
+ *   vastAdId: ?string
  * }}
  *
  * @property {string} adId
@@ -83,6 +84,7 @@ mediaTailor.AdBreak;
  * @property {number} startTimeInSeconds
  * @property {!Array<mediaTailor.NonLinearAd>} nonLinearAdList
  * @property {!Array<mediaTailor.TrackingEvent>} trackingEvents
+ * @property {?string} vastAdId
  * @exportDoc
  */
 mediaTailor.Ad;

externs/shaka/ads.js

@@ -477,6 +477,11 @@ shaka.extern.IAd = class {
    */
   getVastMediaWidth() {}
 
+  /**
+   * @return {string}
+   */
+  getVastAdId() {}
+
   /**
    * @return {string}
    */

lib/ads/client_side_ad.js

@@ -319,6 +319,14 @@ shaka.ads.ClientSideAd = class {
     return this.ad_.getVastMediaWidth();
   }
 
+  /**
+   * @override
+   * @export
+   */
+  getVastAdId() {
+    return '';
+  }
+
   /**
    * @override
    * @export

lib/ads/interstitial_ad.js

@@ -292,6 +292,14 @@ shaka.ads.InterstitialAd = class {
     return 0;
   }
 
+  /**
+   * @override
+   * @export
+   */
+  getVastAdId() {
+    return '';
+  }
+
   /**
    * @override
    * @export

lib/ads/interstitial_static_ad.js

@@ -249,6 +249,14 @@ shaka.ads.InterstitialStaticAd = class {
     return 0;
   }
 
+  /**
+   * @override
+   * @export
+   */
+  getVastAdId() {
+    return '';
+  }
+
   /**
    * @override
    * @export

lib/ads/media_tailor_ad.js

@@ -278,6 +278,14 @@ shaka.ads.MediaTailorAd = class {
     return 0;
   }
 
+  /**
+   * @override
+   * @export
+   */
+  getVastAdId() {
+    return this.ad_.vastAdId || '';
+  }
+
   /**
    * @override
    * @export

lib/ads/server_side_ad.js

@@ -276,6 +276,14 @@ shaka.ads.ServerSideAd = class {
     return this.ad_.getVastMediaWidth();
   }
 
+  /**
+   * @override
+   * @export
+   */
+  getVastAdId() {
+    return '';
+  }
+
   /**
    * @override
    * @export

test/test/util/fake_ad.js

@@ -50,6 +50,9 @@ shaka.test.FakeAd = class {
     /** @private {number} */
     this.vastMediaWidth_ = 1280;
 
+    /** @private {string} */
+    this.vastAdId_ = 'Test VAST Ad ID';
+
     /** @private {string} */
     this.adId_ = 'Test Ad ID';
 
@@ -293,6 +296,14 @@ shaka.test.FakeAd = class {
     return this.vastMediaWidth_;
   }
 
+  /**
+   * @override
+   * @export
+   */
+  getVastAdId() {
+    return this.vastAdId_;
+  }
+
   /**
    * @override
    * @export