Notas de versão do SDK da AppsFlyer

Para:

Profissionais de marketing Desenvolvedores

Última atualização: 12 de Março de 2023 14:43

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.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		Resolução de deeplink com UDL para aplicativos que usam a opção Out-of-Store with Channel.
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.2`com `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		Nova API: `setPartnerData`
6.1.4	2021-01-12		Compatibilidade com DexGuard V9 adicionada
6.1.3	2020-12-24		Nova API: `addPushNotificationDeepLinkPath` (compatível com Movable Ink)
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		Compatibilidade com API unificada de deep linking adicionada
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:


   {
      "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",
  }


   {
      "adgroup": null,
      "campaign": "awesome_campaign",
      "media_source": "super_media_source",
      "adset_id": null,
      "campaign_id": 1234,
      "iscache": true,
      "install_time": "2019-11-11 15:00:59.828",
      "adgroup_id": null,
      "af_sub5": null,
      "click_time": "2019-11-11 15:00:35.102",
      "agency": null,
      "cost_cents_USD": "0",
      "advertising_id": "215d8172-c61e-4d0c-9eb2-aa4d0971ed8",
      "adset": null,
      "af_sub3": null,
      "af_siteid": null,
      "http_referrer": null,
      "orig_cost": "0.0",
      "af_sub4": null,
      "af_cpi": null,
      "af_sub1": "promo",
      "af_click_lookback": "7d",
      "af_sub2": null,
      "af_status": "Non-organic",
      "is_first_launch": "true",
      "retargeting_conversion_type": "none"
  }

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