Słownik

Jak tagi Open Graph decydują o tym, co pokazuje każda sieć

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •8 min czytania
Jak tagi Open Graph decydują o tym, co pokazuje każda siećJak tagi Open Graph decydują o tym, co pokazuje każda sieć

TL;DR, szybka odpowiedź

8 min czytania

Tagi Open Graph to elementy meta w sekcji head strony, które mówią sieci społecznościowej, jaki tytuł, typ, obraz i adres URL pokazać w podglądzie linku. Protokół opisany na ogp.me wymaga dokładnie czterech: og:title, og:type, og:image i og:url. Facebook, LinkedIn, Pinterest i Slack czytają je bezpośrednio, a X najpierw sprawdza własne właściwości twitter:, a gdy ich brak, sięga po Open Graph.

Czym są tagi Open Graph?

Strona deklaruje tagi Open Graph jako elementy <meta> w sekcji <head>, a te elementy mówią sieci społecznościowej, jaki tytuł, typ, obraz i adres URL umieścić w podglądzie linku, gdy ktoś udostępni stronę. Strona główna protokołu, ogp.me, zaczyna się od zdania "The Open Graph protocol enables any web page to become a rich object in a social graph." Całość opiera się na crawlerze: sieć pobiera twój adres URL, analizuje elementy meta i na ich podstawie buduje kartę, zamiast zgadywać na podstawie treści strony. Umieść cztery wymagane tagi w sekcji head każdej udostępnianej strony, a potem sprawdź działający adres w debugerze każdej sieci.

Programista wpisuje tagi meta w sekcji head strony na laptopie.

Których tagów Open Graph wymaga protokół?

Protokół Open Graph wymaga czterech właściwości, a ogp.me wymienia je jako og:title, og:type, og:image i og:url. Każda ma w specyfikacji jednowierszową definicję.

WłaściwośćDefinicja z ogp.mePrzykładowa wartość
og:title"The title of your object as it should appear within the graph"Planowanie postów w trzynastu sieciach
og:type"The type of your object, e.g., 'video.movie'"article
og:image"An image URL which should represent your object within the graph"https://example.com/preview.png
og:url"The canonical URL of your object that will be used as its permanent ID"https://example.com/guide

Poza tymi czterema ogp.me wymienia właściwości opcjonalne, w tym og:description, og:site_name, og:locale, og:determiner, og:audio i og:video, oraz właściwości strukturalne, takie jak og:image:secure_url, og:image:type i og:image:alt. Specyfikacja wymaga też prefiksu RDFa w elemencie głównym: <html prefix="og: https://ogp.me/ns#">.

<meta property="og:title" content="Scheduling posts across thirteen networks" />
<meta property="og:type" content="article" />
<meta property="og:image" content="https://example.com/preview.png" />
<meta property="og:url" content="https://example.com/guide" />
<meta property="og:description" content="What each network reads before it draws a card." />

Które sieci czytają tagi Open Graph, a które używają własnych?

Facebook, LinkedIn, Pinterest i Slack czytają właściwości og: bezpośrednio, a X najpierw sięga do własnej przestrzeni nazw twitter:. Ten podział to praktyczny problem, gdy jedna strona trafia do kilku sieci, bo zestaw tagów wystarczający dla jednego crawlera może u innego skończyć się pustą kartą.

Miejsce doceloweCo czytaŹródło
Facebookwłaściwości og:Przewodnik Meta dla webmasterów wymienia og:url, og:title, og:description, og:image, og:type, og:locale, fb:app_id
LinkedInwłaściwości og:Strona pomocy LinkedIna: kod źródłowy "needs to comply with Open Graph Protocol (OGP)"
Pinterestwłaściwości og: lub schema.orgOmówienie Rich Pins na Pintereście: "the most common formats are Open Graph and Schema.org"
Xwłaściwości twitter:, a awaryjnie og:Zarchiwizowany przewodnik X po kartach, cytowany niżej
Slackwłaściwości og: i metadane kart XDokumentacja Slacka: rozwijanie linków "looks for common OpenGraph and X (formerly known as Twitter) Card metadata"

Wynikają z tego dwie rzeczy. Sieć czyta twoje tagi tylko wtedy, gdy post zawiera link możliwy do pobrania, więc format podpisu, który nigdy nie pokazuje adresu URL, nigdy nie uruchomi crawlera. Sieć z własną przestrzenią nazw woli też właśnie ją, przez co publikowanie jednej strony wszędzie jest problemem z metadanymi, zanim stanie się problemem z planowaniem. Potrzebna jest tu ta sama staranność, co przy każdym procesie cross-postingu: tekst się przenosi, sposób wyświetlania już nie.

Dlaczego og:url musi być adresem kanonicznym?

Przewodnik Meta po udostępnianiu definiuje og:url jako "The canonical URL for your page. This should be the undecorated URL, without session variables, user identifying parameters, or counters." Protokół nazywa tę samą właściwość stałym identyfikatorem, więc każde udostępnienie śledzonego wariantu sprowadza się do jednego zadeklarowanego adresu. Ustaw og:url na czysty adres kanoniczny, parametry kampanii trzymaj w udostępnianym linku, a nie w tagu, a stronę kampanijną analizuj osobno, gdy śledzisz ruch z mediów społecznościowych.

Ten sam przewodnik definiuje og:title jako "The title of your article without any branding such as your site name," ponieważ Facebook i tak pokazuje domenę na karcie.

Jak X przechodzi od tagów twitter: do tagów og:?

Procesor kart X najpierw szuka właściwości twitter:, a gdy jej brakuje, używa odpowiednika z Open Graph. X nie publikuje już przewodnika po kartach, a dawny adres dla deweloperów przekierowuje na ogólną stronę przeglądową, więc wszystkie cytaty w tej sekcji pochodzą z zarchiwizowanej kopii tego przewodnika z grudnia 2023 roku i opisują działanie, które X udokumentował wtedy po raz ostatni. Zasada brzmiała tak: "When the Twitter card processor looks for tags on a page, it first checks for the Twitter-specific property, and if not present, falls back to the supported Open Graph property." Jedyna właściwość bez odpowiednika w Open Graph to samo twitter:card, opisane jako "The card type, which will be one of 'summary', 'summary_large_image', 'app', or 'player'."

Z przewodnika wynikają dwa szczegóły składni. X nie potrzebuje prefiksu RDFa, a choć jego tagi używają name i content, "Twitter's parser will fall back to using property and content, so there is no need to modify existing Open Graph protocol markup if it already exists." Do poprawnego zestawu Open Graph wystarczy więc dodać jeden tag dla X.

<meta name="twitter:card" content="summary_large_image" /> <meta name="twitter:site" content="@yourhandle" />

Jak długo platformy przechowują pobrane dane w pamięci podręcznej?

Facebook i X przechowują pobrane dane w pamięci podręcznej, ale według różnych zegarów. Strona dobrych praktyk Meta oferuje Sharing Debugger witrynom, które "need to update them more often than the standard 24 hour update period." Zarchiwizowany przewodnik po kartach mówi: "Content is cached by Twitter for 7 days after a link to a page with card markup has been published in a Tweet." Popraw tagi, zanim link pójdzie w świat, bo potem czekasz już na cudzą pamięć podręczną.

Dłoń przewija kanał mediów społecznościowych na smartfonie, czyli ekran, na którym pojawia się karta podglądu linku.

Jak sprawdzić, co naprawdę widzi crawler?

Każda sieć udostępnia debuger, który pobiera twój adres URL jako jej crawler i wyświetla odczytane tagi. Dokumentacja Meta podaje, że Sharing Debugger "will show which meta tags the crawler scrapes as well as any errors or warnings," a to samo uruchomienie zapisuje twój obraz w pamięci podręcznej. Wskaż dokładnie ten adres, który zamierzasz opublikować, a nie kopię testową, i powtórz sprawdzenie po każdej zmianie w sekcji head.

Crawlery można rozpoznać w logach serwera i regułach robots. Meta wymienia m.in. agentów użytkownika facebookexternalhit/1.1 i meta-externalagent/1.1, a X używa "the User-Agent of Twitterbot (with version, such as Twitterbot/1.0)." Jego przewodnik ostrzega, że "if a page with card markup is blocked, no card will be shown."

Co może pójść nie tak z tagami Open Graph?

Większość pustych lub błędnych podglądów ma cztery przyczyny i żadnej nie widać w przeglądarce. Pierwsza to zablokowany crawler, o czym wspomina strona pomocy LinkedIna: jeśli obraz spełnia wymagania, a mimo to się nie pojawia, "your website may be blocking us from pulling the image or the image may be located on a protected directory or website." Druga to umiejscowienie, bo dokumentacja crawlera Meta stwierdza, że "any Open Graph properties need to be listed before the first 1 MB of your website or app, or it will be cutoff." Trzecia to nieaktualna pamięć podręczna. Czwarta to względna ścieżka obrazu, ponieważ og:image jest zdefiniowane jako adres URL obrazu, a crawler z innego hosta nie ma adresu bazowego, względem którego mógłby ją rozwiązać.

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Pinterest stoi z boku tych czterech przypadków, bo Rich Pins traktują metadane jako treść strukturalną, a nie tylko podgląd. Opisuje to osobny przewodnik po Rich Pins. Jednorazowe poprawienie sekcji head to najtańsza część optymalizacji pod media społecznościowe. Gdy ten sam link trafia w kilka miejsc, adaptlypost publikuje jeden post na wielu kontach naraz, więc praca nad tagami zostaje na twojej stronie, a dystrybucja odbywa się w jednym miejscu. Sposób wyświetlania nadal należy do każdej sieci i o tym warto pamiętać w każdej strategii cross-postingu.

Cztery sposoby na zepsuty podgląd
Zablokowany crawlerReguły robots lub serwer nie pozwalają crawlerowi pobrać obrazu
Zbyt późne umiejscowienieTagi Open Graph znajdują się poza pierwszym 1 MB strony i zostają ucięte
Nieaktualna pamięć podręcznaSieć wciąż pokazuje to, co pobrała przed twoją ostatnią zmianą
Względna ścieżka obrazuog:image nie ma adresu bazowego, względem którego inny host mógłby ją rozwiązać
Cztery przyczyny odpowiadają za większość pustych lub błędnych podglądów linków i żadnej nie widać w przeglądarce.

