Preguntas frecuentes sobre los links universales
Existen varios factores que pueden afectar el comportamiento de tus links universales. Si tienes resultados inesperados con tus links universales, 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, comunícate con nosotros.
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=1
deberí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_js
presente, 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=promo1
No envía datos de clics:
myapp://welcome
Si 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}
.
Problemas con los links universales
¿Por qué mi link universal no abre una aplicación instalada?
Revisa si la configuración de tus links universales está correcta.
Revisa cuál es el entorno de Apple desde el que se abre el link. Los redirects hacia los links universales no están permitidos por Apple fuera de Safari, por lo que deberás alojar el link universal sin procesar o el esquema en un entorno web. Por ejemplo,
https://abcd.adj.st/
omyapp://
, respectivamente. Con la aplicación instalada en tu dispositivo de testeo, visita la página donde alojaste el link universal sin procesar o el esquema y selecciona el link.
Si tu aplicación no se abre :
- Abre tu página HTML de testeo en Safari y selecciona el ícono de Compartir. Deberías ver un menú "Abrir en...", donde tu aplicación aparece como una de las opciones. Si ves este menú, quiere decir que la configuración de dominios asociados es correcta y que el archivo de asociación de sitios con aplicaciones de Apple (AASA) se descargó correctamente. Si no ves esa opción, tal vez tengas que desinstalar y reinstalar la aplicación.
- Verifica que tu ID del paquete sea el mismo en el entorno de testeo y en el entorno de producción.
- Asegúrate de que el ID del paquete de iOS y el app prefix de tu aplicación que aparecen en AppView sean correctos. Si están configurados correctamente y tu aplicación aún no se abre, consulta a tu desarrollador para revisar la asociación con el link universal o el esquema de la aplicación.
- Revisa si el atributo
target=“_blank”
forma parte de tu link:
Esto puede provocar que la aplicación se abra en el entorno de testeo, pero no en el de producción.
Por ejemplo, con el atributo target=“_blank”
, tu código HTML se puede parecer al siguiente:
<a href="[https://abcd.adj.st](https://abcd.adj.st/)" target="_blank">Universal Link to App</a>
Para resolver este problema, elimina el atributo, como se muestra en el siguiente ejemplo:
<a href="[https://abcd.adj.st](https://abcd.adj.st/)">Universal Link to App</a>
¿Por qué se me dirige hacia la tienda aunque mi aplicación está instalada?
- Sigue nuestras instrucciones de testeo para los links universales. Además, sigue los pasos descritos en la sección titulada "¿Por qué mi link universal no abre una aplicación instalada?".
- Toma en cuenta el entorno en el que se hizo clic en el link universal 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=1
deberí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_js
presente, es posible que tu esquema de la aplicación esté incorrecto en la configuración de tu aplicación en AppView.
- Por ejemplo: si se hace clic en un link universal JSR desde Slack, la marca
¿Por qué mi deep link o mi deep link diferido no abren la aplicación en el lugar adecuado después de la instalació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.
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é no funciona mi link universal desde una publicación de Facebook o Instagram?
Asegúrate de que tu link universal tenga una ruta anexada. De lo contrario, 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://abcd.adj.st/path?adjust_t=abc123
¿Puedo utilizar links universales en las campañas de correo electrónico?
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.
Existen muchos entornos diferentes en los que se puede abrir un correo electrónico, como un navegador o una aplicación de correo electrónico no compatible con los links universales. Por lo tanto, la práctica recomendada es utilizar links JSR o, idealmente, una de las integraciones con ESP de Adjust.
¿Por qué no puedo ver mis datos de atribución o los niveles de mi campaña?
Revisa si los parámetros de Adjust incluyen los prefijos adj_
o adjust_
. Los parámetros de Adjust que no incluyan los prefijos adj_
o adjust_
se eliminarán, y es probable que no puedas ver los datos de esos parámetros.
¿Por qué mi socio recibe callbacks atribuidos aunque las instalaciones están atribuidas correctamente?
- Revisa si agregaste el parámetro de ID de clic al link universal.
- 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.
- Verifica que el parámetro de ID de clic tenga los prefijos
adj_
oadjust_
¿Por qué tengo problemas con los links universales JSR en Safari para iOS 12.2 y 12.3?
Para iOS 12.2 y 12.3, los links universales JSR no siempre se abren correctamente al hacer clic en ellos dentro de un entorno de Safari. Esto afecta específicamente los casos en los que el encabezado del referente HTTP no es legible (por ejemplo, al utilizar el modo incógnito).
Para las campañas de Safari, recomendamos utilizar links universales sin procesar. Sin embargo, esto no funciona para las campañas de correo electrónico con URL envueltas.
Esto no aplica a partir de iOS 13, ya que podemos aplicar una alternativa (fallback) para el esquema. Sin embargo, esto provoca que se muestre un mensaje emergente adicional.