Глосарій для людей, чий блог публікується автоматично
Дванадцять термінів зі світу даних про посилання та конвеєрів публікації, кожен із назвою поля, яке ви побачите в JSON, та помилкою, яку люди часто роблять.
Дослідницька команда SEOBlogBot ·
Як читати цю сторінку
Це сторінка термінів, а не теорії. Переходьте до потрібного запису, оскільки кожен з них є самостійним.
Кожен запис містить назву поля, яке ви побачите в JSON, короткий опис значення та помилку, яку люди часто роблять. Якщо у вас мало часу, спочатку прочитайте рядок про помилку.
Терміни подано в порядку, у якому конвеєр з ними стикається: дані про посилання, гроші, збої та перевірки, узгоджені командою.
Люди шукають перевірку зворотних посилань SEO Moz, тому що бачили Domain Authority в звіті й хочуть отримати те саме число в скрипті. Наш рейтинг — це інший показник, тому в кожному записі пояснюється, що означає термін тут і чим він відрізняється від великих інструментів.
Три плутанини, що коштують реального часу
Кількості часто плутають більше, ніж будь-що інше, включаючи числа зі звіту перевірки зворотних посилань SEO Moz. Сайт із 10 000 зворотних посилань від 40 посилаючих доменів значно менший у термінах графа посилань, ніж сайт із 2 000 зворотних посилань від 900 посилаючих доменів.
Наш рейтинг побудовано саме на посилаючих доменах з цієї причини. Ворітця, що читають сукупну кількість зворотних посилань, легко обдурити одним посиланням у нижньому колонтитулі всього сайту.
Четверта помилка — читання рейтингу без дати. Рейтинг весною та восени — це вже різні вимірювання, якщо індекс оновився між цими моментами.
Вказуйте дату для кожного рейтингу, який ви копіюєте в звіт, навіть якщо в звіті лише один стовпець із числами.
Використовуйте одне ім’я для кожного об’єкта в команді та в логах, щоб пошук знаходив кожну важливу рядок.
Друга пастка — слово free. overview безкоштовний, але refdomains коштує 2 кредити, а перша відповідь з _credits покаже, який саме запит ви зробили.
Читання рейтингу без самообману
Рейтинг — це число на шкалі, і у шкали є форма. Найважливіші дві ідеї. Обидві знову з’являться в посібниках із ворітцями та аудитом, тому варто розібратися в них тут.
Чому шкала логарифмічна
Перехід від 20 до 30 посилаючих доменів змінює рейтинг значно більше, ніж перехід від 400 до 410. Логарифмічна шкала стискає великі числа, тому верхня частина діапазону змінюється повільно. Плануйте порогові значення, враховуючи цю форму, а не сприймайте кожну точку як рівну.
Що таке підлога (floor)
Підлога — це найнижчий рейтинг, який ви приймаєте для хоста, куди виходите. Це локальне правило, встановлене на основі ваших власних публікацій, і жодна інша команда його не використовує. Запишіть його з датою встановлення, щоб пізніший огляд знав, проти чого вимірювалося.
Підлога, встановлена на основі тридцяти публікацій, є лише стартовою точкою. Вона стає правилом лише після того, як команда використала її протягом принаймні одного повного оновлення.
Читання відповіді по полях
Починайте з ok. Кожна відповідь містить його, а автентифіковані відповіді додають _credits із вартістю та залишком балансу.
Аналізуйте ці два поля перед усім іншим. Конвеєр, який читає дані з відповіді, де ok дорівнює false, охочо запише сміття у ваш лог, тому ця перевірка коштує один рядок коду.
Зберігайте оригінальну відповідь для кожного збою. Назви полів чутливі до регістру в більшості парсерів. Точно збігайте ok та _credits. Коли число здається неправильним у щомісячному звіті, збережена відповідь показує, що API надіслав насправді, що є найшвидшим способом вирішити суперечку.
Терміни даних про посилання
01
Посилаючий домен
Унікальний сайт, який посилається на ваш, рахується один раз, скільки б посилань він не надсилав. Дія refdomains перелічує їх, 2 кредити за запит.
02
Зворотне посилання
Одне посилання з однієї сторінки на іншу. Наш індекс містить близько 798,5 мільярдів таких посилань, а дія backlinks повертає до 1000 рядків за запит.
03
Ярковий текст (anchor text)
Клікабельні слова посилання. anchors повертає розподіл, і несприятливе скупчення одного фрази — це те, на що варто звертати увагу.
04
DR (наш рейтинг)
round(100 x log(ref_domains + 1) / log(20,000,000)). Логарифмічна шкала, тому стрибок від 20 до 30 більший, ніж від 60 до 70.
05
DA та Ahrefs DR
Показники інших інструментів із власними формулами. Вони не збігатимуться з нашим числом, тому ніколи не змішуйте їх у одному пороговому значенні.
06
Граф посилань
Карта того, хто на кого посилається. Наш граф містить 181 132 097 доменів і 2 774 625 913 посилань між доменами.
Терміни грошей простими словами
Слова, пов’язані з билінгом, з’являються в кожному огляді конвеєра, і кожне з них має конкретне значення тут. Більша частина плутанини виникає через припущення, що слово означає те саме, що й на інвойсі підписки.
Попередньо оплачений кредит
Ви купуєте кредити заздалегідь, і кожен платний запит зменшує їх. Немає підписки, яку потрібно скасувати, і немає щомісячного мінімуму, який потрібно виконати.
Поповнення в USDT (TRC-20)
Ви додаєте баланс на сторінці облікового запису, сплачуючи USDT в мережі TRC-20. Поповнення — це те, як зростає баланс, тому завданню, яке зупинилося через 402, потрібне одне перед повторним запуском.
Безкоштовні та платні дії
Безкоштовні дії: domain, overview, stats та suggest. Кожна інша дія витрачає кредити, від 1 до 3 за запит, а відповідь показує точну суму.
Швидкий підсумок допоможе: за $0,0001 за кредит, тисяча платних запитів, кожен з яких коштує один кредит, обходиться приблизно в десять центів.
Слова про збої, які мають значення в конвеєрі
Конвеєр може збійти способами, які ніколи не покаже одиночний запит. Ці три терміни називають збої, які команди найчастіше пропускають. Більшість із них з’являються лише тоді, коли завдання виконується без нагляду. Ніхто не спостерігає за запланованим запуском.
Команди, які записують ці терміни заздалегідь, витрачають менше часу на суперечки про них пізніше.
Частковий збій
Завдання, яке виконує чотири речі і завершує три, збійшло так, як це має значення. Публікація оброблена наполовину, і нічого в логах не каже про це, якщо хтось не перевірить кожен крок. Виправлення — це результат для кожного кроку, щоб лог називав крок, який не завершився.
Постумовна умова (postcondition)
Стан, який завдання мало залишити після себе, наприклад, публікація з позначкою Scheduled із часом публікації. Перевіряйте постумовну умову після дії, а не лише код статусу запиту. Запишіть її як так чи ні, наприклад, чи є статус Scheduled і чи час публікації все ще в майбутньому.
Порожній результат
Відповідь, яка успішна, але не містить рядків. Це питання для дослідження, а не факт для тихого логування. Порівняйте його з тим самим доменом минулого місяця, перш ніж вирішити, що це.
Пройдіть одну відповідь від запиту до рядка логу
Один і той самий шлях працює для кожної дії, тому напишіть його один раз і використовуйте для кожного запиту.
01
Надішліть запит
Зверніться до кінцевої точки з ключем у заголовку Bearer і помістіть дію та домен у рядок запиту.
02
Перевірте HTTP-статус
401 або 402 зупиняє завдання до того, як буде проаналізовано будь-що.
03
Проаналізуйте JSON
Підтвердіть, що тіло парситься і що ok дорівнює true. Тільки тоді читайте поля даних.
04
Запишіть рядок
Збережіть дату, дію, значення _credits та баланс. Один рядок на запит робить лог легким для підсумовування.
Терміни конвеєра
01
Ворітця (Gate)
Перевірка, яка може зупинити публікацію перед відправкою. Дивіться дерево рішень.
02
Аудит
Перевірка, яка запускається після публікації і звітує, а не блокує. Посібник запуску має розклад.
03
Ідемпотентний запуск
Завдання, яке можна повторити без зміни результату. Запити API тільки для читання є ідемпотентними; ваші сповіщення Slack зазвичай ні, тому зменшуйте дублікати.
04
Кредит
Одиниця билінгу. Один кредит дорівнює $0,0001, а поле відповіді _credits показує вартість та баланс.
05
HTTP 401 проти 402
401 означає відсутній або неправильний ключ; 402 означає, що кредити закінчилися. Повторна спроба не виправить жодного з них.
06
Вікно оновлення
Наші дані оновлюються приблизно раз на місяць. Нове посилання може не з’явитися тижнями, тому сповіщення мають порівнювати місяці.
Одна повторювана помилка
Команди встановлюють підлогу DR на основі скріншота іншого інструмента, наприклад, Moz DA або Ahrefs DR, а потім дивуються, чому половина гарних публікацій затримується. Спочатку калібруйте на власних публікаціях.
Терміни, які потрібно узгодити перед написанням посібника запуску
Яке поле відповіді вирішує pass або fail.
Чи є порожній результат попередженням чи помилкою.
Хто володіє сповіщенням, коли кредити закінчуються.
Формат дати та часовий пояс, що використовуються в логах.
Що вважається значущою зміною між двома щомісячними знімками.
Де закінчуються терміни
Деякі терміни тут є нашими власними, наприклад DR та кредит. Якщо термін суперечить тому, що показує ваша власна відповідь, довіряйте відповіді.
Коли колега цитує Moz DA, перевірте, який саме показник він має на увазі, перш ніж порівнювати його з нашим. Два показники використовують різні вхідні дані та різні формули, тому одне число ніколи не є заміною іншого.
Тримайте цю сторінку відкритою, поки пишете першу версію завдання, і закрийте її, коли рядки логів стануть зрозумілими самі по собі.
Оберіть одну людину, яка відповідатиме на запитання про ці терміни, щоб відповіді залишалися послідовними в команді.
Терміни допомагають лише тоді, коли їх використовують однаково всі, хто читає лог. Узгодьте значення до першого запуску, і сторінка виконає свою роботу.
Запишіть різницю перед тим, як змінити будь-який код. Сторінка облікового запису — це місце, де починаються питання щодо вашого власного облікового запису.
