Como adicionar o SDK do Audience Network ao seu app iOS
Prepare-se agora para as mudanças no iOS 14.5
Todos os publishers precisarão usar o SDK do Audience Network 6.2.1 ou versões posteriores para monetizar com usuários do iOS 14.5. Para usuários do iOS 14, também recomendamos usar a versão 6.2.1 do SDK. Há dois requisitos nessa versão:
- Implementar a sinalização setAdvertiserTrackingEnabled, independentemente do uso de mediação, para informar se os dados devem ser usados para veicular anúncios personalizados.
- Adicionar os IDs de SKAdNetwork sugeridos à Info.plist do projeto no XCode para que os anunciantes possam mensurar o sucesso das campanhas de anúncio.
Leia mais na nossa publicação no Meta for Developers.
Atualize para a versão mais recente do SDK antes de integrar o app para monetização.
Este guia explica como incluir o SDK do Audience Network no seu app iOS para que você possa fazer chamadas de APIs do Audience Network. O método preferencial para gerenciar dependências é o CocoaPods. No entanto, também são fornecidos locais de download para integração manual.
CocoaPods (método preferencial de download)
Adicione a seguinte linha ao Podfile do projeto.
pod 'FBAudienceNetwork'
Execute este comando.
pod install
Download manual
Se o CocoaPods não for uma opção viável, baixe o SDK do Audience Network de um dos locais da tabela abaixo.
| Package | Date | Change Log |
|---|---|---|
Oct 15, 2024 | ||
Aug 15, 2024 |
Depois de fazer isso, conclua a integração da seguinte forma:
- Abra o projeto no XCode.
-
Arraste o FBAudienceNetwork.xcframework da pasta Dynamic do arquivo do SDK do Audience Network para iOS que você baixou e solte no XCode.
-
Na aba General das configurações do destino do app, selecione Embed & Sign para FBAudienceNetwork.xcframework.
Observações
- Também é possível usar uma variante estática do SDK do Audience Network fornecida no download. Para fazer isso, arraste e solte FBAudienceNetwork.xcframework da pasta Static.
- Caso você queira usar a variante Static, verifique se o projeto usa Swift. Se o projeto não usar Swift, adicione um novo arquivo swift ao projeto (File -> New -> Swift no XCode).
- Se o projeto estiver direcionado para versões do iOS anteriores à 12.4, configure Always embed Swift standard libraries como YES na aba Build settings do direcionamento do app no XCode.
- Use o CocoaPods para evitar ajustes extras depois da instalação manual.
Solução de problemas com o SDK 6.9.0 e versões posteriores
O SDK do Audience Network para iOS tem o Swift habilitado desde a versão 6.9.0. Consulte os itens abaixo para solucionar os principais problemas de instalação do SDK e interoperabilidade do Swift:
- O XCode emite erros "Undefined symbol:
__swift_FORCE_LOAD_$_swiftDataDetection" e "Undefined symbol:__swift_FORCE_LOAD_$_swiftFileProvider". Esses erros significam que você não está usando a versão mais recente do XCode. Atualize para o XCode 13 ou versões posteriores para corrigi-los. - O XCode emite muitos erros
Undefined symbol__swift_FORCE_LOAD_$_. Esses erros significam que a compatibilidade com o Swift não está habilitada no projeto. A forma mais simples de corrigir esse problema é criando um arquivo Swift vazio (File -> New -> Swift file no XCode). - Quando usado em um dispositivo, o app falha logo no início com o seguinte erro: "dyld: Library not loaded: @rpath/FBAudienceNetwork.framework". Esse erro significa que você não incorporou o SDK do Audience Network ao app. Acesse as configurações do destino e escolha Embed & Sign para FBAudienceNetwork.xcframework na aba General.
- O app falha logo no início com o erro: "dyld: Library not loaded: @rpath/libswiftCore.dylib". Esse erro significa que você está executando um app em uma versão do iOS anterior à 12.4 e que você não definiu Always embed Swift standard libraries como YES. Configure Always embed Swift standard libraries como YES na aba Build settings no direcionamento do app no XCode.