Anzeigen von Werbung in VideoinhaltenShow ads in video content

Warnung

Ab dem 1. Juni 2020 wird die Microsoft AD-Monetarisierungsplattform für Windows UWP-apps heruntergefahren.As of June 1, 2020, the Microsoft Ad Monetization platform for Windows UWP apps will be shut down. Weitere InformationenLearn more

In dieser exemplarischen Vorgehensweise wird gezeigt, wie die adscheduler -Klasse verwendet wird, um Anzeigen in Videoinhalten in einer universelle Windows-Plattform-app (UWP) anzuzeigen, die mithilfe von JavaScript mit HTML geschrieben wurde.This walkthrough shows how to use the AdScheduler class to show ads in video content in a Universal Windows Platform (UWP) app that was written using JavaScript with HTML.

Hinweis

Diese Funktion wird zurzeit nur für UWP-Apps unterstützt, die mithilfe von JavaScript mit HTML geschrieben werden.This feature is currently supported only for UWP apps that are written using JavaScript with HTML.

AdScheduler funktioniert mit progressiven Medien und Streamingmedien und nutzt Video Ad Serving Template (VAST) 2.0/3.0 nach IAB-Standard und VMAP-Nutzlastformate.AdScheduler works with both progressive and streaming media, and uses IAB standard Video Ad Serving Template (VAST) 2.0/3.0 and VMAP payload formats. Durch die Verwendung von Standards ist AdScheduler agnostisch gegenüber dem Anzeigendienst, mit dem die Interaktion erfolgt.By using standards, AdScheduler is agnostic to the ad service with which it interacts.

Werbung für Videoinhalte variiert in Abhängigkeit davon, ob das Programm kürzer als zehn Minuten (kurzes Format) oder länger als zehn Minuten (langes Format) ist.Advertising for video content differs based upon whether the program is under ten minutes (short form), or over ten minutes (long form). Die Einrichtung des letzteren Formats für den Dienst ist zwar komplizierter, aber es besteht eigentlich kein Unterschied darin, wie der clientseitige Code geschrieben wird.Although the latter is more complicated to set up on the service, there is actually no difference in how one writes the client side code. Wenn AdScheduler eine VAST-Nutzlast mit einer einzelnen Werbeanzeige anstelle eines Manifests empfängt, wird dies so behandelt, als ob das Manifest eine einzelne Pre-Roll-Anzeige (eine Unterbrechung bei 00:00) aufgerufen hat.If the AdScheduler receives a VAST payload with a single ad instead of a manifest, it is treated as if the manifest called for a single pre-roll ad (one break at time 00:00).

VoraussetzungenPrerequisites

  • Installieren Sie das Microsoft Advertising SDK mit Visual Studio 2015 oder einer neueren Version.Install the Microsoft Advertising SDK with Visual Studio 2015 or a later release.

  • In Ihrem Projekt muss das MediaPlayer-Steuerelement verwendet werden, um die Videoinhalte bereitstellen zu können, für die die Anzeigen eingeplant werden.Your project must use the MediaPlayer control to serve the video content in which the ads will be scheduled. Dieses Steuerelement ist in der Bibliotheksammlung TVHelpers von Microsoft auf GitHub verfügbar.This control is available in the TVHelpers collection of libraries available from Microsoft on GitHub.

    Das folgende Beispiel zeigt, wie Sie einen MediaPlayer im HTML-Markup deklarieren.The following example shows how to declare a MediaPlayer in HTML markup. Dieser Markupcode gehört normalerweise in den Abschnitt <body> in der Datei „index.html“ (oder einer anderen HTML-Datei, je nach Eignung für Ihr Projekt).Typically, this markup belongs in the <body> section in the index.html file (or another html file as appropriate for your project).

    <div id="MediaPlayerDiv" data-win-control="TVJS.MediaPlayer">
      <video src="URL to your content">
      </video>
    </div>
    

    Im folgenden Beispiel wird veranschaulicht, wie Sie einen MediaPlayer in JavaScript-Code einrichten.The following example shows how to establish a MediaPlayer in JavaScript code.

    var mediaPlayerDiv = document.createElement("div");
    document.body.appendChild(mediaPlayerDiv);
    
    var videoElement = document.createElement("video");
    videoElement.src = "<URL to your content>";
    mediaPlayerDiv.appendChild(videoElement);
    
    var mediaPlayer = new TVJS.MediaPlayer(mediaPlayerDiv);
    

