Parámetros de tracking links

Más guías para socios integrados Más guías sobre Singular Links para clientes

Los parámetros de los tracking links cumplen un rol fundamental para garantizar una recopilación de datos y una atribución precisas para los socios de redes publicitarias. Los tracking links de Singular admiten una amplia variedad de parámetros que permite a las redes publicitarias adjuntar información valiosa sobre clics e impresiones. Al completar estos parámetros, las redes publicitarias pueden transmitir datos críticos a Singular, lo que permite una medición más precisa del rendimiento de las campañas.

Una vez que se activa un tracking link, el tracker de Singular procesa los parámetros incorporados y los utiliza de diversas maneras, como por ejemplo:

  • Mejorar la precisión de la atribución determinística o probabilística
  • Habilitar insights más profundos de la campaña: Cualquier dato sobre la campaña, la subcampaña (grupo de anuncios/conjunto de anuncios), el creativo, etc., es guardado por el tracker de Singular y se utiliza para proporcionar desgloses adicionales en los informes agregados y en los logs a nivel de usuario ( Export Logs and User-Level Data FAQ ).
  • Determinar el comportamiento de redirección de los Singular Links: Algunos parámetros se utilizan para determinar cómo se comporta el tracking link. Estos parámetros especiales no necesitan ser completados por la red: se agregan al Singular Link cuando el cliente lo crea en la plataforma de Singular.

Los tracking links son un componente clave de tu integración como fuente de medios integrada con Singular. Te permiten transmitir datos esenciales sobre clics e impresiones, garantizando una atribución y una medición de campañas precisas. Si tu empresa también admite postbacks, asegúrate de revisar la sección Postback Macros and Passthrough Parameters for Ad Networks antes de enviar una solicitud de integración con Singular. Una vez que hayas reunido todos los detalles necesarios, puedes postularte aquí para ser una fuente de medios integrada con Singular.

Mostrar: Todos Datos del dispositivo Parámetros de granularidad Comportamiento de Singular Links Parámetros de Website Links


Tracking Link Parameter
Descripción Dimension Name in Singular Aggregated Reports
Field Name in Singular User-Level Data
Categoría
In Web UI
In API/ Data Destination Schemas
In Web UI (Export Logs)
In Data Destination Schemas
ip IP del dispositivo al momento del clic IP ip
Device and Other Data
cl El ID del clic o de la transacción, cuando está disponible Click ID click_id
Device and Other Data
ve La versión del sistema operativo en el dispositivo del usuario. Nota: solo numérico y decimal. OS Version os_version
Device and Other Data
idfa El iOS Advertising ID del dispositivo (sin hashear/en crudo) IDFA idfa
Device and Other Data
ifa1 El iOS Advertising ID del dispositivo (formato SHA-1) IDFA SHA1
idfa_sha_1
Device and Other Data
ifa5 El iOS Advertising ID del dispositivo (formato MD5) IDFA MD5
idfa_md5
Device and Other Data
idfv El iOS Identifier for Vendor. Este identificador se utiliza para todas las apps en el dispositivo publicadas por el mismo proveedor y puede ayudar a determinar la atribución cuando el IDFA no está disponible. IDFV idfv
Device and Other Data
ifv1 El iOS Identifier for Vendor (formato SHA-1) IDFV SHA-1
Device and Other Data
ifv5 El iOS Identifier for Vendor (formato MD5) IDFV MD5
Device and Other Data
aifa El Android Advertising ID (AAID) del dispositivo del usuario, también conocido como GAID GAID gaid
Device and Other Data
aif1 El Android Advertising ID (AAID) del dispositivo del usuario, también conocido como GAID (formato SHA-1) GAID SHA1 gaid_sha_1
Device and Other Data
aif5 El Android Advertising ID (AAID) del dispositivo del usuario, también conocido como GAID (formato MD5) GAID MD5 gaid_md5
Device and Other Data
oaid El Open Anonymous Device ID del dispositivo del usuario (usado en China) OAID Device and Other Data
amid
Amazon Advertising ID AMID
Device and Other Data
sng_ref
El Google Play Install Referrer. Usa este parámetro si tienes una integración de atribución por link S2S para habilitar la atribución basada en install referrer en dispositivos Android. Más información
Device and Other Data
ua El user agent del dispositivo

