Parâmetros e estrutura do link de atribuição

Para:
Profissionais de marketing Agências Ad Networks
Última atualização:

Visão geral: conheça a estrutura e os parâmetros do link de atribuição da AppsFlyer.

Visão geral

Links de atribuição permitem que os anunciantes coletem dados sobre o engajamento do usuário com um anúncio. Os links de atribuição são colocados atrás dos anúncios e notificam a AppsFlyer quando os usuários se engajam com um anúncio. O engajamento pode ocorrer através de um clique em um anúncio ou quando um usuário vê uma impressão do anúncio. Uma cópia da URL de atribuição é enviada à AppsFlyer.

Os links de atribuição são gerados usando OneLink ou um link de plataforma única.

  OneLink (link multiplataforma) Link de plataforma única

Descrição e quando usar

Use quando:

  • Você deseja um único link para todas as plataformas.
  • São necessárias capacidades de deep linking.
  • Você quer usar os App Links do Android ou os Universal Links do iOS para abrir o aplicativo.

Saiba mais sobre o OneLink

Use quando:

  • Você só utiliza uma única plataforma. Por exemplo, o Android e não o iOS.
  • Você só usa esquemas de URI para abrir o aplicativo.

Saiba mais sobre como estabelecer um parceiro integrado

Pré-requisitos

Template do OneLink

 Nenhum

Informações obrigatórias

URL base

{subdomain}.onelink.me

app.appsflyer.com

Identificador único

ID do template

app_id
Estrutura do URL https://{subdomain}.onelink.me/
{templateid}&pid{media_source}
&af_siteid={ApplicationID}
&c={CampaignName}

https://app.appsflyer.com/{app_id}?pid={media_source}&af_siteid={ApplicationID}&c={CampaignName}
Exemplo https://suamarca.onelink.me/aAB1?pid=greatnetwork_int
&c=GreatCampaign&af_siteid=A1b1		 https://app.appsflyer.com/com.greatapp?pid=greatnetwork_int&
c=GreatCampaign&af_siteid=A1b1

Parâmetros de link de atribuição

  • Os parâmetros listados estão disponíveis para uso no link de atribuição.
  • O número na coluna Tipo de campo é o limite de caracteres do valor do parâmetro. Saiba mais sobre as limitações no comprimento dos valores de parâmetros aqui.

Parâmetros do link de atribuição—UA e retargeting

As listas de audiências podem ser baixadas como um arquivo .csv.

Parâmetro Nome de exibição no Raw Data Descrição

Tipo e comprimento do campo
pid Fonte de mídia Identifica exclusivamente um parceiro integrado da AppsFlyer. Não altere-o. Mais detalhes.

String 150
c Campanha Fornecido pelo anunciante ou pelo editor. Consulte os limites de nomes de campanha.

Sequência de caracteres 100

af_prt

parceira
  • Nome de conta da agência permite a atribuição de novas instalações à agência
  • Atenção: não use esse parâmetro antes de garantir que as Permissões da agência estejam ativadas

Sequência de caracteres 50

af_mp

 N/D
  • Ative o envio de postbacks para parceiros de marketing do editor por instalação.
  • Observação: atualmente, esse parâmetro é relevante apenas para parceiros de marketing do Pinterest.

 

clickid

N/D

Identificador de clique único da ad network

 

af_siteid

Site ID
  • ID exclusivo que identifica o publisher que exibe o anúncio. Saiba mais

Sequência de caracteres 24

af_sub_siteid

ID do sub-site
  • ID da sub-rede de anúncios/publisher. 
  • Se, além do publisher principal (ID do site), houver um sub-publisher, ou você desejar incluir informações adicionais, como tipo de anúncio/posicionamento dentro do aplicativo, como banner, intersticial, vídeo etc, use af_sub_siteid. Por exemplo: af_sub_siteid =ABCD_4567

Sequência de caracteres 50

af_c_id

ID da campanha

Fornecido pelo anunciante/editor

Sequência de caracteres 24

af_adset

Conjunto de anúncios
  • Fornecido pelo anunciante/editor.
  • Conjunto de anúncios é um nível intermediário na hierarquia entre Campanha e Anúncio. Ver mais

Sequência de caracteres 100

af_adset_id

ID do conjunto de anúncios

