Notion URL shortener перетворює звичайні посилання, що знаходяться в базі даних Notion, на відстежувані брендовані короткі посилання, не виходячи з бази даних. Ви залишаєте вашу таблицю кампаній, контент-календар або директорію посилань точно там, де вона вже знаходиться. Elido зчитує URL призначення в кожному рядку, карбує коротке посилання на вашому домені та записує це посилання назад у стовпець поруч. Підключіть один раз через OAuth - без копіювання токена, без експорту в таблицю.
Це коротка версія. Довша полягає в тому, що Notion непомітно став місцем, де багато команд планують кампанії, складають контент та зберігають канонічний список кожного посилання, що має значення. Проблема в тому, що Notion зберігає URL як мертвий текст. Він не скорочує їх, не брендує та не рахує жодного кліку. Тому люди в підсумку ведуть два інструменти паралельно: план у Notion та відстежувані посилання десь в іншому місці, синхронізовані вручну. Саме цю прогалину і закриває інтеграція.
Цей пост охоплює, що насправді робить інтеграція з Notion, чим OAuth-підключення в один клік відрізняється від застарілого підходу з вставкою токена, чотири сценарії використання, де вона себе виправдовує, як статистика кліків повертається до таблиці та шляхи Zapier та API для команд, що їх воліють. В кінці - практичний посібник з налаштування.
Що робить інтеграція Notion URL shortener#
Зведемо до механіки. У вас є база даних Notion із властивістю, що містить URL призначення: цільову сторінку, мету кампанії, посилання на документ. Elido підключається до цієї бази даних і для кожного рядка створює брендоване коротке посилання, що вказує на це призначення. Коротке посилання повертається в той самий рядок, у властивість, яку ви вказуєте. Відтоді цей рядок є одночасно планом і живим відстежуваним посиланням.
Оскільки кожне посилання, яке генерує Elido, є звичайним посиланням у вашому воркспейсі, воно несе повний набір функцій. Воно резолвується на edge з тією самою затримкою p95 менш ніж 15ms, що й будь-яке інше посилання Elido, може використовувати кастомний брендований домен та фіксує кожен клік у ClickHouse без вибірки. Нічого другосортного в цьому посиланні тільки тому, що воно «народилося» в Notion.
Зворотній потік - це те, що команди недооцінюють. Elido може записувати поточну кількість кліків у числову властивість у тому самому рядку, що оновлюється за розкладом. Ваша таблиця Notion перестає бути статичним списком і стає маленьким дашбордом: назва кампанії, призначення, коротке посилання, кліки - все в одному вигляді, який ви вже перевіряєте кожного ранку. Не потрібно перемикати вкладки для читання цифр.
Варто бути точним щодо одного: точні назви властивостей та макет екрана згоди належать Notion, і Notion постійно оновлює свій UI. Патерн стабільний, пікселі - ні. Сприймайте будь-яку конкретну мітку нижче як ілюстративну та довіряйте тому, що вам показує екран підключення у конкретний момент.
OAuth в один клік, а не вставлений токен#
Старіші інтеграції Notion в екосистемі працювали одним способом. Ви відкривали налаштування Notion, створювали внутрішню інтеграцію, копіювали довгий секретний токен, вставляли його в сторонній інструмент, потім поверталися в Notion, щоб вручну поділитися кожною базою даних із цією інтеграцією. Чотири кроки, два додатки, один секрет у текстовому полі. Це працювало, але секрети потрапляли в буфери обміну та ламалися, коли хтось ротував токен.
Натомість Elido використовує OAuth-потік Notion. З екрана інтеграцій вашого воркспейсу ви натискаєте «Підключити» на картці Notion. Elido переправляє вас на власний екран авторизації Notion, розміщений Notion, де ви обираєте, яких сторінок або баз даних може торкатися Elido. Ви схвалюєте, Notion передає Elido обмежений грант, і ви повертаєтесь в Elido вже підключеним. Жоден секрет ніколи не проходить через ваш буфер обміну.
Ця відмінність важлива не лише для зручності. При OAuth доступний грант знаходиться у власності Notion та видно у ваших налаштуваннях Notion, тому ви можете бачити точно, до чого має доступ Elido, та відкликати його в один клік у будь-який момент. Область дозволів - це те, що ви схвалили, і нічого ширшого. Це та сама модель, що стоїть за соціальним входом для сервісів скорочення URL: ви автентифікуєтесь у провайдера, а провайдер підтверджує вузький, відкликуваний грант, а не передає статичний обліковий запис. Власна документація авторизації Notion описує публічний OAuth-потік, поверх якого знаходиться Elido.
Варто сказати прямо: OAuth-хендшейк спілкується з Notion, і сервери Notion можуть знаходитися за межами ЄС. Це крок автентифікації та авторизації, а не місце зберігання даних ваших посилань. Ваші посилання Elido та події кліків залишаються прив'язаними до регіону ЄС, що ви обрали для вашого воркспейсу. Notion зберігає призначення; Elido зберігає аналітику - в обраному вами регіоні.
Чотири способи використання командами#
Інтеграція навмисно є загальною, але чотири форми з'являються знову і знову.
Посилання в контент-календарі. Маркетингова команда планує пости в базі даних-календарі Notion, один рядок на пост, кожен із URL призначення. Підключіть Elido - і кожен запланований пост автоматично отримає брендоване коротке посилання, готове для вставки у пост при публікації. Після публікації кількість кліків повертається, щоб календар показував, які пости справді принесли трафік, а не лише які вийшли.
База даних для відстеження кампаній. Це той, що продає інтеграцію. База даних кампаній зі стовпцями для назви, каналу, призначення та бюджету отримує ще два: коротке посилання та його кількість кліків. Команда отримує відстеження кліків по кампаніях, не відкриваючи окремий аналітичний інструмент, і оскільки посилання несуть UTM-параметри, дані чисто стикуються з тим, що знаходиться нижче за течією. Якщо ви сьогодні складаєте UTM-рядки вручну, конструктор UTM та посібник з UTM-шаблонів пояснюють, як прикріплювати їх послідовно, щоб таблиця Notion залишалася акуратною.
Внутрішня директорія посилань. Великі організації ведуть сторінку Notion із канонічними внутрішніми посиланнями: документ налаштування VPN, форма для витрат, посібник для новачків. Перетворіть їх на брендовані короткі посилання - і ви отримаєте дві речі. Люди краще запам'ятовують go.yourbrand.com/vpn, ніж 90-символьний URL SharePoint, і ви дізнаєтесь, якими внутрішніми ресурсами люди насправді користуються. Низька кількість кліків на посилання із правилами безпеки - це спостереження, а не примітка.
Матеріали для клієнтів. Агентства передають клієнтам сторінку Notion із посиланнями: живий сайт, стейджинг-превью, аналітичний дашборд, рахунок. Брендовані короткі посилання змушують цю сторінку виглядати так, ніби агентство контролює весь стек, а дані кліків розповідають менеджеру акаунту, чи відкривав клієнт звіт до дзвінка-ревю. Ця відповідь корисна до дзвінка, а не після.
Спільна нитка: жодна з цих команд не хотіла виходити з Notion. План вже жив там. Інтеграція приходить до них там, де вони працюють, замість того, щоб просити вести паралельний список у інструменті для посилань.
Повернення статистики кліків#
Коротке посилання, яке не можна виміряти, - це просто перенаправлення. Сенс генерації посилань з бази даних - замкнути цикл і повернути цифри туди, де ви планували роботу.
Elido записує загальну кількість кліків у числову властивість кожного рядка, що оновлюється за розкладом. Це дає вам вигляд із сортуванням та фільтрацією: відсортуйте базу даних кампаній за кліками - і переможці спливуть нагору прямо в Notion, без необхідності експорту. Це не заміна повноцінного аналітичного інтерфейсу, який розбиває кліки за країною, пристроєм, реферером та часом. Це цифра на перший погляд, що знаходиться поруч із планом.
Для команд, яким потрібно більше ніж одне число в клітинці, відкриваються два шляхи. Запис посилання містить повну историю через API, тому скрипт може отримати більш детальну розбивку та записати зведений блок на сторінку Notion. А вебхуки можуть надіслати сповіщення в той момент, коли відстежуване посилання перевищує поріг - зручно, коли матеріал клієнта раптово набирає переглядів і хтось повинен знати до наступного стендапу. Інтеграція обробляє типовий випадок; API та вебхуки - довгий хвіст.
Альтернативи через Zapier та API#
Нативна OAuth-інтеграція - шлях найменшого опору, але не єдиний, і дві альтернативи краще підходять для конкретних ситуацій.
Zapier підходить командам, що вже стандартизувалися на ньому. Zap стежить за вашою базою даних Notion для нових рядків, і коли з'являється новий, він викликає Elido для створення короткого посилання та записує результат назад у рядок. Ви отримуєте невелику затримку та залежність від Zapier в обмін на можливість з'єднати Notion з Elido в рамках процесу, що може також торкатися CRM, каналу Slack та таблиці в тому самому запуску. Ширший патерн описано в посібнику з автоматизації Zapier. Компроміс чесний: Zapier додає перехід та залежність, а нативна інтеграція - ні, тому вибирайте Zapier, коли створення посилань є одним кроком у більш довгій автоматизації, а не всією роботою.
API - шлях для інженерів, яким потрібен повний контроль. REST API Elido та SDK для TypeScript, Python та Go дозволяють вам самостійно скриптувати синхронізацію Notion-Elido: читати базу даних через API Notion, створювати посилання через Elido та записувати назад усе, що вам потрібно. Ви контролюєте розклад, обробку помилок та точний вигляд того, що потрапляє в Notion. Якщо ви вже виконуєте завдання з API Notion, додавання виклику Elido - це кілька рядків. Швидкий старт з API та SDK описує автентифікацію, ідемпотентність та підводні камені, а сторінка функцій API перераховує всю поверхню. Довідник API Notion документує ендпоінти запиту та оновлення бази даних, які ви б поєднали з ним.
Використовуйте ключі ідемпотентності, якщо ви скриптуєте це самостійно. Запит до бази даних Notion, що виконується повторно за розкладом, знову дасть вам ті самі рядки, і без ключа ідемпотентності, прив'язаного до ID рядка, ви створюєте дублікати посилань при кожному циклі. Швидкий старт охоплює саме цей сценарій збою.
Налаштування#
Ось практична послідовність. Мітки можуть змінюватися з оновленнями UI Notion, тому слідкуйте за підказками на екрані, де вони відрізняються.
По-перше, приведіть базу даних Notion у потрібний вигляд. Вам потрібна щонайменше властивість із URL призначення. Додайте порожню властивість для короткого посилання, яке Elido запише назад, і якщо хочете статистику - числову властивість для кількості кліків. Властивість типу URL для короткого посилання та типу число для кліків забезпечить акуратне форматування в Notion.
По-друге, підключіть Notion в Elido. Відкрийте екран інтеграцій вашого воркспейсу, знайдіть картку Notion та натисніть «Підключити». Ви потрапите на екран авторизації Notion. Це ключовий крок: оберіть, до яких сторінок або баз даних Elido може мати доступ, і надайте лише ті, що містять посилання для відстеження. Схваліть - і повернетесь до Elido підключеним.
По-третє, зіставте базу даних. В Elido виберіть підключену базу даних та вкажіть, яка властивість містить призначення, а яка має отримати коротке посилання. Якщо синхронізуєте кількість кліків - вкажіть на числову властивість теж. Збережіть зіставлення.
По-четверте, запустіть і перевірте один рядок. Elido обробляє рядки та записує короткі посилання назад. Відкрийте базу даних, переконайтесь, що рядок отримав реальне коротке посилання, клікніть на нього та підтвердіть, що клік зареєструвався в аналітиці Elido та що кількість повернулася до таблиці при наступному оновленні. Перевіряйте на одному рядку перед тим, як довіряти всій таблиці.
Це весь цикл. Призначення залишаються в Notion, де ви плануєте; посилання знаходяться на вашому брендованому домені; а цифри повертаються до тієї самої таблиці. Якщо ви зважуєте це проти ведення посилань у таблиці, масовий імпорт з Google Sheets описує еквівалентний потік для команд, де джерелом правди є таблиця, а не база даних; а що таке сервіс скорочення URL закладає основу, якщо ви новачок у брендованих посиланнях. Маркетологи, що оцінюють весь стек, можуть починати зі сторінки рішень для маркетологів, а ціни на брендовані домени та вищі ліміти - на сторінці планів.