A partir de iOS 26, la versión se adjunta al user agent. Asegúrate de que el user agent que se transmite sea el user agent completo con la versión. Por ejemplo:
Mozilla/5.0 (iPhone; CPU iPhone OS 18_6 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/26.0 Mobile/15E148 Safari/604.1
User Agent Device and Other Data
pssn El nombre del sitio/ubicación dentro de la app del publisher. Sub Publisher Name sub_publisher_name
Device and Other Data
pssid El ID del sitio/ubicación dentro de la app del publisher. Sub Publisher ID sub_publisher_id
Device and Other Data
p
Plataforma del dispositivo (Android/iOS) Platform platform
Platform platform Granularity Parameters
pcn El nombre de la campaña Campaign Name campaign_name Campaign Name campaign_name
Granularity Parameters
pcid El ID de la campaña Campaign ID campaign_id Campaign ID campaign_id
Granularity Parameters
pscn El nombre de la subcampaña. La subcampaña es un desglose adicional bajo el nivel de campaña en algunas redes. A veces se le llama Ad Set o Ad Group. Sub Campaign Name sub_campaign_name Sub Campaign Name sub_campaign_name
Granularity Parameters
pscid El ID de la subcampaña. La subcampaña es un desglose adicional bajo el nivel de campaña en algunas redes. A veces se le llama Ad Set o Ad Group. Sub Campaign ID sub_campaign_id Sub Campaign ID sub_campaign_id
Granularity Parameters
pcrn El nombre del creativo (según la red, el "creativo" de Singular puede ser lo mismo que el "anuncio" de la red, o puede haber múltiples creativos por cada anuncio). Creative Name creative_name
Creative Name creative_name Granularity Parameters
pcrid El ID del creativo (según la red, el "creativo" de Singular puede ser lo mismo que el "anuncio" de la red, o puede haber múltiples creativos por cada anuncio). Creative ID creative_id
Creative ID creative_id Granularity Parameters
pshid El ID de la app en la que se mostró el anuncio. El ID está hasheado o anonimizado. Publisher ID publisher_id
Publisher Hashed ID publisher_hashed_id
Granularity Parameters
psn El nombre de la app en la que se mostró el anuncio (normalmente el nombre de la app en la tienda de apps correspondiente). Publisher Site Name publisher_site_name
Publisher Name publisher_name
Granularity Parameters
psid El ID público de la app en la que se mostró el anuncio (normalmente el ID de la app en la tienda de apps correspondiente). Publisher Site ID publisher_site_id
Publisher ID publisher_id
Granularity Parameters
kw La palabra clave de búsqueda (para Google Ads y Apple Search Ads) Keyword keyword
Keyword Granularity Parameters
paffn El nombre del afiliado (para redes de afiliados que lo reportan) Affiliate Name affiliate_name
Affiliate Name affiliate_name
Granularity Parameters
paffid El ID del afiliado (para redes de afiliados que lo reportan) Affiliate ID affiliate_id
Affiliate ID affiliate_id Granularity Parameters
_dl Deep link para todas las plataformas móviles. Nota: la sobrescritura/el uso de este query parameter solo es posible si el link original fue habilitado con deep linking. Ten en cuenta que se requiere URL encode para este parámetro Singular Links Redirect Behavior
_ddl Deferred deep link para todas las plataformas móviles. Nota: _ddl puede habilitar el deferred deep linking incluso si no se habilitó a través de la UI durante la creación. Ten en cuenta que se requiere URL encode para este parámetro Singular Links Redirect Behavior
_global_redirect Redirección para todas las plataformas, incluso en el caso de que el usuario tenga la app instalada.

**Cuando se usa en el mismo link junto con otros parámetros de sobrescritura de destino (por ejemplo, _fallback_redirect), el valor de _global_redirect definirá el destino de la redirección. Ten en cuenta que se requiere URL encode para este parámetro
Singular Links Redirect Behavior
_fallback_redirect Redirección de fallback para plataformas que no son Android ni iOS (normalmente usada para Web). Ten en cuenta que se requiere URL encode para este parámetro Singular Links Redirect Behavior
_android_redirect Redirección de Android: URL de redirección si la app no está instalada en Android. Normalmente es la URL de la tienda de apps. Ten en cuenta que se requiere URL encode para este parámetro Singular Links Redirect Behavior
_samsung_redirect Redirección de Android para dispositivos Samsung: URL de redirección si la app no está instalada en dispositivos Samsung. Se admiten valores de la tienda de apps de Samsung ( samsungapps://ProductDetail/com.game.app ). Ten en cuenta que actualmente no se admite el deep linking con esta opción de redirección. Ten en cuenta que se requiere URL encode para este parámetro Singular Links Redirect Behavior
_android_dl Deep Link (Android): normalmente se usa si tu URL de deep link en Android es diferente de la de tu app de iOS. Ten en cuenta que se requiere URL encode para este parámetro Singular Links Redirect Behavior
_android_ddl Deferred Deep Link (Android): normalmente se usa si tu URL de deep link en Android es diferente de la de tu app de iOS. Nota: _android_ddl puede habilitar el deferred deep linking incluso si no se habilitó a través de la UI durante la creación. Ten en cuenta que se requiere URL encode para este parámetro Singular Links Redirect Behavior
_ios_redirect Redirección de iOS (iOS): URL de redirección si la app no está instalada en iOS. Normalmente es la URL de la tienda de apps. Ten en cuenta que se requiere URL encode para este parámetro Singular Links Redirect Behavior
_ios_dl Deep Link (iOS): normalmente se usa si tu URL de deep link en iOS es diferente de la de tu app de Android. Nota: la sobrescritura/el uso de este query parameter solo es posible si el link original fue habilitado con deep linking de iOS. Ten en cuenta que se requiere URL encode para este parámetro Singular Links Redirect Behavior
_ios_ddl Deferred Deep Link (iOS): normalmente se usa si tu URL de deep link en iOS es diferente de la de tu app de Android. Nota: _ios_ddl puede habilitar el deferred deep linking incluso si no se habilitó a través de la UI durante la creación. Ten en cuenta que se requiere URL encode para este parámetro Singular Links Redirect Behavior
_p El passthrough parameter se usa en la configuración de Deep Links y Deferred Deep Links. Se pueden personalizar para transmitir cosas como códigos promocionales o nombres de afiliados/influencers. Ten en cuenta que se requiere URL encode para este parámetro Passthrough passthrough Singular Links Redirect Behavior
_force_redirect=1 Force Redirect: en los casos en que los iOS Universal Links podrían no hacer deep link , adjuntar &_force_redirect=1 (o &_force_redirect=true) permitirá que el Singular Link use deep linking basado en app scheme para forzar el deep link hacia el usuario final. Más información en Singular Links dynamic redirects handling Singular Links Redirect Behavior
redirect=false Este parámetro debe usarse si el socio desea redirigir a sus usuarios a la tienda de forma independiente. Hacer clic en un link con &redirect=false no llevará a la tienda. Singular Links Redirect Behavior
_forward_params=1

Opciones de forward parameters:

  • Establece en 1 para reenviar los parámetros del Singular Link a los destinos de redirección de App Store y Web Fallback.
  • Establece en 2 para reenviar los parámetros del Singular Link a todos los destinos de redirección, incluido el Deeplink.

Más información

Singular Links Redirect Behavior
_og_title Sobrescribe el título OG (titular) que se muestra cuando el link se comparte en plataformas sociales.
Se requiere URL encoding.
Solo para links de Custom Source.
Singular Links Redirect Behavior
_og_desc Sobrescribe la descripción OG que se muestra cuando el link se comparte en plataformas sociales.
Se requiere URL encoding.
Solo para links de Custom Source.
Singular Links Redirect Behavior
_og_image Sobrescribe la imagen OG que se muestra cuando el link se comparte en plataformas sociales.
Debe ser una URL de imagen de acceso público.
Se requiere URL encoding.
Solo para links de Custom Source.
Singular Links Redirect Behavior
force_ios_landing_page Fuerza una landing page social para links de iOS. Funciona independientemente del indicador "Enable Landing Page" en Manage Links. Singular Links Redirect Behavior
force_android_landing_page Fuerza una landing page social para links de Android en apps de Meta compatibles (Facebook, Facebook Messenger, Facebook Messenger Lite, Instagram). Funciona independientemente del indicador "Enable Landing Page" en Manage Links. Singular Links Redirect Behavior
an
Socio de red publicitaria Website Links Parameters
utm_campaign
El valor del parámetro utm_campaign de la URL de la landing page web. * El valor se usará como Campaign Name si utilizas Singular Web Attribution y no implementas el parámetro "wpcn". UTM Campaign* UTM Campaign utm_campaign Website Links Parameters
utm_medium
El valor del parámetro utm_medium de la URL de la landing page web UTM Medium UTM Medium utm_medium Website Links Parameters
utm_source
El valor del parámetro utm_source de la URL de la landing page web. ** El valor se usará como Source si utilizas Singular Web Attribution y no implementas el parámetro "wpsrc". UTM Source** UTM Source utm_source Website Links Parameters
utm_term El valor del parámetro utm_term de la URL de la landing page web UTM Term UTM Term utm_term Website Links Parameters
utm_content El valor del parámetro utm_content de la URL de la landing page web UTM Content UTM Content utm_content Website Links Parameters
wpcid
El ID de la campaña Campaign ID campaign_id Campaign ID campaign_id Website Links Parameters
wpcn
El nombre de la campaña Campaign Name campaign_name Campaign Name campaign_name Website Links Parameters
wpcrid
El ID del creativo (según la red, el "creativo" de Singular puede ser lo mismo que el "anuncio" de la red, o puede haber múltiples creativos por cada anuncio). Creative ID creative_id Creative ID creative_id Website Links Parameters
wpcrn
El nombre del creativo (según la red, el "creativo" de Singular puede ser lo mismo que el "anuncio" de la red, o puede haber múltiples creativos por cada anuncio). Creative Name creative_name Creative Name creative_name Website Links Parameters
wpkmatch
Match Type Website Links Parameters
wpkwid
Target ID Website Links Parameters
wpkwn
Palabra clave de búsqueda Keyword keyword Keyword Website Links Parameters
wpscid
El ID de la subcampaña. La subcampaña es un desglose adicional bajo el nivel de campaña en algunas redes. A veces se le llama Ad Set o Ad Group. Sub Campaign ID sub_campaign_id Sub Campaign ID sub_campaign_id Website Links Parameters
wpscn
El nombre de la subcampaña. La subcampaña es un desglose adicional bajo el nivel de campaña en algunas redes. A veces se le llama Ad Set o Ad Group. Sub Campaign Name sub_campaign_name Sub Campaign Name sub_campaign_name Website Links Parameters
wpsn El nombre del sitio/ubicación dentro de la app del publisher. Publisher Site Name publisher_site_name Publisher Name publisher_name Website Links Parameters
wpsrc
Red Source source Partner source Website Links Parameters

Deshabilitar las sobrescrituras de parámetros para short links

Section heading anchor-link helper

De forma predeterminada, puedes adjuntar parámetros de redirección y de deeplink a un Singular Link (como _dl , _fallback_redirect , _ios_redirect , etc.) al momento del clic para sobrescribir dinámicamente la configuración guardada del link. Esto es útil cuando necesitas ofrecer distintos destinos de redirección desde el mismo link base.

Sin embargo, en algunos flujos de trabajo — por ejemplo, cuando muchos miembros del equipo comparten links internamente — es posible que desees evitar la sobrescritura y la reutilización de links.

La función Disable short link parameters overrides te permite bloquear un link personalizado acortado para que los parámetros que ya están configurados en el link base no puedan sobrescribirse al adjuntarlos a la URL. Los parámetros que no están configurados en el link base aún pueden adjuntarse como nuevos valores.

Cómo funciona

Configuración Comportamiento
Casilla desmarcada (predeterminado) Los parámetros adjuntados al short link se respetan: el link se comporta igual que un Singular Link estándar.
Casilla marcada Los parámetros que ya están configurados en el link base quedan bloqueados y no pueden sobrescribirse al adjuntarlos al short link. Los parámetros que no están configurados en el link base — incluidos los parámetros de granularidad como pcn , pcid , pcrn y los passthrough parameters como _p — aún pueden adjuntarse como nuevos valores.

Los siguientes parámetros de redirección y de deeplink están específicamente protegidos frente a la sobrescritura cuando están configurados en el link base:

_dl , _android_dl , _ios_dl , _ddl , _android_redirect , _android_ddl , _ios_redirect , _ios_ddl , _fallback_redirect

Cualquier otro parámetro que ya esté definido en el link base también está protegido.

Cómo habilitarlo (UI)

  1. Ve a Links → Manage Links en la plataforma de Singular.
  2. Ubica tu link personalizado y haz clic para editarlo (o crea uno nuevo).
  3. Si no ves el toggle Disable short link parameters overrides , intenta activar primero Shorten Link .
  4. Activa el toggle Disable short link parameters overrides .
  5. Guarda el link.

Disable short link parameters overrides toggle in the Link Summary section

Cómo habilitarlo (API)

Esta configuración también es compatible al crear o actualizar un link a través de la Singular Links API . Pasa el parámetro booleano opcional disable_short_link_parameters_overrides en el cuerpo de tu solicitud:

  • false (predeterminado) — los parámetros del link base pueden sobrescribirse al adjuntarlos al short link.
  • true — los parámetros que ya están configurados en el link base quedan bloqueados y no pueden sobrescribirse.

Si usas la Dynamic Short Links API , cualquier short link generado hereda automáticamente el valor de disable_short_link_parameters_overrides de su Singular Link base. No se requiere ninguna configuración adicional.

Limitaciones

  • Esta función está disponible solo para links personalizados (de source) . No está disponible para links de socios.
  • Esta es una configuración por link . Para tener control a nivel de cuenta sobre qué destinos de redirección se permiten en todos los links, consulta Limiting Override Destinations .

URL Encoding requerido para Dynamic Deep Links y redirecciones a tiendas de terceros

Section heading anchor-link helper

El URL encoding es obligatorio para todos los parámetros de dynamic deep link y los parámetros de redirección a tiendas de terceros (por ejemplo, _samsung_redirect o _android_dl ).

Hemos observado múltiples casos en los que clientes o socios adjuntan Singular links sin aplicar URL encoding a los valores de los query parameters, lo que provoca que los links no se resuelvan correctamente o que caigan inesperadamente en fallback hacia la Play Store.

Para garantizar un comportamiento consistente y confiable entre dispositivos y navegadores, usa siempre valores con URL encoding. Un encoding correcto:

  • Garantiza la resolución correcta de los dynamic deep links
  • Habilita redirecciones confiables a tiendas de terceros
  • Evita comportamientos de fallback no deseados (como redirecciones a la Play Store)

Ejemplo

Correcto (con URL encoding):

&_samsung_redirect=samsungapps%3A%2F%2FProductDetail%2Fnet.singular.deviceassist2

Incorrecto (sin encoding):

&_samsung_redirect=samsungapps://ProductDetail/net.singular.deviceassist2

Nota: Aplica siempre URL encoding a los valores de los query parameters antes de adjuntarlos a los Singular links.