How can we help?

Используйте API OneLink для создания ссылок в масштабных кампаниях Премиум

  • Обновлено

Краткий обзор: API OneLink позволяет вовлекать конечных пользователей и использовать собственные медиа, создавая персонализированные ссылки для крупномасштабных кампаний, СМС-рассылок и т.д. Для реализации требуется участие рекламодателя и разработчика. Используйте его, чтобы создавать бесшовные кросс-канальные пути, повышать вовлеченность и улучшать конверсию.

OneLink API

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

  • https://dev.appsflyer.com/hc/reference/create-onelink-attribution-link
  • Параметры, связанные с атрибуцией, такие как медиа-источник, кампания или ресурс, используемые для измерения и отслеживания маркетинговых инициатив.Примечание: Параметр медиа-источника (pid) является обязательным.
  • Параметры для персонализации, которые позволяют настроить индивидуальный пользовательский интерфейс при открытии приложения по соответствующей ссылке. Эти параметры позволяют отправлять пользователей на настраиваемый контент в приложении, например на страницу определенного продукта, код купона или рекламную акцию.
  • Автоматически создавайте большое количество коротких ссылок и QR-кодов
  • Настраивайте TTL (Time To Live) и поведение продления для каждого кейса. Узнать больше
  • Применяйте строгую валидацию параметров, чтобы обеспечить предсказуемое поведение перенаправления и надежное измерение.
  • Получайте данные об использовании квоты для управления потреблением.
     

 Пример

Глобальное туристическое приложение ежедневно генерирует миллионы контекстных коротких ссылок для CRM, электронной почты и QR-кодов. Используя OneLink API v2, их платформа автоматизации создает персонализированные диплинки, учитывающие локаль, уровень лояльности и конкретные разделы в приложении, — при этом обеспечивая управление и согласованное измерение на всех рынках.  

Начало

OneLink API является премиум-функцией, которая используется для:

Необходимое условие: учетная запись AppsFlyer. Чтобы получить доступ к OneLink API, свяжитесь со своим CSM или напишите на hello@appsflyer.com. 

Чтобы настроить API OneLink:

  1. Скопируйте токен API OneLink.
  2. Создайте шаблон OneLink.
  3. Скопируйте идентификатор ID шаблона.  
  4. Передайте разработчику идентификатор шаблона и токен API и попросите его следовать этим инструкциям

Дэшборд

Дэшборд API OneLink отображает ваше использование API за день, месяц и три месяца. Это помогает отслеживать потребление в сравнении с ежемесячным лимитом квоты. 

Чтобы открыть дэшборд API OneLink

В AppsFlyer в боковом меню выберите Engage > OneLink API.

Использование когорты

Ниже приведены кейсы, которые показывают распространенные способы применения OneLink API для создания бесшовных контекстных путей в ваше приложение.

Кросс-платформенные пути (CTV, настольные ПК, web-to-app)

Создавайте краткосрочные или посессионные ссылки, которые помогают пользователям бесшовно перемещаться между устройствами. Типичные примеры включают QR-коды в ТВ-рекламе или сценарии «отсканируйте, чтобы продолжить» на настольных ПК, которые направляют пользователей прямо к нужному шагу в приложении.

Ценность: бесшовная непрерывность и улучшенная конверсия на разных устройствах.

Каналы на базе CRM (СМС, электронная почта, WhatsApp)

Создавайте персонализированные короткие ссылки для каждого пользователя в момент отправки для сообщений с высоким намерением, таких как уведомления о снижении цены, листы ожидания, win-back-кампании, напоминания об оплате или сценарии входа по magic link.

Ценность: персонализация в масштабе с согласованной атрибуцией.

Офлайн- и QR-вовлеченность

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

Ценность: Динамическая маршрутизация и офлайн-атрибуция без повторной печати физических материалов.

Реферальный обмен и обмен через амбассадоров

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

Ценность: Масштабируемое измерение и точная атрибуция для рефералов.

Характеристики и ограничения

В этом разделе перечислены некоторые ключевые особенности и ограничения OneLink API. Сообщите ему о том, что необходимо следовать инструкциям для разработчиков.

Специфика Примечания
Ограничение квоты API
  • Ограничение по использованию API OneLink для создания, редактирования или удаления ссылок OneLink составляет 7,5 миллионов в месяц (часовой пояс UTC), на один аккаунт.
  • Запросы POST, PUT и DELETE учитываются в этом лимите. Запросы GET и GET QR не учитываются в квоте.
  • Все запросы, отправленные после превышения этой квоты, не обслуживаются; вызов API получает код статуса 429 с сообщением «Monthly quota exceeded».
  • Проверить, какая часть квоты уже использована и сколько осталось, можно одним из следующих способов:
    • Откройте страницу OneLink API на платформе AppsFlyer, чтобы просмотреть историю использования за последние 4 месяца, или
    • Используйте API GET quota, чтобы получить текущий статус квоты.
    Вы также можете использовать GET quota API для запуска внутренних оповещений, когда использование приближается к заданному порогу.
Видимость ссылки
  • Ссылки, созданные через API, не отображаются в списке настраиваемых ссылок OneLink на дэшборде AppsFlyer.

    af_dp 

Примечание.

Новая версия OneLink API (v2) была выпущена в декабре 2025 года. Предыдущая версия (v1) устарела и продолжит работать до июня 2026 года, после чего поддерживаться не будет. В новых интеграциях следует использовать OneLink API v2. Руководство по миграции см. в руководстве по миграции в Dev Hub.

This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.


Share article: