How can we help?

[Legacy] Configuración de OneLink Smart Script V1

  • Actualización

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. Nota: Aunque no es obligatorio, considera la posibilidad de migrar a OneLink Smart Script V2

7901_Smart_Script_flow_1920x1080_2__1_.png

instalación

Hay dos versiones de Smart Script de OneLink:

OneLink Smart Script V2 (recomendado): Si estás configurando OneLink Smart Script por primera vez, esta es la versión preferida. La parte de trabajo del desarrollador es más fácil y también se puede configurar con Google Tag Manager. Nota: Aunque no es obligatorio, considera la posibilidad de migrar a la V2. 

OneLink Smart Script V1 (heredado): Si ya tienes configurado Onelink Smart Script, utiliza la documentación de esta versión para mantener y editar este script. 

Responsabilidades

¿Quién participa?

  • Anunciante: 
    • Decide qué debe contener la URL saliente. Esto incluye qué datos de atribución se añadirán al enlace y los datos necesarios para el Deep Linking. Ya sea manipulando la URL entrante o forzando ciertos valores. 

    • 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. 
  • Desarrollador web:
    • Configura los datos para inicializar el script. 
    • Introduce los setters necesarios para generar las URL salientes de OneLink en función de los parámetros de URL entrantes proporcionados por el responsable de marketing. Esto incluye parámetros obligatorios y opcionales.  
    • Inserta el script en el sitio web o en páginas específicas. 

Prerrequisitos

Para implementar el script en la página web:

  1. Decide qué parámetros/valores debe contener la URL saliente de OneLink generada automáticamente. Consulta la lista de parámetros que puedes usar. 
    • Asegúrate de que todas las campañas con URL entrantes tengan parámetros para los que funcione el script (y que pueda colocarlos como parámetros pid y c). 
  2. Proporciona la lista de parámetros al desarrollador web.
  3. Dile al desarrollador que siga las instrucciones para desarrolladores e implemente el script para que se genere el enlace saliente correcto.

Parámetros

Parámetros/valores proporcionados al desarrollador para implementar el Smart Script

Parámetro/valor Nota Registra tus respuestas (para que el desarrollador las utilice)
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
 
pidKeysList (fuentes de medios)
  • Enumera todos los parámetros de fuente de medios de la URL entrante que se colocarán como parámetro de fuente de medios (pid) en la URL saliente.
  • Ejemplo: ['af_pid', 'utm_source']
 

pidOverrideList

  • Para las fuentes de medios que quieras cambiar en el enlace saliente, enumera los valores de fuente de medios en la URL entrante junto con aquello por lo que quieras reemplazarlos.
  • Ejemplo: {
    'twitter': 'twitter_int',
    'snapchat': 'snapchat_int',
    'some_social_net': 'some_social_net_int'
    }

 

pidStaticValue

  • Indica cuál quieres que sea tu fuente de medios de "fallback".
  • Si no se encuentra un parámetro de fuente de medios en tu pidKeysList, se usa pidStaticValue como fuente de medios (pid) en la URL saliente.
  • Ejemplo: 'website' o 'landing_page'

 

campaignKeysList (campañas)
  • Enumera todos los parámetros de campaña de la URL entrante que se colocarán como parámetro de campaña (c) en la URL saliente.
  • Ejemplo: ['af_campaign', 'utm_campaign']

 

campaignStaticValue
  • Indica cuál quieres que sea tu campaña de "fallback".
  • Si no se encuentra un parámetro de campaña en tu campaignKeysList, se usa campaignStaticValue como la campaña (c) en la URL saliente.
  • Ejemplo: 'website' o 'landing_page'

 

gclIdParam
  • Indica cómo llamar al parámetro que contiene 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.
 
skipList
  • Enumera las cadenas del referente HTTP que deshabilitan Smart Script para un clic específico (por ejemplo, Twitter o Facebook). Si se encuentran esas cadenas, el Smart Script no se ejecuta. Esto puede ser útil para SRN como X Ads y Meta Ads, para los cuales ya se informan los clics.
  • Si quieres que Smart Script se ejecute siempre, incluso para las SRN, dile al desarrollador que pase una lista de omisión vacía.
 
