Notas de lançamento do iOS SDK da AppsFlyer

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

iOS SDK V6  

Guias de integração do iOS SDK para desenvolvedores

Versão Data de lançamento Observações
6.16.1 18/02/2025
  • API atualizada para o envio manual de dados de consentimento de DMA para a AppsFlyer.
6.16.0 19/01/2025
  • Suporte adicionado para as APIs StoreKit 2 da Apple para relatórios de assinatura e compras in-app através do Purchase Connector. Atualmente, esse recurso está em beta fechado.
6.15.3 23/09/2024 Manutenção do SDK
6.15.2 28/08/2o24
  • Corrigimos um problema com a transmissão de eventos no Purchase Connector. Essa correção não afeta nenhuma versão de produção do Purchase Connector e está relacionada à sua atualização para a versão 6.15.x.
6.15.1 19/08/2024
  • Corrigimos um problema com a detecção de reinstalação que ocorria quando dois ou mais aplicativos do mesmo fornecedor estavam instalados no dispositivo.
6.15.0 06/08/2024
  • Adicionamos a logAdRevenue API para enviar dados de receita de anúncios para a AppsFlyer. Atenção: A partir dessa versão, o AdRevenue Connector não deve mais ser usado; ele deve ser substituído pelo método logAdRevenue. Para mais detalhes, consulte aqui.
  • Atualizações internas relacionadas ao Purchase Connector. Os aplicativos que usam o Purchase Connector e atualizam para essa versão do SDK também devem atualizar seu Purchase Connector para a versão 6.15.0.
6.14.6 24/07/2024
  • Corrigimos um problema em que o SDK estava fazendo chamadas redundantes para a getConversionData API (GCD) ao iniciar uma nova sessão; isso não afeta a mensuração.
6.14.5 03/07/2024
  • Corrigimos um problema em que o SDK enviava os dados de consentimento manual configurados pelo aplicativo, mesmo que o código para enviar o consentimento manual tivesse sido removido.
6.14.4 10/06/2024
6.14.3 26/04/2024
  • Corrigimos a mesclagem automatizada do Privacy Manifest para apps que usam o Cocoapods.
6.14.2 19/04/2024 Manutenção do SDK
6.14.1 18/04/2024
  • Adicionamos suporte para o fluxo atualizado de validação de compras. Atualmente, esse recurso está em beta fechado. Saiba mais.
6.14.0 07/04/2024
  • Adicionamos suporte para Privacy Manifest. Saiba mais sobre o Privacy Manifest na AppsFlyer
  • Adicionamos uma assinatura XCFramework ao SDK, permitindo que os desenvolvedores que usam o Xcode 15 validem a origem e a autenticidade do SDK.
6.13.2 26/03/2024
6.13.1 05/03/2024
  • Corrigimos o problema de envio de dados de consentimento para usuários aos quais a GDPR não se aplica em um fluxo de consentimento de CMP (DMA).
6.13.0 
Desativada
08/02/2024
  • Adicionamos suporte para a nova política de consentimento do Google na UE 
6.12.3 04/01/2024
  • Um novo parâmetro de original_link foi adicionado ao callback de deep linking no fluxo de resolução de provedores de serviços de e-mail (ESPs).
  • Todas as referências ao iAd Framework foram removidas.
6.12.2 24/08/2023 Manutenção do SDK
6.12.1 20/07/2023
  • Correção de um problema na SKAdNetwork 4.0 que fazia com que valores da conversão parciais fossem relatados como "None"
  • Correção de uma falha na implementação do tvOS
6.12.0 28/06/2023 Suporte de bitcode removido do SDK
6.11.2 13/06/2023 Correção de um problema identificado na v6.11.0, em que ao chamar validateAndLogInAppPurchase (a API legada para validação de compra e logging) o log do evento de compra não ocorria. 

Importante: Se você estiver usando v6.11.0 ou v6.11.1 e a validateAndLogInAppPurchase API, atualize para essa versão.
6.11.1 24/05/2023 Manutenção do SDK
6.11.0 25/04/2023
  • Novo nome de domínio da AppsFlyer na URL usada pelo SDK para enviar solicitações aos servidores da AppsFlyer.
  • Alteração no comportamento da API setHost quando valores vazios ou nulos são enviados.  Saiba mais
