Notas de versão do Android SDK da AppsFlyer

Visão geral: consulte as notas de versão do SDK para um resumo das últimas alterações feitas ao nosso Android SDK. Desenvolvedores que desejam acessar informações mais detalhadas devem acessar as notas de lançamento do Android no Dev Hub.

Android SDK V6 

Guia de integração do Android SDK para desenvolvedores

Versão Data de lançamento Observações
6.13.0 08/02/2024
  • Adicionamos suporte para a nova política de consentimento do Google na UE (DMA)
6.12.6 29/01/2024

Manutenção do SDK

6.12.5 18/12/2023
  • Adicionamos o original_link parâmetro ao callback de deep linking no fluxo de resolução de ESPs.
6.12.4 25/10/2023
  • Dexguard atualizado para a versão 9.4.16 para melhorar a estabilidade do SDK.

6.12.3

31/08/2023 Manutenção do SDK

6.12.2

02/08/2023
  • Corrigimos um bug que fazia o aplicativo travar em alguns dispositivos com Android 8.1.0 e Android 11.

6.12.1

29/06/2023
  • Corrigimos um problema com o atraso da abertura da Play Store em promoções cruzadas.
  • Corrigimos um bug que fazia o aplicativo travar em alguns dispositivos.

6.12.0

28/06/2023
  • Obsoleto - use a versão 6.12.1.

6.11.2

29/06/2023
  • Corrigimos um bug que fazia o aplicativo travar em alguns dispositivos.

6.11.1

06/06/2023
  • Obsoleto - use a versão 6.12.1.
  • Corrigimos um bug em que o aplicativo às vezes travava após inicializar o SDK.

6.11.0

16/05/2023
  • Correção de um problema que às vezes fazia o aplicativo travar em alguns dispositivos quando o SDK tentava obter o Google Play Referrer

6.10.3

25/04/2023 Manutenção do SDK

6.10.1

01/03/2023
  • Corrigimos um problema que às vezes fazia com que aplicativos em dispositivos Samsung fechassem ao inicializar o SDK. Esse problema afetou aplicativos com o SDK V6.6.0 e versões posteriores.

6.10.0

13/02/2023
  • Novo domínio da AppsFlyer para comunicação entre os servidores do SDK e da AppsFlyer.
  • API setHost alterada quando valores vazios ou nulos são enviados. Saiba mais

6.9.4

06/12/2022
  • Correção de um problema em que o envio de um evento de receita de anúncios do conector do ad revenue SDK acionava uma chamada para o ouvinte da conversão.
  • Correção de um problema que às vezes fazia com que os aplicativos congelassem quando um evento de receita de anúncios era enviado do conector do ad revenue SDK.

6.9.3

28/11/2022
  • A estrutura de solicitação interna para obter dados de conversão (GCD) foi atualizada. Observação: os dados de resposta permanecem os mesmos.
  • Correção de um problema em que o SDK acionava uma solicitação GCD quando o aplicativo tinha o ConversionListener definido como nulo.

6.9.2

02/10/2022
  • Correção de um problema relacionado a um atraso na solicitação de validação de compra usando a API validateAndLogInAppPurchase.

6.9.1

19/09/2022 Manutenção do SDK

6.9.0

12/09/2022
  • Compatibilidade com Xiaomi GetApps Store Referrer adicionada.
  • Atualizamos a API interna para geração de relatórios de receita de anúncios. A partir dessa versão, apenas o conector genérico do ad revenue SDK é compatível.

6.8.2

29/08/2022
  • Correção de um problema crítico com o mecanismo de armazenamento em cache do SDK introduzido na V6.7.0, fazendo com que os eventos armazenados em cache fossem enviados várias vezes.

6.8.1
(Desativada)

24/08/2022
  • Desativada. Por favor, use a V6.8.2.

6.8.0
(Desativada)

18/07/2022
  • Desativada. Por favor, use a V6.8.2.
  • A API enableLocationCollection foi removida do SDK. O aplicativo ainda pode relatar os dados de localização do usuário enviando-os para o SDK diretamente por meio da API logLocation.
  • Adicionamos a permissão com.google.android.gms.permission.AD_ID ao AndroidManifest.xml do SDK. Saiba mais aqui.
  • Correção de um problema relacionado à otimização e ofuscação usando R8.

6.7.0
(Desativada)

19/06/2022
  • Desativada. Por favor, use a V6.8.2.
  • A maneira como o SDK lida com solicitações para os servidores da AppsFlyer foi alterada. Após essa alteração, a solicitação de relatório da primeira abertura do app (conversão) será priorizada em relação a eventos in-app e outros tipos de solicitações. Saiba mais aqui.
  • Nova API: use setDisableNetworkData para cancelar a coleta de informações sobre a rede de celular (nome da operadora).

6.6.1

16/05/2022 Manutenção do SDK

6.6.0

01/05/2022

6.5.4

23/03/2022 Manutenção do SDK

6.5.3

09/03/2022
  • Correção de bug: correção de problema com a criação de links de convite de usuário que contêm caracteres especiais.

6.5.2

26/01/2022
  • Correção de problema com a resoluão de URLs para deferred deep linking em UDL.
  • Atualizado para DexGuard 9.2
  • Refatoração e mudanças internas.

6.5.1

29/12/2021

6.5.0

07/12/2021
  • Refatoração e mudanças internas.

6.4.3

14/11/2021
  • Corrigimos um bug introduzido na V6.4.2 com LinkGenerator que causava a criação de links com parâmetros de URL ausentes.

6.4.2

24/10/2021

Foram resolvidos:

  • Parâmetro pid anexado duas vezes às URLs personalizadas gerados pelo LinkGenerator.
  • / extra adicionado ao valor af_dp ao usar o LinkGenerator para criar esquemas URI personalizados.
  • Tanto o IMEI quanto o AndroidID eram coletados, caso o aplicativo acionasse a coleta de apenas um deles.

6.4.1

17/10/2021

Resolvido o erro de compilação ao usar a versão Gradle anterior à V3.5.4.

6.4.0

12/09/2021

Nova API: setSharingFilterForPartners, que permite que você configure quais parceiros o SDK deve excluir do compartilhamento de dados.

A partir dessa versão, setSharingFilter e setSharingFilterForAllPartners foram desativados.

6.3.2

Desativação: 31/08/2024

06/06/2021

Nova API: setDisableAdvertisingIdentifiers

6.3.1

Desativação: 31/08/2024

26/05/2021
  • Nova API: performOnDeepLinking
  • Adicionada a capacidade de acionar a API de convite do usuário antes de chamar start/depois de chamar stop
  • Correção de bug: Corrigimos um problema em que a chamada para waitForCustomerUserId não era liberada mesmo após a chamada para setCustomerUserId

6.3.0

Desativação: 31/08/2024

29/04/2021
  • Correção de bug: Invocação incorreta de uma falha onConversionDataFail na solicitação de envio de um evento in-app
  • Correção de bug: coleta de métricas do sensor de movimento (para detecção de fraude)
  • Correção de bug: Correção relacionada à ofuscação no UDL
  • Atualização técnica para a OneLink API
6.2.3
Desativação: 31/08/2024
04/03/2021 Manutenção do SDK
6.2.0
Desativação: 31/08/2024
07/02/2021
6.1.4
Desativação: 31/08/2024
12/01/2021
  • Compatibilidade com DexGuard V9 adicionada
6.1.3
Desativação: 31/08/2024
24/12/2024
6.1.1
Desativação: 31/08/2024
03/12/2020
  • Suporte adicional para o Samsung Galaxy Store referrer
  • Pequenas correções de bugs e melhorias de performance.
6.1.0
Desativação: 31/08/2024
09/11/2020
6.0.1
Desativação: 31/08/2024
28/10/2020

Manutenção do SDK

6.0.0
Desativação: 31/08/2024
14/10/2020
  • Grandes alterações na funcionalidade do SDK e na API, incluindo descontinuação e alterações no nome do método. Saiba mais

Notas de versão do Android V6.0.0

Métodos removidos/desativados ou renomeados

