Agregar el SDK de Audience Network a tu app de iOS

Prepárate ahora para los cambios en iOS 14.5

Todos los editores deben usar el SDK de Audience Network 6.2.1 o una versión posterior para poder monetizar con usuarios de iOS 14.5. (También recomendamos el SDK de Audience Network 6.2.1 para usuarios de iOS 14). En esta versión, hay dos requisitos:

  • Implementar el marcador setAdvertiserTrackingEnabled, usen o no la mediación, para notificarnos si debemos usar los datos a fin de entregar anuncios personalizados.
  • Agrega los identificadores de SKAdNetwork sugeridos al archivo Info.plist del proyecto Xcode para que los anunciantes midan el éxito de las campañas de anuncios.

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

Actualiza a la versión más reciente del SDK antes de incorporar tu app para monetización.

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

CocoaPods (método de descarga recomendado)

Agrega la siguiente línea al Podfile de tu proyecto.

pod 'FBAudienceNetwork'

Ejecuta el siguiente comando.

pod install

Descarga manual

Si el uso de CocoaPods no es una opción, puedes descargar el SDK de Audience Network desde una de las ubicaciones que se incluyen en la siguiente tabla.

Después de descargar el SDK de Audience Network, completa las integraciones de la siguiente manera:

  1. Abre el proyecto en XCode.
  2. Arrastra FBAudienceNetwork.xcframework desde la carpeta Dynamic de tu SDK de Audience Network para iOS descargado y suéltalo en XCode.
  3. En la pestaña General de la configuración de tu app, selecciona Embed & Sign en FBAudienceNetwork.xcframework

Notas

  • También puedes usar la variante estática del SDK de Audience Network en la descarga. Para ello, arrastra FBAudienceNetwork.xcframework desde la carpeta Static y suéltalo.
  • Si quieres usar la variante Static, asegúrate de que tu proyecto esté usando Swift. Si tu proyecto no usa Swift, agrega un archivo Swift vacío (File -> New -> Swift en XCode) para tu proyecto.
  • Si tu proyecto se orienta a una versión de iOS anterior a la 12.4, asegúrate de configurar la opción Always embed Swift standard libraries en YES dentro de Build settings en la configuración de la plataforma de destino de tu aplicación en XCode.
  • Para evitar agregar ajustes adicionales después de la instalación manual, usa CocoaPods.

Solución de problemas de versiones del SDK a partir de la 6.9.0

A partir de la versión 6.9.0, el SDK de Audience Network para iOS viene con Swift habilitado. Consulta los puntos a continuación para solucionar los problemas más comunes relacionados con la instalación del SDK y la interoperabilidad de Swift:

  • XCode emite los errores "Undefined symbol: __swift_FORCE_LOAD_$_swiftDataDetection" y "Undefined symbol: __swift_FORCE_LOAD_$_swiftFileProvider". Estos errores implican que no usas la última versión de XCode. Para corregirlos, actualiza a XCode 13 o una versión más nueva.
  • XCode emite muchos errores Undefined symbol__swift_FORCE_LOAD_$_. Estos errores significan que no está habilitada la compatibilidad con Swift para tu proyecto. La manera más sencilla de corregir esto consiste en agregar un archivo Swift vacío ('File' -> 'New' -> 'Swift file' en XCode).
  • Al ejecutarse en el dispositivo, la app falla después de iniciarse con un error: "dyld: Library not loaded: @rpath/FBAudienceNetwork.framework". Este error significa que no insertaste el SDK de Audience Network en tu app. Accede a la configuración de destino y elige "Embed & Sign" para "FBAudienceNetwork.xcframework" en la pestaña "General".
  • La app falla después de iniciarse con un error: "dyld: Library not loaded: @rpath/libswiftCore.dylib". Este error significa que estás ejecutando una app en una versión de iOS anterior a la 12.4 y que no configuraste "Always embed Swift standard libraries" en "YES". Asegúrate de fijar el ajuste "Always embed Swift standard libraries" en "YES" en "Build settings" en la configuración de la plataforma de destino de tu app en XCode.