Atribuição de view-through no fluxo CTV-to-mobile app para ad networks

Para:
Ad Networks
Última atualização:
Resumo: Atribua instalações de apps mobile a anúncios visualizados em dispositivos CTV.

Atribuição de CTV-to-mobile app para ad networks

Com as URLs de impressão cross-platform da AppsFlyer, você pode atribuir instalações de apps mobile a anúncios exibidos em CTV. Múltiplas instalações dentro da mesma residência podem ser atribuídas à mesma impressão de anúncio na CTV.

50310_CTV_flow_chart__2_.jpg

A atribuição de view-through no fluxo CTV-to-mobile usa uma URL de impressão do OneLink que se baseia em um template cross-platform do OneLink (e que possui um template ID) criado pelos anunciantes. Isso permite que os anunciantes agrupem múltiplos apps de diferentes plataformas (por exemplo, apps do Android e do iOS) usando uma única URL.

Assim, quando os usuários veem um anúncio na CTV, a URL de impressão é enviada para a AppsFlyer em tempo real.

Exemplo de URL:

https://impressions.onelink.me/{template_id}?pid=__media_source__&af_xplatform=true&af_xplatform_vt_lookback=24h&af_siteid=__CSITE__&c=__CAMPAIGN_NAME__&af_channel=__PLACEMENT__&af_c_id=__CAMPAIGN_ID__&af_adset=__AID_NAME__&af_adset_id=__AID__&af_ad=__CID_NAME__&af_ad_id=__CID__&af_source_platform=__source_platform__&af_source_device_category=__device_category__&af_ad_type=__CTYPE__&af_ip=__IP__&af_ua=__UA__&redirect=false

Postbacks são enviados para você após cada conversão.

Atenção:

Este recurso está disponível apenas para parceiros designados. Para saber mais, entre em contato com seu Partner Development Manager (PDM).

Configuração

Para configurar a atribuição de view-through no fluxo CTV-to-mobile com um anunciante:

  1. Certifique-se de que é um parceiro integrado da AppsFlyer, de que configurou corretamente os postbacks e de que testou a sua integração de CTV-to-mobile com a AppsFlyer.
  2. Certifique-se de que a URL contém os parâmetros obrigatórios, bem como quaisquer outros parâmetros desejados.
  3. Envie o user IP e o user agent para a AppsFlyer. Esses dados são necessários para a atribuição de view-through no fluxo CTV-to-mobile app. Eles podem ser enviados:
    1. Como os parâmetros af_ip e af_ua na URL de impressão.
    2. Como os parâmetros e nos headers da solicitação.

Testar a integração com o parceiro

Para testar a atribuição de view-through no fluxo CTV-to-mobile:

  1. Use os seguintes aplicativos de teste: com.appsflyer.android.deviceid e id1192323960
  2. Entre em contato com a equipe de Partner Solutions da AppsFlyer para receber uma URL de teste. Para isso, faça login no seu dashboard de parceiro e, no menu superior, clique em ajuda > fale com a nossa equipe.
    • Exemplo de URL: https://impressions.onelink.me/dfHa?pid=partner_int&c=test_1&af_xplatform=true&af_xplatform_vt_lookback=24h&af_ip=MACRO&af_ua=MACRO&redirect=false
  3. Confirme se o seu partner ID no parâmetro pid está correto.
  4. Insira o seu endereço IP para o parâmetro af_ip.
  5. Insira o seu user agent para o parâmetro af_ua.
  6. Insira a URL em um navegador de desktop.
  7. No seu dispositivo mobile, vá para a loja de aplicativos e baixe, instale e abra o aplicativo.
  8. Uma nova instalação deve aparecer na AppsFlyer e deve receber um postback correspondente. Se não vir a instalação ou não receber o postback, entre em contato com a equipe de Partner Solutions.

Parâmetros

Os seguintes parâmetros são usados para fornecer dados de atribuição e mensuração para os anunciantes.

Parâmetro Obrigatório Descrição
template_ID ✓ O ID do template do OneLink. O template contém configurações básicas de previsão para os aplicativos do anunciante, além de ser a base para criar outros links.
pid ✓

O identificador do parceiro, atribuído pela AppsFlyer à fonte de mídia (ad network) que posiciona o anúncio.

af_xplatform ✓
  • Definido pelo anunciante para indicar se o link oferece suporte à atribuição cross-platform.
  • Valores: true/false
af_xplatform_vt_lookback -

Janela configurável que indica o número de horas após a impressão, um período no qual a instalação do aplicativo pode ser atribuída à impressão. Valores de parâmetros disponíveis: 1h - 72h (horas). O valor padrão é 24h.

af_ip ✓
  • O endereço IP do dispositivo de CTV que exibe o anúncio.
  • Se o endereço IP não for enviado na URL, ele deve ser enviado nos headers da solicitação para que a AppsFlyer faça a atribuição do fluxo CTV-to-mobile.
af_ua ✓
  • O user agent do dispositivo CTV que exibe o anúncio.
  • Se o user agent não for enviado na URL, ele deve ser enviado nos header da solicitação para que a AppsFlyer consiga fazer a atribuição de CTV-to-mobile.
af_source_platform -
  • Um conjunto de valores que representa o sistema operacional onde a impressão ocorre.
  • Valores:
    • android
    • ios
    • tizen
    • webos
    • smartcast
    • roku
    • windowsphone
    • vidaa
    • PlayStation
    • smartcast
    • website
af_source_device_category -
  • Um conjunto de valores que representa o tipo de dispositivo onde a impressão ocorre.
    • tv
    • mobile_phone
    • desktop
    • tablet
    • set_top_box
    • games_console
    • unknown_device_category
    • media_player

Outros parâmetros que podem ser adicionados à URL podem ser encontrados no artigo estrutura e parâmetros do link de atribuição.

Características e limitações

Caraterística Observações
Janela de atribuição Entre 1-72 horas, dependendo do parâmetro af_xplatform_vt_lookback da janela de lookback.
Retargeting
  • Reatribuição: disponível para cross-platform-to-mobile. Indisponível para outras plataformas.
  • Reengajamento: Indisponível
Método de atribuição Atribuição de view-through com modelagem probabilística (IP address)
Atribuição a nível doméstico Disponível. Significa que múltiplas instalações dentro da mesma casa podem ser atribuídas à mesma impressão de anúncio CTV.
Testar a integração com o parceiro Indisponível para ad networks que foram sinalizadas por suas altas taxas de fraude de mobile app-to-mobile app ou estão afiliadas a diferentes fontes de mídia sinalizadas com fraude.