6.10.1 02/04/2023 O parâmetro link foi adicionado ao payload UDL dos cenários de Direct Deep Linkinig (deep linking direto).
6.10.0 15/02/2023 Suporte para SKAdNetwork 4.0. Saiba mais sobre a solução da AppsFlyer para SKAdNetwork
6.9.2 31/01/2023 A estrutura de solicitação interna para obter dados de conversão (GCD) foi atualizada. Observação: os dados de resposta permanecem os mesmos.
6.9.1 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.
6.9.0 06/11/2022

A API interna para relatórios AdRevenue foi atualizada. A partir dessa versão, somente o conector genérico (Generic Connector) para AdRevenue é compatível.

Essa versão do SDK é compatível com o AdRevenue Connector V6.9.0.

6.8.1 09/08/2022 Detecção de reinstalação: aprimoramos a capacidade de detectar e relatar reinstalações usando o armazenamento no dispositivo. Esse recurso pode ser controlado no dashboard da AppsFlyer na página de Configuração do aplicativo.
6.8.0
Desativação:
03/03/2025
19/07/2022 Para detecção de reinstalação, use o SDK V6.8.1+
6.7.0
Desativação:
03/03/2025
19/06/2022

Atualize a implementação da SKAdNetwork para usar a Apple API atualizada, updatePostbackConversionValue, introduzida no iOS 15.4.

Isso não afeta os dados enviados da SKAdNetwork e não requer nenhuma alteração no código do aplicativo.

6.6.1
Desativação:
03/03/2025
16/05/2022 Manutenção do SDK
6.6.0
Desativação:
03/03/2025
01/05/2022 Adicionamos mais parâmetros ao callback didResolveDeepLink da UDL para o fluxo Direct Deep Linking (usuários existentes). Clique aqui para mais informações.
6.5.4
Desativação:
03/03/2025
23/03/2022 Manutenção do SDK
6.5.3
Desativação:
03/03/2025
02/03/2022 Correção de bug: correção de um problema com uma invocação dupla de didResolveDeepLink em links baseados em esquemas URI.
6.5.2
Desativação:
03/03/2025
26/01/2022 Manutenção do SDK
6.5.1
Desativação:
03/03/2025
03/01/2022 Manutenção do SDK
6.5.0
Desativação:
03/03/2025
22/12/2021 Refatoração e mudanças internas.
6.4.4
Desativação:
03/03/2025
12/12/2021 Manutenção do SDK
6.4.3
Desativação:
03/03/2025
30/11/2021 Correção de estabilidade para MacOS 10.14.6 com xcframework.
6.4.2
Desativação:
03/03/2025
28/10/2021 Manutenção do SDK
6.4.1
Desativação:
03/03/2025
24/10/2021 Estabilidade resolvida em aplicativos Unity.
6.4.0
Desativação:
03/03/2025
12/09/2021

API adicionada: 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.5
Desativação: 31/08/2024
19/08/2021

API adicionada: setCurrentDeviceLanguage

A partir dessa versão, o idioma não é mais coletado automaticamente pelo SDK.

6.3.4
Desativação: 31/08/2024
21/07/2021
  • Correção de bug: correção de um problema com a execução do SDK em simuladores XCode 12.5
  • Pequenas correções e atualizações.
6.3.2
Desativação: 31/08/2024
17/06/2021 Logs de debug aprimorados.
6.3.1
Desativação: 31/08/2024
02/06/2021 Manutenção do SDK
6.3.0
Desativação: 31/08/2024
13/05/2021
  • Suporte Apple Silicon: adicionamos suporte para executar o SDK em um simulador usando dispositivos Mac com o chipset M1
  • A partir dessa versão, o SDK é compatível com iOS 9+. O iOS 8 não é mais compatível.
  • SDK de modo estrito no iOS: suporte adicionado para o gerenciador de dependências Carthage
  • Atualização técnica para a OneLink API
6.2.6
Desativação: 31/08/2024
25/04/2021
  • Correção de bug: as regras da SKAdNetwork não carregavam quando a inicialização do SDK era feita após didFinishLaunchingWithOptions
  • Correção de bug: caso extremo, em quewaitForATTUserAuthorization fazia com que o evento de inicialização fosse enviado sem IDFA, mesmo em casos em que o usuário consentia com o compartilhamento de dados
  • Permitir que o SDK seja executado em dispositivos iOS 8
  • Limpeza e remoção de código e dados não utilizados
6.2.5
Desativação: 31/08/2024
06/04/2021

