Überspringbare Anzeigen in VOD-Streams aktivieren

In dieser Anleitung wird gezeigt, wie du mit der DAI API einen VOD-Stream mit überspringbaren Anzeigen anforderst, die Schaltfläche zum Überspringen gemäß den Google Ads-Anforderungen rendern und die zugehörigen Tracking-Ereignisse sendest.

Vorbereitung

• Eine App, die DAI API-Aufrufe für VOD-Streams implementiert. Weitere Informationen findest du unter DAI-VOD-Streams anfordern.

Überspringbare Anzeigen anfordern

Wenn du einen VOD-Stream mit überspringbaren Anzeigen anfordern möchtest, musst du den Parameter dai-sas in deiner 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 in der URL für DASH-Streams 'dash' durch:

https://dai.google.com/ondemand/v1/dash/content/{CMS_ID}/vid/{VIDEO_ID}/stream

Verwenden Sie das folgende Format, um mehrere Streamparameter in den Anfragetext aufzunehmen:

-d 'dai-sas=1&cust_params=key1%3dvalue1%26key2%3dvalue2' \

Überspringen von Anzeigen

Verwende zum Überspringen von Anzeigen die Informationen in der Struktur Ad oder AdBreak, je nachdem, ob du die aktuelle Anzeige oder die gesamte Werbeunterbrechung überspringst. Addiere den Wert start zum Wert duration und suche dann zu diesem Punkt im Stream. Die Unternachricht SkipMetadata enthält außerdem den Wert offset, der die Zeit in Sekunden angibt, bevor die Anzeige übersprungen werden kann. Die Unternachricht SkipMetadata wird nur in Anzeigen eingeschlossen, die übersprungen werden können.

ad_breaks

Eine Liste der Werbeunterbrechungen. start (number): Position im Stream, an der die Werbeunterbrechung beginnt, in Sekunden. duration (Zahl) Dauer der Werbeunterbrechung in Sekunden. ads (object(Anzeigen)) Eine Liste der Anzeigen im Stream. start (Zahl) Die Position im Stream, an der die Anzeige beginnt, in Sekunden. duration (Zahl) Dauer der Anzeige in Sekunden. skip_metadata (object(SkipMetadata)) Optionale Metadaten für überspringbare Anzeigen. Wenn diese Option festgelegt ist, gibt sie an, dass die Anzeige übersprungen werden kann. Außerdem enthält sie eine Anleitung zum Umgang mit der Benutzeroberfläche zum Überspringen und zum Tracking-Ereignis. offset (Zahl): Der Versatz gibt an, wie viele Sekunden nach Beginn der Anzeige der Player warten soll, bevor er die Schaltfläche „Überspringen“ rendert. Wird weggelassen, wenn sie nicht im VAST-Dokument angegeben ist. tracking_url (String) Eine URL, die beim Überspringen des Videos angepingt werden soll.

Beispielantwort

{
  ...
  "ad_breaks":[
    {
      ...
      "start":0,
      "duration":10,
      "ads":[
        {
          ...
          "start":0,
          "duration":10,
          "skip_metadata":{
            "offset": 5,
            "tracking_url": "https://example_skip_url.com"
          }
        }
    }
}

Sobald die Anzeige übersprungen wurde, pinge die URL des Überspringereignisses, die in der Streamantwort enthalten ist. Es ist in der SkipMetadata-Unternachricht enthalten.

Anforderungen an die Schaltfläche „Überspringen“

Bei überspringbaren Anzeigen muss die Schaltfläche zum Überspringen die folgenden Designanforderungen erfüllen. Wenn Sie diese Anforderungen nicht einhalten, kann die Auslieferung von Google-Anzeigen auf Ihrer Website oder in Ihrer App eingeschränkt werden.

Countdown-Timer

Die Anzeige darf erst nach der im VAST-Dokument angegebenen Zeit skipoffset übersprungen werden. Während dieser Zeit, in der die Anzeige nicht übersprungen werden kann, muss dem Nutzer eine Benachrichtigung angezeigt 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“

Bei einer Sprache, die von links nach rechts geschrieben wird, platziere die Schaltfläche „Überspringen“ rechts unten im Videoplayer. Bei einer Sprache, die von rechts nach links geschrieben wird, platziere die Schaltfläche „Überspringen“ links unten im Videoplayer.

Größe der Schaltfläche „Überspringen“

Die Schaltfläche und der Text müssen groß genug sein, um auch bei entspannter Nutzung 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 Ikon verwenden.

Bedienungshilfen

Nutzer sollten die Schaltfläche „Überspringen“ mit einer Tastatur oder Fernbedienung aufrufen können. Die App sollte den Fokus auf die Schaltfläche „Überspringen“ legen, sobald der Countdown abgelaufen ist.

Internationalisierung

Wir empfehlen, den Text zum Überspringen 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 für „Werbung überspringen“

Verwenden Sie die skipAdTranslations.json-Datei, um den Text „Anzeige überspringen“ basierend auf dem Gebietsschema des Nutzers zu übersetzen.