APIs des Google IMA DAI SDK

    1. google.ima.dai.api.Ad
    2. google.ima.dai.api.AdPodInfo
    3. google.ima.dai.api.AdProgressData
    4. google.ima.dai.api.CompanionAd
    5. google.ima.dai.api.CuePoint
    6. google.ima.dai.api.LiveStreamRequest
    7. google.ima.dai.api.StreamData
    8. google.ima.dai.api.StreamEvent
    9. google.ima.dai.api.StreamEvent.Type
    10. google.ima.dai.api.StreamManager
    11. google.ima.dai.api.StreamRequest
    12. google.ima.dai.api.VODStreamRequest
    13. google.ima.VERSION

Klasse google.ima.dai.api.Ad

Methoden

Eine Klasse, die ein Anzeigenobjekt während der dynamischen Anzeigenbereitstellung darstellt. Diese Klasse stellt eine Teilmenge der ima.Ad-Attribute bereit.

getAdId()


Rückgaben string:

getAdPodInfo()


Rückgaben google.ima.dai.api.AdPodInfo:

getAdSystem()


Rückgaben string:

getAdvertiserName()


Rückgaben string:

getApiFramework()


Rückgaben string:

getCompanionAds()


Rückgaben Array.<google.ima.dai.api.CompanionAd>:

getCreativeAdId()


Rückgaben string:

getCreativeId()


Rückgaben string:

getDealId()


Rückgaben string:

getDescription()


Rückgaben string:

getDuration()


Rückgaben number:

getTitle()


Rückgaben string:

getVastMediaHeight()


Rückgaben number:

getVastMediaWidth()


Rückgaben number:

getWrapperAdIds()


Rückgaben Array.<string>:

getWrapperAdSystems()


Rückgaben Array.<string>:

getWrapperCreativeIds()


Rückgaben Array.<string>:

Klasse google.ima.dai.api.AdPodInfo

Methoden

Eine Klasse, die ein Ad-Pod-Info-Objekt während der dynamischen Anzeigenbereitstellung darstellt. Diese Klasse macht eine Teilmenge der ima.AdPodInfo-Attribute verfügbar.

getAdPosition()


Rückgaben number:

getMaxDuration()


Rückgaben number:

getPodIndex()


Rückgaben number:

getTimeOffset()


Rückgaben number:

getTotalAds()


Rückgaben number:

Klasse google.ima.dai.api.AdProgressData

Fields

Eine Klasse zum Angeben von Daten zum Fortschritt von Anzeigen.

Attribute

Name Typ Beschreibung
adBreakDuration

adPosition

currentTime

duration

totalAds

Klasse google.ima.dai.api.CompanionAd

Methoden

Eine Klasse, die ein Companion-Anzeigenobjekt während der dynamischen Anzeigenbereitstellung darstellt. Diese Klasse stellt eine Teilmenge der ima.CompanionAd-Attribute bereit.

getAdSlotId()


Rückgaben string:

getContent()


Rückgaben string:

getContentType()


Rückgaben string:

getHeight()


Rückgaben number:

getWidth()


Rückgaben number:

Klasse google.ima.dai.api.CuePoint

Fields

Eine Klasse zum Angeben von Attributen eines Cuepoints, der eine Werbeunterbrechung in DAI-VOD-Streams darstellt.

Attribute

Name Typ Beschreibung
end

Die Endzeit für diesen Cuepoint.
played

Gibt an, ob dieser Cuepoint abgespielt wurde.
start

Die Startzeit für diesen Cuepoint.

Klasse google.ima.dai.api.LiveStreamRequest

Fields

Eine Klasse zum Angeben von Eigenschaften der Livestreamanfrage.

Konstruktor:
Parameter Typ Beschreibung
opt_liveStreamRequest Object

Objekt, dem bereits Eigenschaften für Streamanfragen zugewiesen sind.

Attribute

Name Typ Beschreibung
assetKey

Damit wird festgelegt, welcher Stream abgespielt werden soll. Der Asset-Schlüssel für Livestream-Anfragen ist eine Kennung, die auf der DFP-Benutzeroberfläche zu finden ist.

Klasse google.ima.dai.api.StreamData

Fields

Eine Klasse zum Angeben von Streamdaten.

