Configuración de Smart Script de OneLink V2

1. En AppsFlyer, ve a Experiencias y enlaces profundos > De la web a la aplicación > Smart Script.
2. Para nuevos usuarios
   1. Haz clic en el botón Comenzar.
   2. Sigue los pasos 4 y siguientes.
3. Haz clic en el botón + Nuevo Smart Script en la parte superior de la página.
4. Sigue las instrucciones que aparecen en pantalla para nombrar tu Smart Script.
5. Selecciona una plantilla de OneLink en la que basar el script. La plantilla contiene la configuración básica de redireccionamiento.
6. 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 fuente de medios (pid) es obligatorio.
   1. Selecciona el parámetro/dimensión saliente para asignar.
      A menudo, este es un nombre de parámetro de AppsFlyer que no se puede cambiar, pero en algunos casos, necesitas introducir tu nombre de parámetro.
   2. 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: enumera uno o más parámetros de URL entrante posibles que desees reemplazar por el parámetro de URL saliente. Los valores de los parámetros de URL entrante serán los valores de tu parámetro de URL saliente.
        • Ejemplo: any_param_name, utm_param_name. Si utm_param_name se encuentra en la URL entrante, su valor se utilizará como el valor del parámetro 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: introduce el valor predeterminado deseado para el valor del parámetro saliente cuando no se encuentra un parámetro de URL entrante o si no enumeras ningún parámetro de URL entrante.
        • 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 sustitución: configura uno o más valores de la URL entrante junto a los valores de la URL saliente con los que deseas que sean sustituidos.
        • 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.
   3. [Opcional] Haz clic en + Nuevo parámetro para asignar parámetros adicionales. Consulta todos los argumentos adicionales (configuraciones de parámetros) que puedes utilizar.
7. Selecciona cómo implementar el Smart Script en tu sitio web:
   • Insertar el script en tu sitio web.
   • Utilizar Google Tag Manager.
8. 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.
9. Clic
   1. Guardar para guardar tus cambios.
   2. Guardar y generar para guardar y generar el script.
      1. Haz clic en Descargar script.
10. Si has seleccionado incrustar el script en tu sitio web: envía el script a tu desarrollador web para que lo implemente y dile 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
11. Si seleccionaste usar Google Tag Manager:
    1. 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).
    2. En el cuadro HTML, pega el código de Smart Script generado.
    3. 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
    4. Haga clic en Guardar
    5. 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
12. Los scripts guardados se pueden ver en el menú desplegable.

1. Haz clic en la flecha desplegable junto al nombre de Smart Script.
   Aquí puedes ver todos tus scripts guardados.
2. Haz clic en el icono del lápiz junto al script que quieres editar.
   1. Sigue los pasos de Cómo crear un Smart Script de OneLink.
3. Haz clic en el icono de la papelera para eliminar el Smart Script.

1. Ve al Smart Script que deseas duplicar.
2. Haz clic en el botón duplicar en el banner superior.
3. Sigue los pasos de Cómo crear un Smart Script de OneLink.

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.

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

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

Para configurar el script para los parámetros UTM:

1. 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). 
2. Proporciona estos en la lista de argumentos al desarrollador web.
   

Resultado: Los valores de los parámetros entrantes (utm_source y utm_campaign) se utilizan para rellenar los valores de los parámetros (media_source y campaign) en el enlace saliente. 

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 redirigidos a la URL de la página de la tienda de la aplicación.

Como en este caso, estás redirigiendo clientes potenciales desde Google Ads a una página web/de aterrizaje, el script toma el parámetro GCLID de la URL de la campaña de instalación de Google Ads y lo pone en la URL saliente en el parámetro de salida que elijas af_sub[1-5].

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.

Requisitos previos: En el panel de control de Google, habilita el etiquetado automático.
Con el etiquetado automático habilitado, la URL contiene el parámetro GCLID.

Para configurar el script para Google Ads GCLID:

1. Selecciona un parámetro en la URL saliente para que contenga el GCLID.
   Práctica recomendada: Selecciona af_sub[1-5], para que los datos se muestren en los reportes de raw data de AppsFlyer.
2. Proporciona esto en la lista de argumentos al desarrollador web.
   

Resultado: en la URL saliente, el GCLID es el valor del parámetro af_sub[1-5] .

Para notificar a Google Ads sobre estas instalaciones:

1. 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.
2. Sube los datos de GCLID a Google, ya sea manualmente o a través de Google Ads API.

Los anuncios de Meta llevan ID de clic, llamados ID de clic de Facebook. Si quieres que este ID esté disponible en el raw data AppsFlyer, asegúrate de poner la URL saliente en tu elección del parámetro de salida af_sub [1-5].

Para configurar la secuencia de comandos para el ID de clic de Facebook:

1. Selecciona un parámetro en la URL saliente para que contenga el ID de clic de Facebook.
   Práctica recomendada: Selecciona af_sub[1-5], para que los datos se muestren en los reportes de raw data de AppsFlyer.
2. Proporciona esto en la lista de argumentos al desarrollador web.
   

Resultado: en la URL saliente, el ID de clic de Facebook es el valor del parámetro af_sub[1-5] .

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:

1. Crea una lista de los nombres de los parámetros de fuente de medios y campaña que están en los enlaces entrantes.
2. Proporciona estos en la lista de argumentos al desarrollador web.
   El tipo de SRN/fuente de medios debe ser el valor de fuente de medios en la URL entrante, y el script lo encuentra y lo utiliza como el valor media_source en la URL saliente de OneLink, detrás del botón de descarga en la página web/de aterrizaje. 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: 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. 

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: Utiliza el argumento urlSkipList para listar el parámetro af_r.

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.

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 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

1. Abre la página Smart Script.
2. 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í.

La mayoría de los casos de uso de este artículo son de usuarios que provienen de dispositivos móviles. Por lo tanto, cuando se dirigen del sitio web móvil a una tienda de aplicaciones, pueden descargar tu aplicación de inmediato.

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.

Las instalaciones se atribuyen a las agencias mediante el parámetro af_prt.

Para agregar este parámetro de atribución utilizando el Smart Script de OneLink, dile a tu desarrollador que siga estas instrucciones.  

Resultado: El script detecta el parámetro adicional en la URL entrante con el nombre de la agencia y agrega el parámetro af_prt a la URL saliente.

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:

1. Asegúrate de usar el Smart Script 2.6+ cuando configures tu Smart Script.
2. Dile a tu desarrollador que siga sus instrucciones para crear un código QR con el resultado del Smart Script.
3. [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.

El Smart Script de OneLink se puede usar para contar las impresiones en tu sitio web. Para hacerlo, el desarrollador debe llamar la función de impresión. Entonces, las instalaciones se atribuyen a las impresiones a través de la atribución por impresiones.

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): 

1. Asegúrate de usar el Smart Script 2.3+ cuando configures tu Smart Script.
2. Dile a tu desarrollador que llame la función de impresión en el Smart Script.
3. Asegúrate de que la atribución por impresiones esté activada.

¿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í. 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.