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

Selecione a plataforma: Android iOS Unity Flutter Android (legada)

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.

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, certifique-se de fazer o seguinte:

Usar o Xcode 16.0 ou versões mais recentes.
Segmentar o iOS 13.0 ou versões mais recentes.

Importar o Google Mobile Ads SDK

Para importar o 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 do Google Mobile Ads SDK.
No comando que aparece, busque pelo repositório do GitHub do pacote Swift do Google Mobile Ads:
```
https://github.com/googleads/swift-package-manager-google-mobile-ads.git
```
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:

Abra o Podfile do projeto e adicione esta linha à configuração do build target do 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 do Google Mobile Ads SDK.
Extraia o pacote googlemobileadssdkios.zip.
No projeto do Xcode, adicione os seguintes frameworks:
- GoogleMobileAds.xcframework
- UserMessagingPlatform.xcframework
Nas configurações Gerais do target, acesse Frameworks, Libraries, and Embedded Content.
Confirme que você definiu GoogleMobileAds.xcframework e UserMessagingPlatform.xcframework como Embed & Sign.
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 seguintes chaves:

Uma chave GADApplicationIdentifier com um valor de string de ID do app do Ad Manager encontrado na interface do Ad Manager e do formulário ca-app-pub-################~##########.
Uma chave SKAdNetworkItems. Essa chave inclui valores SKAdNetworkIdentifier para o Google cstr6suwn9.skadnetwork e compradores terceirizados selecionados.

Exemplo completo

<key>GADApplicationIdentifier</key>
<!-- Sample Ad Manager 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 do Ad Manager. Durante o teste, use o ID do app de exemplo mostrado no exemplo anterior.

Para que o app seja inicializado mais rapidamente, vincule seus grupos de rendimento a apps específicos. Se um grupo de rendimento segmentar o iOS, mas não estiver vinculado a um app, o Google vai enviar o grupo para todos os apps iOS na sua conta. Essa abordagem pode reduzir o desempenho.

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()ViewController.swift

SwiftUI

// Initialize the Google Mobile Ads SDK.
MobileAds.shared.start()GoogleMobileAdsConsentManager.swift

Objective-C

// Initialize the Google Mobile Ads SDK.
[GADMobileAds.sharedInstance startWithCompletionHandler:nil];ViewController.m

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.

Selecionar um formato de anúncio

Depois de importar o Google Mobile Ads SDK, você pode selecionar um formato de anúncio para implementar.

O Ad Manager oferece os seguintes formatos de anúncio:

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

Configurar o SDK dos anúncios para dispositivos móveis do Google Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.