Dokumentation · Anleitung

Direktlink & Einbettungscode

Nach dem Veröffentlichen teilen Sie Ihr Projekt als Direktlink oder betten es auf Ihrer Website ein. Der empfohlene Code wählt auf Smartphones automatisch das Hochformat.

  1. Öffnen Sie das Fenster „Video teilen“: im Editor über „Teilen“ (erscheint nach dem Veröffentlichen) oder unter Interaktive Videos an der Projektkachel über „Teilen & Einbetten“.
  2. Direkter Link
    Mit „Link kopieren“ erhalten Sie die Adresse …/watch/… für E-Mail, Messenger oder soziale Netzwerke.
  3. Einbetten
    Wählen Sie unter „Einbettungsoptionen“ die „Art der Einbettung“ und das „Format“ und klicken Sie auf „Einbettungscode kopieren“.
  4. Fügen Sie den Code in Ihre Website ein – als HTML-Block im Seiteninhalt. Für die empfohlene Art muss der Block Skripte erlauben.

Art der Einbettung

OptionWann sie passt
Automatisch mit Skript (empfohlen)Ein iFrame plus das kleine Skript embed.js. Es passt die Höhe an und wählt das Format: „Automatisch: Hochformat auf Handys, sonst Querformat“, „Immer Querformat“ oder „Immer Hochformat“. Dreht jemand das Gerät, läuft das Video an derselben Stelle weiter.
Ohne Skript: zwei iFramesFür Websites, die kein fremdes JavaScript erlauben. Per CSS sehen Handys im Hochformat die Hochkant-Fassung, alle anderen das Querformat. Nur bei Projekten mit Hochformat.
Fester Rahmen (bisheriger Code)Der bisherige Code mit festem „Seitenverhältnis“: 16:9, 9:16, 4:3, 21:9 oder 1:1. Bestehende Einbettungen mit diesem Code funktionieren weiter.

Empfohlener Einbettungscode

Beispiel für ein Projekt ohne Hochformat. Den Code für Ihr Projekt kopieren Sie im Fenster „Video teilen“ – hat das Projekt ein Hochformat, enthält er zusätzlich einen kurzen Stilblock.

HTML
<iframe
  src="https://www.klickplayer.de/embed/IHRE-PROJEKT-ID"
  title="Ihr Videotitel"
  data-klickplayer="IHRE-PROJEKT-ID"
  style="width:100%;aspect-ratio:16/9;max-width:calc(90vh * 16/9);max-width:calc(90svh * 16/9);margin:0 auto;border:0;display:block;color-scheme:normal"
  allow="autoplay; fullscreen; picture-in-picture; encrypted-media"
  allowfullscreen
  loading="lazy"
></iframe>
<script src="https://www.klickplayer.de/embed.js" async></script>

Nützliche Parameter

  • Personalisieren: ?vorname=Erika am Direktlink füllt Platzhalter wie {{vorname}}. Bei Einbettungen gehört der Parameter an die Adresse im iFrame (…/embed/…?vorname=Erika).
  • Startzeit: ?t=30 startet das Video bei Sekunde 30.
  • A/B-Test: ?variant=B zeigt gezielt Variante B.

Tipps aus der Praxis

  • Nach dem Veröffentlichen erscheinen gespeicherte Änderungen automatisch in allen Einbettungen – Sie müssen den Code nicht neu einfügen.
  • In WordPress, Webflow & Co. verwenden Sie einen „HTML“- bzw. „Code Embed“-Block.
  • Haben Sie die Nutzungsanalyse eingeschaltet, braucht der eingebettete Player die Einwilligung Ihrer Besucher (siehe „Datenschutz & DSGVO“).
  • Für einen persönlichen Link je Empfänger nutzen Sie den Einbettungscode einer Kampagne.

Noch kein Konto? Testzugang starten