YouTube DSGVO-konform einbetten

Eine Astro-Komponente, die YouTube erst nach einem Klick lädt: einmalig, zustimmen und merken oder nur der Link. Kein Cookie, kein Request an Google vorher.

Artikel Erstellt Aktualisiert Auch auf Englisch: A GDPR-Compliant YouTube Embed

Geprüft von adrian am

Ich wollte in einem Post auf meiner alten Seite ein YouTube-Video einbetten. Der übliche <iframe src="youtube.com/embed/…"> baut aber eine Verbindung zu Google auf, bevor der Leser irgendetwas geklickt hat: Cookies, Fingerprint, IP-Adresse, alles ohne Einwilligung. Ein Lehrbuchverstoß gegen die DSGVO.

Was ich brauchte:

  1. Vor dem Klick kein einziger Request an Google. Kein Thumbnail, kein Skript, gar nichts.
  2. Echte Einwilligung. Der Klick auf den Button ist die Zustimmung (Art. 6 Abs. 1 lit. a DSGVO).
  3. Wahlmöglichkeiten: einmalig anzeigen, zustimmen und merken oder einfach nur der Link. Kein Cookie, höchstens ein localStorage-Eintrag für die Entscheidung.

Heraus kam eine kleine Astro-Komponente nach einem Muster, das ich bei zeit.de abgeschaut habe.

Die Komponente

src/components/YouTubeEmbed.astro:

---
import { getLocaleFromUrl, t } from '~/i18n/ui';
interface Props { id: string; title?: string }
const { id, title } = Astro.props;
const locale = getLocaleFromUrl(Astro.url);
const privacyHref = locale === 'de' ? '/datenschutz/' : '/en/privacy-policy/';
const youtubeUrl = `https://www.youtube.com/watch?v=${id}`;
---

<figure class="youtube-embed">
  <div class="yt-consent" data-id={id} data-title={title ?? ''}>
    <h3>{t(locale, 'youtube.externalContent')}</h3>
    <p>{t(locale, 'youtube.description')}</p>
    <p>
      {t(locale, 'youtube.serviceName')}
      {title && <><br /><strong>{title}</strong></>}
    </p>
    <div class="yt-consent-buttons">
      <button type="button" data-remember="true">{t(locale, 'youtube.loadVideoRemember')}</button>
      <button type="button">{t(locale, 'youtube.loadVideo')}</button>
      <a href={youtubeUrl} target="_blank" rel="noopener noreferrer">{t(locale, 'youtube.watchOnYouTube')}</a>
    </div>
    <p class="footer">
      {t(locale, 'youtube.consentFooter')}
      <a href={privacyHref}>{t(locale, 'youtube.privacyLink')}</a>.
    </p>
  </div>
</figure>

Ein kleines Skript tauscht den Platzhalter beim Klick gegen einen <iframe> auf youtube-nocookie.com:

<script>
  const CONSENT_KEY = 'yt-consent';

  function buildIframe(id, title, autoplay) {
    const iframe = document.createElement('iframe');
    iframe.src = `https://www.youtube-nocookie.com/embed/${id}?rel=0${autoplay ? '&autoplay=1' : ''}`;
    iframe.allow = 'autoplay; encrypted-media; picture-in-picture; fullscreen';
    iframe.allowFullscreen = true;
    iframe.loading = 'lazy';
    iframe.referrerPolicy = 'strict-origin-when-cross-origin';
    if (title) iframe.title = title;
    return iframe;
  }

  const hasConsent = (() => {
    try { return localStorage.getItem(CONSENT_KEY) === '1'; } catch { return false; }
  })();

  document.querySelectorAll('.yt-consent').forEach((container) => {
    const { id, title } = container.dataset;
    if (!id) return;
    if (hasConsent) {
      container.replaceWith(buildIframe(id, title, false));
      return;
    }
    container.querySelectorAll('button').forEach((button) => {
      button.addEventListener('click', () => {
        if (button.dataset.remember === 'true') {
          try { localStorage.setItem(CONSENT_KEY, '1'); } catch {}
        }
        container.replaceWith(buildIframe(id, title, true));
      });
    });
  });
</script>

Drei Details:

  • youtube-nocookie.com statt youtube.com, der erweiterte Datenschutzmodus. Er speichert erst bei der Wiedergabe Daten und setzt keine Personalisierungs-Cookies.
  • localStorage statt Cookie. Die Entscheidung bleibt im Browser und geht nie an einen Server. Nach ePrivacy-Regeln gilt das als unbedingt erforderlich, weil es die Einwilligung selbst speichert und kein Tracking.
  • Direkter Austausch bei vorhandener Einwilligung. Wer „merken“ geklickt hat, sieht bei späteren Besuchen gleich den iframe, aber ohne autoplay. Niemand mag Videos, die ungefragt losspielen.

Texte in zwei Sprachen

Die Strings liegen in src/i18n/ui.ts, je Sprache ein Satz:

