Słownik

Jak działa tekst alternatywny na Pinterest w Pinach i API

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •6 min czytania
Jak działa tekst alternatywny na Pinterest w Pinach i APIJak działa tekst alternatywny na Pinterest w Pinach i API

TL;DR, szybka odpowiedź

6 min czytania

Pinterest przechowuje tekst alternatywny jako alt_text, zwykłe pole tekstowe samego Pina, ograniczone w API Pinteresta do 500 znaków. Znajduje się obok 100-znakowego tytułu i 800-znakowego opisu, a nie w media_source, więc Pin ma jeden tekst alternatywny nawet wtedy, gdy zawiera kilka obrazów. Ustawiasz go przez POST /v5/pins, a później zmieniasz przez PATCH /v5/pins/{pin_id}. Artykuły centrum pomocy Pinteresta o tworzeniu i edycji Pina nie wymieniają pola tekstu alternatywnego. AdaptlyPost wysyła tekst alternatywny pierwszego obrazu, przycięty do 500 znaków.

Czym jest tekst alternatywny na Pintereście?

Pisanie tekstu alternatywnego na Pintereście oznacza wypełnienie pola alt_text w Pinie, czyli zwykłego tekstowego opisu obrazu, który czytniki ekranu odczytują na głos osobom niemogącym go zobaczyć. Pole należy do Pina, obok tytułu, opisu i linku, a API Pinteresta zwraca je przy każdym odczytywanym Pinie.

Tekst alternatywny i opis Pina pełnią różne funkcje. Opis jest tekstem dla przeglądających oraz dla rankingu Pinteresta: strona ze specyfikacją produktów Pinteresta podaje: "Descriptions are used by our algorithm to determine relevance for delivery." Tekst alternatywny opisuje to, co widać na obrazie, z myślą o osobach korzystających z technologii wspomagających. Opis napisany pod wyszukiwania, na przykład „szybki makaron na wieczór, 20 minut”, nie mówi użytkownikowi czytnika ekranu nic o zdjęciu. Tekst alternatywny tego samego Pina brzmi: „miska spaghetti z sosem pomidorowym i bazylią na drewnianym stole”.

Oba pola mają też osobne limity, więc pisanie jednego nie zabiera miejsca w drugim.

Jaki jest limit znaków tekstu alternatywnego na Pintereście?

Limit tekstu alternatywnego na Pintereście wynosi 500 znaków i jest określony dla pola alt_text w dokumentacji API Pinteresta dotyczącej tworzenia i aktualizowania Pina. Oto porównanie z innymi polami tekstowymi Pina:

Pole PinaNazwa w APILimit
Tekst alternatywnyalt_text500 znaków
Tytułtitle100 znaków
Opisdescription800 znaków
Link docelowylink2 048 znaków

Dokumentacja dla deweloperów oznacza alt_text jako "Nullable", więc Pin bez tekstu alternatywnego jest prawidłowy i wraca z wartością "alt_text": null. Liczba 500 znaków pochodzi z dokumentacji API. Centrum pomocy Pinteresta nie podaje osobnej wartości dla tekstu alternatywnego, więc traktuj 500 jako górną granicę w każdym narzędziu, które zapisuje dane przez API.

Programista pisze kod na laptopie, co ilustruje dodawanie tekstu alternatywnego do Pina przez API.

Jak dodać tekst alternatywny do Pina?

Tekst alternatywny dodajesz do Pina przez pole alt_text podczas jego tworzenia lub aktualizacji i to właśnie tę metodę Pinterest opisuje dla deweloperów oraz narzędzi korzystających z jego API. W serwisie i aplikacji Pinteresta artykuł centrum pomocy "Create a Pin from an image or video" wymienia jako pola do wypełnienia tytuł, opis, link, tablicę, powiązane tematy, publikację później, przełączniki treści zmodyfikowanych przez AI oraz "More options" dla komentarzy i rekomendacji zakupowych. Tekstu alternatywnego na tej liście nie ma. Artykuł "Edit or delete a Pin" wymienia tytuł, opis, link, tablicę i ustawienia komentarzy, również bez tekstu alternatywnego.

Pozostają więc dwie drogi, które Pinterest w pełni dokumentuje:

  1. Utwórz Pina z tekstem alternatywnym. Wyślij POST /v5/pins z polem alt_text w treści żądania, obok board_id, title, description i media_source.
  2. Dodaj lub zmień go później. Wyślij PATCH /v5/pins/{pin_id} z nowym alt_text. Schemat aktualizacji ma ten sam limit 500 znaków.

