Słownik

Jak limit business use case Mety rozlicza Strony na Facebooku

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •9 min czytania
Wzór limitu business use case Mety dla wywołań API Stron na FacebookuWzór limitu business use case Mety dla wywołań API Stron na Facebooku

TL;DR, szybka odpowiedź

9 min czytania

Wywołania Pages API wykonane tokenem dostępu Strony lub użytkownika systemowego podlegają limitowi business use case Mety: "Calls within 24 hours = 4800 * Number of Engaged Users". Wywołania tokenem użytkownika lub aplikacji podlegają natomiast starszemu limitowi na poziomie aplikacji. Zużycie wraca w nagłówku X-Business-Use-Case-Usage pod typem pages, a sama blokada to błąd 80001, "There have been too many calls to this Page account". Meta nigdy nie definiuje, co oznacza zaangażowanie na Stronie, a jej własny przykładowy nagłówek używa tego samego klucza JSON dwa razy.

Czym jest limit business use case Mety dla Stron?

Limit business use case Mety dla Stron to 24-godzinna pula wywołań, którą Meta stosuje do żądań Pages API wykonywanych tokenem dostępu Strony lub tokenem użytkownika systemowego. Dokumentacja limitów Graph API podaje wzór w jednym wierszu:

Calls within 24 hours = 4800 * Number of Engaged Users

Zdanie nad wzorem określa warunki: "Requests made by your app to the Pages API using a Page access token or system User access token are counted against the app's call count. An app's call count is the number of calls it can make during a rolling 24 hour window."

Pula należy więc do aplikacji, okno jest kroczące i nie resetuje się o północy, a jej wielkość zależy od tego, ile osób zaangażowało się w Stronę w ciągu ostatniej doby. Strona z 50 zaangażowanymi użytkownikami daje 240 000 wywołań w 24 godziny. Strona bez zaangażowanych użytkowników daje, według tego samego rachunku, zero.

Business use case, w skrócie BUC, to jeden z dwóch systemów limitów Mety. Drugi to Platform Rate Limits, system na poziomie aplikacji i użytkownika, o którym informuje nagłówek x-app-usage. To właśnie przy Stronach Meta rozdziela te systemy według tokenu.

Pęk mosiężnych kluczy na drewnianym stole, symbolizujący różne tokeny dostępu decydujące o tym, który limit obowiązuje.

Które tokeny obejmują wywołania Stron limitem business use case?

Decyduje token dostępu i nic więcej. Meta opisuje ten podział na początku dokumentacji limitów: "requests made with application or user access tokens are subject to Platform Rate Limits, while requests made with system user or page access tokens are subject to Business Use Case Rate Limits."

Token w żądaniuSystem limitówWzórOknoBłąd po przekroczeniu
Token dostępu StronyBusiness use case4800 * Number of Engaged UsersKroczące 24 godziny80001
Token użytkownika systemowegoBusiness use case4800 * Number of Engaged UsersKroczące 24 godziny80001
Token aplikacjiPlatform, poziom aplikacji200 * Number of UsersKroczące 60 minut4 lub 32 przy wywołaniach Pages API
Token użytkownikaPlatform, poziom użytkownikaNieujawnionyKroczące 60 minut17 lub 32 przy wywołaniach Pages API

To samo wywołanie POST /{page-id}/feed trafia do innego systemu w zależności od poświadczenia wysłanego przez aplikację. Publikowanie odbywa się na tokenach Strony, bo dokumentacja Page Feed wymaga "A Page access token" do publikowania jako Strona, a token Strony uzyskany z długoterminowego tokenu użytkownika nie ma daty wygaśnięcia. Takie wywołania podlegają limitom business use case.

Meta zaleca tę drogę także przy odczycie publicznych Stron. Dokumentacje Page Feed i Page Photos mówią: "When using the Page Public Content Access feature, use a system user access token to avoid rate limiting issues." Meta nie podaje powodu, ale efekt jest jasny: token użytkownika systemowego przenosi takie odczyty z godzinowej puli Platform do 24-godzinnej puli business use case.

Gdy mogłyby obowiązywać oba systemy, Meta rozstrzyga to tak: "If both Platform and Business Use Case rate limits can be applied to a request, BUC rate limits will be applied."

