Rasgos y limitaciones

Característica

Observaciones

API quota limit

  • The limit for using the OneLink API to create, edit, or delete OneLink links is 7.5 million per month (UTC timezone), per account.
  • All requests that are made after exceeding this quota are not served, and the links are not created; the API call receives error status code 429 with the message "Monthly quota exceeded".
  • Information regarding how much of the rate quota is used/remains is displayed in the OneLink API dashboard. 

Rate limit

  • The API rate limit per account is 500 requests per second (30000 per minute).
  • All requests that are made exceeding 500 requests per second (30000 per minute) are not served, and the links are not created; the API call receives error status code 429 with the message "Rate limit exceeded".

Visibilidad de los enlaces

  • Los enlaces creados a través de la API no aparecen en la lista de enlaces personalizados de OneLink en el dashboard de AppsFlyer.
  • Prácticas recomendadas: Guarda los enlaces creados con la API en una tabla local, para que puedas acceder a los enlaces para cualquier fin futuro. 

TTL 

  • El tiempo de vida predeterminado (TTL) para las URL cortas de OneLink creadas a través de la API de OneLink es de 31 días. Se extiende por 31 días cada vez que se hace clic en el enlace. Hacer clic en dicho enlace una vez que el TTL vence sigue siendo el comportamiento predeterminado definido en la configuración base de OneLink, pero la atribución no funcionará.
    • It can take up to 48 hours for a OneLink short URL to be deleted after the TTL expires.
  • El TTL máximo es de 31 días. Cualquier valor del TTL mayor que 31 se reemplaza por el TTL predeterminado de 31.
  • Puedes cambiar el TTL por defecto añadiendo el parámetro  ttl={value}  y especificando cuántos días, horas o minutos. Por ejemplo  ttl=7d,  ttl=12h, o ttl=10m.
  • Puedes enviar una solicitud de actualización para especificar el TTL. Cualquier solicitud de actualización restablece el TTL (para enlaces existentes) al especificado en el cuerpo de la solicitud.
    • Esto significa que se reemplaza el TTL. Por ejemplo, si realizas una llamada de actualización con un TTL 2d para un enlace que actualmente tiene un TTL 29d, cambiará a TTL=2d (no a 31d).
    • Una llamada de actualización puede prolongar potencialmente la vida útil del enlace de atribución. Por ejemplo, si realizas una llamada de actualización con un TTL 31d para un enlace que actualmente tiene un TTL 20d pero han pasado 5 días, el TTL será 31d desde el momento de la actualización.
  • Si no deseas que los TTL del enlace se extiendan automáticamente, agrega el parámetro renew_ttl=false a tus enlaces. El valor de este parámetro es booleano, ya sea verdadero (predeterminado) o falso.
  • El parámetro renew_ttl no se muestra en la URL real.

Caracteres especiales

Los siguientes caracteres deben estar codificados si se usan para enlaces creados por la API: ;, , !, @, #, ?, $, ^, :, &, ~, `, =, +, ’, >, <, /
Si no codificas estos caracteres, se reemplazan con un espacio en blanco.

Carga útil

La cadena de consulta de la carga útil no puede superar los 2048 caracteres.

ID de URL

El ID de URL (o ID de enlace corto) se puede editar para resaltar la oferta de tu campaña. Por ejemplo: https://myapp.onelink.me/abc123/apples. El ID de la URL no debe superar los 50 caracteres y puede ser una combinación de letras y números. De forma predeterminada, tiene 8 caracteres.

Nota:

  • Solo puedes editar el ID de URL si el ID actual aún no está en uso.
  • Si el ID de URL ya está en uso, la creación del enlace falla y devuelve una respuesta de error (400). Deberás decidir y configurar con tu desarrollador lo que sucede en dicho evento.
  • La llamada fallida sigue contando para tu cuota mensual de API.