Anfragen für Videostreams der dynamischen Anzeigenbereitstellung authentifizieren

Mit Authentifizierungsschlüsseln für die dynamische Anzeigenbereitstellung wird nachgewiesen, dass Anfragen für Videostreams von Ihnen stammen. Dadurch wird die Sicherheit bei der Anzeigenbereitstellung erhöht. Jeder Schlüssel ist ein String aus 64 Zeichen und Ziffern ohne Leerzeichen. Einige ältere Schlüssel bestehen möglicherweise aus 25 Zeichen und Ziffern.

Beispiel

0L94DEA6C87B0F3D2407018ACF88ECDE77DK38AD1DX01957311A50E9D1O3F15B

Statische API-Schlüssel: API-Schlüssel haben Vorrang vor HMAC-Schlüsseln, wenn beide enthalten sind. API-Schlüssel sind nicht so sicher wie HMAC-Schlüssel. Deshalb wird die Verwendung von HMAC-Schlüsseln empfohlen.

HMAC: HMAC-basierte Tokenauthentifizierung bietet mehr Sicherheit als statische API-Schlüssel. Bei einem HMAC-Token wird ein geheimer Schlüssel eingesetzt und die Gültigkeitsdauer begrenzt. So kann es nicht einfach für andere Nutzer oder Sitzungen verwendet werden.

Tipp: Bevor Sie Streamanfragen authentifizieren, sollten Sie kontrollieren, dass Folgendes vorhanden ist:

• Authentifizierungsschlüssel für die dynamische Anzeigenbereitstellung vom Typ HMAC
• Für die dynamische Anzeigenbereitstellung konfigurierter Livestream

Neuen HMAC-Authentifizierungsschlüssel für die dynamische Anzeigenbereitstellung hinzufügen

So generieren Sie einen neuen Authentifizierungsschlüssel für die dynamische Anzeigenbereitstellung vom Typ „HMAC“ und fügen ihn hinzu:

1. Melden Sie sich in Google Ad Manager an.
2. Klicken Sie auf Admin und dann auf Video und Audio.
3. Wählen Sie „Authentifizierungsschlüssel für die dynamische Anzeigenbereitstellung“ aus.
4. Klicken Sie auf Neuer Authentifizierungsschlüssel für die dynamische Anzeigenbereitstellung.
5. Geben Sie den Namen des neuen Schlüssels ein. Wählen Sie den Typ „HMAC“ aus.
6. Klicken Sie auf Speichern.

Dieser Schlüssel wird in Ihrem Livestream verlinkt, wenn Sie die Authentifizierung aktivieren.

Authentifizierung für Anfragen an APIs für die dynamische Anzeigenbereitstellung aktivieren

So verknüpfen Sie Ihren HMAC-Schlüssel mit Ihrem Stream:

1. Melden Sie sich in Google Ad Manager an.
2. Klicken Sie auf Video und dann auf Livestreams.
3. Wählen Sie Ihren Livestream aus der Liste aus oder klicken Sie auf Neuer Livestream. Weitere Informationen zum Erstellen eines neuen Livestreams
4. Unter „Allgemeine Einstellungen“:
   1. Wählen Sie für „Authentifizierungsschlüssel für Pod-Ressource“ die Option „Aktiviert“ aus, um Anfragen für Anzeigen-Pods zu authentifizieren und/oder
   2. Wählen Sie für „Authentifizierungsschlüssel für das Erstellen des Streams“ die Option „Aktiviert“ aus, um Stream-Sitzungsanfragen zu authentifizieren.
5. Wählen Sie den von Ihnen erstellten HMAC-Schlüssel aus.
6. Klicken Sie auf Speichern.

Wenn Sie den Schlüssel aufrufen oder kopieren möchten, müssen Sie zur Detailseite zurückkehren. Nachdem Sie einen aktiven Authentifizierungsschlüssel für die dynamische Anzeigenbereitstellung generiert haben, können Sie diesen sofort verwenden. Betten Sie den Schlüssel in die Client-Video-App ein, in der Sie Streamanfragen für die dynamische Anzeigenbereitstellung stellen.

Tipp: Es empfiehlt sich, für jede Ihrer Clientplattformen (z. B. iOS, Android und Web) separate Authentifizierungsschlüssel für die dynamische Anzeigenbereitstellung zu generieren.

Schlüssel werden beim Speichern automatisch auf „Aktiv“ gesetzt. Nur mit korrekt implementierten aktiven Schlüsseln können Anfragen validiert werden.

Anfragen mit deaktivierten Schlüsseln werden abgelehnt. Deaktivieren Sie einen Schlüssel nur, wenn er manipuliert wurde oder wirklich nicht mehr verwendet werden soll.

Vorhandenen Authentifizierungsschlüssel deaktivieren

So deaktivieren Sie einen Authentifizierungsschlüssel:

1. Melden Sie sich in Google Ad Manager an.
2. Klicken Sie auf Admin, Video und Audio und dann auf „Authentifizierungsschlüssel für die dynamische Anzeigenbereitstellung“.
3. Wählen Sie in der Liste den Schlüssel aus, den Sie deaktivieren möchten.
4. Wählen Sie den Status „Inaktiv“ aus.
5. Klicken Sie auf Speichern.

Authentifizierungsschlüssel implementieren

HMAC-Schlüssel

HMAC-Authentifizierung implementieren

API-Schlüssel

Definieren Sie mithilfe des IMA SDKs die apiKey-Eigenschaft im IMAStreamRequest-Objekt. Weitere Informationen finden Sie in der Entwicklerdokumentation für iOS, Android, Chromecast oder tvOS.

Beim serverseitigen Beaconing (SSB) verwenden Sie den Abfrageparameter api-key:

curl "https://dai.google.com/ondemand/hls/content/CMS_ID/vid/VIDEO_ID/master.m3u8?api-key=<api-authentication-key>"

Wenden Sie sich bei Problemen oder Ausfällen bei der dynamischen Anzeigenbereitstellung an den Publisher-Support.