Sobre estrutura e parâmetros do link

Para:

Última atualização: 13 de Maio de 2025 17:22

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

Visão geral

Os 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 incorporados nos anúncios e notificam a AppsFlyer quando os usuários se engajam com um anúncio. A interação pode ocorrer ao clicar em um anúncio ou quando um usuário visualiza uma impressão de anúncio. Uma cópia da URL de atribuição é enviada para a AppsFlyer.

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

	OneLink (link multiplataforma)	Link de plataforma única
Descrição e quando utilizar	Utilizar 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 Links Universais do iOS para abrir o aplicativo. Saiba mais sobre o OneLink	Utilizar quando: Você só utiliza uma única plataforma. Por exemplo, Android e não iOS. Você só usa esquemas URI para abrir o aplicativo. Saiba mais sobre como configurar um parceiro integrado
Pré-requisitos	Template do OneLink	Nenhum
Informações obrigatórias	Canal de mídia Campanha ID do site/ID do subsite	Canal de mídia Campanha ID do site/ID do subsite
URL base	{subdomain}.onelink.me	app.appsflyer.com
Identificador único	ID do template	app_id
Estrutura da 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://yourbrand.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`

Importante!

A AppsFlyer oferece suporte apenas ao protocolo HTTPS para tráfego de engajamento de entrada, ou seja, cliques e impressões.

Parâmetros do link de atribuição

Os parâmetros listados estão disponíveis para uso no link de atribuição.
A coluna tipo de campo indica o limite de caracteres do valor do parâmetro. Saiba mais sobre as limitações de comprimento dos valores dos parâmetros aqui.

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

A tabela abaixo pode ser baixada como arquivo .