Verwenden der AdScheduler-Klasse im CodeHow to use the AdScheduler class in your code

  1. Öffnen Sie in Visual Studio Ihr Projekt, oder erstellen Sie ein neues Projekt.In Visual Studio, open your project or create a new project.

  2. Sollte in Ihrem Projekt die Zielplattform ANYCPU definiert sein, müssen Sie eine architekturspezifische Buildausgabe verwenden (z. B. X86) und das Projekt entsprechend aktualisieren.If your project targets Any CPU, update your project to use an architecture-specific build output (for example, x86). Sollte in Ihrem Projekt die Zielplattform ANYCPU definiert sein, können Sie bei den folgenden Schritten keinen Verweis auf die Microsoft Advertising-Bibliotheken hinzufügen.If your project targets Any CPU, you will not be able to successfully add a reference to the Microsoft advertising library in the following steps. Weitere Informationen finden Sie unter Referenzfehler, die durch die Ausrichtung auf eine beliebige CPU (Any CPU) in Ihrem Projekt verursacht werden.For more information, see Reference errors caused by targeting Any CPU in your project.

  3. Fügen Sie Ihrem Projekt einen Verweis auf die Bibliothek Microsoft Advertising SDK für JavaScript hinzu.Add a reference to the Microsoft Advertising SDK for JavaScript library to your project.

    1. Klicken Sie im Projektmappen-Explorer Fenster mit der rechten Maustaste auf Verweise, und wählen Sie Verweis hinzufügen... aus.From the Solution Explorer window, right click References, and select Add Reference…
    2. Erweitern Sie im Verweis-Manager den Knoten Universal Windows, klicken Sie auf Erweiterungen, und wählen Sie dann das Kontrollkästchen neben Microsoft Advertising SDK für JavaScript (Version 10.0).In Reference Manager, expand Universal Windows, click Extensions, and then select the check box next to Microsoft Advertising SDK for JavaScript (Version 10.0).
    3. Klicken Sie im Verweis-Manager auf „OK“.In Reference Manager, click OK.
  4. Fügen Sie dem Projekt die Datei „AdScheduler.js“ hinzu:Add the AdScheduler.js file to your project:

    1. Klicken Sie in Visual Studio auf Projekt und NuGet-Pakete verwalten.In Visual Studio, click Project and Manage NuGet Packages.
    2. Geben Sie im Suchfeld den Suchbegriff Microsoft.StoreServices.VideoAdScheduler ein, und installieren Sie das Microsoft.StoreServices.VideoAdScheduler-Paket.In the search box, type Microsoft.StoreServices.VideoAdScheduler and install the Microsoft.StoreServices.VideoAdScheduler package. Die Datei „AdScheduler.js“ wird dem Unterverzeichnis „../js“ Ihres Projekts hinzugefügt.The AdScheduler.js file is added to the ../js subdirectory in your project.
  5. Öffnen Sie die Datei „index.html“ (oder je nach Projekt eine andere HTML-Datei).Open the index.html file (or other html file as appropriate for your project). Fügen Sie im Abschnitt <head> nach den JavaScript-Verweisen auf „default.css“ und „main.js“ des Projekts den Verweis auf „ad.js“ und „adscheduler.js“ hinzu.In the <head> section, after the project’s JavaScript references of default.css and main.js, add the reference to ad.js and adscheduler.js.

    <script src="//Microsoft.Advertising.JavaScript/ad.js"></script>
    <script src="/js/adscheduler.js"></script>
    

    Hinweis

    Diese Zeile muss <head> nach dem einschließen von main.js in den Abschnitt eingefügt werden. andernfalls tritt ein Fehler auf, wenn Sie das Projekt erstellen.This line must be placed in the <head> section after the include of main.js; otherwise, you will encounter an error when you build your project.

  6. Fügen Sie der Datei „main.js“ des Projekts Code hinzu, mit dem ein neues AdScheduler-Objekt erstellt wird.In the main.js file in your project, add code that creates a new AdScheduler object. Übergeben Sie den MediaPlayer, mit dem Ihre Videoinhalte gehostet werden.Pass in the MediaPlayer that hosts your video content. Der Code muss so angeordnet werden, dass er nach WinJS.UI.processAll ausgeführt wird.The code must be placed so that it runs after WinJS.UI.processAll.

    var myMediaPlayer = document.getElementById("MediaPlayerDiv");
    var myAdScheduler = new MicrosoftNSJS.Advertising.AdScheduler(myMediaPlayer);
    
  7. Verwenden Sie die requestschedule -Methode oder die requestschedulebyurl -Methode des adscheduler -Objekts, um einen AD-Zeitplan vom Server anzufordern und in die Media Player -Zeitachse einzufügen und dann die Video Medien wiederzugeben.Use the requestSchedule or requestScheduleByUrl methods of the AdScheduler object to request an ad schedule from the server and insert it into the MediaPlayer timeline, and then play the video media.

    • Wenn Sie Microsoft-Partner sind und eine Berechtigung zum Anfordern eines Anzeigenzeitplans vom Microsoft-Anzeigenserver erhalten haben, können Sie requestSchedule verwenden und die IDs für die Anwendung und die Anzeigeneinheit angeben, die von Ihrem Microsoft-Vertreter bereitgestellt wurden.If you are a Microsoft partner who has received permission to request an ad schedule from the Microsoft ad server, use requestSchedule and specify the application ID and ad unit ID that were provided to you by your Microsoft representative.

      Diese Methode hat die Form einer Zusicherung, bei der es sich um ein asynchrones Konstrukt handelt, bei dem zwei Funktionszeiger übermittelt werden: ein Zeiger für die OnComplete -Funktion, die aufgerufen werden soll, wenn die Zusage erfolgreich abgeschlossen wird, und ein Zeiger für die OnError -Funktion, die bei einem Fehler aufgerufen wirdThis method takes the form of a Promise, which is an asynchronous construct where two function pointers are passed: a pointer for the onComplete function to call when the promise completes successfully and a pointer for the onError function to call if an error is encountered. Beginnen Sie in der OnComplete -Funktion mit der Wiedergabe von Videoinhalten.In the onComplete function, start playback of your video content. Die Werbe Wiedergabe wird zum geplanten Zeitpunkt wiedergegeben.The ad will start playing at the scheduled time. Behandeln Sie den Fehler in der OnError -Funktion, und beginnen Sie dann mit der Wiedergabe Ihres Videos.In your onError function, handle the error and then start playback of your video. Ihre Videoinhalte werden ohne Werbung wiedergegeben.Your video content will play without an ad. Das-Argument der OnError -Funktion ist ein Objekt, das die folgenden Member enthält.The argument of the onError function is an object that contains the following members.

      myAdScheduler.requestSchedule("your application ID", "your ad unit ID").then(
        function promiseSuccessHandler(schedule) {
            // Success: play the video content with the scheduled ads.
            myMediaPlayer.tvControl.play();
        },
        function promiseErrorHandler(err) {
            // Error: play the video content without the ads.
            myMediaPlayer.tvControl.play();
        });
      
    • Verwenden Sie requestschedulebyurl, und übergeben Sie den Server-URI, um einen AD-Zeitplan von einem nicht-Microsoft-Ad-Server anzufordern.To request an ad schedule from a non-Microsoft ad server, use requestScheduleByUrl, and pass in the server URI. Diese Methode hat auch die Form einer Zusicherung , die Zeiger für die OnComplete -und OnError -Funktionen akzeptiert.This method also takes the form of a Promise that accepts pointers for the onComplete and onError functions. Die vom Server zurückgegebene AD-Nutzlast muss den Nutz Last Formaten für die Video-und Videowiedergabe Vorlage (Vast) oder Video Multiple AD Wiedergabelisten (VMAP) entsprechen.The ad payload that is returned from the server must conform to the Video Ad Serving Template (VAST) or Video Multiple Ad Playlist (VMAP) payload formats.

      myAdScheduler.requestScheduleByUrl("your URL").then(
        function promiseSuccessHandler(schedule) {
            // Success: play the video content with the scheduled ads.
            myMediaPlayer.winControl.play();
        },
        function promiseErrorHandler(evt) {
            // Error: play the video content without the ads.
            myMediaPlayer.winControl.play();
        });
      

    Hinweis

    Warten Sie, bis requestschedule oder requestschedulebyurl zurückgegeben wird, bevor Sie mit der Wiedergabe der primären Videoinhalte in Media Playerbeginnen.You should wait for requestSchedule or requestScheduleByUrl to return before starting to play the primary video content in the MediaPlayer. Die Wiedergabe von Medien vor der Rückgabe von requestschedule (bei einer Pre-Roll-Ankündigung) führt dazu, dass der primäre Videoinhalt von der vorab Ausführung unterbrochen wird.Starting to play media before requestSchedule returns (in the case of a pre-roll advertisement) will result in the pre-roll interrupting the primary video content. Sie müssen auch " Play " aufruft, auch wenn die Funktion fehlschlägt, da der " Media Player" den Media Player anweist, die AD (s) zu überspringen und direkt zum Inhalt zu wechseln. AdSchedulerYou must call play even if the function fails, because the AdScheduler will tell the MediaPlayer to skip the ad(s) and move straight to the content. Unter Umständen besteht bei Ihnen auch eine andere geschäftliche Anforderung, z. B. das Einfügen einer integrierten Anzeige, falls eine Anzeige nicht erfolgreich von einem Remotestandort abgerufen werden kann.You may have a different business requirement, such as inserting a built-in ad if an ad can't be successfully fetched remotely.

  8. Während der Wiedergabe können Sie zusätzliche Ereignisse verarbeiten, mit denen Ihre App den Status bzw. Fehler nachverfolgen kann, die nach dem ersten Anzeigenabgleich auftreten.During playback, you can handle additional events that let your app track progress and/or errors which may occur after the initial ad matching process. Der folgende Code zeigt einige dieser Ereignisse, einschließlich onPodStart, onPodEnd, onPodCountdown, onAdProgress, onAllComplete und onErrorOccurred.The following code shows some of these events, including onPodStart, onPodEnd, onPodCountdown, onAdProgress, onAllComplete, and onErrorOccurred.

    // Raised when an ad pod starts. Make the countdown timer visible.
    myAdScheduler.onPodStart = function (sender, data) {
        myCounterDiv.style.visibility = "visible";
    }
    
    // Raised when an ad pod ends. Hide the countdown timer.
    myAdScheduler.onPodEnd = function (sender, data) {
        myCounterDiv.style.visibility = "hidden";
    }
    
    // Raised when an ad is playing and indicates how many seconds remain  
    // in the current pod of ads. This is useful when the app wants to show 
    // a visual countdown until the video content resumes.
    myAdScheduler.onPodCountdown = function (sender, data) {
        myCounterText = "Content resumes in: " +
        Math.ceil(data.remainingPodTime) + " seconds.";
    }
    
    // Raised during each quartile of progress through the ad clip.
    myAdScheduler.onAdProgress = function (sender, data) {
    }
    
    // Raised when the ads and content are complete.
    myAdScheduler.onAllComplete = function (sender) {
    }
    
    // Raised when an error occurs during playback after successfully scheduling.
    myAdScheduler.onErrorOccurred = function (sender, data) {
    }
    