Fornecido pelo anunciante/editor

Sequência de caracteres 24

af_ad

Anúncio

Nome do anúncio (ver mais) - fornecido pelo anunciante/editor

Sequência de caracteres 100

af_ad_id

 ID do anúncio Fornecido pelo anunciante/editor

Sequência de caracteres 24

af_ad_type

Tipo de anúncio

 Use a seguinte convenção de nomenclatura:

  • text: uma unidade de anúncios contendo apenas texto, por exemplo, um resultado de pesquisa
  • banner: um formato básico que aparece na parte superior ou inferior da tela do dispositivo
  • interstitial: um anúncio de página inteira que aparece durante pausas na experiência vigente
  • video: um vídeo padrão, ou seja, não recompensado
  • rewarded_video: uma unidade de anúncio que oferece recompensas no aplicativo em troca de assistir a um vídeo
  • playable: uma unidade de anúncio que contém uma visualização interativa da experiência do aplicativo
  • sponsored_content: um link incluído em um pedaço de conteúdo patrocinado, como um artigo publicitário
  • audio: um anúncio em áudio

Sequência de caracteres 24

af_click_lookback

Janela de lookback de atribuição
  • Janela de lookback para atribuição de clique.  A duração da janela é o CTIT (tempo entre o clique e a instalação) máximo para o usuário novo ser atribuído à fonte que exibe o anúncio/link.
  • Número de dias configurável do período de lookback para atribuição do clique. Valores disponíveis do parâmetro: 1d - 30d (dias) ou 1h - 23h (horas). O valor padrão é 7d. 
  • A janela de lookback pode ser personalizada para OneLinks e SRNs.

Observação: Afeta apenas URLs de clique e não URLs de impressão.

Máximo de 3 caracteres

af_viewthrough_
lookback

N/D
  • Número configurável de horas para o período de atribuição da vista de retrospectiva. Valores de parâmetros disponíveis: 1h a 24h (horas). O padrão é 24h.
  • A janela de lookback pode ser personalizada para SRNs.

Observação: Afeta apenas URLs de impressão e não URLs de clique.

Máximo de 3 caracteres

af_channel

Canal

O canal da fonte de mídia através do qual os anúncios são distribuídos, por exemplo: UAC_Search, UAC_Display, Instagram, Meta Audience Network, etc.

Enumeração dinâmica Sequência de caracteres 20

af_keywords

Palavras-chave

Lista de palavras-chave para campanhas que usam texto para target.

Sequência de caracteres 100

af_cost_model

Modelo de custo

Sequência de caracteres 20

af_cost_currency

Moeda do custo
  • Código da moeda com 3 letras compatível com a norma ISO-4217. Por exemplo: USD, ZAR, EUR
  • [Padrão]: USD

Enumeração 3 caracteres 

af_cost_value

Valor de custo
  • Valor de custo na moeda do custo de uso.
  • Até 4 dígitos após o ponto decimal.
  • Definir SOMENTE dígitos numéricos (use um ponto decimal se necessário). Exemplo: "56", "2.85 "

Sequência de caracteres 20

af_sub[n] 

(n=1-5) exemplo: af_sub1

Sub param [n]

Parâmetro personalizado opcional definido pelo anunciante. Para obter mais informações sobre o uso desses parâmetros, verifique a seção perguntas frequentes.

Sequência de caracteres 100
af_r N/D

Usado em links de plataforma única para redirecionar os usuários para a URL especificada para ambas as plataformas (Android e iOS).

  • Substitui os seguintes parâmetros no nível do template:
    • android_custom_url
    • ios_custom_url
  
af_web_dp N/D

URL para redirecionar usuários de desktop (por exemplo, Windows ou Mac) para uma página da web diferente da configurada no template do OneLink. Use isso para manter dados de atribuição de usuários de desktop em outras plataformas (por exemplo, Google Analytics ou Omniture)