Parâmetro	Nome de exibição em dados brutos	Descrição	Tipo e comprimento do campo
pid	Canal de mídia	Identifica exclusivamente um parceiro integrado da AppsFlyer. Não altere isso. Mais detalhes.	String 150
c	Campanha	Fornecido pelo anunciante ou pelo publisher. Consulte os limites de nomes de campanha.	String 100
af_prt	Parceiro	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 de Agência estejam ativadas	String 50
af_mp	N/D	Ative o envio de postbacks para parceiros de marketing de publisher por instalação. Atenção: Atualmente, esse parâmetro é relevante apenas para Pinterest Marketing Partners.
clickid	N/D	Identificador de clique único da ad network
af_siteid	O ID do Site	ID exclusivo que identifica o publisher que exibe o anúncio. Saiba mais	String 24
af_sub_siteid	ID do Subsite	Ad sub-network/Publisher ID. 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. Exemplo: af_sub_siteid=ABCD_4567	String 50
af_c_id	ID da Campanha	Fornecido pelo anunciante/publisher.	String 24
af_adset	Adset	Fornecido pelo anunciante/publisher. Adset é um nível intermediário na hierarquia entre Campanha e Anúncio. Saiba mais	String 100
af_adset_id	Adset ID	Fornecido pelo anunciante/publisher.	String 24
af_ad	Anúncio	Nome do anúncio (saiba mais) fornecido pelo anunciante/publisher.	String 100
af_ad_id	ID do Anúncio	Fornecido pelo anunciante/publisher.	String 24
af_ad_type	Tipo de Anúncio	Usee as seguintes convenções de nomenclatura: native: Mídia paga desenvolvida para combinar com o conteúdo de uma fonte de mídia. Esse tipo de mídia é concebida para combinar com o design visual e a função de um conteúdo natural, aparecendo no seu feed de vídeos recomendados. banner: Anúncios gráficos que normalmente são pequenos e retangulares, que aparecem em vários locais de uma página da web ou interface do aplicativo. interstitial: Anúncios em tela cheia que cobrem toda a interface do aplicativo hospedeiro. Eles são colocados no meio do conteúdo e normalmente são exibidos em pontos de transição no fluxo do aplicativo, como entre atividades ou níveis de um jogo, ou durante uma pausa. rewarded_video: Anúncios que os usuários podem optar por visualizar até o final em troca de uma recompensa in-app – como assistir a um vídeo para ganhar uma vida extra, acessar um artigo ou usar o wi-fi de um aeroporto. Esses anúncios “premiados” engajam os usuários e oferecem uma melhor experiência geral no aplicativo. audio: Anúncios em formato áudio apresentados em podcasts online ou em plataformas de streaming de música. offerwall: Uma unidade de anúncio in-app usada pelos desenvolvedores para monetizar seus aplicativos. Ele funciona como uma mini-loja dentro do app, listando várias “ofertas” que os usuários podem completar em troca de uma recompensa no aplicativo.	String 24
af_ad_format	Formato do anúncio	Use as seguintes convenções de nomenclatura: text: Um anúncio em texto que geralmente aparece como um snippet curto. Pode incluir um título, uma descrição e um link ou call-to-action. Seu objetivo é gerar interesse e incentivar um clique em um site ou landing page. image: Um anúncio visual que apresenta um produto, serviço ou marca por meio de gráficos ou fotografias. Normalmente inclui uma imagem cativante junto com um texto conciso e também pode incorporar um call-to-action. video: Um anúncio digital que utiliza conteúdo audiovisual para transmitir uma mensagem de marketing. Sua duração pode variar, podendo ser exibido como pre-roll, mid-roll e post-roll em conteúdos de vídeo online ou como vídeos independentes em diferentes plataformas. playable: Um anúncio interativo que permite que os usuários se engajem com uma versão em miniatura de um jogo ou aplicativo antes do download ou de fazer uma compra. Ele oferece uma experiência prática do gameplay ou dos recursos do aplicativo. interactive: Um anúncio atraente e dinâmico que incentiva os usuários a interagir ou a participar de uma ação. Pode incluir questionários, enquetes ou outros elementos interativos para captar a atenção dos usuários e incentivar a participação ativa. dynamic_product: Um formato de anúncio personalizado que preenche dinamicamente informações e detalhes do produto com base no comportamento, preferências ou histórico de navegação do usuário. Ele permite que os anunciantes mostrem anúncios de produtos altamente relevantes e personalizados. carousel: Um formato de anúncio que consiste em vários slides ou cards em um único asset. Cada card pode incluir uma imagem, um título e uma descrição diferentes, permitindo que os anunciantes exibam vários produtos ou recursos em um único anúncio.
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 que o novo usuário seja 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 dos parâmetros disponíveis: 1d - 30d (dias) OU 1h-23h (horas). O valor padrão é 7d. A janela de lookback pode ser personalizada para OneLinks e SRNs. Atenção: Afeta apenas URLs de clique, não URLs de impressão.	3 caracteres no máximo
af_viewthrough_ lookback	N/D	Número de horas configurável para o período de atribuição por lookback view-through. Valores dos parâmetros disponíveis: 1h - 24h (horas). O valor padrão é 24h. A janela de lookback pode ser personalizada para SRNs. Atenção: Afeta apenas URLs de impressão, não URLs de clique	3 caracteres no máximo
af_canal	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. String 20
af_keywords	Palavras-chave	Lista de palavras-chave para campanhas direcionadas por texto.	String 100
af_cost_model	Modelo de custo	Modelo de custo - CPI (padrão) é atualmente o único modelo com suporte, que pode preencher o valor de custo em dados agregados da AppsFlyer nos relatórios. Sempre que possível, reporte o custo por API. Nos casos em que o custo é reportado pelo link e pela API - a API tem prioridade.	String 20
af_cost_currency	Moeda de custo	Código de moeda de três letras de acordo com o ISO-4217. Por exemplo, USD, ZAR, EUR [Padrão]: USD	Enum. 3 caracteres
af_cost_value	Valor do custo	Valor de custo utilizando a moeda de custo. Até 4 dígitos após o ponto decimal. Configure APENAS dígitos numéricos (use um ponto decimal se necessário). Exemplo: "56", "2,85"	String 20
af_sub[n] (n=1-5) exemplo: af_sub1	Subparâmetro [n]	Parâmetro personalizado e opcional configurado pelo anunciante. Para obter mais informações sobre o uso desses parâmetros, consulte a seção Características e limitações.	String 100
af_r	N/D	Usado para redirecionar usuários para a URL especificada em todas as plataformas (Android, iOS e desktop). Em links multiplataforma (OneLink), esse parâmetro: Substitui a configuração de redirecionamento a nível de template. É substituído pelos seguintes parâmetros a nível de link: `af_android_url` `af_ios_url` `af_web_dp` Atenção: Veja as características e limitações adicionais do parâmetro de redirecionamento.
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-a para manter dados de atribuição de usuários de desktop em outras plataformas (por exemplo, Google Analytics ou Omniture) Atenção: Veja as características e limitações adicionais do parâmetro de redirecionamento.
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. Atenção: Se você usar um valor de web URL para esse parâmetro (não recomendado), revise as características e limitações do parâmetro de redirecionamento.
af_force_deeplink	N/D	Force o deep linking na atividade especificada no valor af_dp
af_ref	N/D	As ad networks que trabalham com cliques S2S podem enviar um valor de referência único usando o seguinte parâmetro: &af_ref=ReferrerValue O valor de af_ref deve consistir em um único valor, estruturado da seguinte forma: NomeDaAdNetwork_ValorCliqueÚnicoParaCadaClique Exemplo: af_ref=nomedaadnetwork_123456789ABCDEF O nome da ad network pode ser qualquer string válida. Pode ser nomeadnetwork ou simplesmente nome da ad network. A AppsFlyer pode usar este 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: true/false 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 caso os parâmetros de link de atribuição causem problemas devido ao tratamento de parâmetros de consulta na página redirecionada
af_base_params_forward	N/D	Quando definidos como false, 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 a URL receber um clique no desktop e você desejar que os parâmetros essenciais do CRM permaneçam, mas que os parâmetros PID e C da AppsFlyer sejam removidos. Isso evitará que você tenha vários PIDs na URL.
af_partner_account_id	ID da conta da ad network	ID da conta do anunciante com o parceiro	String 100
redirect	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	User-agent	Relevante para ad networks que enviam cliques e impressões de servidor para servidor. A string user-agent enviada como: Parâmetro da URL (codificado em URL) Header de solicitação HTTP (não codificado) O User-Agent deve ser idêntico no parâmetro de URL e no header HTTP. Atençã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. Device IP address Recomendado: Se disponível, forneça o device IP 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 do sistema operacional	[Somente para iOS] A versão do sistema operacional do dispositivo. Esse parâmetro está obsoleto, mas ainda é compatível com a AppsFlyer. Recomendação: em vez disso, use o parâmetro af_os_version.
af_os_version	Versão do sistema operacional	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_modelo	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 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_título	N/D	Quando um link é postado nas redes sociais, o título Open Graph (OG) irá gerar uma pré-visualização do título.	String 40
af_og_description	N/D	Quando um link é postado nas redes sociais, o título Open Graph (OG) irá gerar uma pré-visualização da descrição.	String 300
af_og_imagem	N/D	Quando um link é postado nas redes sociais, o título Open Graph (OG) irá gerar uma pré-visualização da imagem.

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