Refatoração, limpeza e remoção de dados não utilizados do SDK.

A partir dessa versão:

  • O método setShouldCollectDeviceName foi desativado e não retorna o nome do dispositivosetShouldCollectDeviceName
  • O parâmetro wifi enviado do SDK está definido como False
6.2.4
Desativação: 31/08/2024
15/03/2021

Correção de bug relacionado ao modo de mensuração de receita SKAdNetwork e eventos in-app que contêm o parâmetro AF_REVENUE.

A partir desta versão, no caso de mensuração de receita: qualquer evento contendo AF_REVENUE afeta o valor de conversão. Antes dessa alteração, o valor de conversão era definido apenas se estivesse na estrutura do evento AF_PURCHASE

Atenção: se você implementar a mensuração de receita da SKAdNetwork, deverá atualizar para essa versão.

6.2.3
Desativação: 31/08/2024
07/03/2021

Correção de bug relacionado à chamada de updateConversionValue da SKAdNetwork.

 

6.2.2
Desativação: 31/08/2024
18/02/2021 Manutenção do SDK
6.2.1
Desativação: 31/08/2024
15/02/2021 Suporte para relatórios de eventos por S2S
6.2.0
Desativação: 31/08/2024
07/02/2021 API adicional: setPartnerData
6.1.4
Desativação: 31/08/2024
12/01/2021 Manutenção do SDK
6.1.3
Desativação: 31/08/2024
24/12/2024
6.1.2
Desativação: 31/08/2024
03/12/2020 Manutenção do SDK
6.1.1
Desativação: 31/08/2024
17/11/2020 Introdução ao modo estrito do SDK
6.1.0
Desativação: 31/08/2024
09/11/2020 Suporte para Unified deep linking API
6.0.8
Desativação: 31/08/2024
28/10/2020 Suporte para a atribuição de Apple App Clips.
6.0.7
Desativação: 31/08/2024
21/10/2020 Manutenção do SDK
6.0.6
Desativação: 31/08/2024
20/10/2020 Manutenção do SDK
6.0.5
Desativação: 31/08/2024
08/10/2020 Manutenção do SDK
6.0.4
Desativação: 31/08/2024
30/09/2020 Suporte a vários redirecionamentos de ESPs
6.0.3
Desativação: 31/08/2024
06/09/2020
  • Alteração no nome da API:
    waitForAdvertisingIdentifier --> waitForATTUserAuthorization
  • O SDK coleta o IDFA por padrão para iOS 14 (assim como para versões anteriores do iOS)
6.8.1 (Desativada) 27/08/2020
  • Alteração no nome da API:
    deviceLoggingDisabled --> anonymizeUser
  • A caixa de diálogo AppTrackingTransparency (ATT) é necessária para coletar o IDFA para iOS 14
  • Adicionamos suporte para atribuição de promoção cruzada com IDFV

6.0.1 beta

[desativada]

06/08/2020
  • Suporte adicionado para atribuição da SKAdNetwork, com o intuito de ajudar os anunciantes a mensurar o sucesso das suas campanhas sem violar a privacidade do usuário

6.0.0 beta

[desativada]

04/08/2020
  • Recursos de debugging estendidos
  • Grandes alterações na API e na funcionalidade do SDK. Saiba mais

Notas de versão do iOS V6.0.0

Métodos adicionados, removidos ou renomeados

Métodos adicionados

Os seguintes métodos foram adicionados ao SDK:

  • waitForAdvertisingIdentifier

Métodos removidos

Os seguintes métodos foram removidos do SDK:

  • disableAppleAdSupportTracking

Métodos renomeados

Nome da API (antes da V6) Nome atual da API (V6 em diante)
AppsFlyerTracker AppsFlyerLib
disableIAdTracking disableCollectASA
trackAppLaunchWithCompletionHandler startWithCompletionHandler
trackLocation logLocationEvent
trackAppLaunch iniciar
trackEvent logEvent
disableAppleAdSupportTracking disableAdvertiserIdentifier
validateAndTrackInAppPurchase validateAndLogInAppPurchase
isStopTracking isStopped
deviceTrackingDisabled deviceLoggingDisabled
sharedTracker (Objective C) shared

Suporte para App Tracking Transparency (ATT)

O SDK do iOS oferece suporte à coleta de IDFA no iOS 14+ por meio da estrutura App Tracking Transparency. Para mais informações:

Versões desativadas

iOS SDK V5