Métodos removidos/desativados

Os seguintes métodos foram removidos do SDK:

  • sendDeepLinkData

  • trackAppLaunch

  • setPluginDeepLinkData

  • setConsumeAFDeepLinks

  • setHostName

Métodos renomeados

Nome da API (antes da V6) Nome atual da API (V6 em diante)

stopTracking

stop

setCustomerIdAndTrack

setCustomerIdAndLogSession

startTracking

start

trackLocation

logLocation

reportTrackSession

logSession

trackEvent

logEvent

setDeviceTrackingDisabled

anonymizeUser

validateAndTrackInAppPurchase

validateAndLogInAppPurchase

isStopTracking

isStopped

trackAndOpenStore

logAndOpenStore

trackCrossPromoteImpression

logCrossPromoteImpression

trackInvite

logInvite

Interface renomeada

Nome da interface (antes da V6) Nome da interface atual (V6 em diante)

AppsFlyerTrackingRequestListener

AppsFlyerRequestListener

Versões desativadas

Notas de versão do Android SDK V5

Versão Data de lançamento Somente manutenção Observações

5.4.6

09/11/2020  
  • Suporte adicional para o Huawei AppGallery referrer.

5.4.4

01/10/2020  
  • Suporte adicional para o SDK, permitindo o processamento de vários redirecionamentos de ESPs
  • Correções de bugs e manutenção

5.4.3

30/07/2020  
  • Ampliação nos recursos de logging e debugging
  • Correções de bugs e manutenção
  • Compatibilidade com o Google install referrer V2

5.4.1

30/06/2020  
  • Permite que os anunciantes controlem o compartilhamento de dados com parceiros/ad networks integradas. Saiba mais
  • Correções de bugs e manutenção

5.4.0

03/06/2020  
  • Suporte total para a coleta automática de OAID
  • Suporte a vários referrers: O SDK pode coletar referrers da Huawei e do Google
  • Melhorias na performance do SDK
  • Correções de bugs e manutenção

5.3.0

27/04/2020   
  • Acesse os dados de conversão de deep linking mais recentes a qualquer momento, por meio do método onAppOpenAttribution
  • Parâmetros adicionais disponíveis para impressões de promoção cruzada
  • Correção de bug: problemas com nomes de arquivos a. e b. no Windows corrigidos
  • O método sendDeepLinkData para obter dados de atribuição mesmo quando o usuário está vinculado a uma atividade específica foi desativado e substituído pelo método startTracking()
5.2.0 10/03/2020   
  • Permitir a inicialização do SDK em qualquer atividade
  • Recursos de segurança, registro e depuração ampliados
  • Correções de bugs e manutenção
5.1.2 19/02/2020 Sim

 