'youtube.externalContent': 'Externer Inhalt',
'youtube.description': 'An dieser Stelle findest du einen externen Inhalt von youtube.com, der den Artikel ergänzt.',
'youtube.serviceName': 'YouTube Video Player (youtube.com)',
'youtube.loadVideo': 'Einmalig anzeigen',
'youtube.loadVideoRemember': 'Zustimmen und merken',
'youtube.watchOnYouTube': 'Auf YouTube ansehen',
'youtube.consentFooter': 'Ich bin damit einverstanden, dass mir externe Inhalte angezeigt werden. Damit können personenbezogene Daten an Drittanbieter übermittelt werden. Mehr dazu in der',
'youtube.privacyLink': 'Datenschutzerklärung',

getLocaleFromUrl(Astro.url) liest die Sprache aus dem Pfad. Deutsch und Englisch laufen damit ohne weiteren Code.

Die CSP anpassen

Meine strikte CSP in Caddy blockte jeden externen iframe. Die Einbettung brauchte deshalb eine gezielte Freigabe:

- frame-ancestors 'none';
+ frame-src https://www.youtube-nocookie.com; frame-ancestors 'none';

img-src muss nicht erweitert werden, weil der Platzhalter keine Bilder von Google lädt. Kein Thumbnail, kein Request an Google vor der Einwilligung: Darum geht es bei der ganzen Konstruktion.

Error 153 und die Referrer-Policy

Der erste Test zeigte Error 153: Fehler bei der Konfiguration des Videoplayers, auch bei Videos, die das Einbetten erlauben.

Die Ursache war meine seitenweite Referrer-Policy: no-referrer. YouTube prüft am Referrer, von welcher Domain der iframe kommt. Ohne Referrer keine Prüfung, und es bleibt ein allgemeiner Error 153.

Die Lösung sitzt am iframe: referrerPolicy = 'strict-origin-when-cross-origin'. YouTube sieht dann nur https://adrian-altner.de ohne Pfad. Ein vertretbarer Kompromiss, und die Prüfung klappt.

Datenschutzerklärung

Die Datenschutzerklärung bekam einen eigenen Abschnitt „Video-Einbettungen (YouTube)“. Er beschreibt die drei Wahlmöglichkeiten und den localStorage-Eintrag yt-consent=1 (kein Cookie, nur lokal, nur die Entscheidung). Dazu kommen die Rechtsgrundlage Art. 6 Abs. 1 lit. a DSGVO und der Transfer in die USA über Standardvertragsklauseln. Heute ist Google LLC unter dem EU-US Data Privacy Framework zertifiziert.1

Die Demo

Der Beitrag zeigte die Komponente live mit einem Cover von „Sweet Child O' Mine“ der OZONE Band. Darunter standen eine Callout-Box mit den Links der Band und eine Google-Maps-Einbettung des Naka Weekend Market auf Phuket. Mit offenem Netzwerk-Tab im Browser siehst du vor dem Klick keinen einzigen Request an google.com, ytimg.com oder googlevideo.com. Erst nach dem Klick lädt der iframe, und auch dann nur von youtube-nocookie.com.

Umfang

Keine Consent-Bibliothek, kein Banner, kein Cookie. Eine Komponente mit rund 100 Zeilen Astro, ein Skript-Block, zwei CSP-Zeilen in Caddy und ein Abschnitt in der Datenschutzerklärung. Für gelegentliche Videos in einem Blog war das die passende Größe zwischen vollständiger Einwilligungs-Infrastruktur und Ignorieren.

Beruht auf

  • YouTube-Videos DSGVO-konform einbetten: dreistufige Consent-Box ohne Cookie (raw/2026/2026-04-24/youtube-videos-dsgvo-konform-einbetten-dreistufige-consent-box-ohne-cookie.md) [post]
  • Google: Legal frameworks for data transfers [dpf]

Mehr dazu

Thema

  • Statische Website Eine Website aus fertigen HTML-Dateien, die einmal gebaut und dann unverändert ausgeliefert werden. Kein Servercode, keine Datenbank.
  • Webentwicklung Wie diese und andere Websites entstehen und gefunden werden: statische Seiten, Suchmaschinen, IndieWeb und Karten im Browser.

Grundlage für

  • Google Maps DSGVO-konform einbetten Eine Astro-Komponente, die Google Maps erst nach Zustimmung lädt, die Entscheidung in localStorage merkt und aus Koordinaten Links zu Google und Apple Maps baut.

Baut auf

  • Security-Header in Caddy Eine strikte Content Security Policy, HSTS und no-referrer in einem Caddy-Siteblock, geprüft mit Webbkoll, securityheaders.com und dem Mozilla Observatory.

Nutzt

  • Caddy Webserver und Reverse Proxy, der TLS-Zertifikate selbst holt und erneuert, eingerichtet in einem kurzen Caddyfile.

Erwähnt in

  • Eine Callout-Komponente für Astro Eine wiederverwendbare Hinweisbox für Astro mit Info, Note und Warning, optionalem Titel, Social-Links und einer Mitglieder-Sektion mit Links pro Person.

In der Graph-Ansicht zeigen