Kto jest zaangażowanym użytkownikiem w limicie dla Stron?

Cała definicja Mety to jedno zdanie: "The Number of Engaged Users is the number of Users who engaged with the Page per 24 hours." Nie wymienia żadnego kwalifikującego działania. O polubieniach, komentarzach, udostępnieniach i kliknięciach nie ma ani słowa.

Ta sama strona używa potem tego pojęcia w innym znaczeniu. W sekcji Messenger wzór to Calls within 24 hours = 200 * Number of Engaged Users, a Meta definiuje je inaczej: "The Number of Engaged Users is the number of people the business can message via Messenger." Dwa wzory w jednym dokumencie używają tego samego terminu dla dwóch różnych grup, z mnożnikami 4 800 i 200.

Nie ma też dolnej granicy. Sekcja Threads w tej samej dokumentacji ustala ją wprost: "The minimum value for impressions is 10 (so if the impressions is less than 10 we default to 10)." W sekcji o Stronach nie ma takiego zapisu. Nowa lub uśpiona Strona ma więc wzór mnożący 4 800 przez liczbę bliską zera.

Wzór zostawia też jedno otwarte pytanie. Wielkość puli wynika z zaangażowania na jednej Stronie, ale wywołania obciążają "the app's call count". Meta nie mówi, czy dwie Strony podłączone do tej samej aplikacji korzystają z dwóch pul, czy z jednej. Nagłówek, opisany poniżej, grupuje zużycie według identyfikatora, który tabela pól Mety opisuje jako "The ID of the business associated with the token making the API calls". To firma, a nie Strona, a dokumentacja nigdy nie wyjaśnia, jak pula Strony się do niej odnosi.

Jak odczytać X-Business-Use-Case-Usage przy wywołaniach Stron?

Meta dołącza ten nagłówek do odpowiedzi objętych logiką business use case i opisuje go jako "a JSON-formatted string that describes current application rate limit usage. This header can return up to 32 objects in one call." Wpisy są pogrupowane według identyfikatora obiektu firmy, a type każdego wpisu wskazuje raportowany limit. Dla wywołań Stron szukasz wartości pages.

Przykład Mety pokazuje wpis dla Stron tak:

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

"10153848260347724": [
  {
    "type": "pages",
    "call_count": 97,
    "total_cputime": 23,
    "total_time": 23,
    "estimated_time_to_regain_access": 0
  }
]
PoleCo według Mety zawiera
type"Type of rate limit applied", jedna z wartości ads_insights, ads_management, custom_audience, instagram, leadgen, messenger lub pages
call_count"A whole number expressing the percentage of allowed calls made by your app over a rolling one hour period"
total_cputime"A whole number expressing the percentage of CPU time allotted for query processing"
total_time"A whole number expressing the percentage of total time allotted for query processing"
estimated_time_to_regain_access"Time, in minutes, until calls will not longer be throttled"

W samym przykładzie Mety kryją się dwa problemy. Po pierwsze, klucz 10153848260347724 występuje w nim dwa razy: raz z wpisem ads_insights i raz z wpisem pages. JSON tego nie zabrania, ale RFC 8259 przestrzega: "The names within an object SHOULD be unique", a gdy tak nie jest, "the behavior of software that receives such an object is unpredictable. Many implementations report the last name/value pair only." JSON.parse w JavaScripcie zachowuje ostatni. Jeśli prawdziwy nagłówek kiedyś powtórzy klucz tak jak przykład, standardowy parser po cichu pominie jeden z wpisów, więc przechodź po wszystkich wpisach i filtruj po type, zamiast szukać jednego klucza.

Po drugie, call_count jest zdefiniowane dla "a rolling one hour period", a wzór dla Stron liczy wywołania w "a rolling 24 hour window". Sekcja o Instagramie w tym samym dokumencie ma identyczną niespójność. Meta nie mówi, którego okna dotyczy procent dla Stron. Planuj według okna 24-godzinnego, bo to ono występuje we wzorze dla Stron.

Dobre praktyki przy tym nagłówku napisano z myślą o reklamach, aż po zdanie "Switch to other ad accounts and come back to this account later." Żadna nie wspomina o Stronach.

