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:
- Abre Xcode.
- Navega a File > Add Package Dependencies….
Instala el paquete de Swift del Google Mobile Ads SDK.
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.gitSelecciona 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:
Abre el Podfile de tu proyecto y agrega esta línea a la configuración de compilación
targetde tu app:pod 'Google-Mobile-Ads-SDK'
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:
- Descarga el Google Mobile Ads SDK.
- Extrae el paquete
googlemobileadssdkios.zip. En tu proyecto de Xcode, agrega los siguientes frameworks:
GoogleMobileAds.xcframeworkUserMessagingPlatform.xcframework
En la configuración General de tu destino, navega a Frameworks, Libraries, and Embedded Content.
Confirma que configuraste
GoogleMobileAds.xcframeworkyUserMessagingPlatform.xcframeworkcomo Embed & Sign.En la configuración de compilación de tu proyecto, haz lo siguiente:
- Agrega la ruta de acceso
/usr/lib/swifta Runpath Search Paths. - Agrega la marca
-ObjCdel vinculador a Other Linker Flags.
- Agrega la ruta de acceso
Actualiza el archivo Info.plist
En el archivo Info.plist de tu app, agrega las siguientes claves:
Una clave
GADApplicationIdentifiercon un valor de cadena de tu ID de app de Ad Manager, que se encuentra en la IU de Ad Manager y tiene el formatoca-app-pub-################~##########Una clave
SKAdNetworkItems. Esta clave incluye valoresSKAdNetworkIdentifierpara Googlecstr6suwn9.skadnetworky compradores externos específicos.
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 |