Otros parámetros de consulta
  • Enumera cualquier otro parámetro que quieras incluir en la URL saliente de OneLink para Atribución o Deep Linking.
  • Añade un deep_link_value para Deep Linking.
    • Además de añadir el parámetro, tú y tu desarrollador tenéis que implementar la lógica de Deep Linking. Saber más
  • Puedes usar parámetros de la URL entrante o forzar un valor estático. 
 

CASOS DE USO

Las siguientes secciones proporcionan casos de uso de Smart Script para algunos escenarios comunes de campañas/fuentes de medios.

Anuncios de Metaatribución multiplataforma

Los anuncios de Meta son una SRN que no usa enlaces de atribución externos.

Cuando se abre la app por primera vez, AppsFlyer consulta a los anuncios de Meta si el usuario ha interactuado previamente (en los últimos 7 días) con un anuncio de la app. Si el usuario ha interactuado con un anuncio de Facebook del anunciante, los anuncios de Meta se autoatribuyen. Los Anuncios de Meta también se atribuyen a la multiplataforma, lo que significa que el usuario puede interactuar con cualquier tipo de campaña, móvil o no, en cualquier plataforma, para que los Anuncios de Meta lo atribuyan a sí mismo.

Acción: Indica a tu desarrollador que use el método skipList para desactivar Smart Script para los anuncios de Meta (o cualquier otra cadena que quieras). Si los anuncios de Meta o cualquiera de las cadenas de la lista de omisión aparecen en el referente HTTP del clic, Smart Script devuelve null.

Nota: La atribución multiplataforma de los anuncios de Meta puede verse afectada cuando los usuarios optan por no compartir su ID de dispositivo, como se espera de los usuarios de iOS 14 durante 2021.

Google AdsGCLID y parámetros UTM

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 leads desde Google Ads a una página web/de destino, 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 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. 

Requisito previoEn el Dashboard de Google, habilita el etiquetado automático.
Con el etiquetado automático habilitado, la URL contiene el GCLID parámetro.

Para configurar el script para Google Ads:

  1. Haz una lista de los nombres de los parámetros de fuente de medios y campaña que están en los enlaces entrantes.
    Por ejemplo: utm_source y utm_campaign.
  2. 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].
  3. Proporciona estos en la lista de parámetros al desarrollador web.

Resultado:

  • Los valores de los parámetros de fuente de medios y campaña (utm_source y utm_campaign) del enlace entrante se utilizan para rellenar los valores de los parámetros pid y c en el enlace saliente. 
  • 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 mediante una API de Adwords.

 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.

SRN, medios propios y otros enlaces de fuentes de medios

SRNs como Snapchat o X Ads funcionan de forma diferente a Google Ads o a una multiplataforma como los 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 parámetros al desarrollador web.
    T
    el tipo de SRN/fuente de medios debe ser el valor de la fuente de medios en la URL entrante, y el script lo encuentra y lo usa como el valor de pid en la URL saliente de OneLink detrás del botón de descarga en la página web/de destino. Si quieres cambiar el pid saliente, proporciona el valor de fuente de medios entrante y el valor de reemplazo de pid en la lista de sustitución de pid. 

Resultado: Para estas SRN/fuentes de medios, los valores de los parámetros de fuente de medios y campaña del enlace entrante se utilizan para rellenar los valores de los parámetros pid y c en el enlace saliente. 

 Ejemplo

URL entrante: https://hotel.me/af_pid=twitter&af_c=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 un enlace de este tipo en AppsFlyer, tienes la opción de añadir un parámetro de ruta URL de redirección (af_r) con la ruta URL deseada a tu sitio web móvil para la atribución de campaña web a aplicación. 

Resultado: Si los parámetros af_r y af_redirect=true están en el enlace entrante, el script de la página de destino no realiza cambios. Deja los enlaces directos de la página web/de destino a las tiendas de aplicaciones tal como están. 

 Ejemplo

URL entrante: https://app.appsflyer.com/id123456789?pid=click_ad_network_int&c=orlando&af_redirect=true&af_r=hotel.me

URL saliente: Igual

Ordenador

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

Limitaciones

Limitación Nota
Administrador de etiquetas

Smart Script no se puede implementar mediante un administrador de etiquetas. Consulta OneLink Smart Script V2 o Smart Banners como solución alternativa de atribución Web-to-app.

This article was translated automatically and may contain errors. The English version is the most accurate - use the language selector below to switch.

Share article: