Obtenha dados de conversão usando o SDK da AppsFlyer

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

Visão geral: Saiba como as reatribuições e os reengajamentos se refletem nos dados de conversão para jornadas de usuários SRN e não SRN.

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=trueis_retargeting=trueis_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"
  }
  • retargeting_conversion_type parâmetro - este parâmetro indica o tipo de redirecionamento. 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 no qual 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.

Deferred deep linking com SRNs

Os parâmetros de deep link definidos nas campanhas de SRNs não estão disponíveis fora do SRN. Isso inclui o parâmetro af_dp, que contém o caminho do esquema no aplicativo. 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 Anúncios da Meta

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 este parâmetro aparecer e for definido como verdadeiro, 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 campo shortlink 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 personalizar 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. A cargas da API Push 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

Exemplos

  1. Um usuário instala seu aplicativo e 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 (não retargeting) com o Anúncios da Meta. Você também define a integração da AppsFlyer com o Anúncios da Meta 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 Anúncios da Meta 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 Anúncios da Meta 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.