Jeśli twój kreator Pinów pokazuje pole tekstu alternatywnego, korzystaj z niego w ten sam sposób i trzymaj się 500 znaków, aby tekst odpowiadał temu, co przyjmuje API. Resztę procesu tworzenia Pina, od tablic po formaty obrazów, opisuje artykuł o tym, jak publikować zdjęcia na Pintereście.

Gdzie umieścić alt_text w żądaniu do API Pinteresta?

W API Pinteresta alt_text znajduje się na najwyższym poziomie treści Pina, a nie w media_source, które opisuje jedynie źródło obrazu lub filmu. Żądanie dla Pina z jednym obrazem wygląda tak:

{
  "board_id": "123456789012345678",
  "title": "Weeknight tomato pasta",
  "description": "A 20-minute pasta with five ingredients.",
  "alt_text": "A bowl of spaghetti with tomato sauce and fresh basil on a wooden table",
  "media_source": {
    "source_type": "image_url",
    "url": "https://example.com/pasta.jpg"
  }
}

Pin z wieloma obrazami używa source_type: "multiple_image_urls" z 2 do 5 elementów. Każdy element przyjmuje url, title, description i link, ale żaden nie przyjmuje tekstu alternatywnego. Cały Pin ma jeden alt_text, więc w Pinie z wieloma obrazami opisz cały zestaw albo pierwszy obraz. Piny wideo używają source_type: "video_id" i tego samego pola najwyższego poziomu.

API Pinteresta ma własne limity wywołań, które opisujemy w artykule o limitach zapytań API Pinteresta. Gdy zaplanowany Pin się nie pojawia, najczęstsze przyczyny znajdziesz w tekście o tym, dlaczego Piny nie publikują się na Pintereście.

Ujęcie z góry lnianego obrusu z mosiężnymi świecznikami, czyli obraz, którego główny motyw dobry tekst alternatywny powinien nazwać jako pierwszy.

Jak napisać dobry tekst alternatywny na Pintereście?

Dobry tekst alternatywny na Pintereście w jednym lub dwóch prostych zdaniach nazywa to, co pokazuje obraz, łącznie z umieszczonymi na nim napisami, a słowa kluczowe zostawia tytułowi i opisowi. Gdy Pin ma nakładkę tekstową, czytnik ekranu nie odczyta słów wtopionych w obraz, chyba że tekst alternatywny je powtórzy.

Krótka lista kontrolna:

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

  • Zacznij od głównego motywu. „Ujęcie z góry lnianego obrusu z mosiężnymi świecznikami” jest lepsze niż „Zdjęcie dekoracji stołu”.
  • Przepisz tekst z nakładki. Jeśli na Pinie widnieje dużymi literami „5 jesiennych pomysłów na stół”, umieść te słowa w tekście alternatywnym.
  • Pomiń „zdjęcie przedstawiające” i „Pin z”. Czytniki ekranu same informują, że to obraz.
  • Nie dodawaj hashtagów ani linków. To pole zwykłego tekstu, a frazy wyszukiwania są już w opisie.
  • Zmieść się w 500 znakach. Większości obrazów wystarczą od jednego do trzech zdań.

Te same nawyki sprawdzają się w innych serwisach, choć przy innych limitach. Zestawienie znajdziesz w przewodniku po dostępności w mediach społecznościowych.

Słaby i mocny tekst alternatywny tego samego Pina
Słaby
  • „Zdjęcie dekoracji stołu”
  • Zaczyna się od „Zdjęcie”, o czym czytniki ekranu i tak informują
  • Pomija słowa umieszczone na Pinie
Mocny
  • „Ujęcie z góry lnianego obrusu z mosiężnymi świecznikami”
  • Zaczyna się od głównego motywu
  • Powtarza tekst z nakładki, na przykład „5 jesiennych pomysłów na stół”
Obie wersje opisują tego samego Pina, ale tylko druga mówi czytnikowi ekranu, co na nim jest.

Jaki tekst alternatywny AdaptlyPost wysyła na Pinteresta?

AdaptlyPost wysyła na Pinteresta tekst alternatywny pierwszego obrazu jako alt_text Pina, przycięty do 500 znaków, ponieważ Pinterest przyjmuje jeden tekst alternatywny na Pin. Mówi o tym wprost notatka przy polu w edytorze: „Pinterest używa tekstu alternatywnego pierwszego zdjęcia”.

