Lorixen.
DE

Eingefügter Link wird nicht eingebettet: oEmbed verstehen

Kurz gesagt: Wenn Sie in Ihr Redaktionssystem einen Link zu einem Video, einem Beitrag oder einer Karte einfügen und statt einer hübschen Einbettung nur ein blauer Link erscheint, steckt meist oEmbed dahinter. oEmbed ist ein offenes Format, mit dem eine Website bei einem Anbieter nachfragt, wie ein Link eingebettet werden soll. Laut der Spezifikation auf oembed.com schickt das System dafür eine Anfrage mit der Adresse an einen Endpunkt des Anbieters und bekommt Titel, Typ und meist fertigen Einbettungscode zurück. Klappt das nicht, weil der Anbieter keinen Endpunkt hat, ihn geschlossen hat oder Ihr System ihn nicht kennt, bleibt es beim Link. Die gute Nachricht: Mit diesem Wissen finden Sie schnell heraus, ob ein Fehler bei Ihnen liegt oder beim Anbieter.

Wie oEmbed funktioniert

Die Spezifikation beschreibt zwei Seiten: den Anbieter, etwa eine Video- oder Fotoplattform, und den Konsumenten, also Ihr Redaktionssystem. Der Ablauf:

  1. Sie fügen eine Adresse ein, etwa die Seite eines Videos.
  2. Ihr System erkennt, zu welchem Anbieter die Adresse gehört, und fragt dessen oEmbed-Endpunkt an. Die Adresse wird dabei als Parameter url übergeben, optional mit maxwidth und maxheight.
  3. Der Anbieter antwortet mit Angaben wie type, version, title, author_name, provider_name und, je nach Typ, mit HTML-Code oder einer Bildadresse.
  4. Ihr System baut daraus die Einbettung.

Laut Spezifikation sind type und version Pflichtangaben, die Version muss 1.0 sein. Weitere Felder wie Titel, Autorin oder Anbietername sind optional.

Woher Ihr System die Anbieter kennt

Es gibt zwei Wege:

  • Feste Liste: Viele Redaktionssysteme haben eine eingebaute Liste unterstützter Anbieter. Laut WordPress-Dokumentation bietet der Block-Editor seit WordPress 5.0 Einbettungen für Videos, Bilder, Beiträge, Audio und andere Inhalte von Drittanbietern, und die Dokumentation führt eine Liste der unterstützten Websites.
  • Discovery: Laut oEmbed-Spezifikation können Anbieter ihre Unterstützung auffindbar machen, indem sie im Kopf ihrer Seiten ein link-Element mit dem Typ „application/json+oembed“ setzen oder einen entsprechenden Link-Header senden. Systeme, die Discovery nutzen, finden so auch Anbieter, die nicht auf ihrer Liste stehen.

Häufige Gründe, warum keine Einbettung erscheint

Der Anbieter hat den offenen Endpunkt geschlossen. Die WordPress-Dokumentation nennt ein bekanntes Beispiel: Für Facebook und Instagram funktioniert der Einbettungsblock seit dem 24. Oktober 2020 nicht mehr in der bisherigen Form. Für solche Einbettungen braucht es laut Dokumentation ein Entwicklerkonto, eine App-ID und ein Zugangstoken. Ohne das bleibt der Link ein Link.

Die Adresse hat das falsche Format. Viele Anbieter erkennen nur bestimmte Adressformen. Die WordPress-Dokumentation nennt etwa, dass bei einer Blogplattform nur Beiträge erkannt werden, nicht einzelne Bilder. Kopieren Sie die Adresse direkt aus der Adresszeile oder über den Teilen-Knopf des Anbieters, nicht aus einer gekürzten Weiterleitung.

Der Inhalt ist nicht öffentlich. Private Videos, Beiträge aus geschlossenen Gruppen oder nur für Mitglieder freigegebene Inhalte liefert der Anbieter nicht als Einbettung aus.

Ihr System kennt den Anbieter nicht. Steht er nicht auf der Liste und bietet keine Discovery an, oder nutzt Ihr System keine Discovery, gibt es keine Einbettung.

Sicherheits- oder Cookie-Einstellungen blockieren. Manche Cookie- oder Datenschutzlösungen ersetzen Einbettungen durch Platzhalter, bis Besucher zustimmen. Im Editor sieht es dann aus, als sei nichts eingebettet.

Ein Plugin oder eine Einstellung hat Einbettungen abgeschaltet. Manche Leistungs- oder Sicherheits-Plugins deaktivieren oEmbed, um Anfragen an Fremdserver zu vermeiden.