Klepsydra na biurku, pokazująca czas oczekiwania, zanim wywołania do Strony objętej limitem będą mogły zostać wznowione.

Co się dzieje, gdy Strona osiągnie limit business use case?

Wywołania kończą się błędem 80001. Przykładowa odpowiedź Mety:

{
  "error": {
    "message": "(#80001) There have been too many calls to this Page account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting.",
    "type": "OAuthException",
    "code": 80001,
    "fbtrace_id": "AmFGcW_3hwDB7qFbl_QdebZ"
  }
}

Dokumentacje Page Photos i Page Post podają ten sam tekst dla 80001 we własnych tabelach błędów, więc to właśnie ten kod zobaczy zadanie publikujące lub odczytujące dane.

Komunikat mówi "Wait a bit and try again." Sekcja dobrych praktyk na tej samej stronie jest surowsza: "When the limit has been reached, stop making API calls. Continuing to make calls will continue to increase your call count, which will increase the time before calls will be successful again." Stosuj się do tej drugiej wskazówki. Odczytaj estimated_time_to_regain_access z wpisu pages, wstrzymaj kolejkę tej Strony na podaną liczbę minut i nie wysyłaj w tym czasie wywołań testowych.

Tabela błędów Mety dla limitów business use case zawiera pomyłkę, na którą warto zwrócić uwagę. Przy "Page calls made with a User access token" wymienia "error code 32", choć ten sam dokument mówi, że wywołania Stron tokenem użytkownika podlegają logice Platform. Poprawna jest tabela Platform: kod 32 "Indicates that the User or app whose token is being used in the Pages API request has reached its rate limit." Traktuj 32 jako błąd Platform, a 80001 jako błąd business use case i kieruj je do różnych ścieżek obsługi.

Nic z tego nie określa, ile postów może opublikować Strona. Dzienne limity publikacji na Facebooku to osobny system z osobnymi błędami.

Jak wyjść z błędu 80001
1
Sprawdź kod. 80001 to błąd business use case. 32 to błąd Platform z własną ścieżką obsługi.
2
Przestań wywoływać. Każde kolejne wywołanie zwiększa licznik i wydłuża blokadę.
3
Odczytaj czas oczekiwania. Znajdź wpis pages w X-Business-Use-Case-Usage i odczytaj estimated_time_to_regain_access.
4
Wstrzymaj kolejkę. Zatrzymaj kolejkę tej Strony na podaną liczbę minut i nie wysyłaj wywołań testowych.
Komunikat Mety radzi chwilę poczekać, ale jej dobre praktyki nakazują całkowicie przerwać wywołania.

Czym limit business use case różni się od limitu na poziomie aplikacji?

Różni się niemal wszystkim, także jednostką czasu. Mnożniki są jednak bliższe, niż się wydaje: 200 wywołań na godzinę przez 24 godziny to 4 800 wywołań dziennie, więc oba wzory dają tę samą dzienną stawkę na liczoną osobę. Różnica polega na tym, kogo się liczy.

Limit business use case dla StronLimit Platform na poziomie aplikacji
TokenStrony lub użytkownika systemowegoAplikacji lub użytkownika
Wzór4800 * Number of Engaged Users200 * Number of Users
OknoKroczące 24 godzinyKroczące 60 minut
Od czego zależyOd osób angażujących się na StronieOd dziennych aktywnych użytkowników aplikacji
NagłówekX-Business-Use-Case-UsageX-App-Usage
Czas oczekiwania w nagłówkuTak, estimated_time_to_regain_accessNie
Kod błędu800014, 17 lub 32

Narzędzie do planowania z niewielką liczbą dziennych aktywnych użytkowników, ale z aktywnymi Stronami klientów, ma znacznie więcej miejsca na tokenach Strony niż na tokenach aplikacji. Popularna aplikacja obsługująca ciche Strony ma odwrotnie.

Mnożnik 4 800 nie występuje tylko przy Stronach. Meta stosuje tę samą liczbę dla Instagrama, gdzie mnoży ją przez wyświetlenia zamiast zaangażowanych użytkowników, a instagramowa wersja wzoru ma własne osobliwości nagłówka. Tylko wersja dla Stron zależy od wysłanego tokenu.