Versão Data de lançamento Observações
5.4.4 23/08/2020 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
5.4.1 30/06/2020
  • Permite que os anunciantes controlem o compartilhamento de dados com parceiros/ad networks integradas. Saiba mais
  • Método onAppOpenAttribution aprimorado para URLs longas de Universal Links: os parâmetros do link são devolvidos já analisados
  • Correções de bugs e manutenção
5.4.0 03/06/2020 Suporte ao projeto MAC Catalyst
5.3.0 27/04/2020 
  • Acesse os dados de conversão de deep linking direto mais recentes a qualquer momento, por meio do método onAppOpenAttribution
  • Parâmetros adicionais disponíveis para impressões de promoção cruzada
  • Aplicativos principais e extensões de aplicativo obtêm o mesmo ID da AppsFlyer, portanto, os eventos in-app são agrupados de maneira semelhante
  • Correções de bugs e manutenção
5.2.0 10/03/2020 
  • Ampliação nos recursos de logging e debugging
  • Correções de bugs e manutenção
5.1.0 23/12/2019
  • Melhor interoperabilidade Obj-C - Swift
  • Correções de bugs e manutenção
5.0.0 12/11/2019
  • Correções de bugs e manutenção
  • Principais alterações na funcionalidade e na API do SDK. Saiba mais

Notas de versão do iOS 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 quando os dados não estão disponíveis
Nome do 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 iOS 4.0.0

Leitura adicional: Política de controle de versões do SDK da AppsFlyer

Versão Data de lançamento Observações
4.11.2 07/11/2019 Correções de bugs e manutenção
4.11.1 31/10/2019 Correções de bugs e manutenção
4.11.0 17/10/2019
  • Não há mais suporte para iOS 7. iOS 8 é a versão mínima compatível.
  • Logging aprimorado para melhores recursos de debug, resolução de ESP e Branded Links, assim como para onInstallConversionData e onAppOpenAttribution.
  • Alcance aprimorado de Apple Search Ads.
4.10.4 12/09/2019
  • Atualização para a recuperação necessária do push token do iOS 13 para a mensuração de desinstalação
  • Correções de bugs e manutenção
4.10.3 16/07/2019 Correções de bugs e manutenção
4.10.2 02/07/2019 Correções de bugs e manutenção
4.10.1 01/07/2019 Correções de bugs e manutenção
4.10.0 14/05/2019
  • API trackAppLaunchWithCompletionHandler para lidar com sucesso ou falha na inicialização do aplicativo de rastreamento
  • API completionHandler para lidar com sucesso ou falha no registro de eventos in-app
  • Correções de bugs e manutenção
4.9.0 18/03/2019
  • API setResolveDeepLinkURLs para solucionar OneLinks agrupados com outro Universal Link
  • Uso de UIPasteboard removido para atribuição do Meta Ads para iOS 7 e versões anteriores
  • Correções de bugs e manutenção
4.8.12 13/02/2019
  • Recursos de zero-rating aprimorados para provedores de celular
  • Recursos de zero-rating aprimorados para provedores de celular
  • Correções de bugs e manutenção
4.8.11 09/01/2019
  • Problema causado pela quebra de generateLink pela API waitForCustomerUserId () corrigido
4.8.10 31/10/2018
  • Correção a uma condição de corrida em que continueUserActivity era invocado após applicationDidBecomeActive, fazendo com que onAppOpenAttribution não fosse chamado
  • ValidAndTrackInAppPurchase ignora a correção de parâmetros extras
  • Correções de bugs e manutenção
4.8.9 27/08/2018
  • Novos eventos de SDK: Inscrição, Iniciar avaliação, Clique em anúncio, Visualização de anúncio
  • Correções de bugs e manutenção
4.8.8 30/07/2018
  • Correção de um problema em que, ao usar is_first_launch por meio de JSONSerialiser, um número inteiro e não booleano era retornado
  • Correções de bugs e manutenção 4.8.7
4.8.7 22/07/2018 Correções de bugs e manutenção
4.8.6 18/06/2018 Correções de bugs e manutenção
4.8.5 29/05/2018 Correções de bugs e manutenção
4.8.4 03/05/2018 Correções de bugs e manutenção
4.8.3 25/01/2018
  • Correções de bugs e manutenção
  • shouldCollectDeviceName API
  • parâmetro de evento af_content
  • shouldCollectDeviceName API
  • parâmetro de evento af_content