3. Configuração do projeto

3.1 ID do app no AdMob

Se AdMob/GAM for uma das suas redes de anúncios habilitadas, adicione seu próprio ID do app no AdMob ao Info.plist (esse ID é específico do app — não pode ser incluído nos xcframeworks):

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-XXXXXXXXXXXXXXXX~YYYYYYYYYY</string>

3.2 SKAdNetworkItems

As redes de mediação/atribuição usadas pelo AKS (AppLovin, IronSource e seus parceiros de lances) precisam de entradas SKAdNetworkIdentifier para atribuir instalações corretamente no contexto da ATT. O app de referência inclui cerca de 48 entradas que abrangem parceiros de mediação da AppLovin/IronSource/Meta/etc. Obtenha a lista atualizada nos painéis das suas redes de anúncios (AppLovin, IronSource e AdMob publicam suas próprias listas) em vez de copiar uma lista antiga — essas redes adicionam novos IDs ao longo do tempo.

3.3 App Tracking Transparency (ATT) — uma lacuna que você precisa preencher

Atenção: a integração de referência não inclui NSUserTrackingUsageDescription nem qualquer chamada a ATTrackingManager.requestTrackingAuthorization(). O AKS não solicita a autorização da ATT por você no iOS. Se quiser disponibilizar o IDFA para a mediação do AdMob/AppLovin/IronSource e para a atribuição do AppsFlyer/Adjust, você precisará adicionar ambos por conta própria:

<key>NSUserTrackingUsageDescription</key>
<string>Your data will be used to deliver personalized ads.</string>

import AppTrackingTransparency

ATTrackingManager.requestTrackingAuthorization { status in
    // call this before initializing ads — see §4.4
}

Sem a string de descrição de uso, a chamada a requestTrackingAuthorization causa uma falha em tempo de execução — portanto, não adicione a chamada sem a chave no Info.plist e não presuma que qualquer uma dessas etapas já esteja resolvida só porque o SDK está integrado.

3.4 GoogleService-Info.plist

Adicione o GoogleService-Info.plist do Firebase ao target do seu app da maneira usual (arraste-o para a pasta do código-fonte e confirme que ele está associado ao target). Não há nada específico do AKS nesse processo — a configuração padrão do Firebase se aplica sem alterações.

3.5 Versão mínima de implantação

AppsKit.xcframework/AKSKit.xcframework são compilados para iOS 15.0 ou superior, com Swift 5.9 (Xcode 15.2+) e BUILD_LIBRARY_FOR_DISTRIBUTION: YES para garantir a estabilidade dos módulos. Defina IPHONEOS_DEPLOYMENT_TARGET do target do seu app como 15.0 ou superior — e lembre-se de que o post_install do Podfile (§1.2) também força todos os targets de pods a usar 15.0. Portanto, uma versão mínima inferior no target do app não permitiria uma vinculação correta com os pods de qualquer forma.