So gehen Sie bei der Fehlersuche vor

  1. Prüfen Sie, ob der Inhalt öffentlich ist, indem Sie die Adresse in einem privaten Browserfenster öffnen.
  2. Kopieren Sie die Adresse über den Teilen-Knopf des Anbieters neu.
  3. Schauen Sie in der Dokumentation Ihres Systems nach, ob der Anbieter unterstützt wird.
  4. Testen Sie mit einem bekannten, sicher unterstützten Link, etwa einem öffentlichen Video. Klappt auch das nicht, liegt das Problem bei Ihrem System, zum Beispiel an einem Plugin.
  5. Falls der Anbieter den offenen Endpunkt geschlossen hat, nutzen Sie den Einbettungscode, den der Anbieter selbst anbietet, oder einen Link mit Vorschaubild.

Sicherheit nicht vergessen

Die oEmbed-Spezifikation weist ausdrücklich auf Sicherheitsfragen hin. Wenn ein System HTML eines Anbieters anzeigt, entsteht ein Einfallstor für Cross-Site-Scripting. Die Spezifikation empfiehlt deshalb, solches HTML in einem iframe anzuzeigen, der von einer anderen Domain ausgeliefert wird, damit es nicht auf Cookies Ihrer Domain zugreifen kann. Außerdem sollten Adressen auf sichere Schemata wie http, https oder mailto gefiltert werden. Für Sie als Betreiberin heißt das: Nutzen Sie Einbettungen nur von Anbietern, denen Sie vertrauen, und halten Sie Ihr System aktuell.

Eigene Inhalte einbettbar machen

oEmbed funktioniert auch in die andere Richtung. Wenn Sie zum Beispiel Rezepte, Veranstaltungen oder Produktvideos auf Ihrer eigenen Website haben, die andere einbetten sollen, können Sie selbst als Anbieter auftreten. Mit einem Endpunkt und dem passenden link-Element im Seitenkopf können Systeme mit Discovery Ihre Inhalte als Einbettung darstellen. Das ist ein Thema für Ihre Entwickler, lohnt sich aber, wenn Partner regelmäßig Ihre Inhalte verlinken. Manche Redaktionssysteme bringen eine solche Anbieterfunktion bereits mit, sodass Ihre Beiträge in anderen Websites mit Titel und Vorschau erscheinen.

Nicht jede Einbettung ist ein Gewinn. Eingebettete Inhalte laden Dateien von fremden Servern, machen Seiten langsamer und bringen fremdes Design auf Ihre Website. Für einen einzelnen Hinweis auf einen Beitrag reicht oft ein gut beschrifteter Link mit einem eigenen Vorschaubild. Einbettungen lohnen sich vor allem, wenn der Inhalt direkt auf Ihrer Seite angesehen werden soll, etwa ein Anleitungsvideo neben der Produktbeschreibung.

Ein Beispiel

Ein Kulturverein in Bregenz pflegt seine Veranstaltungsseite in einem Redaktionssystem (Beispiel zur Veranschaulichung). Eingefügte Links zu Probenvideos erscheinen als Einbettung, Links zu Fotobeiträgen aus einem sozialen Netzwerk aber nur als nackte Adresse. Die Recherche zeigt: Dieser Anbieter verlangt für Einbettungen inzwischen ein Entwicklerkonto. Der Verein nutzt künftig einen Link mit eigenem Vorschaubild und spart sich die zusätzliche Anbindung.

Häufige Fragen

Ist oEmbed ein Standard bestimmter Plattformen?

Nein. Es ist ein offenes Format, beschrieben auf oembed.com, das viele Anbieter und Redaktionssysteme nutzen.

Warum funktionieren manche Plattformen plötzlich nicht mehr?

Anbieter können ihre Endpunkte ändern oder schließen. Die WordPress-Dokumentation nennt dafür das Beispiel Facebook und Instagram ab Oktober 2020.

Machen Einbettungen meine Website langsamer?

Sie laden Inhalte von fremden Servern. Bei vielen Einbettungen auf einer Seite kann das spürbar sein.

Kann ich meine eigenen Inhalte einbettbar machen?

Ja, mit einem eigenen oEmbed-Endpunkt und Discovery-Links im Seitenkopf.

Wenn Ihre Einbettungen zuverlässig funktionieren und Ihre Seiten trotzdem schnell bleiben sollen, helfen wir Ihnen gerne.

Quellen

WhatsAppTermin buchen