Adscheduler-MitgliederAdScheduler members

Dieser Abschnitt enthält einige Details zu den Membern des adscheduler -Objekts.This section provides some details about the members of the AdScheduler object. Weitere Informationen zu diesen Elementen finden Sie in den Kommentaren und Definitionen in der AdScheduler.js-Datei in Ihrem Projekt.For more information about these members, see the comments and definitions in the AdScheduler.js file in your project.

requestschedulerequestSchedule

Diese Methode fordert einen AD-Zeitplan von Microsoft Ad Server an und fügt ihn in die Zeitachse von Media Player ein, die an den adscheduler -Konstruktor übergeben wurde.This method requests an ad schedule from the Microsoft ad server and inserts it into the timeline of the MediaPlayer that was passed to the AdScheduler constructor.

Der optionale dritte Parameter (adtags) ist eine JSON-Auflistung von Name-Wert-Paaren, die für Apps verwendet werden kann, die eine erweiterte Zielplattform haben.The optional third paramter (adTags) is a JSON collection of name/value pairs that can be used for apps that have advanced targeting. Beispielsweise kann eine APP, die eine Vielzahl von automatisch verknüpften Videos wieder gibt, die AD-Einheits-ID mit der Marke und dem Modell des angezeigten Fahrzeugs ergänzen.For example, an app that plays a variety of auto-related videos might supplement the ad unit ID with the make and model of the car being shown. Dieser Parameter soll nur von Partnern verwendet werden, die die Genehmigung von Microsoft zur Verwendung von AD-Tags erhalten.This parameter is intended to be used only by partners who receive approval from Microsoft to use ad tags.

Beim Verweisen auf adtagssollten folgende Punkte beachtet werden:The following items should be noted when referring to adTags:

  • Dieser Parameter ist eine sehr selten verwendete Option.This parameter is a very rarely used option. Der Herausgeber muss vor der Verwendung von adtags eng mit Microsoft zusammenarbeiten.The publisher must work closely with Microsoft before using adTags.
  • Sowohl der Name als auch die Werte müssen für den AD-Dienst vorgegeben werden.Both the names and the values must be predetermined on the ad service. AD-Tags sind keine geöffneten Suchbegriffe oder Schlüsselwörter.Ad tags are not open ended search terms or keywords.
  • Die maximal unterstützte Anzahl von Tags beträgt 10.The maximum supported number of tags is 10.
  • Tagnamen sind auf 16 Zeichen beschränkt.Tag names are restricted to 16 characters.
  • Tagwerte haben maximal 128 Zeichen.Tag values have a maximum of 128 characters.

requestschedulebyurirequestScheduleByUri

Diese Methode fordert einen AD-Zeitplan von dem im URI angegebenen nicht-Microsoft-Ad-Server an und fügt ihn in die Zeitachse von Media Player ein, die an den adscheduler -Konstruktor übergeben wurde.This method requests an ad schedule from the non-Microsoft ad server specified in the URI and inserts it into the timeline of the MediaPlayer that was passed to the AdScheduler constructor. Die AD-Nutzlast, die vom AD-Server zurückgegeben wird, muss den Nutz Last Formaten für die Video-und Videowiedergabe Vorlage (Vast) oder Video Multiple AD Playlist (VMAP) entsprechen.The ad payload that is returned by the ad server must conform to the Video Ad Serving Template (VAST) or Video Multiple Ad Playlist (VMAP) payload formats.

