In diesem Leitfaden erfahren Sie, wie Sie mit der DAI API einen VOD-Stream mit überspringbaren Anzeigen anfordern, die Schaltfläche „Überspringen“ gemäß den Google Ads-Anforderungen rendern und die zugehörigen Tracking-Ereignisse senden.
Voraussetzungen
- Eine App, die DAI API-Aufrufe für VOD-Streams implementiert. Weitere Informationen finden Sie in der DAI API-VOD-Streamanleitung.
Anfrage für überspringbare Anzeigen senden
Wenn Sie einen VOD-Stream mit überspringbaren Anzeigen anfordern möchten, müssen Sie den Parameter dai-sas
in der Streamanfrage übergeben.
API-Endpunkt
POST: /ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Host: dai.google.com
Content-Type: application/x-www-form-urlencoded
Pfadparameter
{CMS_ID} |
Die CMS-ID des Streams. |
{VIDEO_ID} |
Die Video-ID des Streams. |
Körperparameter
dai-sas |
Legen Sie dai-sas=1 fest, um überspringbare Anzeigen zu aktivieren.
|
Beispielanfrage (cURL)
Für HLS-Streamanfragen:
curl -X POST \
-d 'dai-sas=1' \
-H 'Content-Type: application/x-www-form-urlencoded' \
https://dai.google.com/ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Ersetzen Sie 'dash'
in der URL für DASH-Streams:
https://dai.google.com/ondemand/v1/dash/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Verwenden Sie das folgende Format, um mehrere Streamparameter in den Text Ihrer Anfrage aufzunehmen:
-d 'dai-sas=1&cust_params=key1%3dvalue1%26key2%3dvalue2' \
Umgang mit übersprungenen Anzeigen
Wenn Anzeigen übersprungen werden sollen, verwenden Sie entweder die Informationen in der Struktur Ad
oder AdBreak
, je nachdem, ob Sie die aktuelle Anzeige oder die gesamte Werbeunterbrechung überspringen.
Nehmen Sie den Wert start
, fügen Sie den Wert duration
hinzu und springen Sie dann zu diesem Punkt im Stream. Die untergeordnete Meldung SkipMetadata
enthält auch den Wert offset
. Dies ist ein Wert in Sekunden der Zeit, bevor die Anzeige übersprungen werden kann. Die Untermitteilung SkipMetadata
wird nur in Anzeigen eingefügt, die überspringbar sind.
ad_breaks |
Eine Liste der Werbeunterbrechungen.
|
Beispielantwort
{
...
"ad_breaks":[
{
...
"start":0,
"duration":10,
"ads":[
{
...
"start":0,
"duration":10,
"skip_metadata":{
"offset": 5,
"tracking_url": "https://example_skip_url.com"
}
}
}
}
Nachdem die Anzeige übersprungen wurde, pinge die URL des Überspringens an, die in der Stream-Antwort enthalten ist.
Sie ist in der untergeordneten Meldung SkipMetadata
enthalten.
Anforderungen an die Schaltfläche „Überspringen“
Bei überspringbaren Anzeigen muss die Schaltfläche „Überspringen“ gemäß den folgenden Designanforderungen gerendert werden. Andernfalls kann die Auslieferung von Google Anzeigen auf Ihrer Website oder in Ihrer App eingeschränkt werden.
Countdown-Timer
Die Anzeige darf erst überspringbar sein, wenn der skipoffset
-Wert in der VAST-Datei angegeben ist.
Während des Zeitraums, in dem die Anzeige nicht übersprungen werden kann, muss der Nutzer mit einem Hinweis darauf hingewiesen werden, dass die Anzeige in X Sekunden übersprungen werden kann. Der Hinweis muss in die Sprache des Nutzers übersetzt werden.
Position der Schaltfläche „Überspringen“
Wenn du rechtsläufige Sprachen angeben möchtest, platziere die Schaltfläche „Überspringen“ rechts unten im Videoplayer. Wenn die Sprache von rechts nach links gelesen werden soll, platziere die Schaltfläche „Überspringen“ unten links im Videoplayer.
Größe der Schaltfläche „Überspringen“
Schaltfläche und Text müssen groß genug sein, um in einer entspannten Umgebung gut lesbar zu sein.
Text und Symbol
Die Schaltfläche „Überspringen“ muss sowohl Text als auch Symbole enthalten. Sie können das Symbol „Nächstes Material überspringen“ als Symbole verwenden.
Bedienungshilfen
Der Nutzer sollte über eine Tastatur oder Fernbedienung zur Schaltfläche „Überspringen“ gehen können. Sobald der Countdown abgeschlossen ist, sollte die App die Schaltfläche „Überspringen“ hervorheben.
Internationalization
Es empfiehlt sich, den Überspringentext in die Sprache des Nutzers zu übersetzen.
Anzeigen-Pods
Mit der Schaltfläche "Überspringen" können Sie entweder die aktuelle Anzeige im Anzeigen-Pod oder den gesamten Pod überspringen.
Übersetzungen mit „Anzeige überspringen“
Verwenden Sie die Datei skipAdTranslations.json
, um den Text „Anzeige überspringen“ in die Sprache des Nutzers zu übersetzen.