Observação: se você tiver uma lista de permissões de redirecionamento ativa, verifique se o domínio desse URL está na lista.

  
af_dp N/D O valor de fallback do esquema URI para iniciar o aplicativo, a ser usado se o método Universal Link ou Android App Link falham, e para usuários de Android de versões anteriores à 6.0. Ele só deve apontar para o caminho base, ou seja, a atividade padrão.  
af_force_deeplink N/D Forçar links diretos para a atividade especificada no valor af_dp  
af_ref N/D
Redes de anúncios que trabalham com cliques S2S são capazes de enviar um valor referenciador único, usando o seguinte parâmetro: &af_ref=ReferrerValue
O valor de af_ref deve consistir em um único valor, estruturado da seguinte forma:
NetworkName_UniqueClickValueForEachClick
Exemplo: af_ref=networkname_123456789ABCDEF
 
O nome da rede pode ser qualquer string válida. Pode ser networkname_int ou somente networkname.
 
A AppsFlyer pode usar esse parâmetro para atribuição em dispositivos Android. A AppsFlyer não usa esse parâmetro para atribuição em dispositivos iOS ou Windows.
  
is_incentivized N/D
Booleano: verdadeiro/falso
Campanhas incentivadas ou não-incentivadas
  
af_param_forwarding N/D
  • Quando configurados como falsos, os parâmetros que estão no link de atribuição não são encaminhados para a página redirecionada
  • Use isso para uma URL de aparência mais limpa na página redirecionada, ou se os parâmetros de link de atribuição puderem causar problemas devido ao tratamento de parâmetros de consulta na página redirecionada
  
af_base_params_forward N/D
  • Quando definidos como falso, os parâmetros PID e C da AppsFlyer que estão no link de atribuição não são encaminhados para a página redirecionada.
  • Use isso se o URL for clicado em um desktop e você quiser que os parâmetros essenciais do CRM permaneçam, mas os parâmetros PID e C da AppsFlyer sejam removidos. Isso evitará ter vários PIDs no URL.
  
af_partner_account_id ID da conta da rede ID da conta do anunciante com o parceiro Sequência de caracteres 100
Redirecionar N/D Quando &redirect=false, esse parâmetro permite que a AppsFlyer saiba que esse é um clique S2S e que o parceiro é responsável por redirecionar o usuário que clicou.  
af_ua Agente de usuário 

Relevante para ad networks que enviam cliques e impressões de servidor para servidor.

A string de user-agent é enviada como:

  1. Parâmetro de URL (URL codificado)
  2. Header de solicitação HTTP (não codificado)

O User-Agent deve ser idêntico no parâmetro de URL e no header HTTP.

Observação: no Android, o user-agent às vezes é reduzido a Client Hints. Deve ser enviado independentemente.

  • Exemplo de user-agent completo: Mozilla/5.0 (Linux; Android 12; Pixel 5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.16 Mobile Safari/537.36
  • Exemplo de user-agent reduzido: Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.0.0 Mobile Safari/537.36
 
af_ip IP

Relevante para ad networks que enviam cliques e impressões de servidor para servidor.

Endereço de IP do dispositivo

Recomendado: se disponível, forneça o IP do dispositivo no parâmetro af_ip.

Próxima opção: se disponível, a AppsFlyer usará o IP em X-Forwarded-For.

  
[Descontinuado] af_os Versão OS

[Somente para iOS] A versão do sistema operacional do dispositivo.

Esse parâmetro está obsoleto, mas ainda é compatível com a AppsFlyer. Recomendado: em vez disso, use o parâmetro af_os_version. 

  
af_os_version Versão OS
  • Relevante para ad networks que enviam cliques e impressões de servidor para servidor.
  • A versão do sistema operacional do dispositivo.
    • Android:
      • Exemplo: 12
      • Para user-agent reduzido (devido a navegadores executados em desktop ou Android e usando o mecanismo Chrome 110+), a ad network deve usar a API Client Hints para obter esse valor.
      • Para o user-agent que não é reduzido, use o seguinte regex para extrair a versão do sistema operacional Android da string do user-agent: (\d+(?:\.\d+)*);(?:\s..-..;)?\s(.+?(?=\)|\s\w*\/)).
    • iOS:
      • Exemplo: 16.2
  
af_model Modelo do dispositivo
  • Relevante para ad networks que enviam cliques e impressões de servidor para servidor.
  • O modelo do dispositivo.
    •  Android:
      • Exemplo: Pixel 5
      • Para user-agent reduzido (devido a navegadores executados em desktop ou Android e usando o mecanismo Chrome 110+), a ad network deve usar a API Client Hints para obter esse valor.
      • Para o user-agent que não é reduzido, use o seguinte regex para extrair o modelo Android da string do user-agent: (\d+(?:\.\d+)*);(?:\s..-..;)?\s(.+?(?=\)|\s\w*\/)).
    • iOS:
      • iphone ou ipad (tudo em letras minúsculas)
  
