Configuración de Smart Script de OneLink V2

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.

7901_Smart_Script_flow_1920x1080_2__1_.png

 Lectura relacionada:

Para obtener un panorama completo de cómo trabajar con banners inteligentes, consulta estos artículos:

instalación

Hay dos versiones de Smart Script de OneLink:

Smart Script V2 de OneLink (recomendado): si estás configurando Smart Script de OneLink por primera vez, esta es la versión preferible que se debe usar. Se puede generar en la interfaz de usuario de AppsFlyer sin la ayuda del desarrollador. Si por alguna razón, se necesita un desarrollador, su porción de trabajo es más fácil. Y también se puede configurar utilizando Google Tag Manager. Ver instrucciones para desarrolladores

Smart Script V1 de OneLink (heredado): si ya tienes Smart Script de Onelink configurado, utiliza la documentación de esta versión para mantener y editar este script. Nota: Aunque no es obligatorio, considera la posibilidad de migrar a la V2. 

 Nota

Haz clic en el botón Seguir en el encabezado del artículo para recibir información cuando haya una actualización del artículo o script.

Configuración de Smart Script de OneLink

Para configurar Smart Script, puedes:

  • Insertar el script en tu sitio web.
  • Utilizar Google Tag Manager.

Quién debe participar

  • Anunciante:
    • Decide qué debe contener la URL saliente basándose en los argumentos en el script que procesa la URL entrante. Esto determina la atribución y los datos de enlaces profundos que se incorporan a la URL saliente, ya sea manipulando la URL entrante o forzando ciertos valores.

    • Genera el Smart Script en la UI de AppsFlyer. 

    • Se asegura de que todas las campañas que llevan al sitio web móvil tengan direcciones URL entrantes con parámetros para los que funciona el script.
    • Prueba el Smart Script
  • Desarrollador web:
    • Verifica que el script se ejecuta en el sitio/páginas móviles en las que quieres que funcione.
    • Utiliza el valor del resultado según sea necesario, por ejemplo, para colocarlo como un enlace bajo una CTA en tu sitio web.
    • Puede ser necesario para crear códigos QR utilizando el script.
    • Puede ser necesario para agregar manualmente argumentos avanzados al script.

Requisitos previos

Alcance del trabajo

Para configurar Smart Script de Onelink:

  1. En AppsFlyer, ve a Experiencias y enlaces profundos > De la web a la aplicación > Smart Script.
  2. Selecciona una plantilla de OneLink en la que basar el script. La plantilla contiene los ajustes básicos de redireccionamiento.
  3. 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.
  4. Selecciona cómo implementar el Smart Script en tu sitio web:
    • Insertar el script en tu sitio web.
    • Utilizar Google Tag Manager.
  5. Haz clic en Generar.
  6. Haz clic en Descargar script.
  7. 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
  8. 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. Haz 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
  9. Prueba el script en la página de prueba de Smart Script. Asegúrate de que se genere la URL saliente correcta.

¡Importante! Cada vez que actualices el script, deberás implementarlo de nuevo.

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)
  • Lista de cadenas
  • Lista de posibles parámetros en la URL entrante que busca el script, cuyo valor se coloca como valor en la URL saliente.
  • El script busca de izquierda a derecha y se detiene en la primera coincidencia.
  • Ejemplo: ['in_channel', 'utm_channel']
  • Para el parámetro de canal en el script, el script busca en el enlace entrante para in_channel y utiliza el valor como valor para el canal.
Valor predeterminado
  • String
  • Indica cuál quieres que sea el valor de tu "fallback".
  • Si no se encuentra un parámetro en tu lista de claves, se utiliza el valor defaultValue en la URL saliente.
  • Puedes forzar un valor predeterminado pasando una lista de claves vacía.

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

  • Diccionario {string: string}
  • Para los valores que deseas cambiar en el enlace saliente, enumera los valores en la URL entrante, junto con lo que deseas que se reemplace.
  • El script sustituye los valores de los parámetros de la URL entrante por los valores que definas. 

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.

Objeto de configuración 

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.

Argumento Observaciones Registra tus respuestas (para que las utilices tú o tu desarrollador)
oneLinkURL (obligatorio)
  • Proporciona el dominio de la plantilla OneLink + el ID de la plantilla. Nota: ¡No es una URL de enlace personalizada de OneLink!
  • Ejemplo: yourbrand.onelink.me/A1b2
  • Ejemplo de dominio de marca: click.yourbrand.com/A1b2
 

afParameters

(obligatorio)

 

 

 


mediaSource

(obligatorio)

  • Objeto de configuración de la fuente de medios.
  • Ejemplo:
    • Claves: ['incoming_mediasource’' 'utm_source']
    • Valor por defecto: ['any_source']
    • Valores de anulación: {twitter: 'twitter_int', orig_src: 'new_src'}

Claves:

Valor predeterminado:

Valores de anulación:

