Mais guias para parceiros integrados • Mais guias sobre Singular Links para clientes
Os parâmetros de tracking links desempenham um papel fundamental para garantir a coleta de dados e a atribuição precisas para os parceiros de redes de anúncios. Os tracking links da Singular oferecem suporte a uma ampla variedade de parâmetros que permitem às redes de anúncios anexar informações valiosas sobre cliques e impressões. Ao preencher esses parâmetros, as redes de anúncios podem transmitir dados críticos para a Singular, possibilitando uma medição mais precisa do desempenho das campanhas.
Depois que um tracking link é acionado, o tracker da Singular processa os parâmetros incorporados e os utiliza de diversas maneiras, tais como:
- Melhorar a precisão da atribuição determinística ou probabilística
- Habilitar insights mais aprofundados sobre a campanha: Quaisquer dados sobre a campanha, subcampanha (ad group/ad set), criativo, etc., são salvos pelo tracker da Singular e usados para fornecer detalhamentos adicionais em relatórios agregados e logs em nível de usuário ( FAQ de Exportação de Logs e Dados em Nível de Usuário ).
- Determinar o comportamento de redirecionamento dos Singular Links: Alguns parâmetros são usados para determinar como o tracking link se comporta. Esses parâmetros especiais não precisam ser preenchidos pela rede - eles são adicionados ao Singular Link quando este é criado pelo cliente na plataforma Singular.
Os tracking links são um componente essencial da sua integração como fonte de mídia integrada com a Singular. Eles permitem que você transmita dados essenciais sobre cliques e impressões, garantindo atribuição e medição de campanhas precisas. Se a sua empresa também oferece suporte a postbacks, revise a seção Macros de Postback e Parâmetros de Passthrough para Redes de Anúncios antes de enviar uma solicitação de integração com a Singular. Depois de reunir todos os detalhes necessários, você pode inscrever-se aqui para se tornar uma fonte de mídia integrada com a Singular.
Exibir: Todos Dados do Dispositivo Parâmetros de Granularidade Comportamento dos Singular Links Parâmetros de Website Links
|
Tracking Link Parameter |
Descrição |
Dimension Name in Singular Aggregated Reports
|
Field Name in Singular User-Level Data
|
Categoria | ||
|---|---|---|---|---|---|---|
|
In Web UI
|
In API/ Data Destination Schemas
|
In Web UI (Export Logs)
|
In Data Destination Schemas | |||
| ip | IP do dispositivo no momento do clique | IP |
ip
|
Device and Other Data | ||
| cl | O ID do clique ou da transação, quando disponível | Click ID |
click_id
|
Device and Other Data | ||
| ve | A versão do sistema operacional no dispositivo do usuário. Observação: apenas valores numéricos e decimais. | OS Version |
os_version
|
Device and Other Data | ||
| idfa | O ID de publicidade do iOS do dispositivo (não criptografado/bruto) | IDFA |
idfa
|
Device and Other Data | ||
| ifa1 | O ID de publicidade do iOS do dispositivo (formato SHA-1) |
IDFA SHA1
|
idfa_sha_1
|
Device and Other Data | ||
| ifa5 | O ID de publicidade do iOS do dispositivo (formato MD5) |
IDFA MD5
|
idfa_md5
|
Device and Other Data | ||
| idfv | O Identifier for Vendor do iOS. Esse identificador é usado para todos os apps no dispositivo publicados pelo mesmo fornecedor e pode ajudar a determinar a atribuição quando o IDFA não está disponível. | IDFV |
idfv
|
Device and Other Data | ||
| ifv1 | O Identifier for Vendor do iOS (formato SHA-1) |
IDFV SHA-1
|
Device and Other Data | |||
| ifv5 | O Identifier for Vendor do iOS (formato MD5) |
IDFV MD5
|
Device and Other Data | |||
| aifa | O Android Advertising ID (AAID) do dispositivo do usuário, também conhecido como GAID | GAID |
gaid
|
Device and Other Data | ||
| aif1 | O Android Advertising ID (AAID) do dispositivo do usuário, também conhecido como GAID (formato SHA-1) | GAID SHA1 |
gaid_sha_1
|
Device and Other Data | ||
| aif5 | O Android Advertising ID (AAID) do dispositivo do usuário, também conhecido como GAID (formato MD5) | GAID MD5 |
gaid_md5
|
Device and Other Data | ||
| oaid | O Open Anonymous Device ID do dispositivo do usuário (usado na China) | OAID | Device and Other Data | |||
|
amid
|
Amazon Advertising ID |
AMID
|
Device and Other Data | |||
|
sng_ref
|
O Google Play Install Referrer. Use esse parâmetro se você tiver uma integração de link de atribuição S2S para habilitar a atribuição baseada em install referrer em dispositivos Android.
Saiba mais
|
Device and Other Data | ||||
| ua |
O user agent do dispositivo
A partir do iOS 26, a versão é anexada ao user agent. Certifique-se de que o user agent transmitido seja o user agent completo com a versão. Ex.: 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 | O nome do site/posicionamento dentro do app publisher. | Sub Publisher Name |
sub_publisher_name
|
Device and Other Data | ||
| pssid | O ID do site/posicionamento dentro do app publisher. | Sub Publisher ID |
sub_publisher_id
|
Device and Other Data | ||
|
p
|
Plataforma do dispositivo (Android/iOS) | Platform |
platform
|
Platform | platform | Granularity Parameters |
| pcn | O nome da campanha | Campaign Name | campaign_name | Campaign Name |
campaign_name
|
Granularity Parameters |
| pcid | O ID da campanha | Campaign ID | campaign_id | Campaign ID |
campaign_id
|
Granularity Parameters |
| pscn | O nome da subcampanha. A subcampanha é um detalhamento adicional abaixo do nível da campanha em algumas redes. Às vezes chamada de Ad Set ou Ad Group. | Sub Campaign Name | sub_campaign_name | Sub Campaign Name |
sub_campaign_name
|
Granularity Parameters |
| pscid | O ID da subcampanha. A subcampanha é um detalhamento adicional abaixo do nível da campanha em algumas redes. Às vezes chamada de Ad Set ou Ad Group. | Sub Campaign ID | sub_campaign_id | Sub Campaign ID |
sub_campaign_id
|
Granularity Parameters |
| pcrn | O nome do criativo (dependendo da rede, o "criativo" da Singular pode ser o mesmo que o "ad" da rede, ou pode haver vários criativos para cada ad). | Creative Name |
creative_name
|
Creative Name | creative_name | Granularity Parameters |
| pcrid | O ID do criativo (dependendo da rede, o "criativo" da Singular pode ser o mesmo que o "ad" da rede, ou pode haver vários criativos para cada ad). | Creative ID |
creative_id
|
Creative ID | creative_id | Granularity Parameters |
| pshid | O ID do app no qual o anúncio foi exibido. O ID é criptografado (hashed) ou anonimizado. | Publisher ID |
publisher_id
|
Publisher Hashed ID |
publisher_hashed_id
|
Granularity Parameters |
| psn | O nome do app no qual o anúncio foi exibido (geralmente o nome do app na app store relevante). | Publisher Site Name |
publisher_site_name
|
Publisher Name |
publisher_name
|
Granularity Parameters |
| psid | O ID público do app no qual o anúncio foi exibido (geralmente o ID do app na app store relevante). | Publisher Site ID |
publisher_site_id
|
Publisher ID |
publisher_id
|
Granularity Parameters |
| kw | A palavra-chave de pesquisa (para Google Ads e Apple Search Ads) | Keyword |
keyword
|
Keyword | Granularity Parameters | |
| paffn | O nome do afiliado (para redes de afiliados que o reportam) | Affiliate Name |
affiliate_name
|
Affiliate Name |
affiliate_name
|
Granularity Parameters |
| paffid | O ID do afiliado (para redes de afiliados que o reportam) | Affiliate ID |
affiliate_id
|
Affiliate ID | affiliate_id | Granularity Parameters |
| _dl | Deep link para todas as plataformas móveis. Observação: A substituição/uso desse parâmetro de query só é possível se o link original tiver sido habilitado com deep linking. Observe que a codificação de URL (URL encode) é obrigatória para esse parâmetro | Singular Links Redirect Behavior | ||||
| _ddl | Deferred deep link para todas as plataformas móveis. Observação: _ddl pode habilitar o deferred deep linking mesmo que ele não tenha sido habilitado por meio da UI durante a criação. Observe que a codificação de URL (URL encode) é obrigatória para esse parâmetro | Singular Links Redirect Behavior | ||||
| _global_redirect |
Redirecionamento para todas as plataformas, mesmo no caso de o usuário ter o app instalado.
**Quando usado no mesmo link com outros parâmetros de substituição de destino (por exemplo, _fallback_redirect), o valor de _global_redirect definirá o destino do redirecionamento. Observe que a codificação de URL (URL encode) é obrigatória para esse parâmetro |
Singular Links Redirect Behavior | ||||
| _fallback_redirect | Redirecionamento de fallback para plataformas que não sejam Android e iOS (geralmente usado para Web). Observe que a codificação de URL (URL encode) é obrigatória para esse parâmetro | Singular Links Redirect Behavior | ||||
| _android_redirect | Redirecionamento no Android: URL de redirecionamento se o app não estiver instalado no Android. Geralmente é a URL da app store. Observe que a codificação de URL (URL encode) é obrigatória para esse parâmetro | Singular Links Redirect Behavior | ||||
| _samsung_redirect | Redirecionamento Android para dispositivos Samsung: URL de redirecionamento se o app não estiver instalado em dispositivos Samsung. Valores da app store da Samsung são suportados ( samsungapps://ProductDetail/com.game.app ). Observe que o deep linking com essa opção de redirecionamento não é suportado atualmente. Observe que a codificação de URL (URL encode) é obrigatória para esse parâmetro | Singular Links Redirect Behavior | ||||
| _android_dl | Deep Link (Android): Geralmente usado se a URL de deep link no Android for diferente da do seu app iOS. Observe que a codificação de URL (URL encode) é obrigatória para esse parâmetro | Singular Links Redirect Behavior | ||||
| _android_ddl | Deferred Deep Link (Android): Geralmente usado se a URL de deep link no Android for diferente da do seu app iOS. Observação: _android_ddl pode habilitar o deferred deep linking mesmo que não tenha sido habilitado por meio da UI durante a criação. Observe que a codificação de URL (URL encode) é obrigatória para esse parâmetro | Singular Links Redirect Behavior | ||||
| _ios_redirect | Redirecionamento iOS (iOS): URL de redirecionamento se o app não estiver instalado no iOS. Geralmente é a URL da app store. Observe que a codificação de URL (URL encode) é obrigatória para esse parâmetro | Singular Links Redirect Behavior | ||||
| _ios_dl | Deep Link (iOS): Geralmente usado se a URL de deep link no iOS for diferente da do seu app Android. Observação: A substituição/uso desse parâmetro de query só é possível se o link original tiver sido habilitado com deep linking no iOS. Observe que a codificação de URL (URL encode) é obrigatória para esse parâmetro | Singular Links Redirect Behavior | ||||
| _ios_ddl | Deferred Deep Link (iOS): Geralmente usado se a URL de deep link no iOS for diferente da do seu app Android. Observação: _ios_ddl pode habilitar o deferred deep linking mesmo que não tenha sido habilitado por meio da UI durante a criação. Observe que a codificação de URL (URL encode) é obrigatória para esse parâmetro | Singular Links Redirect Behavior | ||||
| _p | O parâmetro passthrough é usado na configuração de Deep Links e Deferred Deep Links. Eles podem ser personalizados para transmitir informações como códigos promocionais ou nomes de afiliados/influenciadores. Observe que a codificação de URL (URL encode) é obrigatória para esse parâmetro | Passthrough | passthrough | Singular Links Redirect Behavior | ||
| _force_redirect=1 | Forçar Redirecionamento: Em casos em que os Universal Links do iOS podem não fazer o deep link , anexar &_force_redirect=1 (ou &_force_redirect=true) permitirá que o Singular Link use o deep linking baseado em app scheme para forçar o deep link ao usuário final. Leia mais em Tratamento de redirecionamentos dinâmicos dos Singular Links | Singular Links Redirect Behavior | ||||
| redirect=false | Esse parâmetro deve ser usado se o parceiro desejar redirecionar seus usuários para a loja de forma independente. Clicar em um link com &redirect=false não levará à loja. | Singular Links Redirect Behavior | ||||
| _forward_params=1 |
Opções de encaminhamento de parâmetros:
|
Singular Links Redirect Behavior | ||||
| _og_title |
Substitui o título OG (headline) exibido quando o link é compartilhado em plataformas sociais.
Codificação de URL (URL encoding) obrigatória. Apenas para links de Custom Source. |
Singular Links Redirect Behavior | ||||
| _og_desc |
Substitui a descrição OG exibida quando o link é compartilhado em plataformas sociais.
Codificação de URL (URL encoding) obrigatória. Apenas para links de Custom Source. |
Singular Links Redirect Behavior | ||||
| _og_image |
Substitui a imagem OG exibida quando o link é compartilhado em plataformas sociais.
Deve ser uma URL de imagem publicamente acessível. Codificação de URL (URL encoding) obrigatória. Apenas para links de Custom Source. |
Singular Links Redirect Behavior | ||||
| force_ios_landing_page | Força uma landing page social para links do iOS. Funciona independentemente do flag "Enable Landing Page" em Manage Links. | Singular Links Redirect Behavior | ||||
| force_android_landing_page | Força uma landing page social para links do Android em apps compatíveis da Meta (Facebook, Facebook Messenger, Facebook Messenger Lite, Instagram). Funciona independentemente do flag "Enable Landing Page" em Manage Links. | Singular Links Redirect Behavior | ||||
|
an
|
Parceiro de rede de anúncios | Website Links Parameters | ||||
|
utm_campaign
|
O valor do parâmetro utm_campaign da URL da landing page da web. * O valor será usado como Campaign Name se você usar a Atribuição Web da Singular e não implementar o parâmetro "wpcn". | UTM Campaign* | UTM Campaign | utm_campaign | Website Links Parameters | |
|
utm_medium
|
O valor do parâmetro utm_medium da URL da landing page da web | UTM Medium | UTM Medium | utm_medium | Website Links Parameters | |
|
utm_source
|
O valor do parâmetro utm_source da URL da landing page da web. ** O valor será usado como Source se você usar a Atribuição Web da Singular e não implementar o parâmetro "wpsrc". | UTM Source** | UTM Source | utm_source | Website Links Parameters | |
| utm_term | O valor do parâmetro utm_term da URL da landing page da web | UTM Term | UTM Term | utm_term | Website Links Parameters | |
| utm_content | O valor do parâmetro utm_content da URL da landing page da web | UTM Content | UTM Content | utm_content | Website Links Parameters | |
|
wpcid
|
O ID da campanha | Campaign ID | campaign_id | Campaign ID | campaign_id | Website Links Parameters |
|
wpcn
|
O nome da campanha | Campaign Name | campaign_name | Campaign Name | campaign_name | Website Links Parameters |
|
wpcrid
|
O ID do criativo (dependendo da rede, o "criativo" da Singular pode ser o mesmo que o "ad" da rede, ou pode haver vários criativos para cada ad). | Creative ID | creative_id | Creative ID | creative_id | Website Links Parameters |
|
wpcrn
|
O nome do criativo (dependendo da rede, o "criativo" da Singular pode ser o mesmo que o "ad" da rede, ou pode haver vários criativos para cada ad). | Creative Name | creative_name | Creative Name | creative_name | Website Links Parameters |
|
wpkmatch
|
Match Type | Website Links Parameters | ||||
|
wpkwid
|
Target ID | Website Links Parameters | ||||
|
wpkwn
|
Palavra-chave de pesquisa | Keyword | keyword | Keyword | Website Links Parameters | |
|
wpscid
|
O ID da subcampanha. A subcampanha é um detalhamento adicional abaixo do nível da campanha em algumas redes. Às vezes chamada de Ad Set ou Ad Group. | Sub Campaign ID | sub_campaign_id | Sub Campaign ID | sub_campaign_id | Website Links Parameters |
|
wpscn
|
O nome da subcampanha. A subcampanha é um detalhamento adicional abaixo do nível da campanha em algumas redes. Às vezes chamada de Ad Set ou Ad Group. | Sub Campaign Name | sub_campaign_name | Sub Campaign Name | sub_campaign_name | Website Links Parameters |
| wpsn | O nome do site/posicionamento dentro do app publisher. | Publisher Site Name | publisher_site_name | Publisher Name | publisher_name | Website Links Parameters |
|
wpsrc
|
Rede | Source | source | Partner | source | Website Links Parameters |
Desabilitando substituições de parâmetros para links curtos (short links)
Por padrão, você pode anexar parâmetros de redirecionamento e deeplink a um Singular Link (como _dl , _fallback_redirect , _ios_redirect , etc.) no momento do clique para substituir dinamicamente as configurações salvas do link. Isso é útil quando você precisa servir destinos de redirecionamento diferentes a partir do mesmo link base.
No entanto, em alguns fluxos de trabalho — por exemplo, quando muitos membros da equipe compartilham links internamente — você pode querer impedir a substituição e a reutilização do link.
O recurso Disable short link parameters overrides permite bloquear um link personalizado encurtado para que os parâmetros já definidos no link base não possam ser substituídos por meio do acréscimo à URL. Parâmetros não definidos no link base ainda podem ser anexados como novos valores.
Como funciona
| Configuração | Comportamento |
|---|---|
| Caixa de seleção desmarcada (padrão) | Os parâmetros anexados ao link curto são respeitados — o link se comporta da mesma forma que um Singular Link padrão. |
| Caixa de seleção marcada |
Os parâmetros
já definidos
no link base são bloqueados e não podem ser substituídos ao serem anexados ao link curto. Os parâmetros
não definidos
no link base — incluindo parâmetros de granularidade como
pcn
,
pcid
,
pcrn
e parâmetros de passthrough como
_p
— ainda podem ser anexados como novos valores.
|
Os seguintes parâmetros de redirecionamento e deeplink são especificamente protegidos contra substituição quando estão definidos no link base:
_dl
,
_android_dl
,
_ios_dl
,
_ddl
,
_android_redirect
,
_android_ddl
,
_ios_redirect
,
_ios_ddl
,
_fallback_redirect
Qualquer outro parâmetro já definido no link base também é protegido.
Como habilitar (UI)
- Acesse Links → Manage Links na plataforma Singular.
- Localize o seu link personalizado e clique para editá-lo (ou crie um novo).
- Se você não vir o toggle Disable short link parameters overrides , tente primeiro ativar o toggle Shorten Link .
- Ative o toggle Disable short link parameters overrides .
- Salve o link.
Como habilitar (API)
Essa configuração também é suportada ao criar ou atualizar um link por meio da
Singular Links API
. Passe o parâmetro booleano opcional
disable_short_link_parameters_overrides
no corpo da sua requisição:
- false (padrão) — os parâmetros no link base podem ser substituídos ao serem anexados ao link curto.
- true — os parâmetros já definidos no link base são bloqueados e não podem ser substituídos.
Se você usar a
Dynamic Short Links API
, qualquer link curto gerado herdará automaticamente o valor de
disable_short_link_parameters_overrides
do seu Singular Link base. Nenhuma configuração adicional é necessária.
Limitações
- Esse recurso está disponível apenas para links personalizados (source) somente . Ele não está disponível para links de parceiros.
- Essa é uma configuração por link . Para controle em nível de conta sobre quais destinos de redirecionamento são permitidos em todos os links, consulte Limitando destinos de substituição .
Codificação de URL obrigatória para Deep Links dinâmicos e redirecionamentos para lojas de terceiros
A codificação de URL (URL encoding) é
obrigatória
para todos os parâmetros de deep link dinâmico e parâmetros de redirecionamento para lojas de terceiros (por exemplo,
_samsung_redirect
ou
_android_dl
).
Observamos vários casos em que clientes ou parceiros anexam links da Singular sem codificar (URL-encode) os valores dos parâmetros de query, resultando em links que não resolvem corretamente ou que inesperadamente caem para a Play Store.
Para garantir um comportamento consistente e confiável em todos os dispositivos e navegadores, sempre use valores codificados (URL-encoded). A codificação correta:
- Garante a resolução correta de deep links dinâmicos
- Habilita redirecionamentos confiáveis para lojas de terceiros
- Evita comportamento de fallback não intencional (como redirecionamentos para a Play Store)
Exemplo
Correto (URL-encoded):
&_samsung_redirect=samsungapps%3A%2F%2FProductDetail%2Fnet.singular.deviceassist2Incorreto (não codificado):
&_samsung_redirect=samsungapps://ProductDetail/net.singular.deviceassist2Observação: Sempre codifique (URL-encode) os valores dos parâmetros de query antes de anexá-los aos links da Singular.