Attribute

Name Typ Beschreibung
adProgressData

Zeitbezogene Informationen zur aktuell laufenden Anzeige.
cuepoints

Die Cuepoints für Anzeigen für den On-Demand-Stream. Diese können sich im Laufe des Streams ändern. Diese Variable wird nur im Ereignis-Listener für CUEPOINTS_CHANGED AdEvent ausgefüllt.
errorMessage

streamId

subtitles

url

Klasse google.ima.dai.api.StreamEvent

Methoden

Dieser Ereignistyp wird vom Stream-Manager als Benachrichtigung ausgelöst, wenn sich der Streamstatus ändert.

getAd()


Gibt google.ima.dai.api.Ad zurück:Gibt das Rückgabeobjekt mit Anzeigeninformationen zurück.

getStreamData()


Gibt google.ima.dai.api.StreamData zurück:Rückgabeobjekt mit Streaminformationen.

Enum google.ima.dai.api.StreamEvent.Type

Fields

Liste der vom IMA SDK unterstützten Ereignistypen.

Werte

Wert Beschreibung
AD_BREAK_ENDED

Wird ausgelöst, wenn ein Werbeunterbrechung endet.
AD_BREAK_STARTED

Wird ausgelöst, wenn eine Werbeunterbrechung beginnt
AD_PROGRESS

Wird ausgelöst, wenn es Neuigkeiten zum Fortschritt einer Anzeige gibt.
CLICK

Wird ausgelöst, wenn auf das Klickelement geklickt oder getippt wird, während eine Anzeige wiedergegeben wird.
COMPLETE

Wird ausgelöst, wenn eine Anzeige vollständig ausgeliefert wurde.
CUEPOINTS_CHANGED

Wird für On-Demand-Streams gesendet, wenn sich die Cuepoints ändern.
ERROR

Wird ausgelöst, wenn ein Fehler auftritt.
FIRST_QUARTILE

Wird ausgelöst, wenn eine Anzeige das erste Quartil erreicht.
LOADED

Wird ausgelöst, wenn das Streammanifest verfügbar ist.
MIDPOINT

Wird ausgelöst, wenn die Hälfte der Anzeige ausgeliefert wurde
STARTED

Wird ausgelöst, wenn eine Anzeige beginnt.
STREAM_INITIALIZED

Wird ausgelöst, wenn der Stream initialisiert wird.
THIRD_QUARTILE

Wird ausgelöst, wenn das dritte Quartil einer Anzeige erreicht wird.

Klasse google.ima.dai.api.StreamManager

Methoden

Verarbeitet Streams mit dynamischer Anzeigenbereitstellung. Es verwaltet die Interaktionen mit dem DAI-Backend und verarbeitet Tracking-Pings sowie die Weiterleitung von Stream- und Anzeigenereignissen an den Publisher. Dieser Manager erbt nicht von BaseAdsManager, da er kein Manager für eine bestimmte Anzeige, sondern für den gesamten Stream ist.

Konstruktor:
Parameter Typ Beschreibung
videoElement HTMLVideoElement

Das eigentliche Videoplayer-Element.

contentTimeForStreamTime(streamTime)

Gibt die Contentzeit ohne Anzeigen für eine bestimmte Streamzeit zurück. Gibt die angegebene Streamzeit für Livestreams zurück.

Rückgaben number:Die Inhaltszeit, die der angegebenen Streamzeit entspricht, nachdem Anzeigen entfernt wurden.

Parameter Typ Beschreibung
streamTime number

Die Stream-Zeit mit eingefügten Anzeigen (in Sekunden).

onTimedMetadata(metadata)

Übergibt ein Dictionary mit verarbeiteten Metadaten. Das Dictionary erwartet den Schlüssel „TXXX“ mit dem benutzerdefinierten Metadatenstring als Wert. Wenn dein Player Rohmetadaten bereitstellt, rufe stattdessen ima.dai.api.StreamManager.processMetadata auf.

Parameter Typ Beschreibung
metadata Object

Das Dictionary mit Metadaten.

previousCuePointForStreamTime(streamTime)

