Para veicular anúncios e gerar receita, integre o Google Mobile Ads SDK ao app iOS. Para preparar seu projeto, importe e inicialize o Google Mobile Ads SDK antes de solicitar anúncios.
Se você incluir o Firebase no seu app iOS, consulte Começar a usar a AdMob no seu projeto iOS.
Este guia aborda a importação e inicialização do Google Mobile Ads SDK e a seleção de um formato de anúncio.
Pré-requisitos
Antes de continuar, confira se você:
- Usa o Xcode 16.0 ou versões mais recentes.
- Segmenta o iOS 13.0 ou versões mais recentes
Importar Google Mobile Ads SDK
Para importar Google Mobile Ads SDK, conclua uma das seguintes seções:
Gerenciador de pacotes do Swift
Para adicionar uma dependência de pacote ao seu projeto, siga estas etapas:
- Abra o Xcode.
- Acesse File > Add Package Dependencies....
Instale o pacote Swift Google Mobile Ads SDK.
No comando que aparece, pesquise o repositório do GitHub desse pacote:
https://github.com/googleads/swift-package-manager-google-mobile-ads.gitSelecione a versão do pacote do Google Mobile Ads SDK que você quer usar. Para novos projetos, recomendamos usar a opção Up to Next Major Version.
CocoaPods
Para usar o CocoaPods, siga estas etapas:
Abra o Podfile do projeto e adicione esta linha à configuração do build
targetdo app:pod 'Google-Mobile-Ads-SDK'
Em um terminal, execute:
pod install --repo-update
Baixar manualmente
Para fazer o download manual do Google Mobile Ads SDK, siga estas etapas:
- Faça o download de Google Mobile Ads SDK.
- Extraia o pacote
googlemobileadssdkios.zip. No projeto do Xcode, adicione os seguintes frameworks:
GoogleMobileAds.xcframeworkUserMessagingPlatform.xcframework
Nas configurações Gerais do target, acesse Frameworks, Libraries, and Embedded Content.
Confirme que você definiu
GoogleMobileAds.xcframeworkeUserMessagingPlatform.xcframeworkcomo Embed & Sign.Nas configurações de build do projeto, faça o seguinte:
- Adicione o caminho
/usr/lib/swifta Runpath Search Paths. - Adicione a flag do vinculador
-ObjCa Other Linker Flags.
- Adicione o caminho
Atualizar o arquivo Info.plist
No arquivo Info.plist do app, adicione as seguintes chaves:
Uma chave
GADApplicationIdentifiercom o valor de string do ID do app da AdMob. Para mais detalhes, consulte Encontrar e copiar um ID de aplicativo ou de bloco de anúncios .Uma chave
SKAdNetworkItems. Essa chave inclui valoresSKAdNetworkIdentifierpara o Googlecstr6suwn9.skadnetworke compradores terceirizados selecionados.
Exemplo completo
<key>GADApplicationIdentifier</key>
<!-- Sample AdMob app ID: ca-app-pub-3940256099942544~1458002511 -->
<string>SAMPLE_APP_ID</string>
<key>SKAdNetworkItems</key>
<array>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>cstr6suwn9.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>4fzdc2evr5.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>2fnua5tdw4.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>ydx93a7ass.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>p78axxw29g.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>v72qych5uu.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>ludvb6z3bs.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>cp8zw746q7.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>3sh42y64q3.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>c6k4g5qg8m.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>s39g8k73mm.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>wg4vff78zm.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>3qy4746246.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>f38h382jlk.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>hs6bdukanm.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>mlmmfzh3r3.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>v4nxqhlyqp.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>wzmmz9fp6w.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>su67r6k2v3.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>yclnxrl5pm.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>t38b2kh725.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>7ug5zh24hu.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>gta9lk7p23.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>vutu7akeur.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>y5ghdn5j9k.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>v9wttpbfk9.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>n38lu8286q.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>47vhws6wlr.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>kbd757ywx3.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>9t245vhmpl.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>a2p9lx4jpn.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>22mmun2rn5.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>44jx6755aq.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>k674qkevps.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>4468km3ulz.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>2u9pt9hc89.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>8s468mfl3y.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>klf5c3l5u5.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>ppxm28t8ap.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>kbmxgpxpgc.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>uw77j35x4d.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>578prtvx9j.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>4dzt52r2t5.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>tl55sbb4fm.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>c3frkrj4fj.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>e5fvkxwrpn.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>8c4e2ghe7u.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>3rd42ekr43.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>97r2b46745.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>3qcr597p9d.skadnetwork</string>
</dict>
</array>Substitua SAMPLE_APP_ID pelo ID do app da AdMob. Durante o teste, use o ID do app de exemplo mostrado no exemplo anterior.
Agora é o momento ideal para criar uma conta da AdMob ou registrar um app, caso ainda não tenha feito isso.
Inicializar o Google Mobile Ads SDK
Antes de carregar anúncios, chame o método start() da propriedade GADMobileAds.sharedInstance para inicializar Google Mobile Ads SDK. Esse método chama um gerenciador de conclusão depois que o Google Mobile Ads SDK e os adaptadores de mediação terminam o processamento ou após 30 segundos.
O exemplo a seguir inicializa o Google Mobile Ads SDK:
Swift
// Initialize the Google Mobile Ads SDK.
MobileAds.shared.start()
SwiftUI
// Initialize the Google Mobile Ads SDK.
MobileAds.shared.start()
Objective-C
// Initialize the Google Mobile Ads SDK.
[GADMobileAds.sharedInstance startWithCompletionHandler:nil];
Ao chamar o método startWithCompletionHandler:, o Google Mobile Ads SDK pode pré-carregar anúncios ou inicializar SDKs de terceiros. Se você precisar do consentimento de usuários no Espaço Econômico Europeu (EEE), no Reino Unido (UK) ou na Suíça, defina flags específicas de solicitações. Se você precisar definir flags específicas de solicitações, faça isso antes de inicializar o Google Mobile Ads SDK. Para mais detalhes, consulte Segmentação.
Selecione um formato de anúncio
Depois de importar o Google Mobile Ads SDK, você pode selecionar um formato de anúncio para implementar.
A AdMob oferece os seguintes formatos:
| Formato do anúncio | Descrição | Documentação |
|---|---|---|
| Banner | Mostra anúncios retangulares em uma seção do layout do app. Esse anúncio é atualizado automaticamente em intervalos definidos. Os usuários veem esses anúncios periodicamente quando permanecem na mesma tela. | Configurar anúncios de banner |
| Intersticial | Mostra anúncios de página inteira no seu app. Posicione esse anúncio em intervalos e transições naturais da interface, por exemplo, após a conclusão de uma fase em um app de jogo. | Anúncios intersticiais |
| Nativo | Permite personalizar recursos, como títulos e calls-to-action, nos seus apps. Ao personalizar o anúncio, você cria uma publicidade que combina com o design visual do app. | Carregar um anúncio nativo |
| Premiado | Os usuários ganham recompensas no app, como moedas ou pontos, ao jogar, responder a pesquisas ou assistir a vídeos. É possível definir recompensas para blocos de anúncios e especificar os valores e itens que os usuários recebem. | Anúncios premiados |
| Intersticial premiado | Permite oferecer recompensas, como moedas ou vidas extras, em anúncios que são exibidos durante as transições do app. | Anúncios intersticiais premiados |
| Abertura do app | Aparece quando os usuários abrem ou voltam para o app. O anúncio se sobrepõe à tela de carregamento. | Anúncios de abertura do app |