Najczęściej zadawane pytania

Czy potrzebuję og:description, jeśli protokół go nie wymaga?

ogp.me wymienia og:description jako właściwość opcjonalną, więc strona bez niej nadal spełnia wymagania protokołu. Przewodnik Meta po udostępnianiu opisuje ją jako tekst pokazywany pod tytułem na Facebooku, więc jej pominięcie oddaje sieci decyzję, którą możesz podjąć samodzielnie. Napisz ten opis.

Czy mogę używać tagów Open Graph i twitter: na tej samej stronie?

Tak, a zarchiwizowany przewodnik X po kartach uznawał to za zamierzony układ: zdefiniowanie obu "minimizes the amount of duplicate markup required to describe content and experience." Procesor czyta właściwość twitter:, gdy istnieje, a og:, gdy jej nie ma. Dla X wystarczy dodać twitter:card do kompletnego zestawu Open Graph.

Co się stanie, jeśli og:url wskazuje inne miejsce niż sama strona?

Sieć zbuduje kartę dla adresu z og:url, który ogp.me definiuje jako "The canonical URL of your object that will be used as its permanent ID." Niezgodność sprawi, że każda osoba udostępniająca odeśle innych na inną stronę niż ta, którą czytała. Dbaj, aby og:url był równy adresowi kanonicznemu strony zawierającej tag.

Dlaczego podgląd wciąż pokazuje stary tytuł, mimo że poprawiono tag?

Sieci przechowują pobrane dane w pamięci podręcznej. Strona dobrych praktyk Meta wspomina o "standard 24 hour update period" i oferuje Sharing Debugger do wcześniejszego odświeżenia, a zarchiwizowany przewodnik X po kartach podawał 7 dni od opublikowania linku w poście. Uruchom odpowiedni debuger, a potem udostępnij link ponownie.

Czy atrybut prefix w elemencie html ma znaczenie?

ogp.me określa prefiks RDFa <html prefix="og: https://ogp.me/ns#"> jako część protokołu, więc go dodaj. Przewodnik X po kartach zaznacza, że dla jego tagów twitter: taki znacznik nie jest wymagany. Nie oczekuj, że prefiks naprawi kartę, która nie działa z innego powodu.

Co robią sieci, gdy brakuje og:image?

Protokół nie definiuje żadnego rozwiązania awaryjnego, więc zachowanie zależy od sieci i jej crawlera. Dokumentacja Slacka opisuje klasyczne rozwijanie linków jako przeszukiwanie adresu pod kątem metadanych Open Graph i kart X oraz wyświetlanie "some micro-approximation of the content," co uczciwie oddaje to, co sieć robi z niepełnym zestawem. Podaj og:image i nie zostawiaj tego wyboru heurystyce.

Co wpisać w og:type, jeśli strona nie jest artykułem?

ogp.me definiuje og:type jako typ obiektu i jako przykład podaje video.movie, więc wartość powinna odpowiadać temu, czym strona faktycznie jest. Tabela w tym przewodniku używa article dla wpisu na blogu, ale to tylko jedna z wartości dozwolonych przez protokół. Ustaw og:type na typ, który rzeczywiście opisuje obiekt na stronie.

Czy og:title powinien zawierać nazwę marki?

Przewodnik Meta po udostępnianiu definiuje og:title jako "the title of your article without any branding such as your site name," ponieważ Facebook i tak pokazuje domenę na karcie. Dodanie tam nazwy marki tylko powtarza to, co sieć pokazuje sama. Zostaw w og:title sam tytuł, a domenę pozostaw sieci.

Czy sieć buduje podgląd z posta bez linku?

Sieć czyta twoje tagi tylko wtedy, gdy post zawiera link możliwy do pobrania, więc format podpisu, który nigdy nie pokazuje adresu URL, nigdy nie uruchomi crawlera. Bez linku crawler nie ma czego pobrać, bez względu na to, jak kompletne są pozostałe tagi. Umieść adres URL w samym poście, a nie tylko na obrazie czy w tekście podpisu.

Jak rozpoznać crawlera sieci w logach serwera?

Meta wymienia agentów użytkownika, m.in. facebookexternalhit/1.1 i meta-externalagent/1.1, które można rozpoznać w logach serwera i regułach robots. X używa agenta Twitterbot z wersją, na przykład Twitterbot/1.0. Sprawdzenie tych ciągów pokazuje, czy crawler w ogóle dotarł do strony, bo przewodnik X ostrzega, że zablokowana strona nie pokaże karty.

Czy ten artykuł był pomocny?

Chętnie poznamy opinię!

Więcej naszych treści w Google

Jedno kliknięcie oznacza AdaptlyPost jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.

Jeszcze chwila...

AdaptlyPost

AdaptlyPost

Planowanie treści na wszystkich platformach

Wszystkie konta społecznościowe w jednym miejscu dzięki AdaptlyPost.

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Powiązane hasła ze słownika

Powiązane artykuły