Gibt den vorherigen Cuepoint für die angegebene Streamzeit zurück. Gibt „null“ zurück, wenn kein solcher Cuepoint vorhanden ist. Diese Funktion wird verwendet, um Funktionen wie „Zurückspringen“ zu implementieren. Sie wird aufgerufen, wenn der Publisher erkennt, dass der Nutzer gesucht hat, um ihn zu einer Werbeunterbrechung zurückzubringen.

Gibt google.ima.dai.api.CuePoint zurück:den vorherigen Cuepoint für die angegebene Streamzeit.

Parameter Typ Beschreibung
streamTime number

Die Streamzeit, zu der gesucht wurde.

processMetadata(type, data, timestamp)

Verarbeitet zeitgesteuerte Metadaten für Livestreams. Verwenden Sie diese Funktion, wenn Ihr Videoplayer ungeparste Metadaten zusammen mit Zeitstempeln bereitstellt. Rufen Sie andernfalls ima.dai.api.StreamManager.onTimedMetadata auf.

Parameter Typ Beschreibung
type string

Typ für Metadaten. Muss „ID3“ sein.
data Uint8Array

Rohe Tag-Daten Bei ID3 muss es sich um das gesamte Tag handeln.
timestamp number

Zeitpunkt, zu dem die Daten verarbeitet werden sollen.

requestStream(streamRequest)

Fordert an, dass ein Stream mit den angegebenen Stream-Parametern geladen wird.

Parameter Typ Beschreibung
streamRequest google.ima.dai.api.StreamRequest

enthält Parameter zum Laden der Stream-Metadaten.

setClickElement(clickElement)

Legt das Element für die Weiterleitung nach dem Klick auf die Anzeige fest. Dieses Element wird als Empfänger für Klicks oder Berührungen verwendet, während eine Anzeige ausgeliefert wird. Es kann dazu führen, dass Nutzer von der aktuellen Seite weggeleitet werden.

Parameter Typ Beschreibung
clickElement Element

Das Element, das als Weiterleitung nach dem Klick auf die Anzeige verwendet wird.

streamTimeForContentTime(contentTime)

Gibt die Streamzeit mit Anzeigen für eine bestimmte Contentzeit zurück. Gibt die angegebene Inhaltszeit für Livestreams zurück.

Gibt number zurück:Die Streamzeit, die der angegebenen Contentzeit entspricht, nachdem Anzeigen eingefügt wurden.

Parameter Typ Beschreibung
contentTime number

Die Contentdauer ohne Anzeigen in Sekunden.

Klasse google.ima.dai.api.StreamRequest

Fields

Eine Klasse zum Angeben von Eigenschaften der Streamanfrage.

Attribute

Name Typ Beschreibung
adTagParameters

Sie können eine begrenzte Anzahl von Anzeigen-Tag-Parametern in Ihrer Streamanfrage überschreiben. Weitere Informationen zum Übertragen von Targeting-Parametern an einen Stream Mit den Parametern „dai-ot“ und „dai-ov“ können Sie die bevorzugte Streamvariante angeben. Weitere Informationen zum Überschreiben der Parameter von Streamvarianten
apiKey

Der API-Schlüssel für die Streamanfrage. Sie wird über die DFP Admin UI konfiguriert und dem Publisher zur Verfügung gestellt, damit er seine Inhalte entsperren kann. Es wird geprüft, welche Anwendungen auf die Inhalte zugreifen möchten.
streamActivityMonitorId

Die ID, die zum Debuggen des Streams mit der Überprüfung der Streamingaktivitäten verwendet werden soll. So können Publisher ganz einfach ein Streamlog im Tool zur Überprüfung der Streamingaktivitäten finden.

Klasse google.ima.dai.api.VODStreamRequest

Fields

Eine Klasse zum Angeben von Eigenschaften der VOD-Streamanfrage.

Konstruktor:
Parameter Typ Beschreibung
opt_VODStreamRequest Object

Objekt, dem bereits Streamanfrage-Attribute zugewiesen sind.

Attribute

Name Typ Beschreibung
contentSourceId

Eindeutige Kennung für die Publisher-Inhalte aus einem CMS. Erforderlich für On-Demand-Streams.
videoId

Kennung für die Quelle für Videocontent. Für On-Demand-Streams erforderlich.

Konstante google.ima.VERSION

Ein String mit der vollständigen Version des SDK.