Cenários e cargas de dados de conversão

Para:
Profissionais de marketing Desenvolvedores
Última atualização:

Visão geral: use os dados de conversão para identificar vários cenários de conversão, personalizar a experiência do usuário e muito mais.

Visão geral

O guia a seguir contém vários cenários de conversão do usuário e suas cargas de dados de conversão correspondentes:

Os dados de conversão são disponibilizados na plataforma usando um dos seguintes itens:

Por conta da troca inerente entre precisão/latência, os dados de conversão para os mesmos IDs de dispositivo podem diferir entre as APIs.

Campos de carga de dados de conversão não orgânica

Campos sempre disponíveis

A tabela a seguir lista os campos que sempre existem para conversões não orgânicas, independentemente do media_source da conversão.

Nome do campo de carga Nome do campo de dados brutos Observações
media_source Canal de mídia

Publisher atribuído. Equivalente ao parâmetro pid em links de atribuição
install_time Hora da instalação  
click_time Tempo de toque atribuído A hora em que um clique ou impressão ocorreu em UTC
is_first_launch N/D true, false
af_status

Os dados brutos são divididos em relatórios separados: orgânicos, não orgânicos

 "Non-organic"
af_siteid Site ID  
adgroup_id Ad ID  
adset Conjunto de anúncios  
adset_id Adset ID  
agency parceira null, ou nome da agência (para campanhas executadas por agências)
campanha Campanha  
campaign_id ID da campanha  
http_referrer Referência HTTP  
retargeting_conversion_type Tipo de conversão de redirecionamento "none" ou retargeting_conversion_type
af_sub[n] (n=1—5) Subparâmetro [n] (n=1–5)  

Campos disponíveis em alguns casos

Os campos na tabela a seguir estão disponíveis em alguns casos, dependendo de como a SRN preenche o evento individual.

Nome dos campos de carga Nome do campo de dados brutos Observações
af_channel Canal

SRNs que preenchem esse parâmetro:

  • AppLovin
  • Google Ads
  • Meta Ads
  • Snapchat
  • TikTok para Empresas
  • Twitter

Exemplo: Facebook—Instagram, Google—YouTube 
orig_cost  

Observação (1)
costs_cents_USD  

Observação (1)
af_cpi  

Observação (1)

Observação

(1) Os campos de custo são preenchidos com valores compartilhados pela ad network. Para que a ad network compartilhe dados de custo com a AppsFlyer, você deve ativar a integração de custos na página Integrações ativas. Algumas SRNs são compatíveis com compartilhamento de custos em massa. Nesse caso, os campos de custo no nível do evento retornam como 0. 

Campos adicionais

Consulte o dicionário de campos de dados brutos para obter informações adicionais.

Limitações

Nomes de parâmetros personalizados

Parâmetros personalizados não podem ser chamados name ("n" minúscula. Name é válido).

Se um parâmetro for chamado name, ele será removido da carga.

Dados de conversão de UA com SRNs

Redes de autorrelato (SRNs) são ad networks que implementam seus próprios mecanismos de atribuição, por exemplo, Meta ads e Google. 

SRNs não usam links de atribuição. Isso significa que:

  • Os campos de carga são predefinidos
  • Você não pode adicionar campos à carga anexando parâmetros a um link de atribuição.

SRNs relatam conversões para a AppsFlyer. Os dados de conversão são disponibilizados no aplicativo. Os campos disponíveis variam de acordo com a SRN e são detalhados nas guias individuais das SRNs a seguir. 

Uma observação sobre o Meta ads

Se você realizar campanhas no Meta ads e não aceitar os termos de serviço do Meta, a AppsFlyer atribuirá a instalação. A disponibilidade do relatório é limitada da seguinte forma:

  • Disponível: dashboards e relatórios agregados e de analytics 
  • Não disponível: dados brutos 
Meta ads Google ASA Snap Twitter Oath

Dados de conversão do Meta ads

Nome do campo Observações Fonte de dados
match_type Sempre "srn" AppsFlyer
media_source Sempre "Anúncios do Meta" AppsFlyer
agency nulo ou valor do parâmetro af_prt no link de atribuição Meta Ads
http_referrer Sempre null Meta Ads
retargeting_conversion_type   AppsFlyer
af_channel   Meta ads (publisher_platform)
af_status Sempre "Non-organic" AppsFlyer
ad_id Somente para uso interno do Meta ads. Meta ads (ad_id)
click_time   AppsFlyer
install_time   AppsFlyer 
is_first_launch true, false Dispositivo
adset_id Disponível em dados brutos: Adset ID Meta ads (campaign_id)
is_fb Sempre true AppsFlyer
campanha Disponível em dados brutos: Nome da campanha Meta ads (campaign_group_name)
campaign_id Disponível em dados brutos: ID da campanha Meta ads (campaign_group_id)
is_paid Sempre true Meta Ads
adgroup Disponível em dados brutos: anúncio Meta ads (adgroup_name)
adgroup_id Disponível em dados brutos: Ad ID Meta ads (adgroup_id)
adset Disponível em dados brutos: Adset Meta ads (campaign_name)
af_siteid Sempre null Meta Ads
af_sub[1-5] Sempre null Anunciante

Observação: os campos relacionados ao custo não estão disponíveis porque os anúncios do Meta não compartilham dados de custo na conversão. Se o compartilhamento de custos estiver ativado, os anúncios do Meta compartilham dados de custo com a AppsFlyer várias vezes ao dia.

Conversão de UA com outras ad networks

Para outras ad networks, os dados na carga são afetados diretamente pelos parâmetros no link de atribuição.

Examine as seguintes cargas JSON.

Atenção! Os dados de conversão retornam como uma estrutura de dados semelhante a um mapa. O desenvolvedor não interage com o JSON bruto.

Applovin

Link de atribuição:

https://app.appsflyer.com/com.company.app?af_ad=ad_name&af_ad_type=INTER
  &af_channel=video&af_siteid=123_site_id&af_c_id=b8******************************&
  af_adset=_DEFAULT&pid=applovin_int&c=campaign_name
  &af_click_lookback=7d&clickid=10****************
  &advertising_id=50********************************&af_ip=

Carga:

{
      "adgroup": null,
      "campaign": "campaign_name",
      "media_source": "applovin_int",
      "retargeting_conversion_type": "none",
      "adset_id": null,
      "campaign_id": null,
      "install_time": "2018-12-30 23:49:54.186",
      "adgroup_id": null,
      "orig_cost": "0.0",
      "click_time": "2018-12-24 14:29:33.738",
      "agency": null,
      "cost_cents_USD": "0",
      "af_ad_type": "INTER",
      "af_c_id": "b8******************************",
      "adset": null,
      "advertising_id": "50********************************",
      "af_sub1": null,
      "clickid": "10****************",
      "af_click_lookback": "7d",
      "af_siteid": "123_site_id",
      "af_ad": "ad_name",
      "http_referrer": null,
      "af_channel": "video",
      "af_adset": "_DEFAULT",
      "af_sub5": null,
      "af_sub4": null,
      "af_cpi": null,
      "af_sub3": null,
      "af_sub2": null,
      "af_status": "Non-organic"
  }
  • Os parâmetros no link de atribuição aparecem como campos na carga
  • Outros campos na carga que não estão no link de atribuição aparecem com um valor nulo
  • O AppLovin é compatível com o compartilhamento de custos de anúncios, mas envia dados de custo para a AppsFlyer em massa. Os campos relacionados ao custo retornam como 0.

ironSource

Link de atribuição:

https://app.appsflyer.com/id123456789?
  af_ua=Mozilla/5.0+(iPhone;+CPU+iPhone+OS+12_1_2+like+Mac+OS+X)+AppleWebKit/605.1.15+(KHTML,+like+Gecko)+Mobile/16C101
  &clickid=ab*******************&redirect=false
  &ua=Mozilla/5.0+(iPhone;+CPU+iPhone+OS+12_1_2+like+Mac+OS+X)+AppleWebKit/605.1.15+(KHTML,+like+Gecko)+Mobile/16C101
  &af_lang=pt&imei=&af_sub1=&advertising_id=&af_ip=192.168.0.1&pid=ironsource_int
  &device_ip=192.168.0.1&c=campaign_name
  &idfa=01**********************************&af_siteid=123_site_id&
  af_enc_data=cN*********************************************************************

Carga:

{
      "adgroup": null,
      "af_enc_data": "cN**************************************************************************************",
      "campaign": "campaign_name",
      "media_source": "ironsource_int",
      "retargeting_conversion_type": "none",
      "adset_id": null,
      "campaign_id": null,
      "install_time": "2018-12-30 23:59:32.194",
      "adgroup_id": null,
      "redirect": "false",
      "orig_cost": "0.75",
      "click_time": "2018-12-30 23:58:54.517",
     "agency": null,
      "cost_cents_USD": "75",
      "adset": null,
      "advertising_id": "35**********************************",
      "af_sub1": null,
      "af_ip": "192.168.0.1",
      "clickid": "ab*******************",
      "af_sub3": null,
      "af_cost_value": "0.75",
      "af_ref": "ironsource_5f******************************************",
      "af_siteid": "123_site_id",
      "http_referrer": null,
      "af_cost_model": "cpi",
      "af_ua": "Mozilla/5.0 (Linux; Android 8.0.0; SM-N950F Build/R16NW; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/71.0.3578.99 Mobile Safari/537.36",
      "af_cost_currency": "USD",
      "af_sub5": null,
      "af_sub4": null,
      "af_lang": "en",
      "af_cpi": null,
      "af_click_lookback": "7d",
      "af_sub2": null,
      "af_status": "Non-organic"
  }

O ironSource compartilha dados relacionados a custos com a AppsFlyer na conversão usando os campos orig_cost, costs_cents_USD e af_cost_value.

No entanto, os dados relacionados ao custo não aparecem no link de atribuição. O ironSource criptografa dados de custo e os armazena no campo af_enc_data.

Dados de conversão de retargeting

O retargeting inclui dois tipos de conversões, reatribuição ou reengajamento.

 Dica

Os dados de conversão para retargeting nem sempre fornecem uma indicação clara quanto ao tipo de conversão. Consulte fontes alternativas de dados de conversão.

Reatribuição com SRNs

Quando um usuário é reatribuído por meio de uma SRN, a carga dos dados de conversão não indica que se trata de uma campanha de retargeting. Como as SRNs não usam links de atribuição, não há como definir um parâmetro is_retargeting=true no link de atribuição. Para SRNs compatíveis com retargeting, a AppsFlyer determina se o usuário deve ser reatribuído ou não.

Isso significa que não há como determinar, no nível do SDK, se uma instalação vem de uma campanha de retargeting. A única maneira é definir o nome da campanha de forma que indique uma campanha de retargeting.

 Observação

Definir o nome da campanha de forma que indique o retargeting não é um método infalível. Veja exemplos para saber mais.

Reatribuição com ad networks regulares

A atribuição a ad networks depende de links de atribuição. Sejam links de atribuição regulares ou OneLink, com retargeting, o link de atribuição sempre tem o parâmetro is_retargeting=true definido nele.

Campanha de retargeting com Criteo

Link de atribuição

https://app.appsflyer.com/id1234567895?pid=criteo_int&af_click_lookback=30d&
  c=campaign_name&is_retargeting=true&redirect=false&idfa=68**********************************
  &af_reengagement_window=30d

Carga de dados de conversão

{
      "adgroup": null,
      "campaign": "campaign_name",
      "media_source": "criteo_int",
      "retargeting_conversion_type": "re-attribution",
      "adset_id": null,
      "campaign_id": null,
      "af_reengagement_window": "30d",
      "install_time": "2018-12-01 23:13:03.126",
      "adgroup_id": null,
      "redirect": "false",
      "af_sub5": null,
      "click_time": "2018-11-18 20:02:31.559",
      "agency": null,
      "cost_cents_USD": "0",
      "is_retargeting": "true",
      "af_cpi": null,
      "af_click_lookback": "30d",
      "af_siteid": null,
      "idfa": "68**********************************",
      "http_referrer": null,
      "orig_cost": "0.0",
      "af_sub4": null,
      "adset": null,
      "af_sub1": null,
      "af_sub3": null,
      "af_sub2": null,
      "af_status": "Non-organic"
  }
  • Parâmetro retargeting_conversion_type - esse parâmetro indica o tipo de retargeting. Pode ser reatribuição, reengajamento ou nenhum.
  • Parâmetro is_retargeting: true - este parâmetro indica que a instalação é uma instalação reatribuída
  • af_reengagement_window: a janela de atribuição de reengajamento é o número de dias em que um evento pode ser atribuído a um usuário reengajado. Como essa é uma conversão de nova atribuição, esse parâmetro é redundante.

Reatribuição com deferred deep linking

Muitas vezes, é possível que você queira criar deep links para usuários reatribuídos que, por serem reatribuídos, não têm o aplicativo instalado. Por exemplo, você define uma campanha com o intuito de trazer de volta os usuários que desinstalaram o aplicativo. A campanha promove um produto ou serviço e você deseja atender os usuários com conteúdo relacionado ao produto ou serviço que você anuncia.

Isso é conhecido como deferred deep linking. A carga de dados de conversão para deferred deep linking vem do método onConversionDataSuccess.

Vinculação profunda adiada com SRNs

Os parâmetros de deep link definidos nas campanhas de SRNs não estão disponíveis fora da SRN. Isso inclui o parâmetro af_dp, que contém o caminho do esquema no aplicativo. A única exceção para isso é ao se usar Campanhas do Google App em Feeds. Para implementar deferred deep linking, uma lógica adicional deve ser aplicada para campanhas de SRN. Use os dados na resposta onConversionSuccess, como campanha, conjunto de anúncios, grupo de anúncios, para redirecionar de forma programática os seus usuários.

Dados de conversão para deferred deep linking com o Meta ads

Android iOS 
{
     "adset":"Adidas Running Shoes Women",
       "adgroup": null,
     "campaign_id":"6**********",
     "af_status":"Non-organic",
     "retargeting_conversion_type": "none",
     "agency":null,
     "af_sub3":null,
     "af_siteid":null,
     "adset_id":"6**********",
     "is_fb":true,
     "is_first_launch":true,
     "click_time":"2017-07-18 12:55:05",
     "iscache":false,
     "ad_id":"6**********",
     "af_sub1":null,
     "campaign":"running shoes summer collection",
     "is_paid":true,
     "af_sub4":null,
     "adgroup_id":"6**********",
     "is_mobile_data_terms_signed":true,
     "af_channel":"Facebook",
     "af_sub5":null,
     "media_source":"Meta ads",
     "install_time":"2017-07-19 08:06:56.189",
     "af_sub2":null
  }

Você pode usar os dados na resposta getConversionData, como campanha, conjunto de anúncios etc., para redirecionar programaticamente seus usuários e exibir um conteúdo relevante para eles.

 Exemplo

O aplicativo é um aplicativo de eCommerce especializado em roupas esportivas. Um usuário que não tem o aplicativo instalado interage com um anúncio e instala o aplicativo. Depois que o aplicativo é iniciado, o SDK retorna os dados de conversão. O desenvolvedor faz com que o aplicativo abra a atividade de coleção de tênis de corrida de verão (campanha) na loja, mostrando a categoria tênis de corrida para mulheres (conjunto de anúncios).

Deferred deep linking com links de atribuição

Existem três maneiras de fazer o deep linking dos usuários:

Esquemas URI

Ao usar esquemas URI, tanto para links de atribuição quanto para OneLink, o link de atribuição e a carga são os seguintes:

Link de atribuição

http://app.appsflyer.com/com.appsflyer.nivisampleapp?pid=media_source_name
  &c=campaign_name&af_dp=superapp%3A%2F%2deeplink-activity

OneLink

// short OneLink
  https://dhba.onelink.me/2rAD/71ba577e
  
  //long OneLink
  https://dhba.onelink.me/2rAD?pid=media_source_name&c=campaign_name
  &is_retargeting=true&af_dp=superapp%3A%2F%2deeplink-activity

Payload

{
      "af_deeplink": true,
      "campaign": "campaign_name",
      "media_source": "media_source_name",
      "retargeting_conversion_type": "none",
      "adset_id": null,
      "campaign_id": null,
      "orig_cost": "0.0",
      "click_time": "2018-12-30 23:59:09",
      "install_time": "2018-12-30 23:59:39.330",
      "agency": null,
      "cost_cents_USD": "0",
      "adset": "AD_SET_NAME",
      "ad_id": "AD_ID",
      "af_siteid": null,
      "http_referrer": null,
      "af_cpi": null,
      "af_sub5": null,
      "af_sub4": null,
      "af_sub1": null,
      "af_sub3": null,
      "af_sub2": null,
      "af_status": "Non-organic",
      "scheme": "superapp",
      "host": "deeplink_activity"
  }
  • af_deeplink: true - quando esse parâmetro aparecer e for definido como true, procure os campos scheme e host
  • scheme e host - esses campos vêm do parâmetro af_dp no link de atribuição e indicam o esquema e a atividade associados ao deep linking do usuário

Universal Links do iOS e App Links do Android

Essas são as outras duas das três maneiras de realizar deep linking.

Ao usar Universal Links ou App Links, o OneLink e a carga são os seguintes:

OneLink

// short OneLink
  https://dhba.onelink.me/2rAD/71ba577e
  
  //long OneLink
  https://dhba.onelink.me/2rAD?pid=media_source_name&c=campaign_name
  &is_retargeting=true

Payload

{
      "install_time": "2019-01-08 16:24:49.853",
      "cost_cents_USD": "0",
      "campaign": "campaign_name",
      "retargeting_conversion_type": "none",
      "is_first_launch": true,
      "click_time": "2019-01-08 16:24:14.322",
      "af_click_lookback": "7d",
      "orig_cost": "0.0",
      "af_status": "Non-organic",
      "iscache": "true",
      "shortlink": "71ba577e",
      "media_source": "media_source_name",
      "is_retargeting": true
  }
  • Campo shortlink - este é o campo que indica o OneLink específico de onde o usuário vem. Ele ajuda o desenvolvedor a saber como proceder em termos de lançamento de uma atividade e veiculação de conteúdo. Outros campos, como campaign também podem ser usados para essa finalidade.

     Importante!

    O shortlink do campo não aparece na carga ao usar o OneLink longo.

    Em ambos os casos (OneLink curto ou longo), recomendamos adicionar um parâmetro personalizado que indique a atividade. Por exemplo &deep_link_activity=shoes_cateogry

 Observação

O uso de Universal Links e App Links só é possível com o OneLink.

Reengajamento com SRNs

Assim como nas campanhas de reatribuição, quando um usuário é reengajado por meio de uma SRN, os dados de conversão não indicam que se trata de uma campanha de reengajamento. Você pode definir o nome da campanha de forma que indique uma campanha de reengajamento.

Reengajamento com ad networks regulares

Aqui também, a carga dos dados de conversão não indica que o usuário vem de uma campanha de reengajamento. Para superar essa limitação, você pode definir o nome da campanha para indicar um reengajamento.

Reengajamento com deep linking

Uma parte importante do reengajamento é enviar o usuário para uma atividade específica. Por exemplo, se você anunciar algum produto ou promoção. Nesses casos, recomendamos que você envie os usuários que clicam no anúncio diretamente para a atividade do aplicativo desse produto ou venda.

Para fazer isso, você usa deep linking. Os dados de conversão no deep linking são muito importantes. Eles contêm as informações necessárias para o desenvolvedor customizar a experiência do usuário e encaminhá-lo para a atividade correta.

Reengajamento: deep linking com SRNs

Os dados de conversão não estão disponíveis quando um usuário reengajado vem de uma SRN. O desenvolvedor precisa usar os métodos de SRN para obtê-lo na inicialização do aplicativo.

Reengajamento: deep linking com ad networks

Quando um usuário é engajado novamente e o aplicativo é iniciado, os seguintes dados de conversão ficam disponíveis no método onAppOpenAttribution:

Para iOS e Android, ao usar a versão curta do OneLink, os dados de conversão são um mapa estruturado de todos os parâmetros no link:

Exemplo:

{
     af_dp: "superapp://Deeplink",
     pid: "media_source_name"
     c: "campaign_name",
     link: "https://abcd.onelink.me/12ab/12ab34c"
     is_retargeting: true
  }
  • O desenvolvedor do aplicativo pode usar tais parâmetros, como af_dp e nome da campanha, para direcionar o usuário a uma atividade específica e exibir o conteúdo relevante.

 Importante!

Recomendamos usar a versão curta do OneLink. Clique aqui para saber mais.

Outro motivo para usar a versão curta do OneLink é a estrutura de dados de conversão que a versão longa retorna. Ao usar a versão longa, os dados de conversão são um mapa com um único campo chamado link que contém todo o OneLink longo.

{
     "link": "https://abcd.onelink.me/12ab?pid=media_source&c=campaign_name&is_retargeting=true&af_dp=superapp%3A%2F%2FDeepLink"
  }

Fontes de dados de conversão alternativas

  • A Push API oferece uma carga de conversão detalhada que indica reatribuição ou reengajamento. As cargas da Push API incluem um campo chamado re_targeting_conversion_type. Esse campo indica o tipo de conversão, seja reatribuição ou reengajamento. Para saber mais, consulte nosso guia de Push API.
  • Os relatórios de dados brutos também contêm indicadores para o tipo de conversão. No relatório de dados brutos para conversões de retargeting, há uma coluna chamada nome do evento. O valor nesta coluna é reengajamento ou reatribuição de acordo com o tipo de conversão.

Exemplos de aquisição e reatribuição de usuários mistos

  1. Um usuário instala seu aplicativo e depois o desinstala. O ato de instalação coloca o usuário em uma janela de reatribuição. Você define uma campanha de aquisição de usuários (e não de retargeting) com o Meta ads. Você também configura a integração da AppsFlyer com o Meta ads para permitir o retargeting.

    Ainda na janela de reatribuição, o usuário vê o anúncio, clica nele e reinstala o aplicativo. De acordo com a AppsFlyer, o usuário é um usuário reatribuído.

    Isso se deve a dois fatores:
    1. A configuração com o Meta ads permite o retargeting
    2. O usuário está na janela de reatribuição

    Nesse caso, o nome da campanha não indica a reatribuição.
  2. Vamos pegar o mesmo exemplo, só que desta vez o usuário está fora da janela de reatribuição. Nesse caso, a instalação é uma nova instalação não orgânica.
  3. Vamos avaliar outro exemplo. Você define uma campanha de retargeting no Meta ads. Alguns usuários se deparam com a campanha e instalam o app. No entanto, esses usuários instalam o aplicativo pela primeira vez. Esses usuários não são considerados usuários reatribuídos. Em vez disso, a AppsFlyer os considera como usuários provenientes de uma campanha de aquisição de usuários.