Массовый импорт коротких ссылок из Google Sheets (реальный рабочий процесс кампании)

Запуски кампаний начинаются не в панели управления. Они начинаются в таблице, которой кто-то поделился в Slack. URL-адреса живут в колонке А, UTM-метаданные заполняют колонки с B по G, слаги находятся в колонке H, а в брифе сказано, что запуск завтра. Самая медленная часть процесса - копирование каждой строки в интерфейс сокращателя по одной ссылке за раз. Не потому, что это технически сложно, а потому, что нет причин делать это именно так.

Этот пост посвящен прямому рабочему процессу: как выглядит таблица, как она сопоставляется с эндпоинтом массового импорта Elido, трем путям импорта в зависимости от количества строк, шагу пробного запуска, который отлавливает ошибки до их попадания в продакшн, и фрагменту кода Apps Script, который автоматизирует все это по триггеру. Для более широкого контекста сквозной гигиены UTM основная статья о UTM-трекинге подробно описывает шаблоны рабочего пространства и серверную пересылку конверсий. Этот пост - часть этого пайплайна, посвященная переходу от таблицы к коротким ссылкам.

TL;DR

• Ведите по одной таблице на кампанию: target_url, slug, utm_source, utm_medium, utm_campaign, tags в качестве именованных колонок. Пустые колонки UTM заполняются из вашего шаблона рабочего пространства.
• Три пути импорта: вставка строк в интерфейс (до 1 000 строк), загрузка CSV (до 10 000 строк) или API через скрипт (неограниченно, повторяемо).
• Всегда сначала запускайте с dry_run=true. Предварительный просмотр показывает итоговую короткую ссылку и полностью отрендеренную строку UTM-запроса без сохранения изменений.
• Добавляйте префиксы к слагам кампаний (q2-, jun-), чтобы разграничить пространства имен. Коллизии проявятся при пробном запуске, а не в середине импорта.

Структура таблицы

Обязательными колонками являются target_url и одна из двух: slug или auto_slug. Все остальное необязательно, но имеет определенную интерпретацию при наличии.

Колонка	Обязательно	Примечания
target_url	да	Полный целевой URL, включая протокол
slug	одна из двух	Предпочтительно - дает предсказуемые короткие URL
auto_slug	одна из двух	Установите true, и Elido сгенерирует слаг
utm_source	необязательно	Переопределяет значение из шаблона рабочего пространства
utm_medium	необязательно	Переопределяет значение из шаблона рабочего пространства
utm_campaign	необязательно	Переопределяет значение из шаблона рабочего пространства
utm_content	необязательно	Обычно вариант креатива
utm_term	необязательно	Платное ключевое слово или сегмент аудитории
tags	необязательно	Разделенные запятыми, применяются к ссылке
title	необязательно	Отображается в списке ссылок в панели управления

Правило UTM простое: если target_url уже содержит параметры запроса ?utm_source= (или любые utm_*), эти значения передаются без изменений. Никакой перезаписи или слияния. Если в целевом URL нет UTM-параметров, Elido создает их из колонок UTM, используя шаблон вашего рабочего пространства для любых пустых колонок. Это важно на практике - некоторые команды используют заранее помеченные целевые URL для своего сервиса рассылок, и инструмент массового импорта, который незаметно перемечает их, ломает аналитику. Elido предупреждает о строках смешанного типа (некоторые UTM присутствуют, некоторые отсутствуют) и просит подтверждения.

Колонка тегов заслуживает отдельного упоминания. Значения представляют собой строки, разделенные запятыми: campaign:q2-spring, channel:paid-social, variant:hero-a. Такая трехчастная структура (dimension:value) дает вам фильтруемые оси в панели управления без необходимости отдельной настройки таксономии. Подробнее об этом в разделе о таксономии тегов ниже.

Три способа импорта

Вставка строк в интерфейс массового импорта (до 1 000 строк)

Для любого объема менее 1 000 строк самый быстрый путь - скопировать диапазон таблицы и вставить его в текстовое поле массового импорта. Интерфейс Elido автоматически распознает значения, разделенные табуляцией, при вставке из электронной таблицы и сопоставляет колонки по заголовкам. Вам не нужно экспортировать CSV; вы просто вставляете данные.

