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 aos anunciantes recolher dados sobre a interação do utilizador com um anúncio. Os links de atribuição são incorporados nos anúncios e notificam a AppsFlyer quando os utilizadores interagem com o anúncio. A interação pode ocorrer ao clicar num anúncio ou ao visualizar uma impressão do mesmo. Uma cópia do 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 (ligação multiplataforma) | Ligação de plataforma única | |
|---|---|---|
| Descrição e quando utilizar |
Utilizar quando:
|
Utilizar quando:
|
| Pré-requisitos | Modelo OneLink | Nenhum |
| Informações obrigatórias | ||
| URL base | {subdomínio}.onelink.me | app.appsflyer.com |
| Identificador único | ID do modelo | ID_da_aplicação |
| 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://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
|
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 seguinte pode ser descarregada como ficheiro .
| Parâmetro | Nome de exibição em dados brutos | Descrição | Tipo e comprimento do campo |
|---|---|---|---|
| pid | Fonte de mídia | Identifica unicamente um parceiro integrado da AppsFlyer. Não altere isso. Mais detalhes. | Sequência 150 |
| c | Campanha | Fornecido pelo anunciante ou pelo editor. Ver limites para os nomes das campanhas. | Sequência 100 |
| af_prt | Parceiro |
|
String 50 |
| af_mp | N/D |
|
|
| clickid | N/D | Identificador único de clique da rede de anúncios. | |
| af_siteid | O ID do Site |
|
String 24 |
| af_sub_siteid | ID do Subsite |
|
String 50 |
| af_c_id | ID da Campanha | Fornecido pelo anunciante/editor. | String 24 |
| af_adset | Adset |
|
String 100 |
| af_adset_id | Adset ID | Fornecido pelo anunciante/editor. | String 24 |
| af_ad | Anúncio | Nome do anúncio (ver mais) fornecido pelo anunciante/editor. | String 100 |
| af_ad_id | ID do Anúncio | Fornecido pelo anunciante/editor. | String 24 |
| af_ad_type | Tipo de Anúncio | Utilize as seguintes convenções de nomenclatura:
|
String 24 |
| af_ad_format | Formato do anúncio | Utilize as seguintes convenções de nomenclatura:
|
|
| af_click_lookback | Janela de retrospetiva de atribuição |
|
3 caracteres no máximo |
| af_viewthrough_ retrospetiva |
N/D |
|
3 caracteres no máximo |
| af_canal | Canal | O canal de origem dos meios de comunicação 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_palavras-chave | Palavras-chave | Lista de palavras-chave para campanhas dirigidas por texto | String 100 |
| af_modelo_custo | Modelo de custo |
|
String 20 |
| af_cost_currency | Moeda de Custo |
|
Enum. 3 caracteres |
| af_cost_value | Valor de Custo |
|
String 20 |
|
af_sub[n] (n=1-5) exemplo: af_sub1 |
Subparâmetro [n] | Parâmetro personalizado, opcional, definido pelo anunciante. Para mais informações sobre a utilização desses parâmetros, consulte a secção Características e limitações. | String 100 |
| af_r | N/D |
Usado para redirecionar utilizadores para o URL especificado em todas as plataformas (Android, iOS e desktop). Em links multiplataforma (OneLink) este parâmetro:
Notas:
|
|
| af_web_dp | N/D |
URL para redirecionar os utilizadores de desktop (por exemplo, Windows ou Mac) para uma página web diferente da configurada no modelo OneLink. Use isto para manter os dados de atribuição de utilizadores de desktop noutras plataformas (por exemplo, Google Analytics ou Omniture). Notas:
|
|
| af_dp | N/D |
O valor de fallback do esquema URI para iniciar a aplicação, a ser usado se o método Universal Link ou Android App Link falhar, e para utilizadores Android abaixo da versão 6.0. Deve apontar apenas para o caminho base, ou seja, a atividade padrão. Nota: Se usar um URL para este parâmetro (não recomendado), assegure-se de que o URL é válido conforme as normas RFC 1738, e que o domínio desse URL está na lista de permissões de redirecionamento. |
|
| af_force_deeplink | N/D | Forçar ligação direta na atividade especificada no valor af_dp | |
| af_ref | N/D |
As redes de anúncios que trabalham com cliques S2S podem enviar um valor de referência único utilizando o seguinte parâmetro: &af_ref=ValorDeReferência
O valor af_ref deve ser único e estruturado da seguinte forma:
NomeDaRede_ValorDeCliqueÚnicoParaCadaClique
Exemplo: af_ref=nomedarede_123456789ABCDEF
O nome da rede pode ser qualquer cadeia de caracteres válida. Pode ser networkname_int ou simplesmente nome da rede.
A AppsFlyer pode usar este parâmetro para atribuição em dispositivos Android. A AppsFlyer não utiliza este 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 |
|
|
| af_base_params_forward | N/D |
|
|
| af_partner_account_id | ID da conta da rede | ID da conta do anunciante com o parceiro | String 100 |
| redirecionar | N/D | Quando&redirect=false, este parâmetro informa a AppsFlyer que se trata de um clique S2S e que o parceiro é responsável por redirecionar o utilizador que clicou. |
|
| af_ua | User-agent |
Relevante para redes de anúncios que enviam cliques e impressões de servidor para servidor. A string user-agent enviada como:
O User-Agent deve ser idêntico tanto no parâmetro de URL quanto no cabeçalho HTTP. Nota: No Android, o user-agent é por vezes reduzido devido a Client Hints. Deve ser enviado independentemente.
|
|
| af_ip | IP |
Relevante para redes de anúncios que enviam cliques e impressões de servidor para servidor. Endereço 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 utilizará o IP presente no X-Forwarded-For. |
|
| [Obsoleto] af_os | Versão do sistema operativo |
[Exclusivo para iOS] A versão do sistema operativo do dispositivo. Este parâmetro está descontinuado, mas ainda é suportado pela AppsFlyer. Recomendação: Utilize o parâmetro af_os_version em vez disso. |
|
| af_os_version | Versão do sistema operativo |
|
|
| af_modelo | Modelo do dispositivo |
|
|
| af_media_type | Tipo de media | Posicionamento do anúncio que contém o link da seguinte forma:
|
|
| deep_link_sub1-10 | N/D | Valores adicionais para ligações diretas. Os programadores implementam o comportamento desejado dos valores no código. | |
| deep_link_value | N/D | O nome para o conteúdo específico dentro da aplicação para o qual os utilizadores serão direcionados. Os programadores implementam o comportamento desejado do valor_de_link_direto no código. | |
| af_og_título | N/D | Quando um link é publicado nas redes sociais, o título Open Graph (OG) irá gerar uma pré-visualização do título. | String de 40 caracteres |
| af_og_descrição | N/D | Quando um link é publicado nas redes sociais, a descrição Open Graph (OG) irá gerar uma pré-visualização da descrição. | String de 300 caracteres |
| af_og_imagem | N/D | Quando um link é publicado nas redes sociais, a imagem 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 largura do campo |
|---|---|---|---|
| é_retargeting | Trata-se de uma campanha de Retargeting? | O URL de clique de todas as campanhas de retargeting deve incluir &is_retargeting=true.Se o parâmetro não for incluído ou o seu valor for "falso", a campanha será considerada como uma campanha normal de aquisição de utilizadores. |
Enumeração de 5 valores |
| af_reengagement_window | Janela de reengajamento |
Altere a janela de atribuição de reengajamento ao adicionar este parâmetro ao link de atribuição. As opções possíveis de intervalo da janela são:
Valor padrão: 30 dias Exemplo: |
N/D |
Parâmetros de visibilidade
Conforme o tipo de anúncio, pode enviar o parâmetro de visibilidade relevante com 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 | Quantidade de vídeo visualizada |
| af_playable_played_length | segundos | Tempo de reprodução do elemento jogável após totalmente carregado |
| af_ad_time_viewed | segundos | Tempo que o anúncio ficou visível no ecrã |
| af_ad_displayed_percent | % | A percentagem máxima de visibilidade do anúncio no ecrã do dispositivo |
| af_audio_total_length | segundos | A duração total possível do áudio |
| af_audio_played_length | segundos | Quantidade de áudio ouvida |
Parâmetros específicos para Android
| Parâmetro | Nome de exibição em dados brutos | Descrição | Tipo de campo |
|---|---|---|---|
| id_publicidade | ID de Publicidade | Google Advertising ID – requer suporte da rede de publicidade | Máximo de 40 caracteres |
| sha1_publicidade_id | N/D | ID de Publicidade do Google com hash SHA1 – requer suporte da rede de publicidade | |
| md5_advertising_id | N/D | ID de Publicidade do Google com hash MD5 – requer suporte da rede de publicidade | Compatível apenas com instalações e reatribuições |
| android_id | Android ID | ID do dispositivo Android – Requer suporte da rede de publicidade | Máximo de 20 caracteres |
| sha1_android_id | N/D | ID do dispositivo Android com hash SHA1 – Requer suporte da rede de publicidade | |
| md5_android_id | N/D | ID do dispositivo Android com hash MD5 – Requer suporte da rede de publicidade | Compatível apenas com instalações e reatribuições |
| imei | IMEI | ID IMEI do dispositivo | |
| sha1_imei | N/D | ID IMEI do dispositivo com hash SHA1 – Requer suporte da rede de publicidade | |
| md5_imei | N/D | ID IMEI do dispositivo com hash MD5 – Requer suporte da rede de publicidade | |
| oaid | OAID | Identificador de Dispositivo Anónimo Aberto | Disponível desde a versão 4.10.3 do Android SDK |
| sha1_oaid | N/D | Identificador de Dispositivo Anónimo Aberto com hash SHA1 – Requer suporte da rede de publicidade | Disponível desde a versão 4.10.3 do Android SDK |
| md5_oaid | N/D | Abrir Identificador de Dispositivo Anónimo com hash MD5 – Requer suporte da rede de anúncios | Disponível desde a versão 4.10.3 do Android SDK |
| af_android_url | N/D |
Redirecione os utilizadores Android para um URL diferente da página da app no Google Play. Utilizar para lojas de apps de terceiros. Notas:
|
|
| sha1_el | N/D | Utilizado para atribuição de desktop para móvel - e-mail com hash com SHA1. Requer suporte da rede de anúncios | |
| fire_advertising_id | N/D | ID de Publicidade do Amazon Fire | |
| af_android_store_csl | página_produto_loja | Listagem personalizada na Google Console | cadeia |
Parâmetros específicos da plataforma iOS
| Parâmetros | Nome de Exibição | Descrição |
|---|---|---|
| idfa | IDFA |
Use letras maiúsculas. Requer suporte da rede de anúncios Tipo de campo: Máximo de 40 caracteres |
| idfv | IDFV | Use letras maiúsculas. |
| af_ios_url |
Utilize isto para redirecionar utilizadores iOS (iPhone ou iPad) para um URL diferente da página da app no iTunes em redirecionamentos de página de destino. Notas:
|
|
| af_ios_store_cpp | página_produto_loja |
ID de página de produto personalizado (ppid) Nota: Em dados brutos e relatórios agregados, o valor do parâmetro af_ios_store_cpp (ID de página de produto personalizado) é registado para cliques, mas não para impressões. |
| af_ios_fallback [descontinuado] | N/D | Descontinuado: Os utilizadores são redirecionados de acordo com o fluxo do esquema URI do iOS. |
| sha1_idfa | N/D | IDFA com hash SHA1. Requer suporte da rede de anúncios |
| sha1_idfv | N/D | IDFV com hash SHA1. |
| mac | N/D | Endereço MAC do dispositivo. Requer suporte da rede de anúncios |
| md5_idfv | N/D | IDFV com hash 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 nas análises, relatórios e APIs.
Parâmetros personalizados
Para além dos parâmetros padrão específicos do Android e iOS, pode definir parâmetros personalizados. Estes parâmetros personalizados auxiliam na personalização da experiência do utilizador e do conteúdo conforme o link de atribuição que conduz à instalação.
É possível anexar parâmetros personalizados 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
Dois aspetos importantes que deve conhecer sobre parâmetros personalizados:
- Os parâmetros personalizados não aparecem nos dados brutos.
- Pode recuperar os parâmetros personalizados a partir da API get conversion data SDK.
Parâmetro ID do parceiro (PID)
Entre todos os parâmetros do link de atribuição disponíveis, o PID é obrigatório. O PID é um identificador único da fonte de média atribuída pela AppsFlyer.
Cada parceiro integrado tem o seu próprio valor PID único. O PID termina com o sufixo _int. Ao utilizar links OneLink, pode definir o PID com o valor que preferir, desde que não esteja reservado por um parceiro integrado. Para evitar conflitos, não utilize o sufixo _int .
Exemplos de IDs de editores integrados importantes: organic, googleadwords_int (Google AdWords), anúncios Meta e X Ads. Pode usar qualquer nome para fontes não integradas, como e-mail, SMS ou até mesmo pombos-correio.
Evite problemas comuns com o PID:
- Inclua sempre o PID nos seus links de atribuição. Sem o PID no link de atribuição, o utilizador é automaticamente atribuído a uma fonte de mídia "Nenhuma" e a fonte original da instalação é perdida.
- Para fontes personalizadas, utilize PIDs de parceiros não integrados. Para cada fonte integrada, utilize apenas o PID designado para a correta atribuição das suas instalações. Para qualquer fonte de mídia personalizada, como e-mail, SMS ou até publicações virais não pagas no Facebook, utilize outros valores PID não integrados.
-
Utilize 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 painel 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
Sugestão
Evite utilizar espaços em branco no valor do PID ou certifique-se de codificar os seus links de atribuição em URL antes de os usar.
Parâmetro ID do site
O ID do site é o identificador único do editor que exibe o anúncio. Ou seja, é o site ou aplicação que apresenta o anúncio. As redes de anúncios atribuem identificadores de site únicos a cada editor.
Este ID está incluído no af_siteidparâmetro transmitido para o AppsFlyer no link de atribuição e está disponível através dos vários painéis, opções de relatórios e postbacks.
O ID do site deve ser enviado para a AppsFlyer no link de atribuição porque:
- Proporciona clareza e transparência sobre o editor
- É utilizado pela AppsFlyer para identificar e eliminar editores fraudulentos e outros clusters de tráfego.
O parâmetro ID do site inclui apenas o identificador do editor que veicula o anúncio.
Para incluir informações adicionais, como o tipo de anúncio e o posicionamento dentro da aplicação, como, por exemplo, banner, intersticial ou vídeo, utilize o parâmetro de ID do subsite.
Exemplo
O seguinte link de atribuição inclui:
-
af_siteid(ID do site): ID do editor -
af_sub_siteid(ID do subsite): Informação adicional 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 do link:
- 1234 = ID do editor
- ABCD = Fonte afiliada (subeditora) com a qual o editor está a colaborar
- 4567 = Posicionamento do tipo de anúncio na aplicação, como banner, intersticial ou vídeo
FAQ: Porque é que o tráfego resulta em muitas instalações bloqueadas?
Instalações bloqueadas podem ocorrer devido a:
-
ID do site em falta: O parâmetro
af_siteidestá vazio no URL de clique. Engajamentos enviados com um ID de site vazio indicam um problema técnico ou uma tentativa intencional de contornar os mecanismos de deteção de fraude. - Múltiplos IDs de site: O mesmo editor é enviado em vários URLs de clique, utilizando diferentes IDs de site. Este comportamento é considerado fraudulento, pois mascara a atividade real do editor e está frequentemente associado à inundação de cliques.
- ID do site mal formatado: O envio de um formato incorreto, combinado com outras indicações de fraude, pode resultar no bloqueio não só do editor específico, mas também de um nível de cluster mais alto, impactando volumes maiores de atividade do parceiro.
Para evitar instalações bloqueadas, garanta que envia um único parâmetro de ID de site por editor, conforme ilustrado no exemplo.
Níveis de detalhe dos dados
Pode usar até quatro parâmetros de URL para analisar detalhadamente o desempenho dos seus anúncios.
Usar todos os quatro parâmetros em todos os seus links de atribuição ativos permite-lhe:
- Atribuir todas as instalações de utilizadores e eventos a anúncios específicos
- Analisar e comparar o desempenho de todos os seus anúncios por conjunto de anúncios, por campanha e por fonte de media em relatórios agregados, otimizando a todos os níveis
- Comparar todos os seus anúncios em todas as fontes de media nos relatórios de dados brutos e na tabela dinâmica
Os parâmetros são:
Media source (pid=)campaign name (c=)Ad set (af_adset=)Ad name (af_ad=)
Exemplo
O link de atribuição seguinte utiliza quatro níveis de detalhe para registar o anúncio de "caxemira" no conjunto de anúncios de "casacos", na campanha "inverno" que está a decorrer na fonte de media integrada "rede".
https://app.appsflyer.com/com.greatapp?pid=networkx_int&c=winter& af_adset=coats&af_ad=cashmere
Perguntas frequentes
Devo usar letras maiúsculas ou minúsculas para os parâmetros?
Pode utilizar ambas, mas deve manter a consistência. Se definir um parâmetro personalizado com letras maiúsculas ou minúsculas, certifique-se de que o usa sempre dessa forma.
Por exemplo, se definir pid=MyMediaSource, certifique-se de que o utiliza sempre assim. Caso utilize pid=MyMediaSource num link de atribuição e pid=mymediasource noutro, poderão surgir discrepâncias nos dados. O mesmo se aplica a qualquer outro parâmetro que definir no link de atribuição.
O link de atribuição da AppsFlyer é dinâmico ou estático?
Como pode saber se um link é dinâmico ou estático?
Se o link de atribuição contiver parâmetros, trata-se de um link de atribuição longo e predefinido, portanto, estático.
Apenas URLs curtos (por exemplo, ), usados para links de atribuição personalizados, são dinâmicos.
Isso significa que, ao começar a utilizar um link de atribuição para um parceiro integrado ou um URL longo para os seus próprios meios, este não mudará para nenhum lead que interaja com ele, mesmo que altere os valores do link de atribuição no painel da AppsFlyer. Para que a alteração tenha efeito, deve utilizar o novo URL longo daqui em diante.
Por outro lado, os URLs curtos para meios próprios não contêm parâmetros diretamente. Quando um lead interage com um URL curto da AppsFlyer, é redirecionado para a AppsFlyer e os parâmetros definidos no momento são aplicados dinamicamente.
O que significa esta 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:
Isto acontece porque o link de atribuição inclui um carácter #. Por exemplo:
https://app.appsflyer.com/com.travelco?pid=globalwide_int&clickid=#reqid#
Normalmente, esses caracteres estão presentes no link porque são macros e são substituídos dinamicamente por um valor, o que não constitui um grande problema, podendo ignorar a mensagem.
Para que servem os parâmetros do subscritor?
Os Parâmetros do Subscritor, como af_sub1, af_sub2, ..., af_sub_5, podem ser usados para registar indicadores chave de performance úteis (KPIs). Estes parâmetros são analisados e aparecem no relatório de dados brutos, facilitando a agregação ou filtragem de dados.
Exemplo
A aplicação de transporte Luber tem criativos com 3 modelos de cor: azul, amarelo e vermelho. Linda, a responsável de marketing móvel da Luber, quer testar qual modelo de cor gera mais instalações. Para isso, adiciona &af_sub3=blue nos links de atribuição de todos os anúncios azuis em todas as fontes de mídia fora do SRN. O mesmo processo é realizado para os anúncios amarelos e vermelhos. Com estas informações analisadas e refletidas nos relatórios de dados brutos, Linda consegue avaliar o sucesso dos anúncios de diferentes cores e escolher aquele que tem melhor desempenho.
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 for excedido, o nome da campanha será 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ística | Observações |
|---|---|
| Caracteres especiais | Os seguintes caracteres especiais não são permitidos nos parâmetros ou valores: ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ', >, <, \/, {, }, % |
| Limite de caracteres do URL | O comprimento total do URL não pode exceder os 2.000 caracteres. |
| Redirecionamento de links diretos no WebView de aplicações sociais Android | Veja os detalhes das limitações aqui |
| Os links diretos não são suportados na app Android Naver Blog | Os links diretos não são suportados na app Android Naver Blog. Os utilizadores serão redirecionados para a Google Play Store ou para a web, conforme definido pelo link. |
| Surge um pop-up ao clicar num link de esquema URI no navegador Chrome no iOS | Devido a uma alteração no Chrome para iOS, sempre que um utilizador clica num link de esquema URI no Chrome no iOS, aparece um pop-up que solicita a confirmação da abertura da 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 a RFC 3986. Os esquemas que não cumpram o mencionado acima podem não abrir uma app e gerar um erro quando clicados numa visualização Web ou noutros ambientes Web. |
| Atribuição de WebView do Telegram | Veja os detalhes das limitações aqui |