Notas de lançamento do iOS SDK da AppsFlyer

Visão geral: 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 Notas

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 
6.8.1(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 relatado 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.0ou 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 do aplicativo usando o armazenamento no dispositivo. Esse recurso pode ser alterado no dashboard da AppsFlyer na página de configuração do aplicativo.

6.8.0
6.8.1(Desativada)

19/07/2022 Para detecção de reinstalação, use o SDK V6.8.1+

6.7.0

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

16/05/2022 Manutenção do SDK

6.6.0

01/05/2022 Adicionados mais parâmetros ao callback da UDL para o fluxo Direct Deep Linking (usuários existentes). Clique aqui para mais informações.

6.5.4

23/03/2022 Manutenção do SDK

6.5.3

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

26/01/2022 Manutenção do SDK

6.5.1

03/01/2022 Manutenção do SDK

6.5.0

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

6.4.4

12/12/2021 Manutenção do SDK

6.4.3

30/11/2021

Correção de estabilidade para MacOS 10.14.6 com xcframework.

6.4.2

28/10/2021

Manutenção do SDK

6.4.1

24/10/2021

Estabilidade resolvida em aplicativos Unity.

6.4.0

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 desta 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 API do OneLink

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
  • caso extremo, em que waitForATTUserAuthorization 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 dispositivo
  • O parâmetro wifi enviado do SDK está definido como False

6.2.4
Desativação: 31/08/2024

15/03/2021

Bugfix 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

Observaçã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/2020

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 para redirecionamentos múltiplos de ESPs

6.0.3
Desativação: 31/08/2024

06/09/2020
  • Alteraçao no nome da API:
    waitForAdvertisingIdentifier --> waitForATTUserAuthorization
  • O SDK coleta IDFA por padrão para iOS 14 (assim como para versões anteriores do iOS)

6.8.1 (Desativada)

27/08/2020
  • Alteraçao 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

start

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 Notas

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 recebem 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
  • Grandes alterações na API e na funcionalidade 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   Nome do 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 para 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, inclusive 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 relacionada Política de controle de versão da AppsFlyer
Versão Data de lançamento Notas
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