5.1.1 23/01/2020    Sim  
5.1.0 06/01/2020      
  • Direcionar para o Android 9 (API de nível 28) de acordo com os requisitos de nível de API de destino do Google
  • Melhorias nas proteções antifraude - para clientes Protect360
  • Módulo opcional para coleta de OAID (relevante para operações internas na China) - Xiaomi e Huawei (consulte https://github.com/AppsFlyerSDK/appsflyer-oaid).
  • Melhoria de estabilidade com o uso de setOneLinkCustomDomain para ESPs
5.0.2 23/12/2019     
5.0.1 12/12/2019     
5.0.0 12/11/2019
  • Correções de bugs e manutenção
  • Grandes alterações na funcionalidade do SDK e na API, incluindo descontinuação e alterações no nome do método. Saiba mais

Notas de versão do Android V5.0.0

Melhoria no tempo de resposta do SDK

A partir do SDK V5.0.0, o tempo de resposta do GCD para instalações orgânicas foi melhorado.

Métodos removidos ou renomeados

Alterações nos nomes dos métodos

Os nomes dos métodos de dados de conversão de instalação agora são os mesmos para Android e iOS. Isso afeta os métodos que lidam com:

  • dados de conversão na instalação
  • erros quando os dados não estão disponíveis
Nomes no Android antes do SDK V5   Nomes no iOS antes do SDK V5 Nome padronizado
onInstallConversionDataLoaded onConversionDataReceived onConversionDataSuccess
onInstallConversionFailure onConversionDataRequestFailure onConversionDataFail

Métodos removidos

Os métodos a seguir foram desativados nas versões anteriores do SDK. Eles foram removidos do SDK.

Android

  • setGCMProjectID (String projectNumber)
  • setGCMProjectNumber (String projectNumber)
  • setGCMProjectNumber (Context context, String projectNumber)
  • enableUninstallTracking (String senderId)
  • setAppUserId (String id)
  • setUserEmail (String email)
  • setCollectFingerPrint (boolean isCollect) 
  • getAttributionId (ContentResolver contentResolver)
  • FirebaseInstanceIdListener class (instance of FirebaseInstanceIdService)

 iOS

  • loadConversionDataWithDelegate: (id<AppsFlyerTrackerDelegate>)delegate
  • setHost:(NSString *)host 

Alterações na formatação dos dados de conversão

Nessa versão, para cada instalação ou abertura do aplicativo, o SDK retorna um objeto de mapa que contém dados de conversão (GCD), como canal de mídia e nome da campanha.  Nas versões anteriores do SDK, o GCD retornava apenas parâmetros que tinham um valor.

A partir dessa versão, todos os parâmetros são retornados, incluindo aqueles sem valor. Parâmetros sem valor têm um valor nulo.  

 Exemplo

Uma instalação é seguida de um clique na seguinte URL:

https://app.appsflyer.com/com.sample.app?pid=super_media_source&c=awesome_campaign
  &campaign_id=1234&af_sub1=promo
  

As respostas são as seguintes:

Resposta GCD antes do SDK V5 Resposta GCD a partir do SDK V5

   {
      "install_time": "2019-11-11 15:00:59.828",
      "media_source": "super_media_source",
      "orig_cost": "0.0",
      "advertising_id": "215d8172-c61e-4d0c-9eb2-aa4d0971ed8c",
      "af_status": "Non-organic",
      "is_first_launch": "true",
      "af_sub1": "promo",
      "af_click_lookback": "7d",
      "cost_cents_USD": "0",
      "iscache": "true",
      "click_time": "2019-11-11 15:00:35.102",
      "campaign": "awesome_campaign",
      "campaign_id": "1234",
  }
      

GCD retorna a mesma estrutura, independentemente dos dados. Se um parâmetro estiver vazio, ele será incluído no GCD com um valor nulo. Isso faz com que seja mais fácil para os desenvolvedores processarem o GCD sem ter que ajustar a lógica de processamento, mesmo que certos parâmetros sejam incluídos ou não. Para saber mais sobre dados de conversão em diferentes cenários, clique aqui.

Notas de versão do Android V4.0.0

Versão Data de lançamento Observações
4.11.0 22/10/2019
  • Logging aprimorado, fornecendo mais recursos de depuração para:
    • ESPs
    • Resolução de Branded Links
    • onInstallConversionData e onAppOpenAttribution.
  • Correções de bugs e manutenção
4.10.3 15/09/2019
  • Correções de bugs e manutenção
  • Compatibilidade com Open Advertiser ID (OAID)  
4.10.2
4.10.1 01/07/2019 Correções de bugs e manutenção
4.10.0 15/05/2019
  • Melhorias do SDK para desenvolvedores que usam o ProGuard.
  • Correções de bugs e manutenção
4.9.0 17/03/2019
  • API setResolveDeepLinkURLs para solucionar OneLinks agrupados com outro Universal Link
  • Correção para gravação de notificações push quando a gravação descartada do payload anterior continha o mesmo pid e ainda estava na memória.
  • Correção de erro de digitação de af_county para af_country
  • Correções de bugs e manutenção
4.8.20 13/02/2019
  • Recursos de zero-rating aprimorados para provedores de celular
  • Correções de bugs e manutenção
4.8.19 26/12/2018
  • Problema corrigido em que o método waitForCustomerUserId() interrompe generateLink
  • Correções de bugs e manutenção
4.8.18 11/11/2018
  • Correção de problemas de deep linking de atividades em trampolim
  • Precisão aprimorada de reengajamento ao sair do plano de fundo para o primeiro plano
  • Correções de bugs e manutenção
4.8.17 02/11/2018 Correção de um problema relacionado a conflitos no ProGuard, causando perda de dados de inicialização do aplicativo em alguns casos. Esse problema afetou apenas a versão 4.8.16 do SDK
4.8.16 31/10/2018 Correções de bugs e manutenção
4.8.15 27/08/2018
  • Eventos adicionais do SDK: Inscrição, Iniciar avaliação, Clique em anúncio, Visualização de anúncio
  • Correções de bugs e manutenção
4.8.14 31/07/2018
  • Foram adicionadas as APIs setOutOfStore e GetOutOfStore para definir dinamicamente o valor AF_STORE
  • Foram adicionadas as APIs onTrackingRequestFailure e onTrackingRequestSuccess para o recebimento da confirmação de que a AppsFlyer recebeu com sucesso os servidores de solicitação de rastreamento
4.8.13 20/06/2018
  • Correção de um bug em um caso extremo em que o IMEI estava ausente quando passado explicitamente pela API setImeiData
  • Correções de bugs e manutenção
4.8.12 27/05/2018
  • Corrigimos uma falha do aplicativo durante o uso do teste JUnit que usa Robolectric
  • Correções de bugs e manutenção
4.8.11 02/05/2018 Correções de bugs e manutenção
4.8.10 26/04/2018
  • API setPreinstallAttribution adicionada
  • Correções de bugs e manutenção
4.8.9 02/04/2018
  • Coleta de IMEI somente quando o GooglePlayServices não existe no dispositivo e não é possível recuperar o GAID nesse dispositivo
  • Correções de bugs e manutenção
4.8.8 11/03/2018
  • API adicionada para atrasar a inicialização do SDK até que o customerUserID seja fornecido
  • Correções de bugs e manutenção.
4.8.7 25/01/2018
  • API isStopTracking para encerrar todas as atividades do SDK
  • Parâmetro de evento af_content
4.8.5 29/11/2017
  • Compatibilidade com a nova Google referrer API
  • Novo método init que recebe contexto
4.8.4 14/11/2017
  • Adicionamos um sinalizador para getConversionData is_first_launch, que indica se essa é a primeira inicialização do aplicativo. Esse sinalizador permite que os desenvolvedores identifiquem a primeira inicialização do aplicativo na resposta do callback getConversionData, que é retornada em cada inicialização. Os valores possíveis para is_first_launch são "true" ou "false"
  • Correções de bugs e manutenção
4.8.3 27/09/2017 Suporte adicional para dados de HTTP referrer em getConersionData
4.8.2 19/09/2017 Correção em sendDeepLinkData(this) para aplicativos com deep link para várias atividades
4.8.1 17/09/2017 Proteção aprimorada contra eventos in-app chamados antes da inicialização do SDK
4.8.0 03/09/2017
  • APIs de convite de usuário
  • APIs de promoção cruzada
  • Personalizar tempo entre sessões
  • Suporte para Zero Rating para operadoras de celular
  • Parâmetro de evento adicional af_projected_revenue
  • Correções de bugs e manutenção
  • Método init adicional introduzido - AppsFlyerLib.getInstance().init(AF_DEV_KEY,conversionDataListener);
4.7.4 28/06/2017 Manipulação aprimorada de vários desligamentos ScheduledExecutorService
4.7.3 06/06/2017 Aprimoramentos para integração mParticle
4.7.2 22/05/2017
  • Corrigimos um pequeno problema de vazamento de memória
  • Precisão aprimorada da mensuração de desinstalação
  • Correção do aviso do ProGaurd que afetava a mensuração de desinstalação
  • Correções de bugs e manutenção
4.7.1 22/02/2017 Corrigimos um aviso acionado pelo ProGuard
4.7.0 13/02/2017
  • Adicionamos mais parâmetros de eventos
  • Suporte para a mensuração de desinstalação no Firebase
  • Correções de bugs e manutenção