Słownik

Gdzie naprawdę zapisano limit znaków tekstu alternatywnego na LinkedInie

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •7 min czytania
Gdzie naprawdę zapisano limit znaków tekstu alternatywnego na LinkedInieGdzie naprawdę zapisano limit znaków tekstu alternatywnego na LinkedInie

TL;DR, szybka odpowiedź

7 min czytania

LinkedIn dokumentuje jeden górny limit tekstu alternatywnego: 4 086 znaków. Pojawia się on w schematach Images API i MultiImage API przy polu altText, a oba zalecają też nieprzekraczanie 120 znaków. Post API Schema opisuje to samo pole bez limitu, a artykuł pomocy o polu tekstu alternatywnego w aplikacji nie podaje żadnej liczby znaków. Tabela błędów Posts API wymienia FIELD_LENGTH_TOO_LONG dla zbyt długiego tekstu, ale szablon komunikatu wskazuje commentary, więc dla altText nie opublikowano dokładnego komunikatu o przekroczeniu.

Jaki jest limit znaków tekstu alternatywnego na LinkedInie?

Dwie strony dokumentacji API LinkedIna ustalają limit tekstu alternatywnego na 4 086 znaków i obie zalecają, by nie przekraczać 120. Wiersz schematu Images API dla altText brzmi dosłownie: "The alternate text of this thumbnail. Used for screen reader accessibility. Maximum length is 4,086 characters, recommended length is less than 120 characters."

To cała zasada. Jeden twardy limit, jedna miękka wartość docelowa i prawie cztery tysiące znaków różnicy między nimi.

Pole jest wysyłane z treścią posta, a nie z przesyłanym plikiem. Dodajesz je w content.media podczas tworzenia posta:

POST https://api.linkedin.com/rest/posts
Linkedin-Version: 202608
X-Restli-Protocol-Version: 2.0.0
 
{
  "author": "urn:li:organization:5515715",
  "commentary": "test strings!",
  "visibility": "PUBLIC",
  "content": {
    "media": {
      "altText": "testing for alt tags",
      "id": "urn:li:image:C5610AQFj6TdYowm17w"
    }
  },
  "lifecycleState": "PUBLISHED"
}

Wartość id to URN obrazu otrzymany z wywołania initializeUpload, które rejestruje przesyłanie obrazu. Tekst alternatywny i plik obrazu trafiają na LinkedIn dwoma osobnymi wywołaniami, a opis niesie tylko drugie z nich.

Długość zalecana a maksymalna
Zalecana długość120 znaków
Maksymalna długość4 086 znaków
Strony schematów Images API i MultiImage API podają obie liczby dla tego samego pola altText.

Które strony LinkedIna podają limit, a które milczą?

altText lub jego odpowiednik opisują cztery miejsca. Dwa podają liczbę, dwa nie.

StronaPoleCo mówi o długości
Schemat Images APIaltText"Maximum length is 4,086 characters, recommended length is less than 120 characters"
Schemat MultiImage APIaltTextIdentyczne zdanie, słowo w słowo
Post API Schema, rekord MediaaltText"The alternate text for the media. None if empty. Optional." Bez limitu
Pomoc LinkedIna, tekst alternatywnyPole Alt.textNie podano liczby znaków

Trzeci wiersz najczęściej wprowadza w błąd. To przez Posts API faktycznie wysyłasz to pole, a strona schematu Posts API opisuje altText bez górnej granicy. Kto czyta tylko stronę odpowiadającą wykonywanemu wywołaniu, może uznać, że pole nie ma limitu. Liczba znajduje się na stronie Images API, która dotyczy przesyłania, a nie publikowania.

Powtórzenie w MultiImage ma znaczenie z innego powodu. Liczba 4 086 dotyczy własnego pola altText rekordu MultiImage, czyli jednego opisu obejmującego cały zestaw. Obok jest tablica images z zapisem "Minimum of 2 images and maximum of 20 images", a każdy jej element to rekord Media z własnym altText, opisanym w Post API Schema bez żadnego limitu.

Co zwraca API LinkedIna, gdy altText jest za długi?

LinkedIn nie publikuje odpowiedzi. To uczciwa wersja i lepiej powiedzieć to wprost, niż zgadywać.

Oto co zawiera dokumentacja. Tabela błędów Posts API wymienia błąd długości:

Status HTTPKod błęduOpis w dokumentacji
400FIELD_LENGTH_TOO_LONG"{field} length exceeds the allowed maximum. Reduce the length of the commentary or other text fields."

