API del Generador de deep links
La API del Generador de deep links está disponible para los clientes que tienen los planes TrueLink Core y TrueLink Enterprise. Si deseas actualizar tu plan, envía un correo electrónico a sales@adjust.com.
La API del Generador de deep links (DLG) te permite crear y administrar los deep links de Adjust de forma programática. En lugar de generar los links manualmente en el Dashboard de Adjust, puedes utilizar la API para crear flujos de trabajo de generación de links flexibles y escalables que te permitan crear links de forma individual o en grupo.
- Escala la creación de links al automatizar la generación por medio de API en lugar de flujos de trabajo manuales
- Integra la generación de deep links en tus herramientas existentes, como los sistemas de CRM o las plataformas de administración de campañas
- Crea y administra links abreviados o extensos, de forma individual o en grupo
- Crea Dashboards o scripts personalizados de generación de links para tus casos de uso internos
¿Para qué sirve?
La API del Generador de deep links replica la funcionalidad del Generador de deep links de Adjust, con lo que te brinda un control programático sobre el proceso de creación de links. Puedes hacer lo siguiente:
- Generar deep links individuales o múltiples con una sola solicitud.
- Crear links abreviados o extensos, según las necesidades de tu campaña.
- Actualizar los tokens de links abreviados existentes.
- Crear herramientas o flujos de trabajo que te permitan conectarte directamente con los endpoints de automatización de Adjust.
Los equipos pueden utilizar la API para automatizar los procesos repetitivos de creación de links, y para garantizar la precisión y la consistencia en la medición de sus campañas.
Casos de uso
¿Cómo funciona?
La API del DLG envía solicitudes HTTPS a los endpoints de automatización de Adjust. Todas las llamadas se autorizan con tu token existente de la API de Adjust.
Descripción general de los endpoints:
- Generar un solo deep link: POST
https://automate.adjust.com/engage/deep-links - Generar deep links en grupo: POST
https://automate.adjust.com/engage/deep-links/bulk - Actualizar un token de link abreviado: PUT
https://automate.adjust.com/engage/deep-links/{short_token} - Extraer datos de link abreviado: GET
https://automate.adjust.com/engage/deep-links/short-link?short_token={short_token}&app_token={app_token}
Primeros pasos
Requisitos
- Paquete TrueLink Core o TrueLink Enterprise.
- Un dominio con marca para iOS y Android.
- Token de la API de Adjust con acceso a la API del Generador de deep links.
Resumen de la configuración
- Configura tu dominio con marca para iOS y Android.
- Obtén tu token de la API de Adjust y tu token del link.
- Crea y testea llamadas de API, siguiendo la documentación para desarrolladores de Adjust.
- Integra scripts o macros de automatización para generar links a escala.
Si deseas ver todos los detalles sobre los primeros pasos, consulta la guía oficial para la API del Generador de deep links en la documentación para desarrolladores de Adjust.
Prácticas recomendadas
- Mantén actualizado tu SDK de Adjust para garantizar la compatibilidad con la resolución de links abreviados.
- Utiliza endpoints en grupo para las campañas de gran tamaño a fin de evitar los problemas relacionados con el límite de la tasa (máximo 200 solicitudes por segundo).
- Almacena los metadatos de tus campañas de forma central, y automatiza la creación de links con macros o scripts.
- Valida las respuestas de la API y reintenta las solicitudes que tengan errores.
- Utiliza un mismo dominio con marca para ambas plataformas a fin de mantener la consistencia en los redirects.
- Mantén los tokens de API en secreto y cámbialos periódicamente para mayor seguridad.
Elaboración de informes y monitoreo de uso
La API del generador de deep links incluye los límites de cuota para la creación de links abreviados. Puedes monitorear el uso mediante el Dashboard de Adjust y las respuestas de la API.
Cuota de links abreviados
- Los límites de links abreviados aplican a nivel de la cuenta
- Los límites están basados en el número de tokens abreviados únicos generados
- Las solicitudes idénticas devolverán links existentes, sin aumentar el uso
¿Qué se toma en cuenta para calcular el límite?
La cuota solo aplica para lo siguiente:
- Links abreviados creados con la API
La cuota no aplica para lo siguiente:
- Links extensos
- Links abreviados creados en el Dashboard
Cómo visualizar el uso en el Dashboard de Adjust
Puedes visualizar los datos de uso en la suite de Adjust:
- Dirígete a Configuración de la cuenta
- Selecciona Planes y uso
En esta sección se muestra lo siguiente:
- Cuota total de links abreviados
- Links abreviados restantes
- Detalles del contrato
Si quieres ver los datos de uso en Datascape, cambiar los rangos de fechas y visualizar la división del uso entre diferentes aplicaciones, también puedes utilizar este link directo
Cómo visualizar el uso mediante los encabezados de la API
Cada respuesta de la API incluye encabezados con la cuota y la información del contrato. Si deseas más información sobre la estructura de la carga útil de la API, consulta la documentación del generador de deep links en Developer Hub
Estos son los encabezados:
x-shortlink-quota-limit
x-shortlink-quota-remaining
x-contract-status
x-contract-start-date
x-contract-end-date