Preguntas frecuentes sobre los deep links
Diversos factores pueden afectar el comportamiento de deep links durante las pruebas o en producción. Emplea este artículo para solucionar problemas comunes con Adjust deep links, link universales y deep links diferidos. Si tu problema continúa, envía un correo electrónico a support@adjust.com.
Problemas generales de deep links
Si tu deep link no abre el destino esperado o devuelve un error HTTP 404 URL no encontrada, primero revisa la sintaxis y la codificación de la URL.
Las URL suelen utilizar esta sintaxis: scheme://host:port/path?query-string#fragment-id
Cada parte de la URL tiene una función específica. El esquema y el host no distinguen entre mayúsculas y minúsculas, pero la ruta y la cadena de consulta sí lo hacen. Cualquier error en la estructura de la URL puede impedir que el link se abra como se esperaba.
Al configurar tu deep link:
- Si deseas agregar un parámetro de Adjust a la cadena de consulta de una URL que ya contiene parámetros de consulta, utiliza un signo
&. No añadas una segunda?, porque la información luego de la segunda?puede ser descartada. - Si tu cadena de consulta está codificada, asegúrate de que de comience con una
/o que forme parte de un parámetrodeeplink. - Cerciórate de que no haya espacios ni caracteres inválidos en los respaldos, callbacks, parámetros de ID de dispositivo o parámetros de campaña. Los problemas de codificación pueden hacer que se corten los parámetros.
Ejemplo correcto :
https://example.go.link/my?path=location&client=name&adjust_t=klm012
Ejemplo incorrecto :
https://example.go.link/my?path=location&client=name?adjust_t=klm012
Si la aplicación no está instalada y la URL está mal estructurada, el navegador puede eliminar el parámetro adjust_t . Adjust necesita este parámetro para identificar el origen de clics. Sin él, Adjust devuelve 404 URL not found.
Esto normalmente significa que el deep link no abrió la app, por lo que el usuario fue redirigido a la tienda como alternativa (fallback).
Resolución de problemas:
- Prueba el link como usuario existente.
- Si la aplicación se abre durante las pruebas, comprueba el entorno donde el link falló originalmente.
- Comprueba si tu configuración de link universales/links a aplicaciones de Android/esquema de la aplicación personalizada es correcta, ya que estos son los estándares de link necesarios para abrir la aplicación
- Cerciórate de que no haya errores de codificación en los fallbacks o callbacks, ya que estos pueden hacer que se eliminen parámetros y rompan el link.
Si el link abre la app pero no abre la pantalla correcta dentro de la aplicación, comprueba si el problema es causado por la configuración del link o por la configuración de la aplicación.
Aloja tu deep link en un entorno sitio web y ábrelo desde tu dispositivo de prueba. Si usas un dominio con marca, prueba directamente el link con marca. Si usas el link heredado Adjust adj.st, puedes probar el dominio de link universal, por ejemplo https://abcd.adj.st/, o el esquema de la aplicación, por ejemplo myapp://.
Si la aplicación se abre pero la ruta de la aplicación es incorrecta, pide a tu desarrollador que confirme que las rutas de la aplicación están configuradas correctamente.
Nota: adj.st link universales son el enfoque heredado. Recomendamos usar dominios con marca para nuevas implementaciones.
Atribución y reporte
No. Adjust recibe datos de clics de deep link que emplean un link de Adjust o que tienen parámetros de Adjust agregados. Un deep link directo que solo usa tu dominio o esquema específico de la aplicación no envía datos de clics a Adjust.
Envía datos de clics:
myapp://welcome?adjust_t=abc123&adjust_campaign=re-engage_my_users&adjust_adgroup=apac&adjust_creative=promo1
https://z9pm.adj.st/welcome?adjust_t=abc123&adjust_campaign=re-engage_my_users&adjust_adgroup=apac&adjust_creative=promo1No envía datos de clics:
myapp://welcomePara recibir datos de clics de aplicaciones instaladas y reatribución de deep link, implementa el clic del SDK en el Adjust SDK para iOS o Android. Los deep links que activan un clic del SDK se reportan como clics en Datascape y son visibles en los datos en bruto a través del callback de clic.
Para identificar clics que provienen de un clic deep link de SDK, incluye el {is_deeplink_click} placeholder.
Si tus datos de atribución o los niveles de tu campaña provenientes de la URL de tu deep link no están disponibles, es probable que exista un problema de configuración. Revisa que los parámetros del ID del dispositivo y los parámetros de la campaña (según correspondan) no estén truncados debido a errores de codificación en las alternativas (fallbacks) o en los callbacks. Por ejemplo, revisa que no haya espacios o caracteres no válidos en la URL.
Problemas de link universal
¿Por qué mi socio recibe callbacks atribuidos aunque las instalaciones están atribuidas correctamente?
Si las instalaciones se atributo correctamente pero tu socio no recibe llamadas de callback atribuidas, revisa la configuración link universal.
Cerciórate de que:
El parámetro de ID de clic se agrega al link universal. No hay errores de codificación en las fallbacks o callbacks. Verifica que el parámetro de ID de clic tenga los prefijos adj_ o adjust_.
Si falta el identificador de clic, está mal formateado o se corta por un problema de codificación, Adjust puede atribuir la instalación pero no pasar los datos esperados del callback del socio.
Primero, comprueba que los link universales estén configurados correctamente.
Luego comprueba desde dónde abre Apple el link. Apple no permite redirecciones a link universales fuera de Safari, así que necesitas alojar el link universal sin procesar o esquema en un entorno sitio web y hacer clic en él desde ahí.
Si tu app sigue sin abrir:
- Abre tu página HTML de testeo en Safari y selecciona el ícono de Compartir. Si ves un Open en... con tu aplicación listada, la configuración de Dominios Asociados es correcta y el archivo de Apple App Site Association se descargó.
- Si no ves la aplicación lista, desinstala y reinstala.
- Verifica que el ID del paquete sea el mismo en pruebas y producción.
- Cerciórate de que el ID del paquete de iOS y el prefijo de la aplicación estén correctos en AppView.
- Si la app sigue sin abrir, pide a tu desarrollador que investigue la asociación link universal o esquema de aplicación.
También comprueba si tu link incluye target="_blank". Esto puede funcionar en pruebas pero fallar en producción. Elimina el atributo del link.
Cerciórate de que el link universal incluya un camino. Si no se agrega ninguna ruta, el usuario puede ser llevado a la tienda incluso si la aplicación está instalada. El camino no tiene por qué ser válido.
En general, iOS no permite la redirección hacia links universales fuera de Safari. Esto significa que cualquier entorno que utilice SFSafariViewController se verá afectado.
Dado que los link de email pueden abrir en muchos entornos, incluidos navegadores y aplicaciones de correo que no soportan link universales, Adjust recomienda usar link JSR o una integración con Adjust ESP.
Deep links con el parámetro de deep link
Las campañas ejecutadas por medio de publicaciones de Facebook deben utilizar una URL del link de Adjust con un parámetro deeplink anexado. El parámetro de deep link también debe incluir una ruta. De lo contrario, se dirigirá al usuario hacia la tienda, incluso si la aplicación está instalada. El camino no tiene por qué ser válido.
Ejemplo: https://app.adjust.com/abc123?deeplink=adjust%3A%2F%2Fsuch_path
Deep links diferidos
¿Por qué mi deep link diferido no abre la aplicación en el lugar adecuado después de la instalación?
Un deep link diferido se emplea cuando un usuario hace clic en un deep link antes de tener la app instalada. Tras la instalación, la aplicación debería abrir en la ubicación prevista dentro de la aplicación.
Si el deep link diferido no abre la ubicación correcta:
- Comprueba si el camino existe en la aplicación.
- Aloja el esquema de la aplicación, por ejemplo
myapp://, en un entorno sitio web y haz clic en él desde ahí. - Si la ruta no funciona para un usuario existente, pide a tu desarrollador que confirme que las rutas de la aplicación están configuradas correctamente.
- Si la ruta funciona para un usuario existente pero no para uno nuevo, inspecciona el dispositivo en la Consola de testeo y comprueba si se atribuye al clic.
- Si el dispositivo no fue atribuido, olvida el dispositivo en la Consola de testeo y vuelve a probarlo.
- Si el dispositivo fue atribuido, comprueba si incluye un parámetro
deeplink. - Si falta el parámetro
deeplink, comprueba si hay problemas de codificación o caracteres especiales que puedan estar cortando la URL. - Si el parámetro
deeplinkestá presente pero falta la ruta, contacta con Adjust Support.
Durante las pruebas, un deep link diferido a veces puede persistir durante un corto tiempo tras el clic, incluso luego de olvidar el dispositivo en la Consola de testeo.
Esto puede suceder en las siguientes circunstancias:
- Haces clic en el deep link, instalas la aplicación y la abres.
- Desinstala la aplicación.
- Olvida el dispositivo en la Consola de testeo.
- Hago otra prueba y el deep link diferido no funciona.
En este caso, vuelve a desinstalar la aplicación, olvida tu dispositivo por medio de la consola de testeo y vuelve a ejecutar la prueba.