Как выбрать модель атрибуции в Директ API для точных отчетов в России

В отчетах API Яндекс Директа доступны четыре модели атрибуции: первый переход, последний переход, последний значимый переход и последний переход из Яндекс Директа. Директ API модель атрибуции задает правило распределения конверсий в отчете: одна и та же заявка или продажа может относиться к разным рекламным кампаниям.

Чтобы расход, клики, показы, CTR, переходы и конверсии отражали одну согласованную логику, запросы API, структуру отчёта и автоматическую выгрузку нужно настраивать вместе. Рекламную статистику стоит сверять с Яндекс Метрикой, CRM и BI-аналитикой, не смешивая несопоставимые источники данных.

• Проведите аудит текущих отчётов Яндекс Директа, Метрики и CRM.
• Выберите модель атрибуции под цикл сделки и тип конверсии.
• Настройте запросы к API и структуру выгрузки.
• Сверьте кампании, цели, фильтры и показатели.
• Задокументируйте логику расчёта и правила интерпретации отчёта.

Если для задачи нужна платная модель — например, GPT-5.6 Terra — доступ к ней дешевле оформить не напрямую у вендора, а через сервис-партнёра Clodex. Разница в цене — ниже.

Как настроить модель атрибуции в API Яндекс Директа

Модель атрибуции в API Яндекс Директа относится к конкретному отчету. Она не закрепляется за рекламным аккаунтом, не меняет стратегию кампании и не влияет на алгоритм показов. Параметр определяет только то, какой переход или источник трафика получит конверсию в статистике.

1. Определите задачу отчёта. Какие решения должны приниматься по данным: перераспределение бюджета, контроль окупаемости канала, оценка первого касания, анализ заявок или сверка оплаченных продаж. Опишите целевые действия: заказ, заявка, звонок, оплата, повторная покупка или смена статуса в CRM.
2. Проверьте источники данных. Рекламные кампании Яндекс Директа, цели Яндекс Метрики, справочники CRM, товарные данные интернет-магазина, ручные таблицы и существующие BI-отчёты. До настройки API важно исключить ситуацию, когда в одном сравнении участвуют клики из Директа, визиты из Метрики и продажи CRM с разными правилами дедупликации лидов.
3. Выберите модель атрибуции. Для привлечения новой аудитории подходит первый переход. Для контроля канала перед заявкой или покупкой используют последний переход. Длинная цепочка касаний требует отдельного анализа, потому что одна модель не отвечает на все вопросы маркетинга и продаж.
4. Настройте запрос API и состав отчёта. Определите период отчёта, тип отчёта, поля по кампаниям, объявлениям, расходам, показам, кликам, CTR и конверсиям. Затем задайте фильтрацию, группировку, срезы по источникам и передайте модель атрибуции в спецификации отчёта. На этом шаге директ api модель атрибуции запросов сопоставляется с целями Яндекс Метрики и идентификатором счетчика.
5. Автоматизируйте выгрузку. Настройте передачу данных в таблицу, базу, CRM, Data Studio или другую BI-систему. Автоматическая выгрузка должна сохранять согласованную структуру полей, обрабатывать ошибки запросов и обновлять статистику по расписанию. После запуска отчетность все равно требует контроля при изменении целей, кампаний, прав доступа или справочников.
6. Сверьте результаты. Сопоставьте расход, переходы, визиты, конверсии, рекламные каналы и источники трафика. Проверьте период, часовой пояс, фильтры, окно конверсии, срезы, модель атрибуции и состав данных. Расхождения не всегда означают ошибку API: CRM может дедуплицировать лиды, Метрика может учитывать цели по своей логике, а продажи могут попадать в систему позже клика.
7. Задокументируйте схему. Опишите отчёт, правила расчёта показателей и рекомендации для маркетолога, аналитика и руководителя — так отчёт станет понятным инструментом для корректировки рекламных решений, а не набором цифр из разных систем.

Модели атрибуции в отчетах API Яндекс Директа

Коды FC, LC, LSC и LYDC используют при формировании отчета в API Яндекс Директа. Перед запуском регулярной загрузки стоит проверить допустимость выбранной модели для нужного типа отчёта по актуальной спецификации сервиса, потому что состав параметров и отчётных возможностей может меняться.

Иллюстративный кейс: интернет-магазин получил 100 заказов за отчетный период. При модели «последний переход» больше заказов оказалось у кампаний, которые возвращали пользователя перед покупкой. При модели «первый переход» часть этих же заказов была отнесена к кампаниям, которые впервые привели покупателя на сайт. После разделения отчетов компания перестала отключать кампании верхней части воронки только из-за низкого числа последних переходов.

Для автоматизации подходят Python, таблицы, базы данных и BI-аналитика — выбор зависит от состава источников. Подходы к автоматизации маркетинговых задач и работе с нейросетями собраны также в разделе ИИ для SEO и аналитики.

Для каких задач настраиваем атрибуцию и отчеты Директ API

Интернет-магазины и товарная реклама

Интернет-магазину нужно отличать кампанию, которая впервые привела покупателя на сайт, от кампании, вернувшей его к заказу. В сводном отчете можно сопоставить рекламную кампанию, категорию, товар, источник трафика, расход и выручку из системы заказов. Для сайта на OpenCart схема зависит от того, какие сведения доступны в CMS и как передаются заказы, статусы и товарные идентификаторы.

Модель атрибуции для товаров не существует отдельно от отчета. Товары, категории и заказы выступают дополнительными измерениями аналитики, а правило распределения конверсии выбирают по бизнес-задаче. Один отчет помогает оценить привлечение спроса, другой показывает кампанию перед оформлением заказа.

Услуги с заявкой и длинным циклом сделки

Пользователь может оставить заявку после нескольких визитов, а продажа появится в CRM после переговоров. В такой схеме недостаточно сравнить конверсию формы с числом оплат. Настройка связывает цели Яндекс Метрики, рекламные переходы, статусы лидов и правила дедупликации, чтобы маркетолог видел путь от обращения до результата.

Какая цифра считается основной: заявка или оплаченная продажа? Ответ зависит от управленческой задачи. Для контроля трафика полезны заявки и звонки, для оценки качества рекламного канала нужны статусы CRM, выручка и причины отказов, если их ведет отдел продаж.

B2B и сложные продажи

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

Сквозная аналитика не создает абсолютную точность сама по себе. Она помогает документировать правила сопоставления, отделять дубли от новых лидов и показывать, где заканчиваются данные Директа и начинаются данные CRM.

Маркетплейсы и продажи через несколько каналов

Ozon может выступать источником коммерческих данных для сводной аналитики, если бизнес сопоставляет рекламные расходы с продажами через сайт, маркетплейс и другие каналы. API Яндекс Директа не получает атрибуцию маркетплейса автоматически. Для такого сценария нужна отдельная схема объединения рекламной статистики, товарных данных и правил расчета выручки.

Здесь полезно заранее разделить показатели. Директ передает расход, показы, клики, CTR и конверсии по доступным целям. Система продаж хранит заказы, возвраты, выкуп и маржинальность. BI-отчет объединяет эти наборы только после согласования ключей, периодов и уровня детализации.

Агентства и несколько рекламных кабинетов

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

Для контроля поисковой видимости и сопоставления рекламного трафика с SEO-показателями полезен обзор Topvisor для SEO-аналитики и мониторинга позиций. Он не заменяет API Яндекс Директа, но помогает разделять задачи поискового продвижения и контекстной рекламы.

Если по ходу чтения решите взять платный тариф — сравните официальную цену с ценой через партнёра, прежде чем оформлять подписку напрямую: разница обычно в разы, расчёт есть в начале и в конце статьи.

Что проверяем до запуска автоматической выгрузки

До запуска нужны права доступа к рекламному аккаунту, счетчикам Яндекс Метрики и согласованным источникам CRM. Проверяем идентификаторы целей, периоды, часовые пояса, фильтры, поля отчета и правила сопоставления кампаний. Ошибка в одном из этих элементов способна изменить результат сравнения даже при корректном запросе API.

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

Что усложняет настройку Директ API и модели атрибуции

Объём работы растёт не линейно: один кабинет с несколькими целями и выгрузкой в таблицу — это часы, а несколько рекламных аккаунтов, CRM, товарная аналитика и регулярная загрузка в BI-систему — уже полноценный проект.

• Количество рекламных кабинетов и кампаний — чем больше источников, тем сложнее контроль структуры данных.
• Число целей и типов конверсий — каждая требует отдельной проверки логики учёта и модели атрибуции.
• Наличие CRM — может потребоваться сопоставление лидов, продаж, статусов и рекламных источников.
• Формат результата — таблица, база данных и BI-дашборд требуют разного объёма работ.
• Качество исходной аналитики — некорректные цели, дубли лидов и несогласованные справочники увеличивают объём предварительного аудита.

FAQ

Настройте отчёты Директ API без смешения несопоставимых данных

Начните с проверки источников, доступов, целей и ожидаемого формата результата. Затем выберите логику атрибуции, настройте запрос API, автоматическую выгрузку и сверку с Яндекс Метрикой, CRM или BI-аналитикой — по шагам выше.

• Единая логика распределения конверсий между рекламными кампаниями.
• Понятные отчёты по расходам, переходам, кликам и результатам рекламы.
• Регулярная загрузка статистики без ручного объединения файлов.
• Документированные правила расчёта для маркетинга и руководителей.

SEO Разум развивает образовательный блог с практическими материалами по SEO, аналитике и ИИ-инструментам.

Платный доступ через API

Если бесплатных лимитов не хватает, доступ к моделям по API можно оформить напрямую у вендора или через сервис-партнёра Clodex — ниже сравнение официальных цен и цены через партнёра. Например, GPT-5.6 Terra через партнёра дешевле официальной цены в 28,6 раза — полный список моделей в таблице.