Dub
Управление ссылками с помощью Dub
Dub — это платформа с открытым исходным кодом для управления ссылками, предназначенная для современных маркетинговых команд. Она предоставляет мощные возможности создания коротких ссылок, аналитики и отслеживания с инфраструктурой корпоративного уровня.
С помощью интеграции Dub в AACFlow вы можете:
- Создавать короткие ссылки: Генерировать брендированные короткие ссылки с пользовательскими доменами, слагами и UTM-параметрами
- Создавать или обновлять ссылки: Создавать или обновлять ссылки идемпотентно по URL назначения
- Получать информацию о ссылках: Искать детали ссылок по ID, внешнему ID или комбинации домен + ключ
- Обновлять ссылки: Изменять URL назначения, метаданные, UTM-параметры и настройки ссылок
- Удалять ссылки: Удалять короткие ссылки по ID или внешнему ID
- Список ссылок: Искать и фильтровать ссылки с пагинацией, сортировкой и фильтрацией по тегам
- Получать аналитику: Получать аналитику кликов, лидов и продаж с группировкой по времени, географии, устройству, браузеру, рефереру и другим параметрам
В AACFlow интеграция с Dub позволяет вашим агентам программно управлять короткими ссылками и отслеживать их производительность. Используйте ее для создания отслеживаемых ссылок в рамках маркетинговых рабочих процессов, мониторинга вовлеченности по ссылкам и принятия решений на основе данных, основанных на аналитике кликов и метриках конверсии.
Создавайте, управляйте и отслеживайте короткие ссылки с помощью Dub. Поддерживает пользовательские домены, UTM-параметры, аналитику ссылок и многое другое.
Создание новой короткой ссылки с помощью Dub. Поддерживает пользовательские домены, слаги, UTM-параметры и многое другое.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ Dub |
url | string | Да | URL назначения короткой ссылки |
domain | string | Нет | Пользовательский домен для короткой ссылки (по умолчанию dub.sh) |
key | string | Нет | Пользовательский слаг для короткой ссылки (генерируется случайным образом, если не указан) |
externalId | string | Нет | Внешний ID для ссылки в вашей базе данных |
tagIds | string | Нет | ID тегов, разделенные запятыми, для назначения ссылке |
comments | string | Нет | Комментарии для короткой ссылки |
expiresAt | string | Нет | Дата истечения срока действия в формате ISO 8601 |
password | string | Нет | Пароль для защиты короткой ссылки |
rewrite | boolean | Нет | Включить ли скрытие ссылки |
archived | boolean | Нет | Архивировать ли ссылку |
title | string | Нет | Пользовательский OG-заголовок для предпросмотра ссылки |
description | string | Нет | Пользовательское OG-описание для предпросмотра ссылки |
utm_source | string | Нет | UTM-параметр source |
utm_medium | string | Нет | UTM-параметр medium |
utm_campaign | string | Нет | UTM-параметр campaign |
utm_term | string | Нет | UTM-параметр term |
utm_content | string | Нет | UTM-параметр content |
| Параметр | Тип | Описание |
|---|
id | string | Уникальный ID созданной ссылки |
domain | string | Домен короткой ссылки |
key | string | Слаг короткой ссылки |
url | string | URL назначения |
shortLink | string | Полный URL короткой ссылки |
qrCode | string | URL QR-кода для короткой ссылки |
archived | boolean | Архивирована ли ссылка |
externalId | string | Внешний ID |
title | string | OG-заголовок |
description | string | OG-описание |
tags | json | Теги, назначенные ссылке (id, name, color) |
clicks | number | Количество кликов |
leads | number | Количество лидов |
sales | number | Количество продаж |
saleAmount | number | Общая сумма продаж в центах |
lastClicked | string | Временная метка последнего клика |
createdAt | string | Временная метка создания |
updatedAt | string | Временная метка последнего обновления |
utm_source | string | UTM-параметр source |
utm_medium | string | UTM-параметр medium |
utm_campaign | string | UTM-параметр campaign |
utm_term | string | UTM-параметр term |
utm_content | string | UTM-параметр content |
Создание или обновление короткой ссылки по ее URL. Если ссылка с таким URL уже существует, она обновляется. В противном случае создается новая ссылка.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ Dub |
url | string | Да | URL назначения короткой ссылки |
domain | string | Нет | Пользовательский домен для короткой ссылки (по умолчанию dub.sh) |
key | string | Нет | Пользовательский слаг для короткой ссылки (генерируется случайным образом, если не указан) |
externalId | string | Нет | Внешний ID для ссылки в вашей базе данных |
tagIds | string | Нет | ID тегов, разделенные запятыми, для назначения ссылке |
comments | string | Нет | Комментарии для короткой ссылки |
expiresAt | string | Нет | Дата истечения срока действия в формате ISO 8601 |
password | string | Нет | Пароль для защиты короткой ссылки |
rewrite | boolean | Нет | Включить ли скрытие ссылки |
archived | boolean | Нет | Архивировать ли ссылку |
title | string | Нет | Пользовательский OG-заголовок для предпросмотра ссылки |
description | string | Нет | Пользовательское OG-описание для предпросмотра ссылки |
utm_source | string | Нет | UTM-параметр source |
utm_medium | string | Нет | UTM-параметр medium |
utm_campaign | string | Нет | UTM-параметр campaign |
utm_term | string | Нет | UTM-параметр term |
utm_content | string | Нет | UTM-параметр content |
| Параметр | Тип | Описание |
|---|
id | string | Уникальный ID ссылки |
domain | string | Домен короткой ссылки |
key | string | Слаг короткой ссылки |
url | string | URL назначения |
shortLink | string | Полный URL короткой ссылки |
qrCode | string | URL QR-кода для короткой ссылки |
archived | boolean | Архивирована ли ссылка |
externalId | string | Внешний ID |
title | string | OG-заголовок |
description | string | OG-описание |
tags | json | Теги, назначенные ссылке (id, name, color) |
clicks | number | Количество кликов |
leads | number | Количество лидов |
sales | number | Количество продаж |
saleAmount | number | Общая сумма продаж в центах |
lastClicked | string | Временная метка последнего клика |
createdAt | string | Временная метка создания |
updatedAt | string | Временная метка последнего обновления |
utm_source | string | UTM-параметр source |
utm_medium | string | UTM-параметр medium |
utm_campaign | string | UTM-параметр campaign |
utm_term | string | UTM-параметр term |
utm_content | string | UTM-параметр content |
Получение информации о короткой ссылке по ее ID ссылки, внешнему ID или комбинации домен + ключ.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ Dub |
linkId | string | Нет | Уникальный ID короткой ссылки |
externalId | string | Нет | Внешний ID ссылки в вашей базе данных |
domain | string | Нет | Домен ссылки (используется с ключом) |
key | string | Нет | Слаг ссылки (используется с доменом) |
| Параметр | Тип | Описание |
|---|
id | string | Уникальный ID ссылки |
domain | string | Домен короткой ссылки |
key | string | Слаг короткой ссылки |
url | string | URL назначения |
shortLink | string | Полный URL короткой ссылки |
qrCode | string | URL QR-кода для короткой ссылки |
archived | boolean | Архивирована ли ссылка |
externalId | string | Внешний ID |
title | string | OG-заголовок |
description | string | OG-описание |
tags | json | Теги, назначенные ссылке (id, name, color) |
clicks | number | Количество кликов |
leads | number | Количество лидов |
sales | number | Количество продаж |
saleAmount | number | Общая сумма продаж в центах |
lastClicked | string | Временная метка последнего клика |
createdAt | string | Временная метка создания |
updatedAt | string | Временная метка последнего обновления |
utm_source | string | UTM-параметр source |
utm_medium | string | UTM-параметр medium |
utm_campaign | string | UTM-параметр campaign |
utm_term | string | UTM-параметр term |
utm_content | string | UTM-параметр content |
Обновление существующей короткой ссылки. Вы можете изменить URL назначения, слаг, метаданные, UTM-параметры и многое другое.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ Dub |
linkId | string | Да | ID ссылки или внешний ID с префиксом ext_ |
url | string | Нет | Новый URL назначения |
domain | string | Нет | Новый пользовательский домен |
key | string | Нет | Новый пользовательский слаг |
title | string | Нет | Пользовательский OG-заголовок |
description | string | Нет | Пользовательское OG-описание |
externalId | string | Нет | Внешний ID для ссылки |
tagIds | string | Нет | ID тегов, разделенные запятыми |
comments | string | Нет | Комментарии для короткой ссылки |
expiresAt | string | Нет | Дата истечения срока действия в формате ISO 8601 |
password | string | Нет | Пароль для защиты ссылки |
rewrite | boolean | Нет | Включить ли скрытие ссылки |
archived | boolean | Нет | Архивировать ли ссылку |
utm_source | string | Нет | UTM-параметр source |
utm_medium | string | Нет | UTM-параметр medium |
utm_campaign | string | Нет | UTM-параметр campaign |
utm_term | string | Нет | UTM-параметр term |
utm_content | string | Нет | UTM-параметр content |
| Параметр | Тип | Описание |
|---|
id | string | Уникальный ID обновленной ссылки |
domain | string | Домен короткой ссылки |
key | string | Слаг короткой ссылки |
url | string | URL назначения |
shortLink | string | Полный URL короткой ссылки |
qrCode | string | URL QR-кода для короткой ссылки |
archived | boolean | Архивирована ли ссылка |
externalId | string | Внешний ID |
title | string | OG-заголовок |
description | string | OG-описание |
tags | json | Теги, назначенные ссылке (id, name, color) |
clicks | number | Количество кликов |
leads | number | Количество лидов |
sales | number | Количество продаж |
saleAmount | number | Общая сумма продаж в центах |
lastClicked | string | Временная метка последнего клика |
createdAt | string | Временная метка создания |
updatedAt | string | Временная метка последнего обновления |
utm_source | string | UTM-параметр source |
utm_medium | string | UTM-параметр medium |
utm_campaign | string | UTM-параметр campaign |
utm_term | string | UTM-параметр term |
utm_content | string | UTM-параметр content |
Удаление короткой ссылки по ее ID ссылки или внешнему ID (с префиксом ext_).
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ Dub |
linkId | string | Да | ID ссылки или внешний ID с префиксом ext_ |
| Параметр | Тип | Описание |
|---|
id | string | ID удаленной ссылки |
Получение постраничного списка коротких ссылок для аутентифицированного рабочего пространства. Поддерживает фильтрацию по домену, поисковому запросу, тегам и сортировку.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ Dub |
domain | string | Нет | Фильтр по домену |
search | string | Нет | Поисковый запрос, сопоставляемый со слагом короткой ссылки и URL назначения |
tagIds | string | Нет | ID тегов, разделенные запятыми, для фильтрации |
showArchived | boolean | Нет | Включать ли архивные ссылки (по умолчанию false) |
sortBy | string | Нет | Сортировка по полю: createdAt, clicks, saleAmount или lastClicked |
sortOrder | string | Нет | Порядок сортировки: asc или desc |
page | number | Нет | Номер страницы (по умолчанию: 1) |
pageSize | number | Нет | Количество ссылок на странице (по умолчанию: 100, максимум: 100) |
| Параметр | Тип | Описание |
|---|
links | json | Массив объектов ссылок (id, domain, key, url, shortLink, clicks, tags, createdAt) |
count | number | Количество возвращенных ссылок |
Получение аналитики для ссылок, включая клики, лиды и продажи. Поддерживает фильтрацию по ссылке, временному диапазону и группировку по различным измерениям.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ Dub |
event | string | Нет | Тип события: clicks (по умолчанию), leads, sales или composite |
groupBy | string | Нет | Группировка результатов по: count (по умолчанию), timeseries, countries, cities, devices, browsers, os, referers, top_links, top_urls |
linkId | string | Нет | Фильтр по ID ссылки |
externalId | string | Нет | Фильтр по внешнему ID (с префиксом ext_) |
domain | string | Нет | Фильтр по домену |
interval | string | Нет | Временной интервал: 24h (по умолчанию), 7d, 30d, 90d, 1y, mtd, qtd, ytd или all |
start | string | Нет | Начальная дата/время в формате ISO 8601 (переопределяет interval) |
end | string | Нет | Конечная дата/время в формате ISO 8601 (по умолчанию сейчас) |
country | string | Нет | Фильтр по стране (код ISO 3166-1 alpha-2) |
timezone | string | Нет | Часовой пояс IANA для данных временных рядов (по умолчанию UTC) |
| Параметр | Тип | Описание |
|---|
clicks | number | Общее количество кликов |
leads | number | Общее количество лидов |
sales | number | Общее количество продаж |
saleAmount | number | Общая сумма продаж в центах |
data | json | Сгруппированные данные аналитики (временные ряды, страны, устройства и т.д.) |
