Yandex Metrica Offline Conversions

Renta загружает офлайн-конверсии из вашего хранилища данных в счётчик Яндекс Метрики: каждая строка модели становится конверсией, которую Яндекс привязывает к породившему её визиту.

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

Аутентификация

Renta авторизуется через Yandex OAuth. Авторизуйте аккаунт Яндекса, у которого есть права на чтение и редактирование нужного счётчика.

Подготовьте счётчик

Офлайн-конверсия привязывается к цели, и принимает её только цель типа «офлайн-конверсия». Создайте такую цель в Яндекс Метрике заранее, в разделе Настройки > Цели, и запомните её идентификатор. Это число вы замаппите на Target.

Подготовьте модель данных

Пайплайн Reverse ETL читает данные из модели: это SQL-запрос, сохранённый в разделе Data models, который решает, какие строки хранилища синхронизировать и что лежит в каждой строке. Создайте её до пайплайна, потому что выпадающие списки маппинга заполняются её колонками.

Renta отправляет каждое значение ровно в том виде, в каком его вернул запрос, поэтому за форматы отвечает модель. DateTime должен быть Unix-временем в секундах, а в идентификаторе должно лежать то самое значение, по которому Яндекс знает посетителя.

Настройка пайплайна

На последнем шаге выберите, какой счётчик принимает конверсии и какие колонки их описывают.

Что отправляет Renta

Выберите объект, модель данных и счётчик.

1. What would you like Renta to send to Yandex Metrica.
   Basic здесь единственный объект. Конверсии по звонкам и чатам загружаются через отдельные методы Яндекса, которые это назначение не использует.
2. Data model.
   Модель для синхронизации. Колонки, доступные для сопоставления и маппинга ниже, берутся из неё.
3. Counter ID.
   Счётчик, которому принадлежат конверсии. В списке все счётчики, доступные авторизованному аккаунту Яндекса.

Сопоставление записей

Укажите, какая колонка идентифицирует посетителя, чтобы Яндекс привязал конверсию к нужной сессии.

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

Маппинг полей

Свяжите колонки хранилища с остальными полями офлайн-конверсии. Обязательны Target и DateTime, остальное по желанию.

Кнопка + Static отправляет одно и то же значение в каждой строке: так обычно и задают идентификатор цели. Кнопка + Variable отправляет значение запуска, например имя пайплайна.

Поведение синхронизации

Задайте, что происходит с конверсией, чья строка исчезла из модели, и назовите пайплайн.

1. When a source row is deleted.
   Ignore здесь единственный вариант. У Яндекса нет метода удаления офлайн-конверсий, поэтому исчезновение строки из модели ничего не меняет на его стороне.
2. Integration name.
   Имя вашего пайплайна. Измените его под свои задачи.

Расписание

Выберите, как часто запускается пайплайн.

Для расписания Daily укажите Update time (точное время старта каждого запуска) и нажмите Create pipeline.

Новый пайплайн появится в разделе Pipelines на вкладке Reverse ETL, где видно его запуски и прогресс.

Стратегия синхронизации

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

Renta загружает данные файлами до 10 000 строк. Яндекс сначала принимает файл и только потом сопоставляет его с визитами, поэтому запуск считается успешным в момент приёма файла.

Ограничения

1. Конверсии только добавляются.
   Загруженное в счётчик нельзя ни исправить, ни удалить. Проверяйте маппинг на маленькой модели, прежде чем направлять пайплайн на всю историю.
2. Атрибуция обрывается на 21 дне.
   Яндекс связывает конверсию только с визитом, который случился в предыдущий 21 день. Более старые строки принимаются и остаются несопоставленными.
3. Один идентификатор и одна цель на пайплайн.
   И тип идентификатора, и идентификатор цели фиксированы для всей загрузки. Чтобы передавать две цели или сопоставлять часть строк по ClientId, а часть по Yclid, нужны отдельные пайплайны.
4. Обработка не мгновенная.
   Конверсия появляется в отчётах Яндекс Метрики в течение пары часов после приёма файла. Следите за ней в счётчике, а не в Renta.
5. Запуск останавливается при потоке отказов.
   Renta останавливает запуск, когда отклонено больше 30% партии или больше 10% строк, загруженных с начала запуска. Уже принятые конверсии остаются в счётчике, а следующий запуск продолжит с места остановки.