af_media_type Tipo de mídia

Posição do anúncio que transporta o link da seguinte forma:

  • app: o link está disponível através de um aplicativo
  • web: o link está disponível em um site mobile
  
deep_link_sub1-10 N/D

Valores adicionais de deep link. Os desenvolvedores implementam o comportamento desejado dos valores no código.

  
deep_link_value N/D

A nomenclatura para o conteúdo específico em formato de arquivo que será direcionado aos usuários. Os desenvolvedores implementam o comportamento desejado do deep_link_value no código. 

  
af_og_title N/D

Quando um link é postado na mídia social, o título do gráfico aberto (OG) irá gerar uma visualização do título.

 Sequência 40
af_og_description N/D

Quando um link é postado na mídia social, a descrição do gráfico aberto (OG) irá gerar uma visualização da descrição.

 Sequência 300
af_og_image N/D

Quando um link é postado na mídia social, o título do gráfico aberto (OG) irá gerar uma visualização do título.

  

Parâmetros do link de atribuição—apenas retargeting

Parâmetro Nome de exibição no Raw Data Descrição

Tipo e comprimento do campo

is_retargeting

 É retargeting (campanha)  A URL de clique de cada campanha de redirecionamento deve incluir & is_retargeting=true.
Se o parâmetro não for incluído ou se seu valor for "false", a campanha é considerada uma campanha normal de aquisição de usuários. 

Enumeração 5 caracteres

af_reengagement_window

Janela de reengajamento

Altere a janela de atribuição de reengajamento adicionando esse parâmetro ao link de atribuição.

As possíveis opções de intervalo de janelas são:

  • Dias: 1-90  ou Horas 1-36
  • Tempo de vida: significa que a janela de reengajamento é ilimitada. Exemplo: &af_reengagement_window=lifetime

Valor padrão: 30 dias

Exemplo - &af_reengagement_window=30d define a janela de re-engajamento em 30 dias.

N/D

Parâmetros de tipo de anúncio

Dependendo do tipo de anúncio, você também pode enviar o parâmetro de visibilidade relevante detalhando as especificações do engajamento. Segue uma lista de valores possíveis para "af_ad_type" juntamente com os parâmetros de visibilidade esperados.

Tipo de anúncio (af_ad_type)

Parâmetro Formato do valor Descrição
af_video_total_length segundos A duração total possível do vídeo
af_video_played_length segundos Quanto do vídeo foi visualizado
af_playable_played_length segundos Quanto tempo o elemento jogável foi jogado uma vez totalmente carregado
af_ad_time_viewed segundos Quanto tempo a unidade de anúncio estava visível na tela
af_ad_displayed_percent % A porcentagem máxima da unidade de anúncios que estava visível na tela do dispositivo
af_audio_total_length segundos A duração total possível do áudio
af_audio_played_length segundos Quanto do áudio foi ouvido

Parâmetros específicos do Android

Parâmetro Nome de exibição no Raw Data Descrição

Tipo de campo

advertising_id

Advertising ID

ID de publicidade do Google - requer suporte da rede de anúncios

Máximo de 40 caracteres

sha1_advertising_id

N/D

ID de publicidade do Google com hash SHA1 - requer suporte da rede de anúncios

 

md5_advertising_id

N/D

ID de publicidade do Google com hash SHA1 - requer suporte da rede de anúncios

Suportado apenas com instalações e reatribuições

android_id

Android ID

Android_id do dispositivo - requer suporte da rede de anúncios

Máximo de 20 caracteres

sha1_android_id

N/D

Android_id com hash do dispositivo SHA1 - requer suporte da rede de anúncios

 

md5_android_id

N/D

Android_id com hash do dispositivo MD5 - requer suporte da ad network

Suportado apenas com instalações e reatribuições

imei

IMEI

Device IMEI ID

 

sha1_imei

N/D

IMEI ID com hash do dispositivo SHA1 - requer suporte da ad network

 

md5_imei

N/D

