How can we help?

Utiliza la API de OneLink para crear enlaces en campañas a gran escala Premium

  • Actualización

En resumen: La API de OneLink te ayuda a captar la atención de los usuarios finales y a aprovechar los medios propios mediante la generación de enlaces personalizados en campañas a gran escala, a través de SMS y mucho más. Úsalo para crear viajes fluidos entre canales, profundizar el engagement y mejorar la conversión.

API de OneLink

La API de OneLink es una función premium que te permite convertir cualquier canal propio en una ruta directa a tu aplicación móvil. Al generar enlaces cortos personalizados de forma programática, puedes ofrecer viajes de usuario personalizados a escala, profundizar el engagement e impulsar más conversiones en SMS, correo electrónico, sitios web, publicaciones en redes sociales y mucho más. Con la API de OneLink, puedes:

  • https://dev.appsflyer.com/hc/reference/create-onelink-attribution-link
  • Los parámetros relacionados con la atribución, usados para medir y monitorear esfuerzos de marketing, como fuentes de medios, campañas y activos.Nota: El parámetro de la fuente de medios (pid) es obligatorio.
  • Estos parámetros te permiten enviar a los usuarios a contenido personalizado in-app, por ejemplo, una página de producto específica, un código de cupón o una promoción.
  • Genera automáticamente grandes volúmenes de enlaces cortos y QR code
  • Personaliza el TTL (Time To Live) y el comportamiento de renovación por caso de uso. Más información
  • Aplica una validación estricta de parámetros para garantizar un comportamiento de redirección predecible y una medición fiable.
  • Consulta el uso de la cuota para gestionar el consumo.
     

 Ejemplo

Una aplicación global de viaje genera millones de enlaces cortos contextuales al día en experiencias de CRM, correo electrónico y QR. Con la API de OneLink v2.0, su plataforma de automatización crea enlaces profundos por usuario que respetan la configuración regional, el nivel de fidelización y los destinos específicos in-app, al tiempo que mantiene la gobernanza y una medición coherente en todos los mercados. Prácticas recomendadas:

Comienza

La API de OneLink es una función premium que se utiliza para:

Requisito previo: Una cuenta de AppsFlyer. Para acceder a la API de OneLink, contacta con tu CSM o escríbenos a hello@appsflyer.com. 

Para configurar la API de OneLink:

  1. Copia el token de la API de OneLink.
  2. Crea una plantilla de OneLink.
  3. Copia el ID de la plantilla de OneLink. 
  4. Comparte el ID de la plantilla y el token de API con el desarrollador y pídele que siga estas instrucciones

Panel de Control

El dashboard de la API de OneLink muestra nuestro uso diario, mensual y trimestral de la API. Esto te ayuda a llevar el monitoreo de tu consumo frente al límite de cuota mensual. 

Para ver el dashboard de la API de OneLink

En AppsFlyer, en el menú lateral, selecciona Engage > API de OneLink.

CASOS DE USO

Los siguientes casos de uso destacan formas habituales de usar la API de OneLink para crear viajes fluidos y contextuales hacia tu aplicación.

Viajes multiplataforma (CTV, desktop, Web-to-app)

Genera enlaces de corta duración o por sesión que ayuden a los usuarios a moverse sin fricciones entre dispositivos. Algunos ejemplos habituales incluyen QR code en anuncios de TV o flujos de «escanea para continuar» en desktop que llevan a los usuarios directamente al paso in-app correcto.

Valor: Continuidad sin fricciones y mejora de la conversión entre dispositivos.

Canales impulsados por CRM (SMS, correo electrónico, WhatsApp)

Crea enlaces cortos personalizados por usuario en el momento del envío para mensajes de alta intención, como alertas de bajada de precio, listas de espera, campañas de recuperación, recordatorios de facturas o flujos de inicio de sesión mágico.

Valor: Personalización a escala con una atribución coherente.

Engagement offline y basado en QR

Genera enlaces escaneables para materiales en tienda, recibos, embalajes o señalización de eventos. Puedes actualizar la configuración de destino sin tener que volver a imprimir los materiales físicos.

Valor: Enrutamiento dinámico y atribución offline sin tener que reimprimir activos físicos.

Compartición de referidos y defensores de la marca

Habilita enlaces cortos compartibles para programas de referencias de influencers, creadores o clientes, con parámetros personalizables y enrutamiento preparado para la atribución.

Valor: Medición escalable y atribución precisa para las referencias.

Características y limitaciones

En esta sección se enumeran algunos de los principales atributos y limitaciones de la API de OneLink. Dile al desarrollador que siga las instrucciones del centro de desarrollo.

Caducado Observaciones
Límite de cuota de la API
  • El límite para usar la API de OneLink para crear, editar o eliminar enlaces de OneLink es de 7,5 millones al mes (zona horaria UTC), por cuenta.
  • Las solicitudes POST, PUT y DELETE cuentan para este límite. Las solicitudes GET y las solicitudes GET de QR no cuentan para la cuota.
  • No se atienden todas las solicitudes que se realizan después de superar esta cuota y no se crean los enlaces; la llamada a la API recibe el código de estado de error 429 con el mensaje «Se ha superado la cuota mensual».
  • Puedes comprobar cuánto de la cuota se ha usado o queda disponible de una de estas formas:
    • Visita la página de la API de OneLink en la plataforma de AppsFlyer para ver el historial de uso de los últimos 4 meses, o
    • Usa la API GET de cuota para recuperar el estado actual de tu cuota.
    También puedes usar la API GET de cuota para activar alertas internas cuando tu uso se acerque al umbral definido.
Visibilidad de los enlaces
  • Los enlaces creados mediante la API no aparecen en la lista de enlaces personalizados de OneLink en el dashboard de AppsFlyer.

    af_dp 

Nota:

En diciembre de 2025 se lanzó una nueva versión de la API de OneLink (v2.0). La versión anterior (v1.0) está obsoleta y seguirá funcionando hasta junio de 2026; después, dejará de recibir mantenimiento. Las nuevas integraciones deben usar la API de OneLink v2.0. Para obtener orientación sobre la migración, consulta la guía de migración en 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: