> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nemu.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# iOS

# Considerações específicas para iOS

O iOS possui regras e limitações próprias relacionadas a **privacidade**, **atribuição** e **coleta de dados**, que impactam diretamente o funcionamento de qualquer SDK de tracking, incluindo o SDK da Nemu.

Esta seção descreve como o SDK se comporta no iOS e quais são as limitações esperadas pela plataforma.

***

## Privacidade e políticas da Apple

A Apple impõe restrições rigorosas sobre coleta e compartilhamento de dados, especialmente após a introdução do **App Tracking Transparency (ATT)**.

O SDK da Nemu é projetado para:

* Não depender de identificadores proibidos pela Apple
* Operar corretamente mesmo quando o usuário **nega consentimento de tracking**
* Respeitar as políticas de privacidade da App Store

<Info>
  O SDK não utiliza IDFA como requisito para funcionamento básico de atribuição.
</Info>

***

## App Tracking Transparency (ATT)

Em dispositivos iOS 14.5 ou superior, o sistema pode solicitar ao usuário permissão explícita para tracking entre apps e sites de terceiros.

### Comportamento do SDK

* O SDK **não solicita automaticamente** a permissão ATT
* Cabe ao aplicativo decidir **quando** e **se** irá exibir o prompt de consentimento
* A ausência de consentimento **não impede**:
  * Captura de UTMs via deep link
  * Atribuição de instalação
  * Deferred deep links
  * Registro de eventos no app

### Recomendação

Caso seu aplicativo utilize ATT, recomendamos exibir o prompt **apenas após explicar claramente ao usuário** o motivo da solicitação.

***

## Identificadores no iOS

Devido às restrições da Apple, o SDK trabalha com identificadores compatíveis com as políticas da plataforma.

### Identificadores utilizados

* Identificadores gerados pelo próprio aplicativo (ex: UID do usuário)
* Identificadores internos de sessão
* Dados de origem fornecidos pelo sistema ou pelo link de entrada

### Identificadores não utilizados

* IDFA (quando não autorizado)
* Fingerprinting de dispositivo
* Identificadores persistentes proibidos pelas políticas da Apple

<Warning>
  O uso de técnicas de fingerprinting não é permitido no iOS e não é adotado pelo SDK da Nemu.
</Warning>

***

## Atribuição no iOS

### Atribuição de instalação

No iOS, a atribuição de instalação pode ter limitações dependendo:

* Da origem do clique
* Das permissões concedidas pelo usuário
* Das informações disponibilizadas pelo sistema

Quando disponível, o SDK associa a origem da instalação à primeira sessão do aplicativo.

### Deferred Deep Links

Deferred deep links no iOS funcionam de acordo com as capacidades da plataforma e podem variar conforme:

* Tipo de link utilizado
* Versão do iOS
* Configuração do aplicativo

<Info>
  Em alguns cenários, o iOS pode limitar ou atrasar a disponibilização de informações de origem após a instalação.
</Info>

***

## Deep Links e Universal Links

O iOS diferencia dois tipos principais de links:

* **Custom URL Schemes** (`myapp://`)
* **Universal Links** (`https://` associados ao app)

### Recomendações

* Sempre que possível, utilize **Universal Links**
* Garanta que o aplicativo esteja corretamente configurado com:
  * Associated Domains
  * Arquivo `apple-app-site-association`

Isso melhora a confiabilidade na captura de UTMs e na experiência do usuário.

***

## Persistência de dados no iOS

O iOS pode encerrar aplicativos em background de forma agressiva para economizar recursos.

Por esse motivo:

* A captura de origem deve ocorrer o mais cedo possível
* O SDK persiste informações essenciais para evitar perda de dados
* Dados de sessão podem ser restaurados ao reabrir o aplicativo

***

## Boas práticas recomendadas

Para garantir a melhor qualidade de tracking no iOS:

* Inicialize o SDK no início do ciclo de vida do app
* Configure corretamente deep links ou universal links
* Registre o UID do usuário assim que ele estiver disponível
* Não dependa exclusivamente de permissões de tracking para atribuição básica

***

## Expectativas realistas no iOS

Devido às políticas da Apple:

* A atribuição no iOS pode ser menos determinística do que no Android
* Alguns cenários de instalação podem não conter origem identificável
* O comportamento pode variar conforme versão do sistema e permissões

Essas limitações são inerentes ao ecossistema iOS e se aplicam a qualquer solução de tracking do mercado.