IMEI ID com hash do dispositivo MD5 - requer suporte da ad network

 

oaid

OAID

Identificador de Dispositivo Anônimo Aberto

Disponível no Android SDK versão 4.10.3

sha1_oaid

N/D

Identificador de Dispositivo Anônimo Aberto com hash SHA1 - requer suporte da ad network

Disponível no Android SDK versão 4.10.3

md5_oaid

 N/D Identificador de Dispositivo Anônimo Aberto com hash MD5 - requer suporte da ad network Disponível no Android SDK versão 4.10.3

af_android_url

N/D

Redirecione os usuários do Android para uma URL diferente da página do aplicativo no Google Play. Use para app stores de terceiros.

Observação: se você tiver uma lista de permissões de redirecionamento ativa, verifique se o domínio desse URL está na lista.

 

sha1_el

N/D

Usado para atribuição de desktop para mobile — e-mail com hash SHA1. Requer suporte da rede de anúncios

 

fire_advertising_id

N/D

ID de Anúncios Amazon Fire

 

af_android_store_csl

store_product_page

Listagem de loja personalizada no Google Console.

string

Parâmetros específicos do iOS

Parâmetros Nome para exibição Descrição

idfa

IDFA

Use maiúsculas.  Requer suporte da rede de anúncios

Tipo de campo: máximo de 40 carac.

idfv

 IDFV Use maiúsculas. 

af_ios_url

  

Use-o para redirecionamentos de landing page, redirecionando usuários do iOS (iPhone or iPad) para uma URL diferente da página do aplicativo no iTunes

Observação: se você tiver uma lista de permissões de redirecionamento ativa, verifique se o domínio desse URL está na lista.
af_ios_store_cpp store_product_page

ID da página do produto personalizada (ppid)

af_ios_fallback [descontinuado]

 N/D

Descontinuado: os usuários são redirecionados com base no fluxo do esquema URI do iOS. 

sha1_idfa

N/D

IDFA com hashing SHA1. Requer suporte da rede de anúncios

sha1_idfv

N/D

IDFV com hashing SHA1

mac

N/D

Endereço mac do dispositivo Requer suporte da rede de anúncios

md5_idfv

N/D

IDFV com hashing MD5

sha1_mac

N/D

Endereço mac do dispositivo com hash SHA1. Requer suporte da rede de anúncios

 Exemplo

https://app.appsflyer.com/{app_id}/?pid=airpush_int&c=RedBanner&
	  af_siteid={publisher_id}&af_sub1=1.5&af_sub2=USD&af_sub3=burst_campaign

Todos os parâmetros estão disponíveis no Relatório de instalação e em Análises, Relatórios e APIs.

Parâmetros personalizados

Além dos parâmetros padrão específicos do Android e iOS, você também pode especificar parâmetros personalizados. Esses parâmetros personalizados podem ser úteis se você desejar personalizar a experiência e o conteúdo do usuário de acordo com o link de atribuição que leva à instalação.

Você pode adicionar qualquer outro parâmetro personalizado ao link de atribuição no formato parameter=value. Por exemplo:

https://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&af_adset=coats&af_ad=cashmere&my_custom_param=my_custom_value

Duas coisas importantes que você deve saber sobre parâmetros personalizados:

Parâmetro de ID de Parceiros (PID)

Entre todos os parâmetros de link de atribuição disponíveis, o PID é obrigatório. O PID é o identificador exclusivo da fonte de mídia alocada pela AppsFlyer.

Cada parceiro integrado tem seu próprio valor PID exclusivo. O PID termina com o sufixo _int. Ao utilizar links do OneLink você pode configurar o PID para qualquer valor que preferir, desde que não seja reservado por um parceiro integrado. Para evitar conflito, não use o sufixo _int. 

Exemplos de IDs de editores integrados importantes: orgânico, googleadwords_int (Google AdWords), anúncios do Meta, Twitter. Você pode usar qualquer nome para fontes não integradas como e-mail, SMS ou pombos-correio.

