Überspringbare Anzeigen im VOD-Stream

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

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.
start (Zahl) Position im Stream, an dem die Pause beginnt (in Sekunden)
duration (Zahl) Die Dauer der Werbeunterbrechung in Sekunden.
ads (object(Ad)) Eine Liste der Anzeigen im Stream.
start (Zahl) Position im Stream, in dem die Anzeige startet (in Sekunden).
duration (number) Die Dauer der Anzeige in Sekunden.
skip_metadata (object(SkipMetadata)) Optionale Metadaten für überspringbare Anzeigen. Wenn festgelegt, bedeutet dies, dass die Anzeige überspringbar ist und wie die UI für das Überspringen und das Tracking-Ereignis verarbeitet werden.
offset (number) Offset gibt die Zeit in Sekunden an, die der Player bis zum Rendern der Schaltfläche „Überspringen“ warten soll. Ausgelassen, wenn sie nicht in der VAST-Antwort angegeben sind.
tracking_url (String) Eine URL, die beim Überspringen-Ereignis 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"
          }
        }
    }
}

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.