Preguntas frecuentes sobre los deep links
Existen varios factores que pueden afectar el comportamiento de tus deep links. Si tienes resultados inesperados con tus deep links, ya sea en la fase de testeo o en la producción, lee este artículo para encontrar una solución. Si tu problema continúa, envía un correo electrónico a support@adjust.com.
Problemas generales
¿La sintaxis y la codificación de mi URL son correctas?
Si tu deep link no te dirige hacia el destino especificado, o si devuelve un error HTTP 404, en primer lugar, revisa la sintaxis y la codificación de tu URL.
Las URL suelen utilizar esta sintaxis: scheme://host:port/path?query-string#fragment-id
Cada parte de una URL realiza una función diferente, y utiliza caracteres específicos para identificar y separar los valores. El esquema y el host no distinguen entre mayúsculas y minúsculas, pero la ruta y la cadena de consulta sí lo hacen. Si cometes cualquier error al escribir tu URL, esta no se abrirá de la manera esperada.
Al configurar tu deep link, pon atención a las siguientes condiciones:
- 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
&. De lo contrario, se eliminará cualquier información que aparezca después del segundo signo?en una URL.- Ejemplo correcto:
https://abcd.adj.st/my?path=location&client=name&adjust_t=klm012 - Ejemplo incorrecto:
https://z9pm.adj.st/my?path=location&client=name?adjust_t=klm012
- Ejemplo correcto:
- Si tu cadena de consulta está codificada, asegúrate de que de comience con una
/o que forme parte de un parámetrodeeplink.
Si tu aplicación aún no está instalada y no se cumplen estas condiciones, el navegador eliminará el parámetro adjust_t. Adjust necesita este parámetro para localizar la fuente del clic. Si no está presente, se devolverá el error HTTP 404 URL not found.
Ejemplos
Dependiendo de la manera en que configures la URL, tu deep link puede tener los siguientes comportamientos:
| Configuración de deep links | Ejemplo de URL del link | Comportamiento |
|---|---|---|
URL del link + parámetro deep_link | https://app.adjust.com/r40ncx7?deep_link=adjust%3A%2F%2F%3Fpath | La aplicación se abre en la página in-app especificada |
| link universal | https://abcd.adj.st/%3Fpath?adjust_t=r40ncx7 | La aplicación se abre en la página in-app especificada |
| link universal | https://abcd.adj.st/?path&adjust_t=r40ncx7 | La aplicación se abre si ya está instalada, pero no llega a la página in-app especificada. |
| link universal | https://abcd.adj.st%3Fpath?adjust_t=r40ncx7 | No es válida y devuelve un error |
¿Por qué no puedo ver mis datos de atribución o los niveles de mi campaña?
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.
¿Por qué se me dirige hacia la tienda aunque mi aplicación está instalada?
Normalmente, este comportamiento significa que tu deep link no pudo abrir la aplicación y redirigimos hacia la tienda como alternativa (fallback). Para comprobar si este es el caso, sigue estos pasos:
Sigue nuestras instrucciones de testeo como usuario existente para los links universales y para los links que tienen el parámetro deep_link.
Si la prueba resulta exitosa y se abre la aplicación, toma en cuenta el entorno desde el cual se hizo clic en el deep link cuando se presentó el error. Luego, revisa si se necesita algún parámetro adicional para ese caso.
- Por ejemplo: si se hace clic en un link universal JSR desde Slack, la marca
adjust_deeplink_js=1debería estar incluida. Esto ayuda a cargar el esquema antes de redirigir hacia la tienda. Si tu link no funciona incluso con la marcaadjust_deeplink_jspresente, es posible que tu esquema de la aplicación esté incorrecto en Campaign Lab.
- Por ejemplo: si se hace clic en un link universal JSR desde Slack, la marca
Asegúrate de que no exista ningún error de codificación que pueda dañar tus alternativas (fallbacks) o tus callbacks en la URL del link. Esto provoca que se eliminen algunos parámetros. Los parámetros eliminados provocan que el link completo no funcione de la manera esperada.
¿Por qué mi deep link no abre el lugar adecuado de la aplicación?
Si tu link no se abre en el lugar adecuado, pero sí abre tu aplicación, revisa si la causa del problema es el link o la configuración de la aplicación.
- Aloja el dominio del link universal (
https://abcd.adj.st/) o el esquema (myapp://) en un entorno web y haz clic en él desde ahí. - Comunícate con tu desarrollador para asegurarte de que las rutas estén configuradas correctamente dentro de la aplicación.
Nuestro sistema recibe los datos de clics entrantes para los deep links por medio de un link de Adjust o al tener los parámetros de Adjust anexados. Si tienes un deep link directo que únicamente incluye un dominio específico de tu aplicación, este no devolverá ningún dato 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://welcomeSi deseas recibir los datos de clics para todas las aplicaciones que ya están instaladas y para la reatribución de deep links, asegúrate de implementar el clic de SDK en el SDK de Adjust (iOS, Android).
Los deep links que activan un clic del SDK se agregan a los informes como clics en Datascape. También los puedes visualizar en tus datos sin procesar por medio del callback click. Si deseas obtener una visión granular de los clics que se generaron mediante un clic del SDK en el deep link, incluye el parámetro {is_deeplink_click}.
Resolución de problemas relacionados con deep links con un link y un parámetro deep_link
¿Por qué no funciona mi deep link desde una publicación de Facebook?
Las campañas ejecutadas por medio de publicaciones de Facebook deben utilizar una URL del link de Adjust con un parámetro deeplink anexado. Además, el parámetro deeplink debe tener una ruta anexada, o se dirigirá al usuario hacia la tienda (incluso si la aplicación está instalada). No es necesario que la ruta proporcionada sea válida.
Ejemplo de parámetro con una ruta anexada: https://app.adjust.com/abc123?deeplink=adjust%3A%2F%2Fsuch_path
Resolución de problemas relacionados con los deep links diferidos
¿Por qué mi deep link diferido no abre la aplicación en el lugar adecuado después de la instalación?
Si tu deep link diferido no te lleva a la ruta adecuada dentro de la aplicación después de la instalación, en primer lugar, revisa si la ruta existe. Aloja el esquema (myapp://) en un entorno web y haz clic en él desde ahí para probar si la causa del problema es tu link o la configuración de tu aplicación. Comunícate con tu desarrollador para asegurarte de que las rutas estén configuradas correctamente dentro de la aplicación.
Si se te dirige a la ruta correcta como usuario existente, pero no como un nuevo usuario, revisa tu dispositivo mediante la consola de testeo y asegúrate de que se te haya atribuido al clic. Si no fue así, olvida el dispositivo por medio de la consola de testeo y vuelve a intentarlo.
Si se te atribuyó al clic, revisa tu dispositivo para asegurarte de que incluya un parámetro deeplink. Si no lo tiene, asegúrate de que no exista ningún problema de codificación y que ningún carácter especial esté truncado en la URL antes del parámetro deeplink.
Por último, si hay un parámetro deeplink incluido, asegúrate de que la ruta esté presente. Si la ruta no está presente, esto quiere decir que se truncó por alguna razón. Envía un correo electrónico a support@adjust.com para obtener más ayuda.
¿Por qué mi deep link diferido no funciona después de olvidar el dispositivo?
Algunas veces, al hacer el testeo, el deep link diferido persiste durante algún tiempo después del clic, incluso después de olvidar el dispositivo mediante la consola de testeo.
Si esto sucede, tu prueba puede transcurrir de la siguiente manera:
- Haces clic en el deep link, instalas la aplicación y la abres.
- Desinstalas la aplicación.
- Olvidas el dispositivo mediante la consola de testeo.
- Ejecutas otra prueba (clic, instalación, apertura) 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. De esta manera, el deep link diferido debería funcionar de la manera esperada.