Evite problemas comuns de PID:

  • Sempre inclua o PID nos seus links de atribuição. Sem o PID no link de atribuição, o usuário é automaticamente atribuído a uma fonte de mídia "None" (Nenhuma) e a fonte de instalação original desaparece.
  • Para fontes personalizadas, use PIDs de parceiros não integrados. Para cada fonte integrada, use somente o PID designado para a atribuição correta de suas instalações. Para qualquer fonte de mídia personalizada, como e-mail, SMS ou até mesmo postagens não pagas virais no Facebook, use outros valores de PID não-integrados.
  • Use apenas caracteres legais. Se o parâmetro PID no link de atribuição contiver um dos seguintes caracteres /<>*&?\
    • O clique ou instalação aparece no painel em af_invalid_param
    • Links de atribuição não serão atribuídos
    • Os recursos de deep links não funcionarão em cliques

 Dica

Evite usar espaços em branco no valor do PID ou certifique-se de que o URL codifique seus links de atribuição antes de usá-los.

Parâmetro de ID do site

O ID do site é o identificador exclusivo do editor que veicula o anúncio. Em outras palavras, o site ou aplicativo que exibe o anúncio. As ad networks alocam IDs de site exclusivos para cada editor. 

Essa ID está incluída no parâmetro af_siteid passado para a AppsFlyer no link de atribuição e é disponibilizada por meio de vários painéis, opções de relatórios e postbacks. 

O ID do site deve ser transmitido para a AppsFlyer no link de atribuição porque:

  • Fornece clareza e transparência sobre o editor.
  • É usado pela AppsFlyer para identificar e eliminar publishers fraudulentos e outros clusters de tráfego.

O parâmetro de ID do site inclui apenas o ID do publisher que exibe o anúncio.

Para incluir informações adicionais, como tipo de anúncio, posicionamento ou ambos no aplicativo, por exemplo, banner, intersticial ou vídeo, use o parâmetro ID do subsite.

 Exemplo

O link de atribuição a seguir inclui:

  • af_siteid (ID do site): ID do publisher
  • af_sub_siteid (ID do sub-site): informações adicionais de ID (neste caso, uma fonte afiliada e posicionamento do tipo de anúncio)
https://app.appsflyer.com/com.yourapp?pid=mediaName_int&clickid={clickid}&advertising_id={gaid}&af_siteid=1234&af_sub_siteid=ABCD_4567

No exemplo de link:

  • 1234 = ID do publicador
  • ABCD = fonte afiliada (sub-publisher) com a qual o publisher está trabalhando
  • 4567 = posicionamento do tipo de anúncio no aplicativo, como banner, intersticial ou vídeo

FAQ: por que o tráfego resulta em muitas instalações bloqueadas?

As instalações bloqueadas podem ocorrer pois:

  • ID do site ausente: o parâmetro af_siteid está vazio na URL do clique. Os engajamentos enviados com um ID de site vazio significam um problema técnico ou uma tentativa intencional de ignorar mecanismos de detecção de fraudes.
  • Vários IDs de site: o mesmo publisher é enviado em várias URLs de cliques, usando IDs de site diferentes. Isso é considerado um comportamento fraudulento que mascara a atividade real do publisher e frequentemente está associado à prática de flooding de cliques.
  • ID do site incorretamente formatada: enviar o formato errado, combinado com outras indicações de fraude, pode resultar no bloqueio não apenas do publisher em questão, mas também de um nível de cluster mais alto, que pode afetar maiores volumes da atividade do parceiro.

Para evitar instalações bloqueadas, certifique-se de enviar um único parâmetro de ID do site por publisher, como mostramos no exemplo.

Níveis de granularidade de dados

Você pode usar até quatro parâmetros de URL para alcançar um nível mais profundo de análise sobre a performance de seus anúncios.

O uso dos quatro parâmetros em todos os seus links de atribuição ativos permite que você:

  • Atribua todas as instalações e eventos de usuários a anúncios específicos
  • Faça uma busca detalhada e compare a performance de todos os seus anúncios por conjunto de anúncios, por campanha e por fonte de mídia nos relatórios agregados para otimizar todos os níveis
  • Compare todos os seus anúncios em todas as fontes de mídia na tabela dinâmica e relatórios de dados brutos

Os parâmetros são:

  • Fonte de mídia (pid=)
  • nome da campanha (c=) 
  • Conjunto de anúncios (af_adset=)
  • Nome do anúncio (af_ad=) 

 Exemplo