Szablon wymienia commentary, a resztę zbywa określeniem "other text fields". Nigdzie nie pada altText. Images API ma z kolei własną tabelę błędów, a wszystkie jej pozycje dotyczą identyfikatorów, nie długości: INVALID_IMAGE_ID ("This Image ID is invalid"), INVALID_URN_ID, INVALID_URN_TYPE i NOT_FOUND, wszystkie ze statusem 400. Błędu długości tam nie ma.

Jest też trzecia strona błędów, dokumentacja odpowiedzi błędów Marketing API, która rozwija FIELD_LENGTH_TOO_LONG jako "{field} length {length} can't exceeded maximum {max} length" z uzupełnionym polem, długością i maksimum. Strona ogranicza jednak swój zakres w uwadze: ustandaryzowany schemat jest "available for adCampaignGroups, adCampaigns and adAccounts endpoints only." Jedyny komunikat wystarczająco precyzyjny, by go zacytować, pochodzi więc z punktów końcowych niezwiązanych z obrazami.

Zbuduj w swoim edytorze walidację do 4 086 znaków po własnej stronie. Alternatywą jest poznanie faktycznej odpowiedzi LinkedIna na produkcji, a żadna strona nie mówi z góry, jak ona wygląda.

Osoba korzysta z laptopa w słuchawkach, co obrazuje, jak czytniki ekranu wykorzystują tekst alternatywny do opisywania obrazów w aplikacji LinkedIn.

Czy aplikacja LinkedIn stosuje ten sam limit?

LinkedIn nie publikuje limitu znaków dla pola tekstu alternatywnego w aplikacji. Artykuł pomocy "Add alternative text to images for accessibility" opisuje oba sposoby i nigdzie nie podaje liczby: na komputerze "click on Alt.text below the image to write a description of the image/photo", a na telefonie "tap ALT below the image." Artykuł zaktualizowano ostatnio trzy lata temu.

Ten sam tekst opisuje działanie, którego API nie ma: "LinkedIn may automatically add alt-text to images that don't have it. When uploading an image from a desktop computer, you'll be alerted if alt-text is automatically assigned. You won't be alerted if you're uploading an image from a mobile device."

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Jeszcze wyraźniej to milczenie widać po stronie reklam. Specyfikacja reklam z pojedynczym obrazem podaje maksymalne liczby znaków dla czterech pól: nazwa reklamy 255 znaków, tekst wprowadzający maksymalnie 3 000 znaków z zaleceniem 150, by uniknąć ucięcia, nagłówek maksymalnie 200 znaków z zaleceniem 70 oraz opis maksymalnie 300 znaków z zaleceniem 100. Wiersz tuż pod nimi to "Image alt text (optional)", który wyjaśnia, do czego służy tekst alternatywny, ale nie podaje żadnej liczby.

W jednej tabeli LinkedIn zapisuje więc cztery limity, a piąty pomija. Każdy, kto podaje limit tekstu alternatywnego w aplikacji, cytuje coś, czego LinkedIn nie opublikował.

Jak limit tekstu alternatywnego na LinkedInie wypada na tle Instagrama?

Jest ponad czterokrotnie dłuższy i ma inny zakres.

PlatformaPoleUdokumentowane maksimumZalecana długośćZakres
LinkedInaltText4 086 znakówPoniżej 120Obrazy w postach i postach z wieloma obrazami
Instagramalt_text1 000 znakówNie podanoPojedyncze obrazy i obrazy w karuzeli

Liczbę Mety i jej wyłączenia, w tym rolki i relacje, szczegółowo omawia tekst o limicie 1 000 znaków alt_text na Instagramie, więc nie ma sensu ich tu powtarzać. Liczy się różnica w podejściu: Meta publikuje limit bez zalecenia, LinkedIn jedno i drugie, a żadna z firm nie podaje limitu dla pola, które ich własna aplikacja pokazuje zwykłym użytkownikom.

Jeśli piszesz jeden opis i wysyłasz go do kilku sieci przez proces publikowania na wielu kontach naraz, o wszystkim decyduje platforma z najmniejszą udokumentowaną liczbą. W parze LinkedIn i Instagram jest to 1 000.

Jak długi powinien być tekst alternatywny na LinkedInie?

Według zalecenia LinkedIna poniżej 120 znaków, a limit 4 086 istnieje dla obrazów, którym 120 nie wystarcza.

Tak najlepiej czytać obie liczby razem. Zdjęcie dwóch osób na konferencji wymaga jednego zdania. Zrzut ekranu panelu, wykres z opisanymi osiami, tabela cen, harmonogram wydarzenia czy slajd z dużą ilością tekstu wymagają transkrypcji, a zalecenie nie jest zasadą, tylko wskazówką, czego potrzebuje większość obrazów.