campaign

  • Objeto de configuración de la campaña.
  • Ejemplo:
    • Claves: ['incoming_campaign', 'utm_campaign']
    • Valor predeterminado: ['any_campaign_name']
    • Valores de anulación: {campaign_name: 'new_campaign_name'}

Claves:

Valor predeterminado:

Valores de anulación:

channel

  • Objeto de configuración del canal.
  • Ejemplo:
    • Claves: ['incoming_channel', 'utm_channel']
    • Valor predeterminado: ['any_video']
    • Valores de anulación: {video: 'new_video'}

Claves:

Valor predeterminado:

Valores de anulación:

ad

  • Objeto de configuración del anuncio.
  • Ejemplo:
    • Claves: ['incoming_ad', 'utm_ad']
    • Valor predeterminado: ['any_ad_name']
    • Valores de anulación: {ad_name: 'new_ad_name'}

Claves:

Valor predeterminado:

Valores de anulación:

adSet
  • Objeto de configuración del conjunto de anuncios.
  • Ejemplo:
    • Claves: ['incoming_adset', 'utm_adset']
    • Valor predeterminado: ['any_ad_name']
    • Valores de anulación: {adset_name: 'new_adset_name'}

Claves:

Valor predeterminado:

Valores de anulación:

deepLinkValue
  • Objeto de configuración de deep_link_value.
  • Ejemplo:
    • Claves: ['product_id', 'page_name']
    • Valor predeterminado: 'new_offers_page'
    • Valores de anulación: {twenty_percent_off: 'thirty_percent_off'}

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.
Nota: Para que se muestre en los reportes de raw data de AppsFlyer, el parámetro debe ser uno de af_sub[1-5].

 
Otros parámetros de consulta (personalizados)
  • Enumera cualquier otro parámetro que desees incluir en la URL saliente de OneLink para la atribución o los enlaces profundos, junto con sus objetos de configuración.
  • El nombre del parámetro personalizado es identificado por el desarrollador como paramKey en el objeto de configuración.
  • Ejemplo:
    • paramKey: 'deep_link_sub1'
    • Claves: ['page_id']
    • Valor predeterminado: 'page1'
    • Valores de anulación: {page12: 'new_page12'}

Clave de parámetro:

Claves:

Valor predeterminado:

Valores de anulación:

Argumentos (parámetros y valores) para implementar el Smart Script

Argumentos avanzados

La siguiente tabla describe los argumentos que los marketers o desarrolladores con conocimientos técnicos pueden implementar en el Smart Script. 

Argumento Observaciones Registra tus respuestas (para que las utilices tú o tu desarrollador)
 
referrerSkipList
  • Lista de las cadenas en el referente HTTP para un clic en particular (por ejemplo, Twitter o Facebook) que, si se encuentra, hace que el Smart Script devuelva null. Esto puede ser útil para las SRN como Twitter y Facebook, para las que ya se han reportado clics.
  • La implementación de este argumento da como resultado que el script NO genere una URL de OneLink.

 

urlSkipList
  • Lista de cadenas en la URL para un clic determinado (por ejemplo, af_r) que, si se encuentran, hacen que el Smart Script devuelva null. Esto puede ser útil si utilizas un enlace de atribución de AppsFlyer con af_r para redirigir a los usuarios a tu sitio web móvil, y no quieres que se pierdan los datos del clic original.
  • La implementación de este argumento da como resultado que el script NO genere una URL de OneLink.

 

Argumentos avanzados (parámetros y valores) para implementar el Smart Script

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:

  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. 

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

 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.

ID de clic de Facebook

Los anuncios de Facebook llevan ID de clic. Si quieres que este ID esté disponible en el raw data de AppsFlyer, toma el ID de clic de Facebook y ponlo en la URL de salida en el parámetro de salida que elijas af_sub[1-5].

Para configurar el script para Facebook haz clic en ID:

  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, 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 Facebook. 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. 

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

 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.

Escritorio

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.

Agencias

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.

 Ejemplo

URL entrante: https://hotel.me/incoming_campaign=gogo&incoming_media_source=email&partner_name=bigagency

URL saliente: https://hotel.me/pid=email&c=gogo&af_prt=agency

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:

  1. Asegúrate de usar el Smart Script 2.1+ 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ácticas recomendadas: Dile al desarrollador que muestre el código QR cuando los usuarios estén en el escritorio y que 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. Nota: Los códigos QR creados a través de Smart Script no se pueden personalizar.

 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 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.2+ 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.
  4. [Opcional] Si deseas cambiar el valor predeterminado de la ventana retrospectiva por impresiones de 1 día, tú o tu desarrollador deben agregar el parámetro af_viewthrough_lookback con el nuevo valor. Por ejemplo, af_viewthrough_lookback=1d.
¿Fue útil este artículo?

Comentarios

0 comentarios

Inicie sesión para dejar un comentario.