Dwanaście terminów ze świata danych linkowych i potoków publikacji, każdy z nazwą pola, którą zobaczysz w formacie JSON, oraz błędem, jaki ludzie często w nim popełniają.
Zespół badawczy SEOBlogBot ·
Jak czytać tę stronę
To strona z definicjami, a nie wykładem teoretycznym. Przejdź do wybranego hasła, ponieważ każde z nich jest niezależne.
Każde hasło zawiera nazwę pola, którą zobaczysz w odpowiedzi JSON, krótkie wyjaśnienie oraz błąd, jaki ludzie często w nim popełniają. Jeśli masz mało czasu, przeczytaj najpierw sekcję dotyczącą błędów.
Hasła zostały uporządkowane zgodnie z kolejnością, w jakiej potok danych je przetwarza: najpierw dane o linkach, potem kwestie finansowe, następnie błędy, a na końcu sprawdzenia, na których uzgadnia się zespół.
Ludzie szukają narzędzia SEO Moz Backlink Checker, ponieważ widzieli wskaźnik Domain Authority w raporcie i chcą uzyskać tę samą wartość w skrypcie. Nasz wskaźnik to inna metryka, dlatego każde hasło wyjaśnia, co termin oznacza w naszym systemie i чем różni się od narzędzi od dużych graczy.
Trzy nieporozumienia, które kosztują cenny czas
Liczby są mylone częściej niż cokolwiek innego, w tym dane z raportu narzędzia SEO Moz Backlink Checker. Strona z 10 000 backlinkami od 40 domen odsyłających jest znacznie mniejsza w kontekście grafu linkowego niż strona z 2000 backlinkami od 900 domen odsyłających.
Nasz wskaźnik został zbudowany właśnie na podstawie domen odsyłających. Bramka, która czyta surowe całkowite liczby backlinków, jest łatwa do oszukania jednym linkiem w stopce na całej stronie.
Czwartym błędem jest odczytywanie wskaźnika bez daty. Wskaźnik z wiosny i ten z jesieni to nie to samo pomiar, gdy między nimi nastąpiła aktualizacja indeksu.
Podawaj datę przy każdym wskaźniku, który kopiujesz do raportu, nawet jeśli raport zawiera tylko jedną kolumnę z liczbami.
Używaj jednej nazwy dla każdego elementu w całym zespole i w logach, aby wyszukiwanie znajdowało każdą istotną linię.
Drugą pułapką jest słowo „free”. overview jest darmowe, ale refdomains kosztuje 2 kredyty, a pierwsza odpowiedź z polem _credits informuje Cię, jakiego rodzaju wywołania dokonałeś.
Odczytywanie wskaźnika bez oszukiwania samego siebie
Wskaźnik to liczba na skali, a skala ma swój kształt. Najważniejsze są dwa pojęcia. Oba ponownie pojawią się w przewodnikach dotyczących bramki i audytów, więc warto je zrozumieć już teraz.
Dlaczego skala jest logarytmiczna
Przejście od 20 do 30 domen odsyłających zmienia wskaźnik znacznie bardziej niż przejście od 400 do 410. Skala logarytmiczna kompresuje duże liczby, dzięki czemu górna część zakresu zmienia się powoli. Planuj progi uwzględniając ten kształt, a nie traktując każdy punkt jako równoważny.
Czym jest próg dolny (floor)
Próg dolny to najniższy akceptowalny wskaźnik dla hosta docelowego (outbound). To reguła lokalna, ustawiona na podstawie Twoich własnych publikacji, której nie stosują inne zespoły. Zapisz ją wraz z datą ustawienia, aby późniejsza recenzja wiedziała, na jakiej podstawie dokonano pomiaru.
Próg dolny ustawiony na podstawie trzydziestu publikacji to punkt wyjścia. Staje się pełnoprawną regułą dopiero po tym, jak zespół przetestuje go przez co najmniej jeden pełny cykl aktualizacji.
Odczytywanie odpowiedzi pole po polu
Zacznij od pola ok. Każda odpowiedź je zawiera, a odpowiedzi uwierzytelnione zawierają additionally _credits z kosztem i pozostałym saldem.
Przeanalizuj te dwa pola jako pierwsze. Potok, który odczytuje dane z odpowiedzi z wartością ok równą false, bez wahania zapisze śmieci do logu, więc ten sprawdzający kosztuje jedną linię kodu.
Zachowaj surową odpowiedź dla każdego błędu. Nazwy pól w większości parserów są wrażliwe na wielkość liter. Dopasuj ok i _credits dokładnie. Gdy w miesięcznym raporcie liczba wydaje się niepoprawna, zapisana odpowiedź pokazuje, co faktycznie zwróciła API, co jest najszybszym sposobem na rozstrzygnięcie sporu.
Terminologia dotycząca linków
01
Domena odsyłająca
Wyodrębniona domena, która linkuje do Twojej, liczona raz niezależnie od liczby wysłanych linków. Akcja refdomains wypisuje je, kosztując 2 kredyty za wywołanie.
02
Backlink
Jeden link ze strony na inną. Nasz indeks zawiera około 798,5 miliarda takich linków, a akcja backlinks zwraca do 1000 wierszy za wywołanie.
03
Tekst kotwicy
Klikalne słowa linku. anchors zwraca rozkład, a nienaturalne skupisko jednej frazy jest tym, na co należy zwracać uwagę.
04
DR (nasza ocena)
round(100 x log(ref_domains + 1) / log(20,000,000)). Skala logarytmiczna, więc skok od 20 do 30 jest większy niż od 60 do 70.
05
DA i Ahrefs DR
Metryki innych narzędzi z ich własnymi wzorami. Nie będą one równe naszemu wynikowi, więc nigdy nie mieszaj ich w jednym progu.
06
Graf linkowy
Mapa tego, kto linkuje do kogo. Nasz graf obejmuje 181 132 097 domen i 2 774 625 913 linków między domenami.
Terminy finansowe prostym językiem
Słowa związane z rozliczeniami pojawiają się w każdym przeglądzie potoku, a każde z nich ma tu konkretne znaczenie. Większość nieporozumień wynika z założenia, że słowo oznacza to samo co na fakturze subskrypcyjnej.
Kredyty prepay
Kupujesz kredyty z góry, a każde płatne wywołanie je zużywa. Nie ma subskrypcji do anulowania ani miesięcznego minimum do spełnienia.
Doładowanie w USDT (TRC-20)
Dodajesz saldo ze strony konta, płacąc USDT w sieci TRC-20. Doładowania to sposób na wzrost salda, więc zadanie, które zatrzyma się na kodzie 402, potrzebuje doładowania, aby uruchomić się ponownie.
Akcje darmowe i płatne
Darmowe akcje to domain, overview, stats i suggest. Każda inna akcja pobiera kredyty, od 1 do 3 za wywołanie, a odpowiedź pokazuje dokładną kwotę.
Szybkie podsumowanie: przy cenie 0,0001 $ za kredyt, tysiąc płatnych wywołań kosztujących po jednym kredicie daje łącznie około dziesięć centów.
Kluczowe słowa błędów w potoku
Potok może zawieść na sposoby, których pojedyncze wywołanie nie pokaże. Te trzy terminy opisują błędy, które zespoły najczęściej przeoczają. Większość z nich pojawia się tylko wtedy, gdy zadanie działa w tle. Nikt nie obserwuje zaplanowanego uruchomienia.
Zespoły, które zapisują te terminy na wczesnym etapie, spędzają mniej czasu na ich dyskusjach później.
Częstowa awaria
Zadanie, które wykonuje cztery czynności, a kończy trzy, zawodzi w sposób istotny. Publikacja jest przetworzona w połowie, a nic w logach tego nie wskazuje, chyba że ktoś sprawdzi każdy krok. Rozwiązaniem jest raportowanie wyniku dla każdego kroku, dzięki czemu log wskazuje krok, który nie został ukończony.
Warunek końcowy
Stan, w jakim zadanie obiecało zostawić zasób, np. publikację oznaczoną jako Zaplanowana z czasem publikacji. Sprawdź warunek końcowy po wykonaniu akcji, a nie tylko kod statusu wywołania. Zapisz go w formie pytania tak/nie, np. czy status to Zaplanowany, a czas publikacji nadal jest w przyszłości.
Pusty wynik
Odpowiedź, która zwraca sukces, ale nie zawiera żadnych wierszy. To sygnał do zbadania, a nie fakt do cichego zalogowania. Porównaj go z danymi z tego samego domenu z poprzedniego miesiąca, zanim podejmiesz decyzję.
Przeanalizuj jedną odpowiedź od żądania do wpisu w logu
Ta sama ścieżka działa dla każdej akcji, więc zapisz ją raz i używaj ponownie przy każdym wywołaniu.
01
Wyślij żądanie
Wywołaj endpoint z kluczem w nagłówku Bearer oraz akcją i domeną w parametrach zapytania.
02
Sprawdź status HTTP
Status 401 lub 402 zatrzymuje zadanie przed przetworzeniem jakichkolwiek danych.
03
Sparsuj JSON
Potwierdź, że ciało odpowiedzi poprawnie się parsuje i że ok ma wartość true. Dopiero wtedy odczytuj pola danych.
04
Zapisz wiersz
Zapisz datę, akcję, wartość _credits oraz saldo. Jeden wiersz na wywołanie ułatwia sumowanie logów.
Terminologia potoku
01
Bramka
Kontrola, która może zatrzymać publikację przed jej udostępnieniem. Zobacz drzewo decyzji.
02
Audyt
Kontrola uruchamiana po publikacji, która raportuje wyniki, a nie blokuje działania. Instrukcja obsługi zawiera harmonogram.
03
Wywołanie idempotentne
Zadanie, które można powtarzać bez zmiany wyniku. Wywołania API tylko do odczytu są idempotentne; powiadomienia Slack zazwyczaj nie są, więc należy je deduplikować.
04
Kredyt
Jednostka rozliczeniowa. Jeden kredyt to $0.0001, a pole odpowiedzi _credits pokazuje koszt i saldo.
05
HTTP 401 vs 402
401 oznacza brakujący lub błędny klucz; 402 oznacza wyczerpanie kredytów. Ponawianie próby nie naprawia żadnego z tych problemów.
06
Okno odświeżania
Nasze dane aktualizują się mniej więcej raz w miesiącu. Nowy link może nie pojawić się przez tygodnie, więc alert powinien porównywać miesiące.
Jeden powtarzający się błąd
Zespoły ustawiają próg DR na podstawie zrzutu ekranu z innego narzędzia, np. Moz DA lub Ahrefs DR, a następnie zastanawiają się, dlaczego połowa dobrych publikacji jest zatrzymywana. Kalibruj się najpierw na własnych publikacjach.
Terminy do uzgodnienia przed napisaniem instrukcji obsługi
Które pole odpowiedzi decyduje o przejściu lub niepowodzeniu.
Czy pusty wynik jest ostrzeżeniem, czy błędem.
Kto przejmuje odpowiedzialność za alert, gdy zabraknie kredytów.
Format daty i strefa czasowa używane w logach.
Co uznaje się za istotną zmianę między dwoma miesięcznymi snapshotami.
Gdzie kończą się terminy
Niektóre terminy są naszymi własnymi, np. DR i kredyt. Jeśli termin kłóci się z tym, co pokazuje twoja własna odpowiedź, zaufaj odpowiedzi.
Gdy kolega cytuję Moz DA, sprawdź, o którą metrykę dokładnie chodzi, zanim porównasz ją z naszą. Obie używają innych danych wejściowych i innych wzorców, więc jedna liczba nigdy nie jest zamiennikiem drugiej.
Zachowaj tę stronę otwartą podczas pisania pierwszej wersji zadania i zamknij ją, gdy wpisy w logach będą zrozumiałe same w sobie.
Wybierz jedną osobę do odpowiadania na pytania dotyczące tych terminów, aby odpowiedzi były spójne w całym zespole.
Terminy pomagają tylko wtedy, gdy są używane w ten sam sposób przez każdego, kto czyta log. Ustal znaczenie przed pierwszym uruchomieniem, a strona spełni swoją rolę.
Zapisz różnicę przed zmianą jakiegokolwiek kodu. Strona konta jest miejscem, gdzie zaczynają się pytania dotyczące twojego konta.