Os seguintes links de atribuição usam quatro níveis de granularidade para gravar o anúncio de "cashmere" no conjunto de anúncios de "coats" na campanha "winter" que é executada na fonte de mídia integrada "networkx".


https://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter&
af_adset=coats&af_ad=cashmere

Características e limitações

Característica Observações
Caracteres especiais

Os seguintes caracteres especiais não são permitidos em parâmetros ou valores: ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ', >, <, /, {, }, %
Limite de caracteres de URL

O comprimento total do URL não deve exceder 2.000 caracteres 
Redirecionamento de deep links do Facebook

Devido às recentes mudanças na lógica de redirecionamento do Facebook, os usuários do Facebook v420+ WebView do Android agora serão redirecionados para a Play Store em vez do aplicativo instalado anteriormente. 

FAQ

Devo usar letras minúsculas ou maiúsculas nos parâmetros?

Você pode usar tanto letras minúsculas quanto maiúsculas, mas é preciso ser consistente. Se você definir um parâmetro personalizado com caracteres maiúsculos ou minúsculos, use sempre esse parâmetro.

Por exemplo, se você definir pid=MyMediaSource, certifique-se de sempre usá-lo. Se você usar pid=MyMediaSource em um link de atribuição e pid=mymediasource em outro, podem ocorrer discrepâncias nos dados. O mesmo vale para quaisquer outros parâmetros que você definiu no link de atribuição.

O link de atribuição da AppsFlyer é dinâmico ou estático?

Os links de atribuição podem ser tanto dinâmicos como estáticos.
Como saber se um link é dinâmico ou estático?
Se o link de atribuição tiver parâmetros, ele é um link de atribuição longo e predefinido e, portanto, é estático.
Apenas URLs curtas (por exemplo, suamarca.onelink.me/HaT8/r5c2B371), usadas para links de atribuição personalizados, são dinâmicas.
Isso significa que, uma vez que você começa a usar um link de atribuição para um parceiro integrado ou uma URL longa para mídias próprias, ela não se altera para nenhum lead que se engaje com ela, mesmo que você altere os valores do link de atribuição no dashboard da AppsFlyer. Para que a alteração ocorra, você deve usar a nova URL longa a partir de então.
Por outro lado, URLs curtas para mídias próprias não contêm parâmetros diretamente. Quando um lead se engaja com uma URL curta da AppsFlyer, ele é redirecionado para a AppsFlyer e os parâmetros definidos atualmente ocorrem dinamicamente.

O que é essa mensagem de erro da Play Store?

Se alguma vez encontrar a seguinte mensagem de erro na Play Store depois de seguir um link de atribuição:

TL_error_message.png

Isso ocorre porque o link de atribuição inclui um caractere #. Por exemplo: 
https://app.appsflyer.com/com.travelco?pid=globalwide_int&clickid=#reqid#

Geralmente, esses caracteres estão no link porque são macros e são substituídos dinamicamente por um valor, então não é um problema muito grande e você pode ignorar a mensagem.  

Para que servem os parâmetros de assinante?

Os parâmetros do assinante, ou seja, af_sub1, af_sub2, ..., af_sub_5 podem ser usados para registrar quaisquer KPIs úteis. Esses parâmetros são analisados e aparecem no relatório de dados brutos, o que os torna muito úteis para realizar a agregação ou filtragem de dados.

 Exemplo

O Luber, um aplicativo hail ride, tem criativos com modelos de três cores: azul, amarelo e vermelho. Linda, profissional de marketing mobile da Luber, deseja testar qual modelo de cor traz mais instalações. Para isso, ela acrescenta &af_sub3=blue nos links de atribuição de todos os anúncios azuis em TODAS as fontes de mídia não SRN. O mesmo é feito para os anúncios amarelos e vermelhos também. Com esta informação analisada e aparecendo nos relatórios de dados brutos, Linda é capaz de analisar o sucesso dos diferentes anúncios coloridos, e escolher aquele que melhor converte.

Quais são os limites para os nomes das campanhas?

  • O tamanho máximo de um nome de campanha no URL do link de atribuição é limitado a 100 caracteres. Se esse limite for excedido, o nome da campanha é alterado para: c_name_exceeded_max_length
  • O nome da campanha não deve começar ou terminar com um espaço em branco, pois isso pode causar discrepâncias nos painéis e relatórios