Überspringbare Anzeigen im VOD-Stream

In diesem Leitfaden wird gezeigt, wie Sie mithilfe der DAI API einen VOD-Stream mit überspringbare Anzeigen verwenden, wird die Schaltfläche zum Überspringen Anforderungen für Google Ads und die zugehörigen Tracking-Ereignisse senden.

Vorbereitung

Anfrage für überspringbare Anzeigen senden

Wenn du einen VOD-Stream mit überspringbaren Anzeigen anfordern möchtest, musst du die dai-sas übergeben. in Ihrem Streamanfrage ansehen.

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:

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

Umgang mit übersprungenen Anzeigen

Um das Überspringen von Anzeigen zu handhaben, verwenden Sie die Informationen im Ad Struktur oder AdBreak je nachdem, ob Sie die aktuelle Anzeige oder die gesamte Werbeunterbrechung überspringen. Addieren Sie den Wert start, addieren Sie den Wert duration und springen Sie dann zu diesem Punkt in in den Stream aufnehmen. Die SkipMetadata enthält auch den Wert offset, der ein Wert in bis die Anzeige übersprungen werden kann. Die untergeordnete SkipMetadata-Nachricht nur in Anzeigen enthalten, 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 beginnt, in Sekunden.
duration (number) Die Dauer der Anzeige in Sekunden.
skip_metadata (object(SkipMetadata)) Optionale Metadaten für überspringbare Anzeigen. Wenn festgelegt, ist die Anzeige überspringbar und enthält für die Verarbeitung der Benutzeroberfläche zum Überspringen und das Tracking-Ereignis.
offset (Zahl) Der Offset gibt die Dauer in Sekunden nach der Wiedergabe muss der Player warten, bis die Anzeige Schaltfläche „Überspringen“. Ausgelassen, wenn sie nicht in der VAST-Antwort angegeben sind.
tracking_url (String) Eine URL, die beim Überspringen gepingt 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 die Schaltfläche „Überspringen“ mit folgendem Design rendern Anforderungen. Die Nichteinhaltung dieser Anforderungen kann Einschränkungen zur Folge haben die in Google Anzeigen platziert werden, die auf Ihrer Website oder in Ihrer App ausgeliefert 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 Anzeigen nicht übersprungen werden können, muss der Nutzer einen entsprechenden Hinweis einblenden. dass die Anzeige in X Sekunden übersprungen werden kann. Die Mitteilung muss in folgende Sprache übersetzt werden: Sprache der Nutzenden.

Position der Schaltfläche „Überspringen“

Wenn Sie rechtsläufige Sprachen verwenden möchten, platzieren Sie die Schaltfläche „Überspringen“ auf der rechten unteren Videoplayer. Bei Sprachen mit Textrichtung von rechts nach links platzieren Sie die Schaltfläche "Überspringen" auf der untere linke Seite des Videoplayers.

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

Die Schaltfläche und der Text müssen groß genug sein, um in einem leichten, leicht lesbaren Bereich gut lesbar zu sein. Nutzererfahrung.

Text und Symbol

Die Schaltfläche „Überspringen“ muss sowohl Text als auch Symbole enthalten. Sie können die Symbol zum Überspringen des nächsten Materials als Symbol verwenden.

Bedienungshilfen

Die Nutzenden sollten in der Lage sein, über eine Tastatur oder Fernbedienung verwenden. Sobald der Countdown abgelaufen ist, sollte in der App die Schaltfläche „Überspringen“ eingeblendet werden. abgeschlossen ist.

Internationalisierung

Wir empfehlen, den Überspringentext in die Sprache des Nutzers zu übersetzen.

Anzeigen-Pods

Mit der Schaltfläche "Überspringen" kann entweder die aktuelle Anzeige im Anzeigen-Pod übersprungen oder des gesamten Pods.

„Werbung überspringen“ Übersetzungen

Verwenden Sie die Datei skipAdTranslations.json zur Übersetzung von "Anzeige überspringen" Text basierend auf der Sprache des Nutzers.