Link-Vorschau erscheint nicht: Open-Graph-Tags und Cache prüfen

Inhalt
Sie haben einen Link in einen Messenger-Chat eingefügt, doch es erscheint nur ein graues Feld, oder trotz geändertem Bild wird weiterhin die alte Vorschau angezeigt? Dafür gibt es im Kern nur zwei Ursachen: Der Bot, der den Link teilt, konnte die Seite nicht lesen, oder er zeigt ein altes Ergebnis an, das er bereits zwischengespeichert hat.
Die Linkvorschau wird nicht von Ihrem Smartphone erzeugt. Sobald Sie einen Link einfügen, ruft der Scraper-Bot von Kakao (in KakaoTalk) die Adresse selbst auf, liest die Open-Graph-Tags (og-Tags) im <head> ganz oben im HTML und zeichnet daraus die Karte. „In meinem Browser sieht es doch gut aus“ ist deshalb kein Argument.
Kurzfassung ① Die Karte wird aus drei Werten erzeugt:
og:title,og:descriptionundog:image. Fehlt das Bild, ist meistog:imagenicht gesetzt oder die angegebene Adresse lässt sich nicht öffnen. ② Bots, die Links teilen, führen kein JavaScript aus. Wenn die Tags im „Seitenquelltext anzeigen“ fehlen, sieht auch der Bot sie nicht. ③ Haben Sie die Tags korrigiert, die alte Karte erscheint aber weiterhin, liegt es am Cache. Im Kakao-Debugger müssen Sie den Cache für diese URL zurücksetzen, dann ändert sich die Karte.
Der Bot liest die Seite aus und erzeugt die Karte
Open Graph ist ein Standard, mit dem eine Seite selbst angibt: „Das ist mein Titel, und das ist mein Vorschaubild.“ Als Pflichtangaben nennt die Spezifikation (ogp.me) vier Eigenschaften: og:title, og:type, og:image und og:url.
Zusammen mit og:description sind es fünf Werte, die tatsächlich in der Karte verwendet werden. Eine KakaoTalk-Karte ordnet diese Werte in der Reihenfolge Bild, Titel, Beschreibung und Domain an.
Wichtig ist: Der Bot liest die Werte ausschließlich aus dem HTML, das er beim ersten Abruf erhält. Inhalte, die erst nach dem Login sichtbar sind, oder Werte, die JavaScript nachträglich einfügt, liegen außerhalb seines Blickfelds.
Karte erscheint gar nicht: Prüfen ohne Zusatzwerkzeug
Ohne spezielle Programme, allein mit dem Browser, lässt sich die Ursache meist in drei Schritten eingrenzen.
1. Im Seitenquelltext nach og: suchen
Öffnen Sie die betroffene Seite in Chrome am Computer, klicken Sie mit der rechten Maustaste und wählen Sie Seitenquelltext anzeigen (Windows: Strg+U, Mac: Cmd+Option+U). Suchen Sie anschließend mit Strg+F nach og:.
Es muss hier der Quelltext sein, nicht „Untersuchen“ (Entwicklertools). Das Untersuchen-Fenster zeigt das Ergebnis, nachdem JavaScript vollständig gelaufen ist; der Quelltext zeigt dagegen das Original-HTML, das auch der Bot erhält. Sind die Tags im Untersuchen-Fenster vorhanden, im Quelltext aber nicht, ist genau das der Grund, warum keine Karte erscheint.
Wenn Sie ein Terminal nutzen können, geht dieselbe Prüfung in einer Zeile:
curl -s https://example.com/page | grep 'og:'
2. Die Adresse von og:image in einem neuen Tab öffnen
Kopieren Sie die bei og:image eingetragene Adresse und fügen Sie sie unverändert in einen neuen Tab ein. Lässt sich das Bild dort nicht öffnen, bleibt auch in der Karte die Bildfläche leer.
Am sichersten tragen Sie die Bildadresse als vollständige Adresse ein, die mit https beginnt. Relative Pfade wie /img/card.png werden je nach Leser womöglich nicht aufgelöst.
Prüfen Sie auch die Größe. Laut Facebook-Dokumentation zum Teilen liegt die zulässige Mindestgröße bei 200×200 Pixeln. Für eine große Karte werden mindestens 1200×630 Pixel empfohlen, mit einem Seitenverhältnis nahe 1,91:1; die Datei sollte 8 MB nicht überschreiten.
3. Im privaten Fenster öffnen
Prüfen Sie, ob die Seite auch im ausgeloggten Zustand sichtbar ist. Verlangt die Seite einen Login oder eine bestimmte Mitgliedsstufe, wird auch der Bot ausgesperrt und kann keine Karte erzeugen.
Prüfen mit unserem Tool. Wenn es Ihnen zu mühsam ist, die drei Schritte jedes Mal zu wiederholen: Geben Sie einfach die Adresse ein, und dieselbe Prüfung ist in einem Durchgang erledigt. Unser Server ruft die Seite für Sie ab, liest die og-Tags und zeichnet sie als KakaoTalk-Karte. Das kostenlose Tool heißt „Open-Graph-Vorschau für geteilte Links“.
Ohne Anmeldung und Installation: Geben Sie nur die Adresse ein. Unser Server ruft die Seite für Sie ab, liest die og-Tags und zeigt sie als Messenger-Karte.

Unter der Karte werden die Werte von og:title, og:description, og:image, og:site_name, og:type, twitter:card, twitter:title, twitter:image und canonical unverändert aufgelistet; leere Felder sind mit — markiert.
Fehlt einer der ersten drei Werte, wird er gesondert als fehlender Tag hervorgehoben. Lässt sich die Seite zwar öffnen, enthält aber weder og-Tags noch <title>, erscheint der Hinweis „Beim Teilen wird keine Karte erzeugt“.
Eines sollten Sie wissen: Steht og:image im Original als relativer Pfad, zeigt das Tool trotzdem die vollständige Adresse an. Ob im Original-Tag ein relativer Pfad steht, müssen Sie wie oben beschrieben im Seitenquelltext prüfen.
Altes Bild erscheint: Es liegt am Cache
Haben Sie die Tags korrigiert und die Änderung bereits veröffentlicht, in KakaoTalk erscheint aber weiterhin die alte Karte, dann liegt es nicht an den Tags, sondern am Cache. Der Scraper-Bot von KakaoTalk speichert das Ergebnis pro URL.
Um die neue Karte zu sehen, müssen Sie den Cache leeren. Geben Sie im Sharing-Debugger auf der Kakao-Developers-Seite die betreffende Adresse ein und setzen Sie den Cache zurück; ab dem nächsten Teilen werden die neuen Tags übernommen. Für dieses Tool ist eine Anmeldung mit einem Kakao-Konto erforderlich.
Wenn Sie nur schnell testen möchten, können Sie auch einen Wert wie ?v=2 an das Adressende hängen. Der Bot behandelt das als andere Adresse und liest sie neu ein. Verwenden Sie eine so erzeugte Adresse aber nicht dauerhaft zum Teilen, da sich sonst Statistiken verteilen. Nutzen Sie sie nur zur vorübergehenden Kontrolle.
Typische Stolperstellen
| Symptom | Häufige Ursache |
|---|---|
| Titel und Beschreibung erscheinen, nur das Bild bleibt grau und leer | og:image fehlt oder die Adresse lässt sich nicht öffnen |
| Die ganze Karte fehlt | Login erforderlich oder Bot gesperrt, die Seite konnte nicht abgerufen werden |
| Im Quelltext sind keine Tags vorhanden | Die Tags werden nur per JavaScript eingefügt |
| Korrigiert, aber alte Karte | Cache des Bots |
| Vorschau-Tool und echtes KakaoTalk weichen voneinander ab | Das Tool zeigt die aktuellen Tags, KakaoTalk den zwischengespeicherten Wert |
Manchmal meldet das Vorschau-Tool auch „blockiert“. Das liegt nicht an Ihren Tags, sondern daran, dass die Website Zugriffe aus Rechenzentren sperrt. Typische Beispiele sind YouTube- und Google-Seiten. Die Bots von Kakao und Facebook greifen über andere Wege zu, sodass die tatsächliche Karte trotzdem korrekt erzeugt werden kann.
Auch Naver-Blogs sind eine Ausnahme. Die Desktop-Adresse (blog.naver.com) nutzt eine Frame-Struktur, sodass statt der Tags des Beitrags die Angaben des Blogdienstes selbst gelesen werden. Das Tool wechselt in diesem Fall deshalb zur mobilen Adresse (m.blog.naver.com) und weist auf dem Bildschirm darauf hin.
Zusammenfassung
- Die Karte entsteht, indem der Scraper-Bot von Kakao die Seite selbst aufruft und die og-Tags im
<head>liest. Die Anzeige in Ihrem Browser ist kein Maßstab. - Laut Spezifikation sind
og:title,og:type,og:imageundog:urlPflicht; das Aussehen der Karte bestimmen diese Werte zusammen mitog:description. - Die Prüfreihenfolge: ① im Seitenquelltext nach
og:suchen, ② die Adresse vonog:imagein einem neuen Tab öffnen, ③ im privaten Fenster prüfen, ob die Seite ohne Login erreichbar ist. og:imagesollte als vollständige Adresse angegeben werden, mit mindestens 1200×630 Pixeln, einem Seitenverhältnis von 1,91:1 und höchstens 8 MB.- Sind die Tags in Ordnung, die alte Karte erscheint aber weiterhin, liegt es am Cache. Setzen Sie im Kakao-Sharing-Debugger den Cache dieser URL zurück.
Ohne Anmeldung und Installation: Geben Sie nur die Adresse ein. Unser Server ruft die Seite für Sie ab, liest die og-Tags und zeigt sie als Messenger-Karte.
Häufig gestellte Fragen
Ich habe die Tags korrigiert, aber in KakaoTalk wird weiterhin das alte Bild angezeigt. Woran liegt das?
KakaoTalk speichert das Ergebnis, das der Scraper-Bot pro URL ausgelesen hat. Egal, wie oft Sie die Seite neu laden: Die Karte im Chatfenster stammt aus diesem gespeicherten Wert und ändert sich daher nicht. Erst wenn Sie den Cache für die jeweilige Adresse im Sharing-Debugger der Kakao-Entwicklerseite zurücksetzen, wird beim nächsten Teilen eine neue Karte erzeugt.
Welche Größe sollte das og:image haben?
Laut der Facebook-Dokumentation zum Teilen beträgt die zulässige Mindestgröße 200×200 Pixel. Damit eine große Bildkarte angezeigt wird, empfiehlt sich eine Größe ab 1200×630 Pixel. Das Seitenverhältnis sollte nahe bei 1,91:1 liegen, die Dateigröße darf 8 MB nicht überschreiten. Diese Vorgaben gelten bei vielen Diensten faktisch einheitlich.
Bei manchen Links erscheint eine Karte, bei anderen nicht. Was ist der Unterschied?
Entscheidend ist, ob der Bot die og-Tags unter dieser Adresse auslesen konnte. Bei Seiten, die eine Anmeldung erfordern, Bots aussperren oder ihre Tags nur per JavaScript einfügen, findet der Bot nichts zum Auslesen, und es wird keine Karte erzeugt. Prüfen Sie zuerst, ob im Seitenquelltext og: auftaucht – damit lässt sich der Fall meist schon eingrenzen.
Im Vorschau-Tool sieht alles gut aus, aber die echte KakaoTalk-Karte weicht ab. Warum?
Weil sich der Zeitpunkt der Betrachtung unterscheidet. Ein Vorschau-Tool liest die Tags, die in diesem Moment auf der Seite stehen, und zeigt sie an. KakaoTalk dagegen zeigt den Wert, den der Bot früher ausgelesen und gespeichert hat. Weichen beide voneinander ab, sind die Tags bereits korrigiert und nur der Cache ist veraltet. Setzen Sie den Cache zurück, dann stimmen beide wieder überein.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen