Альтернативы DataForSEO, читайте как глоссарий действий

Что означает одна строка для каждого действия

Если вы попали сюда, ища альтернативы DataForSEO, этот глоссарий показывает, что возвращает действие, ориентированное только на ссылки, на уровне строк. Значение строки имеет решающее значение. Большинство людей ошибаются именно здесь, и это самая затратная часть.

Ссылающийся домен против бэклинка

Ссылающийся домен считается один раз, независимо от количества исходящих ссылок. Бэклинк — это одна ссылка с одной страницы на другую, поэтому один сайт может предоставлять их много. Если на графике указано «ссылки», а строки содержат домены, число представляет собой количество доменов и должно быть подписано соответствующим образом.

Определите гранулярность данных перед первым объединением. Таблица действий выше служит справочником по тому, какой вызов возвращает данные какой гранулярности.

Таблица, смешивающая эти два уровня, будет выглядеть как подсчет ссылок, хотя на самом деле это подсчет сайтов. Проверьте первые несколько строк визуально перед тем, как агрегировать данные.

Анкорный текст как категория, а не ключ

Анкорный текст хорошо работает как категориальный столбец. Вы можете группировать анкеры по классам: брендовые, общие и чистые URL, затем подсчитывать каждый класс для каждого ссылающегося домена. Это плохой ключ, так как одни и те же слова повторяются в разных ссылках.

Сохраняйте анкор как текст, приводите его к нижнему регистру один раз при импорте и никогда не объединяйте таблицы по этому столбцу.

Дата снимка

Снимок — это состояние индекса на месяц. Сохраняйте его дату рядом с каждым запросом, в имени файла или в столбце, чтобы сравнение по месяцам было корректным.

Два запроса с разными датами снимка — это еще не тренд, пока вы не проверите, что даты соответствуют заявленным на графике.

Полезная привычка — записывать дату снимка в первую строку каждого отчета, чтобы она сохранялась и на распечатке. Читатели забывают, где именно в файле указана дата, но они всегда читают первую строку.

Средние значения скрывают выбросы

Средние значения на логарифмической шкале вводят в заблуждение. Среднее арифметическое 20 и 60 равно 40, но это число не описывает ни один из сайтов и ничего не говорит о разбросе данных.

Сохраняйте минимальное и максимальное значения рядом со средним. Один очень крупный домен может сильно завысить среднее значение, и читатель графика не поймет этого, глядя только на среднее.

Чтение таблицы действий как модели данных

Каждое действие возвращает строки на определенном уровне, и смешивание уровней — самый быстрый способ получить двойной подсчет, поэтому думайте в терминах гранулярности.

refdomains возвращает одну строку на ссылающийся сайт, backlinks — одну строку на ссылку, anchors — одну строку на уникальный анкорный текст. Объединение первых двух умножает количество строк, поэтому агрегируйте данные перед объединением и проверяйте nrow() до и после.

Пагинация работает одинаково везде: page и per, при этом per должно быть от 10 до 5000, сортировка по sort и order=asc|desc. За один вызов возвращается до 1000 строк, а глубокая пагинация ограничена 50 000 строками, поэтому запрашивайте сортировку, которая выводит нужный результат на первое место.

По вопросам бюджета см. ноутбук по бюджету, а для выбора провайдера см. дерево решений.

Длинные таблицы вместо одного листа на запрос

Привычка открывать новый лист каждый месяц распространена. Ошибки начинаются именно там, и их трудно исправить. Единую длинную таблицу проще поддерживать в актуальном состоянии. Ее также легче проверять.

Подумайте об этом так. Каждый месяц добавляет строки в одну таблицу, а не создает новый объект для поддержки. Таблица становится длиннее, но ни одно число не нужно копировать вручную. Каждая строка содержит свою дату снимка, источник и гранулярность, что читатель может проверить одним взглядом.

Одна длинная таблица со столбцом snapshot

Многие начинают новый лист каждый месяц. Длинная таблица со столбцом snapshot хранит данные за все месяцы в одном месте, а фильтр заменяет копирование и вставку. Представьте, что вы выгружаете ссылающиеся домены для 30 сайтов за шесть месяцев. Это одна таблица для проверки, а не шесть листов для сверки.

Сводные данные становятся одним вызовом group_by() вместо отдельного листа на месяц. Храните исходные выгрузки без изменений, чтобы таблицу можно было перестроить с нуля в любое время.

Одни и те же столбцы, иначе объединение пройдет тихо и незаметно

Файлы от разных людей объединяются корректно только при совпадении имен столбцов, типов данных и кодировки. Проверяйте заголовок каждого файла перед объединением и останавливайте скрипт, если хотя бы один файл отличается.

Шаг переименования, сопоставляющий старые имена с именами из глоссария, занимает несколько строк. Это сэкономит время на повторном просмотре каждого графика, построенного из-за несоответствия.

Ведите короткий список имен столбцов, ожидаемых вашим ноутбуком, и сравнивайте с ним каждый новый файл перед запуском любых операций.

Два предупреждения перед построением модели

Поскольку DR — это наш собственный метрический показатель, рассчитанный только на основе количества ссылающихся доменов, он не равен Moz DA. Никогда не смешивайте его с Ahrefs DR в одной регрессии.

Подсчеты также зависят от краулинга. Сайт, показавший резкий скачок после обновления ядра в марте 2024 года, возможно, просто был прокраулен более полно в этом месяце, поэтому проверьте дату снимка, прежде чем сообщать клиенту какие-либо данные.

Относитесь к глоссарию как к контракту с вашим будущим «я». Если столбец удивит вас через шесть месяцев, определение выше — это то, что вы должны были принять за основу.

Привычки именования собственных столбцов

Переименовывайте при импорте и делайте это один раз.

Добавляйте префикс столбцов по действию, например refdomains или anchors, перед объединением, чтобы слияние никогда не создавало два столбца с одинаковым именем, но разным смыслом. Вынесите шаг переименования в функцию и используйте ее во всех ноутбуках, работающих с API.

Это занимает пять строк кода и экономит споры о том, что означает столбец, что является самым частым источником неверных чисел в отчете о ссылках.

Вопросы о действиях и терминах

Это вопросы, которые обычно возникают после получения первой таблицы ссылок в R.

С какого действия начать?

Начните с domain или overview, так как они бесплатны и не требуют ключа. Они показывают структуру ответа, прежде чем вы потратите кредит.

Переходите к bulk_dr, как только структура станет ясной, так как один вызов оценивает до 2000 доменов за один кредит.

Почему мои подсчеты отличаются от другого инструмента?

Каждый провайдер краулит веб с собственным расписанием и по-разному считает ссылки. Наш граф ссылок обновляется примерно раз в месяц, а DR здесь — это наш собственный показатель на логарифмической шкале.

Сравнивайте тренды по месяцам, а не точные совпадения.

Как рассчитывается DR?

DR равен round(100 натуральный логарифм (ссылающиеся домены + 1) / логарифм (2 10 в степени 7)).

Он зависит от одного входного параметра, поэтому вы можете пересчитать его на основе выгрузки ссылающихся доменов.

Нужен ли ключ для каждого действия?

Бесплатные действия выполняются без ключа. Платные действия принимают ключ в качестве параметра запроса или в заголовке Authorization Bearer.

Отсутствие или некорректность ключа возвращает HTTP 401, что является первой ошибкой, которую нужно проверять при сбое вызова.