API генератора диплинков

API генератора диплинков (англ. Deep Link Generator, DLG) позволяет создавать диплинки Adjust и управлять ими программным способом. Вместо того чтобы вручную создавать ссылки на панели управления Adjust, можно с помощью API создать гибкие и масштабируемые рабочие процессы одиночной или пакетной генерации ссылок.

• Масштабирование процесса создания ссылок за счет автоматизации с помощью API вместо использования ручных рабочих процессов.
• Интеграция диплинков в существующие инструменты, такие как CRM-системы или платформы управления кампаниями.
• Создание коротких или длинных ссылок и управление ими по отдельности или в пакетном режиме.
• Создание кастомных панелей управления или скриптов генерации ссылок для внутренних задач.

Функции API генератора диплинков

API генератора диплинков повторяет функциональность Генератора диплинков Adjust, предоставляя возможность программно управлять созданием ссылок. Вы можете:

• Создавать один или несколько диплинков за один запрос.
• Создавать короткие или длинные ссылки в зависимости от потребностей кампании.
• Обновлять существующие токены коротких ссылок.
• Создавать инструменты или рабочие процессы, напрямую подключаемые к конечным точкам автоматизации Adjust.

Благодаря API команды могут автоматизировать повторяющиеся процессы создания ссылок и поддерживать точность и единообразие при измерении эффективности кампании.

Случаи из практики

Как это работает?

Для настройки конечных точек автоматизации Adjust API генератора диплинков использует HTTPS-запросы. Все вызовы авторизуются с использованием вашего текущего токена Adjust API.

Обзорная информация о конечных точках:

• Создание одиночного диплинка: POST https://automate.adjust.com/engage/deep-links
• Создание пакета диплинков: POST https://automate.adjust.com/engage/deep-links/bulk
• Обновление токена короткой ссылки: PUT https://automate.adjust.com/engage/deep-links/{short_token}
• Получение данных короткой ссылки: GET https://automate.adjust.com/engage/deep-links/short-link?short_token={short_token}&app_token={app_token}

Начало работы

Требования

• Пакет TrueLink Core или TrueLink Enterprise.
• Брендированный домен для iOS и Android.
• Токен API Adjust с доступом к API генератора диплинков.

Краткое руководство по работе с Adjust

1. Настройте свой брендированный домен для iOS и Android.
2. Получите токен API Adjust и токен ссылки.
3. Создайте и протестируйте вызовы API, следуя документации разработчика Adjust.
4. Интегрируйте скрипты или макросы автоматизации для создания ссылок в нужном количестве.

Полную информацию о начале работы см. в официальном руководстве по API генератора диплинков в документации разработчика Adjust.

Истории успеха

• Регулярно обновляйте Adjust SDK, чтобы обеспечить совместимость с разрешением коротких ссылок.
• Для крупных кампаний используйте пакеты конечных точек, чтобы избежать проблем с ограничением скорости (максимум 200 запросов в секунду).
• Храните метаданные кампании централизованно и автоматизируйте создание ссылок с помощью макросов или скриптов.
• Проверяйте ответы API и повторяйте неудачные запросы.
• Используйте один брендированный домен для обеих платформ для единообразия перенаправлений.
• Обеспечьте конфиденциальность хранения токенов API и периодически меняйте их в целях безопасности.

Отчетность и мониторинг использования

API генератора диплинков использует квоты на создание коротких ссылок. Отслеживать данные об использовании коротких ссылок можно через панель управления Adjust и ответы API.

Квота на создание коротких ссылок

• Ограничения на количество создаваемых коротких ссылок действуют на уровне аккаунта.
• Такие ограничения основаны на количестве сгенерированных уникальных коротких токенов.
• Идентичные запросы вернут существующие ссылки и не приведут к увеличению использования коротких ссылок.

Что учитывается при расчете ограничения

Квота распространяется только на:

• Короткие ссылки, созданные через API.

Квота не распространяется на:

• Длинные ссылки.
• Короткие ссылки, созданные через панель управления.

Отслеживание использования коротких ссылок на панели управления Adjust

Просмотреть данные об использовании можно в Adjust Suite:

1. Перейдите в Настройки аккаунта .
2. Выберите Тарифные планы и использование .

В этом разделе отображаются:

• Общая квота на короткие ссылки.
• Оставшееся количество коротких ссылок.
• Детали контракта.

Если вы хотите просмотреть данные об использовании в Datascape, изменить диапазоны дат и посмотреть разбивку по данным об использовании по различным приложениям, вы также можете воспользоваться этой прямой ссылкой.

Просмотр данных об использовании через заголовки API

Каждый ответ API содержит заголовки с информацией о квоте и контракте. Чтобы узнать больше о структуре полезной нагрузки API, ознакомьтесь с документацией по генератору диплинков в Developer Hub.

Ниже приведены соответствующие заголовки:

x-shortlink-quota-limit
x-shortlink-quota-remaining
x-contract-status
x-contract-start-date
x-contract-end-date