Это хорошо работает для самого распространенного случая: бриф кампании уже живет в Google Sheets, дедлайн запуска через час, и нет желания писать скрипты. Интерфейс показывает предварительный просмотр всех строк перед подтверждением (тот же dry-run, который вы получили бы через API) и позволяет исправить любые строки с ошибками прямо на месте перед продолжением.

Один нюанс: если в вашей таблице есть объединенные ячейки или сложное форматирование, вставка может привести к искажению данных. Надежный ход для любой таблицы с нетривиальной структурой - сначала скопировать данные на чистый лист (вставить как значения), а затем вставить очищенный диапазон в интерфейс импорта.

Загрузка CSV (до 10 000 строк)

Для запусков с более чем 1 000 строк (большие каталоги, коды мероприятий, персонализированные ссылки) подходит путь загрузки CSV, который обрабатывает до 10 000 строк. Экспортируйте таблицу как CSV (Файл > Скачать > CSV) и загрузите ее в диалоговом окне импорта. Сопоставление заголовков колонок идентично; разница в том, что большие загрузки обрабатываются асинхронно и сообщают о своем статусе через вебхук или эндпоинт опроса.

Экспорт CSV из Google Sheets через API (доступ получен 12.05.2026) поддерживает экспорт именованного диапазона, а не всего листа, что полезно, когда в вашей таблице кампании несколько вкладок или строк заголовков, которые вы не хотите очищать вручную.

Вызов API из скрипта (более 10 000 строк или регулярные запуски)

Для больших каталогов или для кампаний, которые запускаются еженедельно и требуют автоматизации того же процесса, правильным выбором будет путь через API. Две распространенные реализации: Apps Script (не требует локальных инструментов, работает в браузере) и Python (лучше подходит для команд с существующими пайплайнами данных). Эндпоинт в обоих случаях один и тот же.

curl -X POST \
  https://api.elido.app/v1/links/bulk \
  -H "Authorization: Bearer $ELIDO_TOKEN" \
  -H "Content-Type: multipart/form-data" \
  -F "csv=@q2_spring_links.csv" \
  -F "campaign_id=cmp_8a2f" \
  -F "dry_run=false" \
  -F "on_conflict=skip"

Параметр on_conflict контролирует, что происходит, когда слаг уже существует: skip оставляет существующую ссылку и записывает предупреждение, fail прерывает весь импорт при первой коллизии, а replace обновляет цель существующей ссылки. Для большинства импортов кампаний skip - правильный выбор по умолчанию: повторный запуск того же CSV не перезапишет уже созданные ссылки.

API принимает до 10 000 строк за один вызов. Для более крупных каталогов делайте импорт частями по 5 000 строк; каждый вызов независим и идемпотентен, если вы используете стабильные слаги.

Пробный запуск перед импортом (dry run)

Запускайте каждый импорт с dry_run=true перед финальным подтверждением. Ответ идентичен живому импорту (для каждой строки показана итоговая короткая ссылка, распарсенная строка UTM-запроса, список тегов и любые предупреждения), но ничего не записывается в базу данных.

Что ловит dry-run, чего не поймать иначе до запуска:

• Слаг в строке 14, который конфликтует с существующей ссылкой в вашем рабочем пространстве (выводится как предупреждение о конфликте)
• Колонка UTM, которую случайно оставили пустой (Elido помечает отсутствие utm_medium как предупреждение, а не критическую ошибку, но об этом стоит знать до запуска)
• target_url с лишним пробелом в конце, который сохранился при копировании таблицы (итоговый URL в CSV выглядит нормально, но фактическая цель имеет добавленный %20)
• Значения тегов, превышающие 32 символа (незаметно обрезаются; пробный запуск делает сохраненное значение видимым)

Ответ dry-run разбивается на страницы в том же формате, что и результат реального импорта. Откройте первую страницу, выборочно проверьте строку 2 (первую строку данных после заголовка) и последнюю строку. Затем посмотрите на любые строки с предупреждениями. Две минуты проверки избавляют от ошибок, которые иначе всплыли бы как «почему эта ссылка кампании выдает 404?» на следующее утро после запуска.

Конфликты слагов

Конфликты слагов возникают, когда слаг, который вы пытаетесь импортировать, уже существует в вашем рабочем пространстве или на вашем пользовательском домене. Импорт выводит их в ответе dry-run с типом конфликта (same_workspace, same_domain, reserved) и целевым URL существующей ссылки.