mediatimeoutmediaTimeout

Diese Eigenschaft ruft die Anzahl der Millisekunden ab, die das Medium für die über Wiedergabe benötigt, oder legt diese fest.This property gets or sets the number of milliseconds that the media must be playable. Der Wert 0 teilt dem System mit, dass nie ein Timeout auftritt.A value of 0 informs the system to never timeout. Der Standardwert ist 30000 MS (30 Sekunden).The default is 30000 ms (30 seconds).

playskippedmediaplaySkippedMedia

Mit dieser Eigenschaft wird ein boolescher Wert abgerufen oder festgelegt, der angibt, ob geplante Medien wiedergegeben werden, wenn der Benutzer einen Zeitpunkt hinter einer geplanten Startzeit überspringt.This property gets or sets a Boolean value that indicates whether scheduled media will play if user skips ahead to a point past a scheduled start time.

Der AD-Client und Media Player erzwingen Regeln in Bezug auf die Aktionen, die beim schnellen weiterleiten und erneuten Laden der primären Videoinhalte durchgeführt werden.The ad client and media player will enforce rules in terms what happens to advertisements during fast forwarding and rewinding of the primary video content. In den meisten Fällen erlauben App-Entwickler nicht, dass Ankündigungen vollständig übersprungen werden, sondern eine sinnvolle benutzerfreundliche Benutzerfunktion bereitstellen möchten.In most cases, app developers do not allow advertisements to be entirely skipped over but do want to provide a reasonable experience for the user. Die folgenden beiden Optionen fallen den Anforderungen der meisten Entwickler an:The following two options fall within the needs of most developers:

  1. Ermöglicht Endbenutzern das Überspringen von Ankündigungs-Pods bei der Anzeige.Allow end-users to skip over advertisement pods at will.
  2. Erlauben Sie Benutzern das Überspringen von Ankündigungs-Pods, aber spielen Sie beim Fortsetzen der Wiedergabe den neuesten Pod.Allow users to skip over advertisement pods but play the most recent pod when playback resumes.

