Notas de versão do SDK da AppsFlyer

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

Visão geral: Notas de versão do Android SDK a partir da V4.x.

Android SDK V6 

Integração do SDK para Android para profissionais de marketing

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

6.12.2

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

6.12.1

 29/06/2023  
  • Corrigido um problema em que o lançamento da Play Store era atrasado na promoção cruzada.
  • Corrigido 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  
  • Corrigido um bug que fazia o aplicativo travar em alguns dispositivos.

6.11.1

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

6.11.0

 2023-05-16  
  • 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 Sim  

6.10.1

 2023-03-01  
  • Foi corrigido um problema que às vezes fazia com que aplicativos em dispositivos Samsung fechassem ao inicializar o SDK. Esse problema afetou aplicativos com SDK V6.6.0 e superior.

6.10.0

 2023-02-13  
  • 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

 2022-12-6  
  • Correção de um problema em que o envio de um evento de ad revenue 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

 2022-11-28  
  • 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

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

6.9.1

 2022-09-19 Sim  

6.9.0

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

6.8.2

 2022-08-29  
  • 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
(Descontinuado)

 2022-08-24 Sim
  • Descontinuado. Por favor, use a V6.8.2.

6.8.0
(Descontinuado)

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

6.7.0
(Descontinuado)

 2022-06-19  
  • Descontinuado. 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 do primeiro aplicativo aberto (conversão) será priorizada em relação a eventos in-app e outros tipos de solicitações. Leia mais sobre isso aqui.
  • Nova API: setDisableNetworkData para cancelar a coleta de informações sobre a rede celular (nome da operadora).

6.6.1

 2022-05-16 Sim  

6.6.0

 2022-05-01  
  • Adicionados mais parâmetros ao retorno de chamada onDeepLinking da UDL para o fluxo Direct Deep Linking (usuários existentes). Para mais informações.

6.5.4

 2022-03-23 Sim  

6.5.3

 2022-03-09  
  • 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

 2022-01-26  
  • Correção de problema ao resolver URL para deferred deep linking em UDL.
  • Atualizado para DexGuard 9.2
  • Refatoração e mudanças internas.

6.5.1

 2021-12-29   .

6.5.0

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

6.4.3

 2021-11-14  
  • Corrigido um bug introduzido na  V6.4.2com LinkGenerator causando a criação de links com parâmetros de URL ausentes.

6.4.2

 2021-10-24  

Foram resolvidos:

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

6.4.1

 2021-10-17  

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

6.4.0

 2021-09-12  

Nova API: setSharingFilterForPartners permite configurar quais parceiros o SDK deve excluir do compartilhamento de dados.

A partir desta versão, setSharingFilter e setSharingFilterForAllPartners se tornam obsoletos.
6.3.2 2021-06-06  

Nova API: setDisableAdvertisingIdentifiers
6.3.1 2021-05-26  
  • 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: correção de um problema em que uma chamada de waitForCustomerUserId não era liberada mesmo depois de chamar setCustomerUserId
6.3.0 2021-04-29  
  • Correção de bug: chamada incorreta de onConversionDataFail após falha de solicitação de envio de 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 para UDL
  • Atualização técnica para a API do OneLink
6.2.3 2021-03-04 Sim  
6.2.0 2021-02-07  
6.1.4 2021-01-12  
  • Compatibilidade com DexGuard V9 adicionada
6.1.3 2020-12-24  
6.1.1 2020-12-03  
  • Compatibilidade adicionada com o referenciador Samsung Galaxy Store
  • Pequenas correções de bugs e melhorias de performance.
6.1.0 2020-11-09  
6.0.1 2020-10-28 Sim

 
6.0.0 14/10/2020  
  • Principais 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/descontinuados ou renomeados

Métodos removidos/descontinuados

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 e posterior)

stopTracking

parar

setCustomerIdAndTrack

setCustomerIdAndLogSession

startTracking

iniciar

trackLocation

logLocation

reportTrackSession

logSession

trackEvent

logEvent

setDeviceTrackingDisabled

anonymizeUser

validateAndTrackInAppPurchase

validateAndLogInAppPurchase

isStopTracking

isStopped

trackAndOpenStore

logAndOpenStore

trackCrossPromoteImpression

logCrossPromoteImpression

trackInvite

logInvite

Interface renomeada

Nome da interface (antes de V6) Nome da interface atual (V6 e posterior)

AppsFlyerTrackingRequestListener

AppsFlyerRequestListener

SDK do Android V5 

Notas de versão do Android SDK V5

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

5.4.6

 2020-11-09  
  • Compatibilidade com referenciador Huawei AppGallery adicionada.

5.4.4

 2020-10-01  
  • Compatibilidade com o SDK adicionada para lidar com vários redirecionamentos de ESPs
  • Correções de bugs e manutenção

5.4.3

 2020-07-30  
  • Logs estendidos de registro e depuração
  • Correções de bugs e manutenção
  • Compatibilidade com o referenciador de instalação do Google V2

