Configura Google Mobile Ads SDK

Para publicar anuncios y obtener ingresos, integra el Google Mobile Ads SDK en tu app para iOS. Para preparar tu proyecto, importa e inicializa el Google Mobile Ads SDK antes de solicitar anuncios.

En esta guía, se explica cómo importar e inicializar el Google Mobile Ads SDK, y seleccionar un formato de anuncio.

Requisitos previos

Antes de continuar, asegúrate de lo siguiente:

  • Usa Xcode 16.0 o una versión posterior.
  • Dirígete a iOS 13.0 o una versión posterior

Importa el Google Mobile Ads SDK

Para importar el Google Mobile Ads SDK, completa una de las siguientes secciones:

Swift Package Manager

Para agregar una dependencia de paquete a tu proyecto, sigue estos pasos:

  1. Abre Xcode.
  2. Navega a File > Add Package Dependencies….
  3. Instala el paquete de Swift del Google Mobile Ads SDK.

  4. En el mensaje que aparece, busca el repositorio de GitHub del paquete de Swift de anuncios de Google para dispositivos móviles:

    https://github.com/googleads/swift-package-manager-google-mobile-ads.git
    
  5. Selecciona la versión del paquete de Swift del Google Mobile Ads SDK que deseas usar. Para los proyectos nuevos, te recomendamos que uses la opción Up to Next Major Version.

CocoaPods

Para usar CocoaPods, sigue estos pasos:

  1. Abre el Podfile de tu proyecto y agrega esta línea a la configuración de compilación target de tu app:

    pod 'Google-Mobile-Ads-SDK'
  2. En una terminal, ejecuta lo siguiente:

    pod install --repo-update

Descarga manual

Para descargar el Google Mobile Ads SDK de forma manual, haz lo siguiente:

  1. Descarga el Google Mobile Ads SDK.
  2. Extrae el paquete googlemobileadssdkios.zip.
  3. En tu proyecto de Xcode, agrega los siguientes frameworks:

    • GoogleMobileAds.xcframework
    • UserMessagingPlatform.xcframework
  4. En la configuración General de tu destino, navega a Frameworks, Libraries, and Embedded Content.

  5. Confirma que configuraste GoogleMobileAds.xcframework y UserMessagingPlatform.xcframework como Embed & Sign.

  6. En la configuración de compilación de tu proyecto, haz lo siguiente:

    • Agrega la ruta de acceso /usr/lib/swift a Runpath Search Paths.
    • Agrega la marca -ObjC del vinculador a Other Linker Flags.

Actualiza el archivo Info.plist

En el archivo Info.plist de tu app, agrega las siguientes claves:

Ejemplo 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>

Reemplaza SAMPLE_APP_ID por el ID de tu app de Ad Manager. Cuando hagas pruebas, usa el ID de app de ejemplo que se muestra en el caso anterior.

Para que tu app se inicialice más rápido, vincula tus grupos de rendimiento a apps específicas. Si un grupo de rendimiento se segmenta para iOS, pero no está vinculado a una app, Google envía el grupo a todas las apps para iOS de tu cuenta. Este enfoque puede ralentizar el rendimiento.

Inicializa el Google Mobile Ads SDK

Antes de cargar anuncios, llama al método start() de la propiedad GADMobileAds.sharedInstance para inicializar el Google Mobile Ads SDK. Este método llama a un controlador de finalización después de que el Google Mobile Ads SDK y los adaptadores de mediación terminan de procesar, o después de 30 segundos.

En el siguiente ejemplo, se inicializa 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];

Durante la inicialización, el Google Mobile Ads SDK puede precargar anuncios o inicializar SDK de terceros cuando se llama al método startWithCompletionHandler:. Si necesitas obtener el consentimiento de los usuarios ubicados en el Espacio Económico Europeo (EEE), el Reino Unido o Suiza, configura parámetros específicos de la solicitud. Si necesitas configurar parámetros específicos de la solicitud, asegúrate de hacerlo antes de inicializar el Google Mobile Ads SDK. Para obtener más información, consulta Segmentación.

Selecciona un formato de anuncio

Después de importar Google Mobile Ads SDK, puedes seleccionar un formato de anuncio para implementarlo.

Ad Manager ofrece los siguientes formatos de anuncios:

Formato del anuncio Descripción Documentación
Banner Muestra anuncios rectangulares en una sección del diseño de tu app. Este anuncio se actualiza automáticamente en intervalos establecidos. Los usuarios ven estos anuncios periódicamente cuando permanecen en la misma pantalla. Configura anuncios de banner
Intersticial Muestra anuncios de página completa en tu app. Coloca este anuncio en pausas y transiciones naturales de la interfaz de la app (por ejemplo, después de completar un nivel en una app de juego). Anuncios intersticiales
Nativo Te permiten personalizar los recursos, como los títulos y los llamados a la acción, en tus apps. Cuando personalizas el anuncio, creas anuncios que coinciden con el diseño visual de tu app. Carga un anuncio nativo
Recompensado Los usuarios obtienen recompensas en la app, como monedas o puntos, por jugar, responder encuestas o mirar videos. Puedes establecer recompensas para las unidades de anuncios y especificar los elementos y los valores de las recompensas que recibirán los usuarios. Anuncios recompensados
Intersticial recompensado Te permite ofrecer recompensas, como monedas o vidas adicionales, por los anuncios que aparecen durante las transiciones de la app. Anuncios intersticiales recompensados
Inicio de aplicación Aparece cuando los usuarios abren tu app o vuelven a ella. El anuncio se superpone a la pantalla de carga. Anuncios para inicio de aplicación