Die playskippedmedia -Eigenschaft hat die folgenden Bedingungen:The playSkippedMedia property has the following conditions:

  • Ankündigungen können nach Beginn der Ankündigung nicht mehr ausgelassen oder schnell weitergeleitet werden.Advertisements cannot be skipped or fast forwarded once the advertisement begins.
  • Alle Ankündigungen in einem Ankündigungs Pod werden wiedergegeben, sobald der Pod gestartet wurde.All advertisements in an advertisement pod will play once the pod has started.
  • Nach der Wiedergabe wird eine Ankündigung bei den primären Inhalten (Movie, Episode usw.) nicht wiedergegeben. Ankündigungs Marker werden als wiedergegeben markiert oder entfernt.Once played, an advertisement will not play again during the primary content (movie, episode, etc.); advertisement markers will be marked as played or removed.
  • Ankündigungen vor dem Rollout können nicht übersprungen werden.Pre-rollout advertisements cannot be skipped.

Wenn Sie Inhalte mit Werbung fortsetzen, legen Sie playskippedmedia auf false fest, um die vorab Ausführung zu überspringen und die Wiedergabe der letzten Werbepause zu verhindern.When resuming content that contains advertising, set playSkippedMedia to false to skip pre-rolls and prevent the most recent ad break from playing. Legen Sie playskippedmedia nach dem Start des Inhalts auf true fest, um sicherzustellen, dass die Benutzer nicht schnell durch nachfolgende anzeigen springen können.Then, after the content starts, set playSkippedMedia to true to ensure that users cannot fast-forward through subsequent ads.

Hinweis

Ein Pod ist eine Gruppe von Werbeeinblendungen, die in einer Sequenz wiedergegeben werden, wie z. b. eine Gruppe von WerbeeinblendungenA pod is a group of ads that play in a sequence, such as a group of ads that play during a commercial break. Weitere Informationen finden Sie in der Definition des IAB Digital Video Ad-diensvorlage (Vast).For more details, see the IAB Digital Video Ad Serving Template (VAST) specification.

requestTimeoutrequestTimeout

Diese Eigenschaft ruft die Anzahl der Millisekunden ab, die auf eine AD-Anforderungs Antwort gewartet werden soll, bevor ein Timeout auftritt Der Wert 0 teilt dem System mit, dass nie ein Timeout auftritt.This property gets or sets the number of milliseconds to wait for an ad request response before timing out. A value of 0 informs the system to never timeout. Der Standardwert ist 30000 MS (30 Sekunden).The default is 30000 ms (30 seconds).

scheduleschedule

Diese Eigenschaft ruft die Zeit Plan Daten ab, die vom AD-Server abgerufen wurden.This property gets the schedule data that was retrieved from the ad server. Dieses Objekt enthält die vollständige Daten Hierarchie, die der Struktur der Nutzlast Video Ad-Dienst Vorlage (Vast) oder Video Multiple AD Wiedergabeliste (VMAP) entspricht.This object includes the full hierarchy of data that corresponds to the structure of the Video Ad Serving Template (VAST) or Video Multiple Ad Playlist (VMAP) payload.

onadprogressonAdProgress