5.4.1

 2020-06-30  
  • Permita 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

 2020-06-03  
  • Compatibilidade completa com coleta automática de OAID
  • Suporte a vários referenciadores: o SDK pode coletar referenciadores da Huawei e do Google
  • Melhorias na performance do SDK
  • Correções de bugs e manutenção

5.3.0

 2020-04-27   
  • 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 se o usuário estiver vinculado a uma atividade específica foi descontinuado em favor do método startTracking()
5.2.0 2020-03-10   
  • Permitir a inicialização do SDK em qualquer atividade
  • Recursos estendidos de segurança, registro e depuração
  • Correções de bugs e manutenção
5.1.2 2020-02-19 Sim

 
5.1.1 2020-01-23    Sim  
5.1.0 2020-01-06      
  • 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 coletar OAID (relevante para a China doméstica) - Xiaomi e Huawei (consulte https://github.com/AppsFlyerSDK/appsflyer-oaid).
  • Melhoria de estabilidade ao usar setOneLinkCustomDomain para ESPs

Notas de lançamento 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 no nome do método

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 se os dados não estiverem disponíveis
Nome do Android antes do SDK V5  Nome do iOS antes do SDK V5 Nome padronizado
onInstallConversionDataLoaded onConversionDataReceived onConversionDataSuccess
onInstallConversionFailure onConversionDataRequestFailure onConversionDataFail

Métodos removidos

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

Android

  • setGCMProjectID (String projectNumber)
  • setGCMProjectNumber (String projectNumber)
  • setGCMProjectNumber (Contexto de contexto, String projectNumber)
  • enableUninstallTracking (String senderId)
  • setAppUserId (String id)
  • setUserEmail (String email)
  • setCollectFingerPrint (boolean isCollect) 
  • getAttributionId (ContentResolver contentResolver)
  • Classe FirebaseInstanceIdListener (instância de FirebaseInstanceIdService)

 iOS

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

Alterações para obter o formato dos dados de conversão

Nesta 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 desta versão, todos os parâmetros são retornados, inclusive aqueles sem valor. Parâmetros sem valor têm um valor nulo. 

 Exemplo

Uma instalação segue 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 iniciando o 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 do GCD, independentemente de certos parâmetros serem incluídos ou não. Para saber mais sobre dados de conversão em diferentes cenários, consulte aqui.

Versões descontinuadas

    Leitura relacionada: Política de controle de versão do SDK da AppsFlyer

Versão Data de lançamento Observações
5.0.2 23-12-2019     
5.0.1 2019-12-12     
5.0.0 12/11/2019
  • Correções de bugs e manutenção
  • Principais alterações na funcionalidade do SDK e na API, incluindo descontinuação e alterações no nome do método. Saiba mais
4.11.0 22-10-2019
  • Registro aprimorado para melhores recursos de depuração para:
    • ESP
    • Resolução de Branded Links
    • onInstallConversionData and 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 14-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 resolver OneLinks agrupados com outro Universal Link
  • Correção para gravação de notificação push quando a gravação de notificação push descartada da carga 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 classificação zero aprimorados para provedores de celular
  • Correções de bugs e manutenção
4.8.19 26-12-2018
  • Correção do problema em que o método waitForCustomerUserId() quebra generateLink
  • Correções de bugs e manutenção
4.8.18 11-11-2018
  • Correção de problemas de deep linking de atividades de trampolim
  • Precisão aprimorada de reengajamento ao mover entre o plano de fundo e 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. Este 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: Assinatura, Iniciar avaliação, Clique no anúncio, Visualização do anúncio
  • Correções de bugs e manutenção
4.8.14 31-07-2018
  • Added setOutOfStore and getOutOfStore APIs for dynamically setting the AF_STORE value
  • Adicionadas APIs onTrackingRequestFailure e onTrackingRequestSuccess para receber uma 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
  • Corrigida a falha do aplicativo ao usar o 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
  • Colete o IMEI somente se o GooglePlayServices não existir no dispositivo e não for 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 API de referenciador do Google
  • Novo método init que recebe contexto
4.8.4 14-11-2017
  • Adicionado um sinalizador para getConversionData is_first_launch que indica se este é a primeira inicialização do aplicativo. Esse sinalizador permite que os desenvolvedores identifiquem a primeira inicialização do aplicativo facilmente na resposta de retorno de chamada 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 Compatibilidade adicionada com dados do referenciador HTTP 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
  • Corrigido problema menor 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 Aviso corrigido acionado pelo ProGuard
4.7.0 13-02-2017
  • Parâmetros de evento adicionais
  • Compatibilidade com mensuração de desinstalação baseada no Firebase
  • Correções de bugs e manutenção

Checksums do SDK Android

A AppsFlyer usa checksums md5:

Checksums V6

Versão do Android SDK Checksum
6.6.1 1ec98047f8cb4145137f3c97459d052c
6.6.0 6f5aef27ea407c7fc1691b52ff800c61
6.5.4 c71aacbf201449dd5ef1158b55bd2ad0
6.5.3 7db44f0852be1c94fe36cc535b7c61f7
6.5.2 71e3a16c4278f857cd86b7b05aedd066
6.5.1 261928cfc55b27a6c2ab19cf9081d705
6.5.0 2a6d500fd4939a8faa47bbbba97288b6
6.4.3 c62f9359d6b5497d54e248c526c5f547
6.4.2 dc385fb62eaf68aff2e7f9c1c0ed19ea
6.4.1 94945db2c0e81baab79535393f210f1b
6.4.0 d7910a35901d4299b54259f1c1bbe2d6
6.3.2 46bc92bb2eed1416de28ccccb3a28620
6.3.1 ca47af77ffbcd7525e82d0bdaaef5b91
6.3.0 f969bb5a62885e8084794d5334787275
6.2.3 bab1309f77acd1f0453372150c82694a
6.2.0 fc727698c7b8bfb1ca448726492931b4
6.1.4 983785b1c30a15e8fac029e370bb3b73
6.1.3 c0392a091659dc445a1014e14da6a31a
6.1.1 0a18fafb2826c90b3388b371a3cbdeec
6.1.0 e8d6df04ac2642b2d7b16efb57f315e9
6.0.1 9ebeb6f4f49476667c07d0e8eb1aa2e8
6.0.0 cff3d453ea94e67182f5b1b023aeb1c1

Checksums V5

Versão do Android SDK Checksum
5.4.6 4f1bdc33ac0d6dd3f9b75411c3c0a06c
5.4.4 13a04913cf61276238f54e5e2d73e88d
5.4.3 7b1caef46942c70edcd2e59cad69e439
5.4.1 e4eb21c0030f376857b53e2e30022fc8
5.4.0 8c0270f6c3e7e58b1db42be82cc341d8
5.3.0 d602dd28d9ee807855e5426d6a9b7ebf
5.2.0 64fe94447def6d99549d3274ce908f09
5.1.2 1a7dbb23aad32d697835f3ec29337ca9
5.1.1 dfea6a49e6ae57fc2c700f6dcd904bc1
5.1.0 89cc7e08a0430180e64f3cccf955768f
5.0.2 c113618ea379531cba6ce42bc4c79d72
5.0.1 db0502faa5b02102dd99ac6cec666d04
5.0.0 98f1f78ae5f63cb4f40ba838d3d1be22

Checksums V4

Versão do Android SDK Checksum
4.10.3 855186d68912810fa47897262a9ba0a0
4.10.2 13ed5716d5a8583eeee527f01bd2a69d
4.10.1 ab3e49bb4640990267466b7852cd3de7
4.10.0 b5fb55ee76cd6a742d9bd25b910745a1
4.9.0 afa49524ddceda28ca1648946489a6b0
4.8.20 2f59d0f8db09b92f8261475a1d0807d0
4.8.19 baf8fa419f38de52cef6091de32aca86
4.8.18 3a0641720811a25542449f1927daf13e
4.8.17 3a0641720811a25542449f1927daf13e
4.8.16 501be427b0c2a831e148649131ce3fc0
4.8.15 7b6759a006d72d3a7c78ec80160c3502
4.8.14 bc4facd80958d0600b4d000104e524d9
4.8.13 bc4facd80958d0600b4d000104e524d9
4.8.12 171569002d93fb8d49787b363192973f
4.8.11 4419af159a42e4ee7a218ef8615e2abb
4.8.10 468ad04e4a2088ba7af9c45d42f4ed6d
4.8.9 9a923bbbf3f6c7cc19b900e49644da2c
4.8.8 6dee4814986061a0723cc9f844796e2e
4.8.7 ca13997ccb781a5935e91983b7be81ea
4.8.6 da117a3e9e05df7dd28297df762cfbfa
4.8.5 f8ea07b8a60d664541686ba7064730f5
4.8.4 b10f185c1094cf283b11339810a47c87
4.8.3 7f94ec175b948c5009bfbfe2fb25b2b0
4.8.2 3e34b55e13cd3f8d387b1a33c20105eb
4.8.1 6c2930d2997a7b2b6ab7b3ecf0e3135b
4.8.1 468ad04e4a2088ba7af9c45d42f4ed6d
4.8.1 4419af159a42e4ee7a218ef8615e2abb mais recente
4.8.0 32d67577ce59b2072475e509579baece
4.7.4 7e649e6a1cf8999ca39b05402946b3d6
4.7.3 e30c020f8ee5dd3af274fa94ef414a38
4.7.2 945aaaca554aa8b2f96219f25eed9777
4.7.1 862c349025e4725d4e5044a190c60337
4.7.0 b060ad140ffd0c8f2b3febb26122d173