Parâmetro Nome de exibição em dados brutos Descrição Tipo e comprimento do campo

is_retargeting É campanha de retargeting? 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
Duração: 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 reengajamento para 30 dias.

N/D

Parâmetros de visibilidade

Dependendo do tipo de anúncio, você também pode enviar o parâmetro de visibilidade relevante detalhando as especificações do engajamento.

Parâmetro	Formato de 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	Por quanto tempo o elemento jogável foi jogado uma vez totalmente carregado
af_ad_time_viewed	segundos	Por 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 para Android

Parâmetro	Nome de exibição em dados brutos	Descrição	Tipo de campo
advertising_id	ID de publicidade	Google Advertising ID – requer suporte da ad network	Máximo de 40 caracteres
sha1_publicidade_id	N/D	Google Advertising ID anonimizado com SHA1 - requer suporte da ad network
md5_advertising_id	N/D	Google Advertising ID anonimizado com MD5 - requer suporte da ad network	Compatível apenas com instalações e reatribuições
android_id	Android ID	Device Android_id - requer suporte da ad network	Máximo de 20 caracteres
sha1_android_id	N/D	Device Android_id anonimizado com SHA1 - requer suporte da ad network
md5_android_id	N/D	Device Android_id anonimizado com MD5 - requer suporte da ad network	Compatível apenas com instalações e reatribuições
imei	IMEI	Device IMEI ID
sha1_imei	N/D	Device IMEI ID anonimizado com SHA1 - requer suporte da ad network
md5_imei	N/D	Device IMEI ID anonimizado com MD5 - requer suporte da ad network
oaid	OAID	Open Anonymous Device Identifier	Disponível a partir da versão 4.10.3 do Android SDK
sha1_oaid	N/D	Open Anonymous Device Identifier anonimizado com SHA1 - requer suporte da ad network	Disponível a partir da versão 4.10.3 do Android SDK
md5_oaid	N/D	Open Anonymous Device Identifier anonimizado com MD5 - requer suporte da ad network	Disponível a partir da versão 4.10.3 do Android SDK
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 lojas externas. Atenção: Veja as características e limitações adicionais do parâmetro de redirecionamento.
sha1_el	N/D	Usado para atribuição de desktop para mobile — e-mail anonimizado com SHA1. Requer suporte da ad network
fire_advertising_id	N/D	Amazon Fire Advertising ID
af_android_store_csl	store_product_page	Listagem personalizada no Google Console	string