Dieses Ereignis wird ausgelöst, wenn die AD-Wiedergabe Quartil-Prüfpunkte erreicht.This event is raised when ad playback reaches quartile checkpoints. Der zweite Parameter des Ereignis Handlers (EventInfo) ist ein JSON-Objekt mit den folgenden Membern:The second parameter of the event handler (eventInfo) is a JSON object with the following members:

  • Status : derStatus der AD-Wiedergabe (einer der mediaprogress -Enumerationswerte, der in AdScheduler.js definiert ist).progress: The ad playback status (one of the MediaProgress enum values defined in AdScheduler.js).
  • Clip: der Videoclip, der wiedergegeben wird.clip: The video clip that is being played. Dieses Objekt ist nicht für die Verwendung im Code vorgesehen.This object is not intended to be used in your code.
  • adpackage: ein Objekt, das den Teil der AD-Nutzlast darstellt, der der wiedergegebenen Werbe Eingabe entspricht.adPackage: An object that represents the part of the ad payload that corresponds to the ad that is playing. Dieses Objekt ist nicht für die Verwendung im Code vorgesehen.This object is not intended to be used in your code.

onallcompleteonAllComplete

Dieses Ereignis wird ausgelöst, wenn der Hauptinhalt das Ende erreicht und alle geplanten postrollenads ebenfalls beendet werden.This event is raised when the main content reaches the end and any scheduled post-roll ads are also ended.

onerroreingetretenonErrorOccurred

Dieses Ereignis wird ausgelöst, wenn der adscheduler auf einen Fehler stößt.This event is raised when the AdScheduler encounters an error. Weitere Informationen zu den Fehlercode Werten finden Sie unter errorCode.For more information about the error code values, see ErrorCode.

onpodcountdownonPodCountdown

Dieses Ereignis wird ausgelöst, wenn eine Werbung abgespielt wird und angibt, wie viel Zeit im aktuellen Pod verbleibt.This event is raised when an ad is playing and indicates how much time remains in the current pod. Der zweite Parameter des Ereignis Handlers (EventData) ist ein JSON-Objekt mit den folgenden Membern:The second parameter of the event handler (eventData) is a JSON object with the following members:

  • restingadtime: die Anzahl von Sekunden, die für die aktuelle Werbeanzeige verbleiben.remainingAdTime: The number of seconds left for the current ad.
  • restingpodtime: die Anzahl von Sekunden, die für den aktuellen Pod verbleiben.remainingPodTime: The number of seconds left for the current pod.

Hinweis

Ein Pod ist eine Gruppe von Werbeeinblendungen, die in einer Sequenz wiedergegeben werden, wie z. b. eine Gruppe von WerbeeinblendungenA pod is a group of ads that play in a sequence, such as a group of ads that play during a commercial break. Weitere Informationen finden Sie in der Definition des IAB Digital Video Ad-diensvorlage (Vast).For more details, see the IAB Digital Video Ad Serving Template (VAST) specification.

onpodendonPodEnd

Dieses Ereignis wird ausgelöst, wenn ein Ad-Pod beendet wird.This event is raised when an ad pod ends. Der zweite Parameter des Ereignis Handlers (EventData) ist ein JSON-Objekt mit den folgenden Membern:The second parameter of the event handler (eventData) is a JSON object with the following members:

  • StartTime: die Startzeit des Pods in Sekunden.startTime: The pod's start time, in seconds.
  • Pod: ein Objekt, das den Pod darstellt.pod: An object that represents the pod. Dieses Objekt ist nicht für die Verwendung im Code vorgesehen.This object is not intended to be used in your code.

onpodstartonPodStart

Dieses Ereignis wird ausgelöst, wenn ein Ad-Pod gestartet wird.This event is raised when an ad pod starts. Der zweite Parameter des Ereignis Handlers (EventData) ist ein JSON-Objekt mit den folgenden Membern:The second parameter of the event handler (eventData) is a JSON object with the following members:

  • StartTime: die Startzeit des Pods in Sekunden.startTime: The pod's start time, in seconds.
  • Pod: ein Objekt, das den Pod darstellt.pod: An object that represents the pod. Dieses Objekt ist nicht für die Verwendung im Code vorgesehen.This object is not intended to be used in your code.