Najczęściej zadawane pytania

Jaki jest wzór limitu business use case Mety dla Stron?

Calls within 24 hours = 4800 * Number of Engaged Users, przy czym Meta definiuje zaangażowanych użytkowników jako "the number of Users who engaged with the Page per 24 hours." Wzór dotyczy wywołań Pages API wykonywanych tokenem Strony lub użytkownika systemowego.

Który kod błędu oznacza, że Strona osiągnęła limit business use case?

Błąd 80001 z komunikatem "There have been too many calls to this Page account. Wait a bit and try again." Błąd 32 to kod Platform Rate Limits dla wywołań Pages API wykonanych tokenem użytkownika lub aplikacji.

Czy token użytkownika korzysta z limitu business use case na Stronach?

Nie. Meta kieruje wywołania Pages API wykonane tokenem aplikacji lub użytkownika do Platform Rate Limits. Wywołania tokenem użytkownika obciążają jego własny godzinowy licznik, którego Meta nie ujawnia, a wywołania tokenem aplikacji godzinową pulę 200 * Number of Users. Z limitu business use case korzystają tylko tokeny Strony i użytkownika systemowego.

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Jak długo czekać po błędzie 80001?

Odczytaj estimated_time_to_regain_access we wpisie pages nagłówka X-Business-Use-Case-Usage. Meta definiuje tę wartość jako czas w minutach do zakończenia ograniczania wywołań. Do tego momentu nie wykonuj wywołań dla tej Strony, bo według Mety kolejne wydłużają blokadę.

Co oznaczają zaangażowani użytkownicy w limicie Mety dla Stron?

Meta podaje tylko, że to liczba użytkowników, którzy zaangażowali się na Stronie w ciągu 24 godzin, i nie wymienia kwalifikujących działań. Ta sama strona o limitach używa "Engaged Users" przy Messengerze w innym znaczeniu: jako liczby osób, do których firma może pisać.

Dlaczego Meta zaleca token użytkownika systemowego przy Page Public Content Access?

Dokumentacje Page Feed i Page Photos zalecają aplikacjom korzystającym z Page Public Content Access użycie tokenu użytkownika systemowego "to avoid rate limiting issues." Taki token przenosi odczyty z godzinowej puli Platform do 24-godzinnej puli business use case.

Czym różni się błąd 80001 od błędu 32 przy wywołaniach Stron?

Błąd 80001 to błąd business use case dla tokenów Strony i użytkownika systemowego, z komunikatem "There have been too many calls to this Page account". Błąd 32 to kod Platform Rate Limits dla wywołań Pages API wykonanych tokenem użytkownika lub aplikacji. Tabela błędów business use case Mety przypisuje 32 do wywołań tokenem użytkownika, co przeczy reszcie dokumentu. Traktuj 32 jako błąd Platform i kieruj oba błędy do różnych ścieżek obsługi.

Ile wywołań dostaje Strona na Facebooku z 50 zaangażowanymi użytkownikami w 24 godziny?

Strona daje 240 000 wywołań, czyli 4 800 razy 50, w kroczącym oknie 24 godzin. Strona bez zaangażowanych użytkowników daje według tego samego rachunku zero. Sekcja o Stronach nie ustala minimum, w przeciwieństwie do sekcji Threads, która przyjmuje domyślnie 10 wyświetleń.

Czy dwie Strony podłączone do tej samej aplikacji dzielą jedną pulę?

Meta tego nie mówi. Wzór wylicza pulę z zaangażowania na jednej Stronie, ale wywołania obciążają licznik aplikacji. Nagłówek X-Business-Use-Case-Usage grupuje zużycie według identyfikatora firmy powiązanej z tokenem, a nie według Strony, więc czytaj każdy wpis zamiast zakładać osobną pulę dla każdej Strony.

Czy limit business use case ogranicza liczbę postów publikowanych przez Stronę?

Ogranicza wywołania API, a nie posty. Dzienne limity publikacji na Facebooku to osobny system z osobnymi błędami. Wywołania publikujące do POST /{page-id}/feed nadal obciążają pulę wywołań, bo działają na tokenach Strony.

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