Практическое решение - использование пространств имен. Добавляйте к слагам кампании короткий идентификатор: q2-, jun26-, sm- (для соцсетей), em- (для имейлов). Слаг типа q2-spring-hero-a вряд ли столкнется с чем-либо из предыдущей кампании. Префиксы также делают фильтрацию в панели управления очевидной - все ссылки с тегом q2-* принадлежат одному кварталу кампании.

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

Таксономия тегов

Теги, примененные во время импорта, получают ту же трехчастную структуру, что и колонки таблицы: campaign:q2-spring, channel:email, variant:hero-a. Когда вы позже откроете панель управления и отфильтруете по channel:email, вы не будете просеивать произвольные текстовые строки - вы будете запрашивать согласованную таксономию.

Названия измерений (campaign, channel, variant) берутся из соглашений вашей команды, а не из какой-либо схемы, навязанной Elido. Ограничение заключается в формате: двоеточие в качестве разделителя, отсутствие пробелов в ключе, значения менее 32 символов. Команды, которые обеспечивают это в таблице (колонка tags, которую формула собирает как "campaign:"&E2&", channel:"&F2), никогда не имеют проблем с некорректными тегами в панели управления. Команды, позволяющие колонке тегов быть произвольным текстом, сталкиваются с проблемой очистки данных уже через три кампании.

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

Автоматизация через Apps Script

Для команд, которые еженедельно запускают одну и ту же структуру кампании (ссылки на рассылку, ссылки для платной рекламы, варианты электронных писем), правильным решением будет полная автоматизация импорта. Google Apps Script работает в браузере, имеет доступ к данным таблицы и может запускаться по триггеру времени или при отправке формы.

Схема такая: срабатывает триггер, скрипт считывает любые строки таблицы, у которых нет значения short_link в колонке I, отправляет их (POST) в API массового импорта и записывает созданные короткие ссылки обратно в колонку I. При следующем срабатывании триггера уже импортированные строки пропускаются, так как колонка I заполнена.

// Google Apps Script - массовый импорт новых строк через Elido API
// Триггер: по времени, каждый час (или при отправке формы)
// Документация: https://developers.google.com/apps-script/guides/triggers (доступ 12.05.2026)

function importNewLinks() {
  const sheet =
    SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Q2 Spring");
  const data = sheet.getDataRange().getValues();
  const headers = data[0];

  const urlCol = headers.indexOf("target_url");
  const slugCol = headers.indexOf("slug");
  const srcCol = headers.indexOf("utm_source");
  const medCol = headers.indexOf("utm_medium");
  const campCol = headers.indexOf("utm_campaign");
  const tagsCol = headers.indexOf("tags");
  const doneCol = headers.indexOf("short_link"); // записываем результат сюда

  const newRows = [];
  const rowIndexes = [];

  for (let i = 1; i < data.length; i++) {
    const row = data[i];
    if (!row[urlCol] || row[doneCol]) continue; // пропускаем пустые или уже импортированные
    newRows.push({
      destination: row[urlCol],
      slug: row[slugCol] || undefined,
      utm_source: row[srcCol] || undefined,
      utm_medium: row[medCol] || undefined,
      utm_campaign: row[campCol] || undefined,
      tags: row[tagsCol]
        ? String(row[tagsCol])
            .split(",")
            .map((t) => t.trim())
        : [],
    });
    rowIndexes.push(i);
  }

  if (!newRows.length) return;

  const payload = JSON.stringify({
    links: newRows,
    campaign_id: "cmp_8a2f",
    on_conflict: "skip",
  });

  const resp = UrlFetchApp.fetch("https://api.elido.app/v1/links/bulk", {
    method: "post",
    contentType: "application/json",
    headers: {
      Authorization:
        "Bearer " +
        PropertiesService.getScriptProperties().getProperty("ELIDO_TOKEN"),
    },
    payload: payload,
    muteHttpExceptions: true,
  });

  const result = JSON.parse(resp.getContentText());
  const created = result.links || [];

  // Записываем короткие ссылки обратно в колонку I
  created.forEach((link, idx) => {
    if (!link.short_url) return;
    const sheetRow = rowIndexes[idx] + 1; // 1-индексация
    sheet.getRange(sheetRow, doneCol + 1).setValue(link.short_url);
  });
}

