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:
|
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
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)
- Ve a Links → Manage Links en la plataforma de Singular.
- Ubica tu link personalizado y haz clic para editarlo (o crea uno nuevo).
- Si no ves el toggle Disable short link parameters overrides , intenta activar primero Shorten Link .
- Activa el toggle Disable short link parameters overrides .
- Guarda el link.
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
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.