Configurar o SDK dos anúncios para dispositivos móveis do Google

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 destas seções:

Gerenciador de pacotes do Swift

Para adicionar uma dependência de pacote ao seu projeto, siga estas etapas:

  1. Abra o Xcode.
  2. Acesse File > Add Package Dependencies….
  3. Instale o pacote Swift Google Mobile Ads SDK.

  4. No comando que aparece, pesquise o repositório do GitHub desse pacote:

    https://github.com/googleads/swift-package-manager-google-mobile-ads.git
    
  5. Selecione a versão do pacote Swift 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:

  1. Abra o Podfile do projeto e adicione esta linha à configuração do build target do app:

    pod 'Google-Mobile-Ads-SDK'
  2. Em um terminal, execute:

    pod install --repo-update

Baixar manualmente

Para baixar o Google Mobile Ads SDK de forma manual, siga estas etapas:

  1. Baixe o Google Mobile Ads SDK.
  2. Extraia o pacote googlemobileadssdkios.zip.
  3. No projeto do Xcode, adicione estes frameworks:

    • GoogleMobileAds.xcframework
    • UserMessagingPlatform.xcframework
  4. Nas configurações General do destino, acesse Frameworks, Libraries, and Embedded Content.

  5. Confirme se você definiu GoogleMobileAds.xcframework e UserMessagingPlatform.xcframework como Embed & Sign.

  6. Nas configurações de build do projeto, faça o seguinte:

    • Adicione o caminho /usr/lib/swift a Runpath Search Paths.
    • Adicione a flag do vinculador -ObjC a Other Linker Flags.

Atualizar o arquivo Info.plist

No arquivo Info.plist do app, adicione as chaves abaixo:

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 de forma automática em intervalos definidos. Os usuários veem esses anúncios de tempos em tempos 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 seu app. O anúncio se sobrepõe à tela de carregamento. Anúncios de abertura do app