A simple vista: De un vistazo: Configura el Smart Script de OneLink para convertir y atribuir a los visitantes de tu sitio web móvil, provenientes de cualquier fuente, en usuarios de la aplicación móvil.
Configuración
Hay dos versiones de Smart Script de OneLink:
OneLink Smart Script V2 (recomendado): Si está configurando OneLink Smart Script por primera vez, esta es la versión recomendada para utilizar. Se puede generar en la interfaz de usuario de AppsFlyer sin asistencia del desarrollador. Si por alguna razón se necesita un desarrollador, su parte laboral es más fácil. También se puede configurar mediante Google Tag Manager. Ver instrucciones para desarrolladores
OneLink Smart Script V1 (heredado): Si ya tiene configurado Onelink Smart Script, utilice la documentación de esta versión para mantener y editar este script. Nota: Nota: Aunque no es obligatorio, considera migrar a V2 para obtener correctamente las atribuciones por impresiones usando el Smart Script de OneLink.
Configuración de Smart Script de OneLink
Para configurar Smart Script, puedes:
- Insertar el script en tu sitio web.
- Utilizar Google Tag Manager.
Alcance del trabajo
¿Quién está involucrado?
|
Requisitos previos
|
Cómo crear un Smart Script de OneLink
- En AppsFlyer, desde el menú lateral, seleccione Engage > Web-to-app > Smart Script.
-
Para nuevos usuarios
- Haz clic en el botón Comenzar.
- Sigue los pasos 4 y siguientes.
- Haz clic en el botón + Nuevo Smart Script en la parte superior de la página.
- Sigue las instrucciones que aparecen en pantalla para nombrar tu Smart Script.
- Selecciona una plantilla de OneLink en la que basar el script. La plantilla contiene la configuración básica de redireccionamiento.
- Asigna los parámetros que debe contener la URL saliente. Estos parámetros se basan en los parámetros de la URL entrante. Nota: El parámetro de la fuentes de medios (pid) es obligatorio.
- Seleccione el parámetro/dimensión de salida que desea mapear.
A menudo, este es un nombre de parámetro de AppsFlyer que no se puede cambiar, pero en algunos casos es necesario ingresar el nombre de su parámetro. - Decide y configura cuál debe ser el valor del parámetro de salida en función de uno u otro:
- Parámetros de URL entrante: Enumere uno o más posibles parámetros de URL entrantes que desea que se reemplacen por el parámetro de URL saliente. Los valores de los parámetros de la URL entrante serán los valores de su parámetro de URL saliente.
- Ejemplo: any_param_name, utm_param_name. Si se encuentra utm_param_name en la URL entrante, su valor se utilizará como el valor del parámetro de URL saliente seleccionado.
- La secuencia de comandos inteligente busca en la lista de parámetros de izquierda a derecha y asigna la primera coincidencia a la URL del parámetro saliente.
- Los desarrolladores hacen referencia a esta lista de parámetros como claves.
- Valor predeterminado: Ingrese el valor predeterminado deseado para el valor del parámetro saliente para cuando no se encuentra un parámetro de URL entrante o si no incluye ningún parámetro de URL entrante.
- Ejemplo: Ejemplo: para el parámetro saliente, si el parámetro URL entrante enumera any_paramname, utm_paramname, cuando no se encuentra ningún parámetro en la lista, el valor predeterminado se utilizará como el valor del parámetro saliente.
- Valores de anulación: Configure uno o másvalores de la URL entrante junto con los valores de la URL saliente con los que desea que se reemplacen.
- Ejemplo: Ejemplo: Para el parámetro de campaña, si el valor en la URL entrante es campaign_name, el valor en la URL saliente puede cambiarse a new_campaign_name.
- Parámetros de URL entrante: Enumere uno o más posibles parámetros de URL entrantes que desea que se reemplacen por el parámetro de URL saliente. Los valores de los parámetros de la URL entrante serán los valores de su parámetro de URL saliente.
- [Opcional] Haz clic en + Nuevo parámetro para asignar parámetros adicionales. Consulta todos los argumentos adicionales (configuraciones de parámetros) que puedes utilizar.
- Seleccione el parámetro/dimensión de salida que desea mapear.
-
Selecciona cómo implementar el Smart Script en tu sitio web:
- Insertar el script en tu sitio web.
- Utilizar Google Tag Manager.
- Haz clic en Probar para probar el script en la página de prueba de Smart Script. Asegúrate de que se genere la URL saliente correcta.
- Clic
- Guardar para guardar tus cambios.
-
Guardar y generar para guardar y generar el script.
- Haz clic en Descargar script.
- Si seleccionó incrustar el script en su sitio web: Envíe el script a su desarrollador web para que lo implemente y dígale qué hacer con la URL saliente generada. Por ejemplo, colocarla bajo un botón CTA en tu sitio móvil o presentar un código QR en tu sitio de escritorio. Instrucciones para el desarrollador
- Si seleccionaste usar Google Tag Manager:
- En Google Tag Manager, crea una nueva etiqueta, nombra la etiqueta, haz clic en Tag Configuration (Configuración de etiquetas) y selecciona Custom HTML (HTML personalizado).
- En el cuadro HTML, pega el código de Smart Script generado.
- Haz clic en Triggering (Activación), crea un nuevo activador, nómbralo y elige una Trigger Configuration (Configuración de activador) (por ejemplo, todas las vistas de página). Consulta la documentación de GTM para aprender más
- Haz clic en Save
- Dile a tu desarrollador web qué hacer con la URL saliente generada. Por ejemplo, colocarla bajo un botón CTA en tu sitio móvil o presentar un código QR en tu sitio de escritorio. Instrucciones para el desarrollador
- Los scripts guardados se pueden ver en el menú desplegable.
¡Importante!
Cada vez que actualices el script, deberás implementarlo de nuevo.
Cómo editar o eliminar un script
- Haga clic en la flecha desplegable junto al nombre del Smart Script.
Aquí puedes ver todos tus scripts guardados. - Haz clic en el icono del lápiz junto al script que quieres editar.
- Sigue los pasos de Cómo crear un Smart Script de OneLink.
- Haz clic en el icono de la papelera para eliminar el Smart Script.
¡Importante!
Cada vez que actualices el script, deberás implementarlo de nuevo.
Cómo duplicar un script
- Ve al Smart Script que deseas duplicar.
- Haga clic en el botón duplicar en el banner superior
- Sigue los pasos de Cómo crear un Smart Script de OneLink.
Estructura de los argumentos
El Smart Script de OneLink utiliza argumentos para generar una URL saliente basada en los parámetros de la URL entrante y los argumentos definidos en el script. El argumento afParameters tiene una estructura compuesta por otros argumentos (parámetros) utilizados para la atribución y los enlaces profundos, cada uno de los cuales contiene una estructura (a la que los desarrolladores se refieren como objeto de configuración) que tiene claves, valores de invalidación y un valor predeterminado, como se describe en la tabla siguiente.
Argumento | Descripción | Ejemplo |
---|---|---|
Parámetros de URL entrantes (a los que los desarrolladores se refieren como claves) |
|
|
Valor predeterminado |
|
Ejemplo: ['web_video'] Para el parámetro de canal en el script, si no se encuentra el parámetro in_channel, web_video se utiliza como valor de canal. |
Valores de anulación |
|
Ejemplo: {'video': 'video_new'} Para el parámetro del canal en el script, siempre que el valor entrante sea video, el script lo cambia a video_new en el enlace saliente. |
Argumentos
El Smart Script de OneLink utiliza argumentos para generar una URL saliente basada en los parámetros de la URL entrante y los argumentos definidos en el script.
Argumentos (parámetros y valores) para implementar el Smart Script
Argumento | Observaciones | Registra tus respuestas (para que las utilices tú o tu desarrollador) | |
---|---|---|---|
oneLinkURL (obligatorio) |
|
||
afParameters (obligatorio)
|
Fuente demedios (obligatorio) |
|
Claves: Valor predeterminado: Valores de anulación: |
campaña |
|
Claves: Valor predeterminado: Valores de anulación: |
|
canal |
|
Claves: Valor predeterminado: Valores de anulación: |
|
anuncio |
|
Claves: Valor predeterminado: Valores de anulación: |
|
adSet |
|
Claves: Valor predeterminado: Valores de anulación: |
|
deepLinkValue |
|
Claves: Valor predeterminado: Valores de anulación: |
|
afSub1-5 |
Objeto de configuración de af_sub[1-5]. |
Claves: Valor predeterminado: Valores de anulación: |
|
googleClickIdKey |
Indica cómo llamar al parámetro que lleva el GCLID. |
||
Otros parámetros de consulta (personalizados) |
|
Clave de parámetro: Claves: Valor predeterminado: Valores de anulación: |
Argumentos avanzados
La siguiente tabla describe los argumentos que los marketers o desarrolladores con conocimientos técnicos pueden implementar en el Smart Script.
Argumentos avanzados (parámetros y valores) para implementar en el Smart Script
Argumento | Observaciones | Registra tus respuestas (para que las utilices tú o tu desarrollador) | |
---|---|---|---|
referrerSkipList |
|
|
|
urlSkipList |
|
|
Casos de uso
Las siguientes secciones proporcionan casos de uso de Smart Script para algunos escenarios comunes de campañas/fuentes de medios.
Parámetros UTM
Para configurar el script para los parámetros UTM:
- Haz una lista de los parámetros UTM de la URL entrante (por ejemplo: utm_source y utm_campaign) y hazlos coincidir con los parámetros de la URL saliente (por ejemplo: media_source y campaign).
-
Proporciona estos en la lista de argumentos al desarrollador web.
Resultado: Resultado: Los valores de los parámetros entrantes (utm_source/span> y utm_campaign) se utilizan para rellenar los valores de los parámetros (media_source y campaign) en el enlace saliente.
Google Ads GCLID
El proceso habitual para la atribución de instalaciones de campañas de Google Ads (que contienen un parámetro GCLID) requiere que los usuarios que hacen clic en tu anuncio sean redireccionados a la URL de la página de la tienda de aplicaciones.
Dado que en este caso estás redireccionando clientes potenciales desde Google Ads a una página web o landing page, el script toma el parámetro GCLID de la URL de la campaña de instalación de Google Ads y lo coloca en la URL de salida. A partir de la versión 2.9.0 de Smart Script, los parámetros GCLID, WBRAID y GBRAID, cuando están disponibles, se reenvían automáticamente "tal cual" en las URLs de salida generadas por Smart Script.
También puedes asignar los IDs de clic a otros parámetros de salida (af_sub[1-5]) para que estén disponibles en los reportes de raw data de AppsFlyer.
¡Nota!
- Esto se aplica a las campañas de instalación. En el caso de las campañas de búsqueda que no son de ACI, es decir, las campañas de re-engagement, se puede atribuir a Google como fuente de medios, a pesar del resultado del Smart Script.
- Si se encuentra un GCLID, el script busca la palabra clave del parámetro entrante. Si se encuentra, coloca el valor de la palabra clave en la URL saliente como el valor de af_keywords.
Requisito previo: En el panel de Google, habilite el etiquetado automático.
Con el etiquetado automático habilitado,la URL contiene el parámetroGCLID.
Para configurar el script para asignar el GCLID de Google Ads a otros parámetros:
- Selecciona un parámetro en la URL saliente para que contenga el GCLID.
[Práctica recomendada]: Seleccione af_sub[1-5]para que los datos se muestren en los informes de datos sin procesar de AppsFlyer. -
Proporciona esto en la lista de argumentos al desarrollador web. El resultado será que en la URL saliente, el GCLID será el valor del parámetro af_sub[1-5] .
Para notificar a Google Ads sobre estas instalaciones:
- Obtén los datos GCLID del parámetro af_sub[1-5] a través de CSV o Push API en tiempo real para cada instalación.
- Sube los datos de GCLID a Google, ya sea manualmente o a través de Google Ads API.
Nota
Esta solución GCLID no es oficialmente compatible ni recomendada por Google. En caso de que Google deje de utilizar el parámetro GCLID, cambiaremos el script para admitir los cambios. Sigue este artículo, haciendo clic en el botón Seguir en la cabecera del artículo, para recibir notificaciones cuando haya una actualización del artículo o del script adjunto.
Facebook FBCLID
Los meta anuncios llevan identificadores de clic, llamados Identificador único. A partir de la versión 2.8.1 de Smart Script, cuando esté disponible, FBCLID se reenviará automáticamente "tal cual" en las URL salientes generadas por Smart Script. También puede asignar ID de clic a otros parámetros salientes para que estén disponibles en los informes de datos sin procesar de AppsFlyer.
Para configurar el script para asignar FBCLID a otros parámetros:
- Selecciona un parámetro en la URL saliente para que contenga el GCLID.
[Práctica recomendada]: Seleccione af_sub[1-5]para que los datos se muestren en los informes de datos sin procesar de AppsFlyer. -
Proporciona esto en la lista de argumentos al desarrollador web. El resultado será que en la URL saliente, el FBCLID será el valor del parámetro af_sub[1-5] .
SRN, medios propios y otros enlaces de fuentes de medios
SRN como Snapchat o Twitter, funcionan de manera diferente que Google Ads o una plataforma cruzada como Anuncios de Meta. Las campañas de estas SRN llevan a tus usuarios a la página web/de aterrizaje, y se te factura de acuerdo con los clics que les han conducido, no relacionados con ningún usuario móvil derivado.
Para estas SRN, la configuración del script es la misma que para los enlaces de medios propios u otras fuentes de medios que puedas utilizar.
Para configurar el script:
- Crea una lista de los nombres de los parámetros de fuente de medios y campaña que están en los enlaces entrantes.
-
Proporciona estos en la lista de argumentos al desarrollador web.
yoEl tipo de fuente SRN/media debe ser el valor de la fuente multimedia en la URL entrante, y el script lo encuentra y lo usa como el valor media_source en la URL OneLink saliente detrás del botón de descarga en la página web/de destino. Si deseas cambiar la media_source saliente, proporciona el valor de la fuente de medios entrante y el valor de la fuente de medios de anulación en la lista de argumentos que le das al desarrollador web.
Resultado: Resultado: Para estas SRN/fuentes de medios, los valores de los parámetros de fuente de medios y campaña en el enlace entrante se utilizan para rellenar los valores de los parámetros media_source y campaign en el enlace saliente.
Ejemplo
URL entrante: https://hotel.me/incoming_mediasource=twitter&incoming_campaign=big_social
URL saliente: https://hotel.onelink.me/Ac4G?pid=twitter&c=big_social
Enlaces de atribución de AppsFlyer
Los enlaces de atribución de AppsFlyer pueden utilizarse cuando la fuente de medios es una red de publicidad de clic. Cuando configuras dicho enlace en AppsFlyer, tienes la opción de agregar un parámetro de ruta URL de redireccionamiento (af_r) con la ruta de URL deseada a tu sitio web móvil para la atribución de campaña web a aplicación. Es posible que no desees que el Script cree una URL de OneLink saliente, ya que, en ese caso, podrían perderse algunos de los datos del clic original.
Acción Utilice el argumento urlSkipList para enumerar el parámetro af_r .
Resultado: Resultado: cuando el Smart Script encuentra el parámetro af_r en el enlace entrante, el Smart Script no produce una URL saliente y el desarrollador debe decidir qué enlace colocar como URL saliente e implementarlo.
Ejemplo
URL entrante: https://app.appsflyer.com/id123456789?pid=click_ad_network_int&c=orlando&af_r=hotel.me
URL saliente: No hay URL saliente.
Asignación del referente web
La asignación del referente web te permite aprender de qué página llegaron los usuarios a tu sitio web (por ejemplo, a partir de resultados de búsquedas orgánicas) y, por lo tanto, enriquecer los datos a tu disposición para analizar las instalaciones y los re-engagements que se originan en tu flujo de web a aplicación de Smart Script.
Puedes configurar el Smart Script para recopilar esta información de tu página de aterrizaje o del campo Referer
Referer del encabezado HTTP del sitio web. Este campo contiene la URL base de la página desde la que los usuarios hicieron clic en un enlace que los envió a tu página web.
Para configurar el script para recopilar el referente web
- Abre la página Smart Script.
- En la sección del área de asignación del referente web, selecciona la clave de parámetro de URL saliente para el valor de referente web:
- af_channel: el parámetro está disponible en los paneles de control y en el raw data
- af_sub1-5: el parámetro está disponible en el raw data, bajo las columnas af_sub1-5 y URL original.
- Parámetro personalizado: este se compone del nombre y valor del parámetro. El parámetro se muestra en el raw data, en la columna URL original.
Para aprender sobre la atribución de búsquedas orgánicas para re-engagements usando enlaces universales y enlaces de aplicaciones, consulta aquí.
Escritorio
La mayoría de los casos de uso en este artículo Son de usuarios que provienen de dispositivos móviles. Por lo tanto, cuando se les dirige desde el sitio web móvil a una tienda de aplicaciones, pueden descargar inmediatamente su aplicación.
Sin embargo, los usuarios de escritorio no deben ser enviados inmediatamente a una tienda de aplicaciones, ya que su dispositivo (una computadora de sobremesa o portátil) no es compatible con las descargas de aplicaciones móviles.
Para configurar el script para los usuarios de escritorio:
- En tu plantilla de OneLink, establece una URL de destino para Cuando se hace clic en el enlace en el escritorio. La URL debe redirigir a una página web/de aterrizaje dedicada. La página de aterrizaje puede contener un formulario web en el que se rellenan los datos para recibir un SMS o un correo electrónico con un enlace para descargar la aplicación. Eres tú quien debes crear el formulario web y proporcionar la URL del mismo en el script.
Resultado: El script detecta el dispositivo o la plataforma en la que se encuentra el usuario. Si es de escritorio, el script genera una URL saliente de OneLink que redirige al usuario a tu página web/de aterrizaje dedicada.
Consulta también Conversión de escritorio a aplicación.
Códigos QR
El Smart Script muestra un código QR en tu página web, en lugar de un botón con un enlace detrás.
Para mostrar un código QR:
- Asegúrate de usar el Smart Script 2.6+ cuando configures tu Smart Script.
- Dile a tu desarrollador que siga sus instrucciones para crear un código QR con el resultado del Smart Script.
-
[Práctica recomendada] Dile al desarrollador que:
- Personalice el código QR agregando el logo de tu aplicación al centro de códigos QR y personalizando el color.
- Muestre el código QR cuando los usuarios estén en el escritorio y muestre el botón con el enlace cuando los usuarios estén en el móvil.
Resultado: El script muestra un código QR en lugar de un botón con una URL detrás.
Ejemplo
URL entrante:
https://hotel.me/qr_code.html?incmp=gogo&inmedia=email
URL saliente:
https://hotel.onelink.me/LtRd/?af_js_web=true&af_ss_ver=2_1_0&pid=email&c=gogo
Código QR saliente:
Impresiones
El script inteligente OneLink se puede utilizar para contar impresiones en su sitio web. Para ello, el desarrollador debe: Llamar a la función de impresión. Luego, las instalaciones se atribuyen a las impresiones mediante la atribución de visualización.
Nota:
- El recuento de impresiones se suma a la URL normal producida por el Smart Script que cuenta los clics. El Smart Script puede utilizarse para contar los clics, las impresiones o ambos.
- La atribución por impresiones a través de Smart Script solo funciona en dispositivos móviles; no en los de escritorio.
Para atribuir nuevas instalaciones a estas impresiones (atribución por impresiones):
- Asegúrate de usar Smart Script 2.3+ al configurar tu Smart Script.
- Dile a tu desarrollador que llame la función de impresión en el Smart Script.
- Asegúrate de que la atribución por impresiones esté activada.
¡Importante!
A partir del 1 de febrero de 2023 (lanzamiento estable de Chrome 110), Google ha realizado algunos cambios para reducir los datos de usuario-agente. Para obtener correctamente las las atribuciones por impresiones usando el Smart Script de OneLink, debes usar el OneLink Smart Script versión 2.3 y superior.
Información adicional
Preguntas frecuentes
¿La URL entrante para la generación de enlaces de OneLink funcionará si el usuario navega a una página diferente en el sitio web?
Sí. Sí. Los parámetros de URL entrantes se almacenan durante la sesión de navegación y se aplican a los parámetros salientes del enlace de OneLink generado por Smart Script. Para obtener más información sobre la implementación, consulta nuestro centro de desarrollo.
¿Por qué obtengo un error al implementar Smart Script a través de Google Tag Manager?
A veces, cuando generas el Smart Script en AppsFlyer e intentas insertarlo en Google Tag Manager (GTM), aparece un error de "JavaScript demasiado largo". Si esto ocurre, elimina la etiqueta GTM y crea una nueva.
¿Puedo agregar parámetros que no aparecen en la lista?
Sí. En tu página OneLink Smart Script, haz clic en + Nuevo parámetro para asignar parámetros adicionales.
- Los nuevos parámetros pueden ser parámetros personalizados o parámetros reservados de AppsFlyer que no están listados en el menú desplegable.
- Consulta todos los argumentos adicionales (configuraciones de parámetros) que puedes utilizar.
- Utiliza la opción Personalizado del menú desplegable y tu parámetro en el campo Parámetros de URL saliente.
Por ejemplo, para agregar is_retargeting como parámetro, se seleccionaría el parámetro Personalizado en el campo asignar para , y luego nuestro parámetro is_retargeting en el campo Parámetros de URL saliente.
El conjunto de anuncios y otros parámetros no se muestran en el menú desplegable
Te recomendamos desactivar cualquier bloqueador de anuncios que tengas en tu navegador al crear o agregar nuevos parámetros. A veces los bloqueadores de anuncios eliminarán una opción si tiene la palabra 'Anuncio' en ella.
¿En qué navegadores funciona Smart Script?
Smart Script usa Javascript y debería funcionar en todos los navegadores.
Especificaciones y limitaciones
Especificación |
Observaciones |
---|---|
Esquema URI |
Incluso si se establece un esquema URI en la plantilla de OneLink para abrir la aplicación para los usuarios existentes, para los enlaces creados con Smart Script, el desarrollador debe agregar el parámetro af_dp con el esquema URI a las URL como un parámetro personalizado. |
# en la dirección URL entrante |
Smart Script encuentra problemas al manejar direcciones URL entrantes que incluyen un símbolo hash ('#') que precede a los parámetros de consulta (indicado por un '?' signo). En tales casos, Smart Script revierte a los valores predeterminados. |