W edytorze każdy obraz ma przycisk „Dodaj tekst alternatywny”, który otwiera okno z poleceniem „Opis zdjęcia dla osób korzystających z czytników ekranu”. Piszesz jeden opis na obraz, maksymalnie 1 000 znaków. Ten sam opis trafia do każdego serwisu w poście, który przyjmuje tekst alternatywny, a dla Pinteresta AdaptlyPost bierze opis obrazu 1 i przycina go do 500 znaków. W Pinie z wieloma obrazami AdaptlyPost wysyła ten jeden opis dla całego Pina. Piny wideo są publikowane bez tekstu alternatywnego. API AdaptlyPost działa tak samo: mediaAltTexts zawiera po jednym ciągu znaków na obraz, w kolejności mediaUrls, a dokumentacja zaznacza, że Pinterest dostaje "first image only, max 500 characters."

Aby Pinterest otrzymał pełny opis, napisz tekst alternatywny pierwszego obrazu w maksymalnie 500 znakach, a jeśli Pin zawiera kilka obrazów, opisz go jako całość. Narzędzie do planowania postów na Pintereście obsługuje tablicę, tytuł, link i czas publikacji, a pełną konfigurację opisuje artykuł o tym, jak planować posty na Pintereście.

Najczęściej zadawane pytania

Czy Pinterest ma tekst alternatywny?

Tak. Każdy Pin ma w API Pinteresta pole alt_text, czyli zwykły tekstowy opis obrazu dla czytników ekranu. Może być puste, więc Piny bez tekstu alternatywnego są prawidłowe.

Jaki jest limit znaków tekstu alternatywnego na Pintereście?

Limit wynosi 500 znaków i jest określony dla alt_text w dokumentacji API Pinteresta dotyczącej tworzenia i aktualizowania Pina. Tytuł mieści 100 znaków, opis 800, a każde pole ma własny limit.

Jak dodać tekst alternatywny do istniejącego Pina?

Wyślij PATCH /v5/pins/{pin_id} z nową wartością alt_text przez API Pinteresta lub korzystające z niego narzędzie. Artykuł pomocy Pinteresta "Edit or delete a Pin" wymienia jako pola do edycji tytuł, opis, link, tablicę i ustawienia komentarzy, ale nie tekst alternatywny.

Czy każdy obraz w Pinie z wieloma obrazami może mieć własny tekst alternatywny?

Nie. alt_text należy do Pina, a nie do elementów w media_source, więc Pin z wieloma obrazami ma jeden tekst alternatywny. W tym jednym polu opisz cały zestaw albo pierwszy obraz.

Czy tekst alternatywny na Pintereście to to samo co opis Pina?

Nie. Opis pomaga algorytmowi Pinteresta "determine relevance for delivery" i jest pisany z myślą o wyszukujących, a tekst alternatywny opisuje obraz dla osób korzystających z czytników ekranu. To osobne pola z osobnymi limitami: 800 i 500 znaków.

Jaki tekst alternatywny AdaptlyPost wysyła na Pinteresta?

AdaptlyPost wysyła tekst alternatywny pierwszego obrazu jako alt_text Pina, przycięty do 500 znaków. Opisy pozostałych obrazów trafiają do serwisów przyjmujących osobny tekst dla każdego obrazu, a nie na Pinteresta. Piny wideo są publikowane bez tekstu alternatywnego.

Co napisać w tekście alternatywnym na Pintereście?

Nazwij w jednym lub dwóch prostych zdaniach to, co pokazuje obraz, łącznie z umieszczonymi na nim napisami. Pomiń „zdjęcie przedstawiające”, bo czytniki ekranu same informują, że to obraz. Nie dodawaj hashtagów ani linków, ponieważ frazy wyszukiwania są już w opisie.

Czy tekst alternatywny na Pintereście jest wymagany?

Pinterest go nie wymaga. Dokumentacja dla deweloperów oznacza alt_text jako "Nullable", więc Pin bez tekstu alternatywnego jest prawidłowy i wraca z wartością "alt_text": null.

Które wywołanie API ustawia tekst alternatywny w nowym Pinie?

Wyślij POST /v5/pins z polem alt_text w treści żądania, obok board_id, title, description i media_source. Pole znajduje się na najwyższym poziomie Pina, a nie w media_source.

Ile znaków tekstu alternatywnego mogę wpisać w AdaptlyPost?

Edytor przyjmuje do 1 000 znaków na obraz. Pinterest dostaje tylko tekst alternatywny pierwszego obrazu, przycięty do 500 znaków, więc ten pierwszy opis zmieść w maksymalnie 500 znakach.

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