Links de atribuição direta das plataforma de CTV, PC e console

Para:

Profissionais de marketing

Última atualização: 10 de Junho de 2025 19:21

Resumo: saiba mais sobre a estrutura e os parâmetros de links de atribuição da AppsFlyer para plataformas de CTV, PC e console. Atenção: para os aplicativos de Android e iOS, incluindo jogos de Android para PC, use as instruções do link de atribuição para dispositivos móveis.

Visão geral

Os links de atribuição direta para plataformas de CTV, PC e console permitem que os anunciantes redirecionem os usuários e coletem dados após os cliques. Os links de atribuição direta são links da AppsFlyer compatíveis com o redirecionamento e a atribuição para um único aplicativo de destino em uma única plataforma por vez. O destino de redirecionamento é o valor do parâmetro af_r incluído no link.

Atenção: para os aplicativos de Android e iOS, incluindo jogos de Android para PC, use as instruções do link de atribuição para dispositivos mobile.

Os links de atribuição podem ser criados diretamente por você e colocados atrás de anúncios. Para criar esses links, siga as instruções neste artigo.

Como alternativa, os links podem ser criados via S2S usando a Engagements API. Isso envolve um pouco de programação. Atenção: os links criados por meio de S2S também podem coletar dados de impressão.

Link de atribuição

Propriedade	Valores
URL base	engagements.appsflyer.com/v1.0/c2s/click/app/
Parâmetros de caminho obrigatórios	platform Exemplo: steam app_id Exemplo: 123456
Parâmetros de consulta obrigatórios	af_media_source af_campaign_id
Outros parâmetros	Ver todos os parâmetros
Estrutura da URL	`https://engagements.appsflyer.com/v1.0/c2s/click/app/{platform}/{app_id}?af_media_source={media_source}&af_campaign_id={campaign_id}&af_r={app_store_url}`
URL de exemplo	`https://engagements.appsflyer.com/v1.0/c2s/click/app/steam/123456?af_media_source=aloha&af_campaign_id=1234&af_r=https%3A%2F%2Fstore.steampowered.com%2Fapp%2F440%2FTest_app2%2F%3Futm_term%3Dhello`

Parâmetros

Parâmetro	Nome de exibição na exportação de Dados Brutos e na API de Pull	Descrição	Tipo de campo
platform	Plataforma	Parâmetro de caminho que especificou a plataforma do aplicativo. Valores possíveis: smartcast tizen roku webos vidaa playstation steam quest battlenet epic switch xbox nativepc	String
app_id	App ID	Parâmetro de caminho que especifica a ID do aplicativo para o qual você está postando. Exemplo: `ap123456` Não adicione um prefixo de plataforma ao valor do App ID. Por exemplo, se o app ID for `ap123456` e a plataforma for `platformX`, não use `platformX_ap123456` como o valor de `app_id`.	String
af_media_source	Fonte de mídia	Esse é o identificador exclusivo do parceiro, conforme definido na plataforma da AppsFlyer. Os seguintes caracteres não são permitidos: ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ’, >, <, /, {, }, %.	String
af_campaign	Campanha	Nome da campanha	String
af_campaign_id	ID da campanha	ID da campanha	String
af_request_id	N/D	Um identificador que identifica exclusivamente uma solicitação de um parceiro.	String
af_adset	Conjunto de anúncios	Nome do conjunto de anúncios	String
af_adset_id	ID do conjunto de anúncios	ID do conjunto de anúncios	String
af_ad	Anúncio	Nome do anúncio	String
af_ad_id	ID do anúncio	ID do anúncio	String
af_campaign_type	Tipo de campanha	Ou: user_acquisition retargeting	String
af_prt	Parceiro	Nome da conta da agência que permite atribuir instalações à agência Atenção não use esse parâmetro antes de garantir que as Permissões de Agência estejam habilitadas	String
af_siteid	ID do site	ID exclusivo que identifica o publisher que exibe o anúncio.	String
af_sub_siteid	ID do subsite	ID da sub-rede de anúncios/publisher.	String
af_click_id	N/D	Identificador exclusivo de transação da rede de anúncios	String
af_lookback_window	N/D	Janela de lookback relevante para atribuição por meio de matching de ID. Número configurável de dias/horas para o período de atribuição da janela de lookback. Valores dos parâmetros disponíveis: 1d - 30d (dias) OU 1h-23h (horas). Validação: 3 caracteres no máximo, usando o esquema acima. O valor padrão é 24 horas para impressões e 7 dias para cliques.	String
af_ad_placement	N/D	Identificador exclusivo de transação da rede de anúncios	String
af_ad_type	Tipo de anúncio	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 audio: um anúncio em áudio Diferenciação de maiúsculas e minúsculas.	String
af_channel	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.	String
af_model	Modelo do dispositivo	Modelo do dispositivo	String 64
af_os_version	N/D	Versão do sistema operacional do dispositivo Apenas dígitos e pontos Exemplo: 8.1.0	String
af_device_id_type	N/D	Tipo de identificador de dispositivo. Ou: vida tifa rida lgudid fire advertising_id fire custom	String
af_device_id_value	N/D	Tipo de identificador de dispositivo	String
af_r	N/D	Contém o link para a loja de aplicativos ou página de destino correta Tudo dentro do parâmetro af_r precisa ser codificado. Isso inclui quaisquer valores de parâmetro UTM, se anexados. Atenção: certifique-se de que o domínio da URL para af_r esteja incluído na sua redirect allowlist.	String

Características e limitações

Janela de lookback	Com a modelagem probabilística, é usada uma janela de lookback fixa de 24 horas para cliques e impressões. O valor af_lookback_window é ignorado.
Atribuição de agência	CTV-PC-Console para fluxo mobile - a atribuição de agência é suportada. Fluxo de dispositivos mobile para CTV-PC-Console - a atribuição de agência não é compatível.