Zacznij od tematu i działania, dodaj otoczenie, a potem przepisz widoczny w kadrze tekst zamiast go parafrazować. Pomiń "obraz przedstawiający" i "zdjęcie", bo czytniki ekranu same informują, że to obraz. Język marketingowy zostaw w polu commentary, gdzie jest jego miejsce, a w tekście alternatywnym opisz to, co widać w kadrze.

Jedna praktyczna uwaga o rozmiarach, bo tekst alternatywny i specyfikacje obrazów planuje się razem: zasady kadrowania, które decydują o tym, co zostanie widoczne w feedzie, to osobna kwestia, opisana w poradniku o wymiarach obrazów na LinkedInie dla każdego typu posta. Tekst alternatywny opisuje obraz wyświetlany przez LinkedIn, a nie przesłany plik.

Najczęściej zadawane pytania

Jaka jest maksymalna długość altText w API LinkedIna?

4 086 znaków. Wiersze schematów Images API i MultiImage API opisują altText jako "the alternate text of this thumbnail" z dopiskiem "Maximum length is 4,086 characters, recommended length is less than 120 characters."

Czy dokumentacja Posts API podaje limit tekstu alternatywnego?

Nie. Post API Schema opisuje altText w rekordzie Media jako "The alternate text for the media. None if empty. Optional" bez górnej granicy. Liczba 4 086 pojawia się za to na stronach Images API i MultiImage API.

Pracownik biurowy pisze na laptopie, co nawiązuje do części o błędzie zwracanym przez API LinkedIna przy zbyt długich polach.

Jaki błąd zwraca LinkedIn, gdy tekst alternatywny przekracza limit?

LinkedIn nie dokumentuje takiego błędu dla altText. Tabela błędów Posts API wymienia FIELD_LENGTH_TOO_LONG ze statusem 400 i opisem "{field} length exceeds the allowed maximum. Reduce the length of the commentary or other text fields", a tabela błędów Images API w ogóle nie zawiera błędu długości.

Czy pole tekstu alternatywnego w aplikacji LinkedIn ma limit znaków?

LinkedIn go nie publikuje. Artykuł pomocy o dodawaniu tekstu alternatywnego opisuje działanie na komputerze i telefonie bez podawania liczby, a specyfikacja reklam z pojedynczym obrazem podaje limity dla czterech pól, pomijając wiersz tekstu alternatywnego.

Czy można ustawić tekst alternatywny dla każdego obrazu w poście z wieloma obrazami?

Tak. MultiImage API przyjmuje tablicę images z zapisem "Minimum of 2 images and maximum of 20 images", a każdy element to rekord Media z własnym polem altText. Maksimum 4 086 znaków dotyczy własnego altText rekordu MultiImage, czyli opisu całego zestawu, a pola poszczególnych obrazów opisano bez limitu.

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Na którym etapie wysyła się altText: przy przesyłaniu czy przy publikacji?

Przy publikacji. Wywołanie initializeUpload i przesłanie pliku przenoszą sam plik, a altText trafia w obiekcie content.media żądania POST /rest/posts, które wskazuje URN gotowego obrazu.

Czy LinkedIn dodaje tekst alternatywny automatycznie, jeśli go pominiesz?

LinkedIn może sam przypisać tekst alternatywny do obrazu, który go nie ma. Przy przesyłaniu z komputera pojawia się wtedy powiadomienie, a przy przesyłaniu z urządzenia mobilnego nie, więc opis może napisać LinkedIn, a nie ty.

Ile pól tekstu alternatywnego ma pełny post z wieloma obrazami?

Pełny post z 20 obrazami ma do 21 takich pól. Jedno altText znajduje się w rekordzie MultiImage i obejmuje cały zestaw, a to właśnie je LinkedIn ogranicza do 4 086 znaków. Każdy z 20 elementów Media ma własne altText, które Post API Schema opisuje bez limitu.

Czy specyfikacja reklam LinkedIna podaje limit znaków dla tekstu alternatywnego?

Specyfikacja reklam z pojedynczym obrazem podaje limity dla nazwy reklamy, tekstu wprowadzającego, nagłówka i opisu, czyli łącznie czterech pól. Wiersz tekstu alternatywnego znajduje się tuż pod nimi i wyjaśnia jego przeznaczenie, nie podając żadnej liczby.

Czy tekst alternatywny powinien opisywać oryginalny plik, czy przyciętą wersję?

Powinien opisywać to, co LinkedIn faktycznie wyświetla w feedzie, a nie przesłany plik. Zasady kadrowania decydują o tym, co zostaje z oryginału, a tekst alternatywny musi odpowiadać ostatecznemu, widocznemu kadrowi.

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