Несколько примечаний по реализации:

Храните токен API в PropertiesService.getScriptProperties(), а не прописывайте его жестко в скрипте. Документация по триггерам Apps Script (доступ 12.05.2026) охватывает настройку как триггеров по времени, так и триггеров по событиям. Для таблицы кампании, которую команда заполняет совместно, триггер onEdit срабатывает при заполнении колонки A; короткая ссылка появляется в колонке I в течение нескольких секунд после ввода целевого URL.

Флаг muteHttpExceptions: true важен. Без него ошибка 422 от API вызовет исключение на уровне скрипта, и триггер перестанет делать повторные попытки. С ним вы получите тело ошибки и сможете его залогировать.

Для более серьезной интеграции (скрипт на Python, шаг CI, который читает таблицу через Sheets API, или запланированная задача в вашем существующем пайплайне данных) эндпоинт Sheets API spreadsheets.values.get (доступ 12.05.2026) отдает вам JSON напрямую. Оттуда структура вызова массового импорта идентична примеру с curl выше.

Распространенные ошибки

Лишние пробелы в слагах. Слаг, скопированный из ячейки таблицы, может иметь невидимый пробел в конце. Elido допускает это (слаг технически валиден), но go.example.com/q2-promo с пробелом - это некрасивый URL, а копирование из адресной строки браузера обычно отсекает его, так что человек, который вставит ссылку позже, получит 404. Решение - формула =TRIM(H2) для колонки слага перед экспортом.

Отсутствие utm_medium. Elido предупреждает, но не блокирует импорт при отсутствии utm_medium, так как в некоторых кампаниях его намеренно пропускают. Но отсутствие медиума почти всегда является ошибкой: GA4 направляет все, что его не имеет, в канал (none), что делает атрибуцию по каналам бесполезной. Канонический справочник компоновщика URL GA4 (доступ 12.05.2026) указывает utm_medium как обязательный параметр для корректной атрибуции кампании. Если в вашем шаблоне рабочего пространства есть значение по умолчанию для utm_medium, пустые ячейки унаследуют его; если нет - предупреждение dry-run ваш последний шанс это исправить.

Значения тегов длиннее 32 символов. Elido незаметно обрезает значения тегов, превышающие 32 символа. Обрезка незаметна в предупреждениях dry-run, если не приглядываться (в ответе показано сохраненное значение, а не исходное). Длинные теги обычно появляются при вставке названий UTM-кампаний в колонку тегов: spring-2026-dach-email-reactivation-week3 состоит из 42 символов и превратится в spring-2026-dach-email-reactivation-we в панели управления. Делайте значения измерений тегов короткими; переместите подробные метаданные в заголовок ссылки.

Забытый dry_run=true при повторных запусках. Если вы повторно запускаете загрузку CSV для кампании, в которой уже есть ссылки, on_conflict=skip безопасен, но on_conflict=replace обновит целевые URL для любого слага, который есть и в старом, и в новом CSV. В кампании, где целевые URL не менялись, это безвредно. В кампании, где вы обновили URL лендингов в середине работы, это именно то, что вам нужно. Определитесь с режимом до подтверждения.

Резюме: от настройки до запуска

Самая полная версия этого рабочего процесса: создайте таблицу один раз со стабильными названиями колонок, определите шаблон UTM рабочего пространства, чтобы пустые колонки UTM наследовали разумные значения по умолчанию (описано в setup-branded-short-links), запустите пробный импорт для отлова конфликтов и предупреждений, подтвердите импорт и напишите триггер Apps Script, чтобы следующая кампания требовала ноль ручных действий.

Что касается уровня атрибуции, который замыкает цикл после клика, статья серверный трекинг конверсий описывает, как пробросить click_id из ответа редиректа Elido в Meta CAPI и GA4 - серверную часть, которая выживает после Safari ITP и вмешательства блокировщиков рекламы. Тот пост и этот вместе дают полную картину рабочего процесса маркетологов: от таблицы до короткой ссылки и атрибутированной конверсии.

Весь функционал управления URL-адресами кампаний - шаблоны, массовый импорт, группировка кампаний, пересылка конверсий - находится на странице функций кампаний.