Añadir el SDK de Audience Network a la aplicación de iOS

Toma medidas ahora en relación con los cambios de iOS 14.5

Todos los editores deben usar la versión 6.2.1 del SDK de Audience Network o una posterior para monetizar con usuarios de iOS 14.5. (También recomendamos la versión 6.2.1 del SDK de Audience Network para los usuarios de iOS 14). Hay dos requisitos en esta versión:

  • Implementa la marca setAdvertiserTrackingEnabled, independientemente del uso de la mediación, para hacernos saber si debemos utilizar los datos en la entrega de anuncios personalizados.
  • Añade los identificadores de SKAdNetwork sugeridos al archivo Info.plist del proyecto de Xcode para que los anunciantes puedan medir el éxito de sus campañas publicitarias.

Obtén más información en nuestra publicación de Meta for Developers

Actualiza a la última versión del SDK antes de incorporar la aplicación para la monetización.

En esta guía se explica cómo incluir el SDK de Audience Network en la aplicación de iOS para que puedas llamar a las API de Audience Network. El método preferido consiste en usar CocoaPods para administrar las dependencias. Sin embargo, también se proporcionan las ubicaciones de descarga para realizar una integración manual.

CocoaPods (método de descarga preferido)

Añade la siguiente línea al archivo Podfile del proyecto.

pod 'FBAudienceNetwork'

Ejecuta el comando siguiente.

pod install

Descarga manual

Si no vas a usar CocoaPods, puedes descargar el SDK de Audience Network desde una de las ubicaciones de la siguiente tabla.

Tras descargar el SDK de Audience Network, completa la integración de la siguiente manera:

  1. Abre el proyecto en Xcode.
  2. Arrastra FBAudienceNetwork.xcframework desde la carpeta Dynamic del archivo del SDK de Audience Network para iOS descargado y suéltalo en Xcode.
  3. En la pestaña General de la configuración del destino de la aplicación, selecciona Embed & Sign (Insertar y firmar) en FBAudienceNetwork.xcframework.

Notas

  • También puedes usar la variante estática del SDK de Audience Network que se proporciona en la descarga. Para ello, arrastra y suelta FBAudienceNetwork.xcframework desde la carpeta Static.
  • Si quieres usar la variante estática, asegúrate de que el proyecto use Swift. Si el proyecto no usa Swift, añade un archivo de Swift vacío (File -> New -> Swift [Archivo -> Nuevo -> Swift] en Xcode) al proyecto.
  • Si el destino del proyecto es una versión de iOS anterior a la 12.4, asegúrate de definir la configuración Always embed Swift standard libraries (Insertar siempre las bibliotecas estándar de Swift) en YES (SÍ) en Build settings (Configuración de compilación) para el destino de la aplicación en Xcode.
  • Para evitar añadir más modificaciones después de la instalación manual, usa CocoaPods.

Solucionar problemas de las versiones 6.9.0 y posteriores del SDK

A partir de la versión 6.9.0, el SDK de Audience Network para iOS tiene Swift activado. Consulta los siguientes puntos para solucionar los problemas más habituales de la instalación del SDK y la interoperabilidad con Swift:

  • Xcode emite los siguientes errores: “Undefined symbol: __swift_FORCE_LOAD_$_swiftDataDetection” y “Undefined symbol: __swift_FORCE_LOAD_$_swiftFileProvider”. Estos errores significan que no usas la versión más reciente de Xcode. Actualiza a Xcode 13 o una versión superior para solucionar estos errores.
  • Xcode emite muchos errores Undefined symbol__swift_FORCE_LOAD_$_. Estos errores significan que no tienes activada la compatibilidad con Swift para el proyecto. La forma más sencilla de solucionarlo consiste en añadir un archivo de Swift vacío (“File” -> “New” -> “Swift file” [“Archivo” -> “Nuevo” -> “Archivo de Swift”] en Xcode).
  • Al ejecutarse en un dispositivo, la aplicación se bloquea justo después de iniciarse con el siguiente error: “dyld: Library not loaded: @rpath/FBAudienceNetwork.framework”. Este error significa que no has insertado el SDK de Audience Network en la aplicación. Ve a la configuración del destino y elige “Embed & Sign” (Insertar y firmar) en “FBAudienceNetwork.xcframework” en la pestaña “General”.
  • La aplicación se bloquea justo después de iniciarse con el siguiente error: “dyld: Library not loaded: @rpath/libswiftCore.dylib”. Este error significa que estás ejecutando una aplicación en iOS posterior a la versión 12.4 y no definiste la configuración “Always embed Swift standard libraries” (Insertar siempre las bibliotecas estándar de Swift) en “YES” (SÍ). Asegúrate de definir la configuración “Always embed Swift standard libraries” (Insertar siempre las bibliotecas estándar de Swift) en “YES” (SÍ) en “Build settings” (Configuración de compilación) para el destino de la aplicación en Xcode.