Ограничения и особенности

Специфика

Примечания

Запросы API

  • Ограничение по использованию API OneLink для создания, редактирования или удаления ссылок OneLink составляет 7,5 миллионов в месяц (часовой пояс UTC), на один аккаунт.
  • Все запросы, сделанные после исчерпания лимита в 7,5 млн, не обслуживаются, и ссылки не создаются; при вызове API возвращается ошибка 429 с сообщением throttling limit exceeded (Превышен лимит по запросам).
  • Информация о том, сколько запросов использовано/осталось, отображается на дэшборде API OneLink.

Видимость ссылки

  • Ссылки, созданные через API, не отображаются в списке настраиваемых ссылок OneLink на дэшборде AppsFlyer.
  • Рекомендация: Сохраните ссылки, созданные с помощью API, в таблицу на компьютере, чтобы иметь к ним доступ в будущем. 

TTL 

  • Срок действия (TTL) по умолчанию для коротких URL-адресов OneLink, созданных с помощью API OneLink, составляет 31 день. Он продлевается на 31 день каждый раз, когда кто-то нажимает на ссылку. Клик по ссылке после истечения срока действия по-прежнему соответствует поведению, определенному в базовой конфигурации OneLink, но атрибуция работать не будет.
  • Максимальный TTL составляет 31 день. Любое значение TTL, превышающее 31, заменяется значением TTL по умолчанию (т.е. на 31).
  • ​Вы можете изменить значение TTL по умолчанию, добавив параметр ttl={value} и указав количество дней, часов или минут. Например, ttl=7d, ttl=12h или ttl=10m.
  • Вы можете отправить запрос на обновление чтобы указать значение TTL. Любой запрос на обновление сбрасывает TTL (для существующих ссылок) до значения, указанного в теле запроса.
    • Это означает, что TTL заменен. Например, если вы выполняете вызов обновления с TTL 2 дн. для ссылки, которая в настоящее время имеет TTL 29 дн., он изменится на TTL=2 дн. (не 31 день).
    • Вызов обновления потенциально может продлить срок действия ссылки атрибуции. Например, если вы выполняете вызов обновления с TTL 31 дн. для ссылки, которая в настоящее время имеет TTL 20 дн., из которых 5 дн. уже прошли, TTL будет составлять 31 день со дня обновления.
  • Если вы не хотите, чтобы TTL ссылок автоматически продлевался, добавьте параметр renew_ttl=false к ссылкам. Значение этого параметра логическое, либо true (по умолчанию), либо false
  • Параметр renew_ttl не отображается в фактическом URL-адресе.

Специальные символы

Следующие символы должны быть закодированы, если они используются для ссылок, созданных API: ;, , !, @, #, ?, $, ^, :, &, ~, `, =, +, ’, >, <, /
Если вы не закодируете эти символы, они заменятся пробелом.

Полезная нагрузка

Строка запроса из полезной нагрузки не более 2048 символов.

Идентификатор URL

Идентификатор URL (или идентификатор короткой ссылки) можно изменить, чтобы выделить предложение вашей кампании. Пример: https://myapp.onelink.me/abc123/apples. Идентификатор URL может иметь до 50 символов и содержать буквы и цифры. По умолчанию он состоит из 8 символов.

Внимание:

  • Вы можете изменить идентификатор URL, только если текущий идентификатор еще не используется.
  • Если идентификатор URL уже используется, создание ссылки завершается ошибкой и возвращается ответ об ошибке (400). Вы и ваш разработчик должны решить и настроить, что произойдет в таком случае.
  • Неудачный вызов также учитывается в вашем ежемесячном объеме вызовов API.