Parâmetros específicos do iOS

Parâmetros	Nome de exibição	Descrição
idfa	IDFA	Use letras maiúsculas. Requer suporte da ad network Tipo de campo: Máximo de 40 caracteres
idfv	IDFV	Use letras 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 Atenção: Veja as características e limitações adicionais do parâmetro de redirecionamento.
af_ios_store_cpp	store_product_page	Custom product page ID (ppid) Atenção: Em dados brutos e relatórios agregados, o valor do parâmetro af_ios_store_cpp (Custom product page ID) é registrado para cliques, mas não para impressões.
af_ios_fallback [desativado]	N/D	Descontinuado: os usuários são redirecionados com base no fluxo do esquema URI do iOS.
sha1_idfa	N/D	IDFA anonimizado com SHA1. Requer suporte da ad network
sha1_idfv	N/D	IDFV anonimizado com SHA1.
mac	N/D	Endereço MAC do dispositivo. Requer suporte da ad network
md5_idfa	N/D	IDFA anonimizado com MD5.
md5_idfv	N/D	IDFV anonimizado com MD5.
sha1_mac	N/D	Endereço MAC do dispositivo anonimizado com SHA1. Requer suporte da ad network

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 nas 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:

Os parâmetros personalizados não aparecem nos dados brutos.
Parâmetros personalizados podem ser recuperados da get conversion data SDK API.

Parâmetro Partner ID (PID)

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

Cada parceiro integrado nas tem o seu próprio valor PID único, que 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.

Atenção

A AppsFlyer bloqueia links de atribuição que usam nomes reservados às SRNs como valores de PID em fontes de mídia personalizadas, como e-mail e SMS. Essa restrição não se aplica a ASRNs.

Exemplos de publisher IDs reservados importantes: organic, googleadwords_int (Google AdWords), facebook_int (Meta Ads) e twitter_int (X Ads). Você pode usar qualquer nome para fontes não integradas como email, 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 cada fonte integrada, use somente o PID designado para a atribuição correta de suas instalações.
Para fontes personalizadas, use PIDs de parceiros não integrados. 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, como owned_email, sms_push ou outros identificadores personalizados que não correspondam aos nomes dos parceiros integrados.
Use apenas caracteres permitidos. Se o parâmetro PID no link de atribuição contiver um dos seguintes caracteres /<>*&?\
- O clique ou instalação aparece no dashboard em af_invalid_param
- Os links de atribuição não serão reconhecidos
- As funcionalidades de deep linking não funcionarão com cliques

Dica

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

Parâmetro do Site ID

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

Esse ID está incluído no parâmetro af_siteid enviado para a AppsFlyer no link de atribuição e é disponibilizado por meio de vários dashboards, relatórios e postbacks.

O site ID deve ser enviado para a AppsFlyer no link de atribuição, pois ele:

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

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

Para incluir informações adicionais, como o tipo de anúncio e a sua posição dentro do app, como, por exemplo, banner, intersticial ou vídeo, use o parâmetro de sub-site ID.

Exemplo

O seguinte link de atribuição inclui:

af_siteid (site ID): Publisher ID
af_sub_siteid (sub-site ID): Informação adicional de ID (nesse caso, uma fonte afiliada e a posição de acordo com o 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 do link:

1234 = ID do publisher
ABCD = Fonte afiliada (sub-publisher) com a qual o publisher está trabalhando
4567 = posição de acordo com o tipo de anúncio no app (banner, intersticial ou vídeo)

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

Isso ocorre por alguns motivos:

Site ID em falta: o parâmetro af_siteid está vazio na URL de 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.
Múltiplos site IDs: o mesmo publisher é enviado em várias URLs de cliques, usando site IDs diferentes. Isso é considerado um comportamento fraudulento que mascara a atividade real do publisher e frequentemente está associado à prática de flooding de cliques.
Site ID mal formatado: 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 site ID por publisher, como mostramos no exemplo.

Níveis de granularidade de dados

Você pode usar até quatro parâmetros de URL para analisar os detalhes da performance dos seus anúncios.

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

Atribuir todas as instalações de utilizadores e eventos a anúncios específicos
Analise e compare a performance de todos os seus anúncios por conjunto de anúncios (adset), por campanha e por fonte de mídia em relatórios agregados para otimização em todos os níveis
Compare todos os seus anúncios em todas as fontes de mídia no Pivot Table e em relatórios de dados brutos

Os parâmetros são:

Media source (pid=)
campaign name (c=)
Ad set (af_adset=)
Ad name (af_ad=)

Exemplo

O seguinte link de atribuição usa quatro níveis de granularidade para registrar o anúncio de "cashmere" no conjunto de anúncios de "coats" na campanha "winter", que é executada na fonte de mídia integrada "network".

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

Perguntas frequentes

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 dessa forma. 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 dinâmicos ou estáticos.
Como pode 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.
Somente URLs curtas (por exemployourbrand.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:

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 esse não é um problema significativo 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 e filtragem de dados.

Exemplo

O Luber, um aplicativo hail ride, tem criativos com modelos de três cores: azul, amarelo e vermelho. A responsável por marketing mobile do Luber, Linda, quer 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 processo é realizado para os anúncios amarelos e vermelhos. Com essa informação analisada e exibida nos relatórios de dados brutos, Linda é capaz de avaliar o sucesso dos anúncios de cores diferentes e escolher aquele que mais gera conversões de usuários.

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

O tamanho máximo de um nome de campanha na 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 nem terminar com um espaço em branco, pois isso pode causar discrepâncias nos dashboards e relatórios.

Características e limitações

Características	Observações
Caracteres especiais	Os seguintes caracteres especiais não são permitidos nas chaves e valores de parâmetros (não aplicáveis aos parâmetros de redirect e af_dp): ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ’, >, <, /, {, }, %
Parâmetros de redirecionamento	Certifique-se de que seus domínios de URL de redirecionamento sejam adicionados à sua redirect allowlist. O valor do redirecionamento deve ser uma URL web completa (https://[domain][optional-path]) em conformidade com os padrões RFC 1738; Os identificadores de fragmentos de URI não são compatíveis com URLs de redirecionamento (por exemplo, #webpagesection que leva os usuários até uma seção específica em um artigo).
Limite de caracteres da URL	O comprimento total da URL não pode exceder 2.000 caracteres.
Redirecionamento de deep link em WebView de aplicativos sociais do Android	Veja os detalhes das limitações aqui
O deep linking não é compatível com o aplicativo Android Naver Blog.	O deep linking não é compatível com o aplicativo Android Naver Blog. Os usuários serão redirecionados para a Google Play Store ou para a web, conforme definido pelo link.
Um pop-up aparece ao clicar em um link de esquema URI no navegador Chrome no iOS	Devido a uma alteração no Chrome, sempre que um usuário clica em um link de esquema URI no Chrome no iOS, um pop-up é exibido, solicitando que o usuário confirme a abertura do app ou o redirecionamento para a App Store.
Requisitos de validade para esquemas URI	Recomendamos o uso de um esquema URI válido que cumpra com as normas da RFC 3986. Os esquemas que não cumprem com os requisitos acima podem não abrir o app e gerar um erro quando recebem um clique na Web ou em outros ambientes Web.
Atribuição de WebView do Telegram	Veja os detalhes das limitações aqui