Instrucciones de integración del SDK v9.x

En esta página, se describe cómo integrar el SDK móvil de iOS v9.x dentro del proyecto de Xcode, así como mostrar anuncios en la aplicación. Para obtener instrucciones sobre cómo mostrar los diferentes tipos de anuncios, consulta las páginas de bloques de anuncios correspondientes.

Requisitos

  • Este SDK requiere la versión 15.0 o posterior de Xcode.
  • La aplicación debe tener como destino iOS 12.0 o superior.
  • Para mostrar anuncios, debes tener un identificador de ubicación de Xandr y un identificador de miembro válidos.

Instalación

Hay cuatro formas de obtener nuestro SDK:

CocoaPods

Si no está familiarizado con CocoaPods, revise su documentación. Una vez que tenga CocoaPods instalado:

  1. Use Terminal o el editor de línea de comandos de su elección, navegue hasta el directorio raíz de su proyecto y cree un podfile.

    pod init
    
  2. Con un editor de texto, abra el archivo pod recién creado. Establezca la versión de la plataforma en 12.0 y agregue podAppNexusSDX'' al destino.

    # iOS: Podfile config to include our SDK
    platform :ios, '12.0'
    project 'FunBanner'
    target 'FunBanner' do
      pod 'AppNexusSDK'
    end
    
    
  3. Guarde sus cambios y regrese a la Terminal e ingrese:

    pod install
    
  4. CocoaPods descarga el SDK de Xandr y crea un espacio de trabajo (.xcworkspace) en el directorio del proyecto. Si el proyecto está abierto actualmente, ciérrelo y abra xcworkspace.

Cartago

Si no está familiarizado con Carthage, revise su documentación. Una vez instalado Carthage en el equipo, siga estos pasos:

  1. Abra la aplicación Terminal y vaya al directorio raíz del proyecto. Crear un archivo de cart.

    touch Cartfile
    
  2. Abre el archivo Cartfile en Xcode para editarlo.

    open -a Xcode Cartfile
    
  3. Agregue las siguientes líneas al Cartfile.

    # iOS: Carthage config to include our SDK
    binary "https://adsdkprod.azureedge.net/mobile/ios/releases/carthage/AppNexusSDK.json"
    binary "https://adsdkprod.azureedge.net/mobile/ios/releases/carthage/OMSDK_Microsoft.json"
    
    

    Sugerencia

    Puede usar un editor distinto de Xcode para editar el Cartfile, pero tenga en cuenta que otros programas de edición, como TextEdit, pueden incluir automáticamente comillas inteligentes en lugar de comillas rectas. Carthage no reconoce el contenido entre comillas tipográficas y no funciona correctamente.

  4. Guarde el archivo Cart. Ejecute el siguiente comando para actualizar las dependencias:

    carthage update --use-xcframeworks
    
  5. Para usar AppNexusSDK el SDK, agrega el AppNexusSDKDynamic.xcframework and OMSDK_AppNexus.xcframework a la sección Archivos binarios incrustados :

    • Vaya a Archivos binarios de destinoGeneral → incrustados.
    • Haga clic en el + icono y agregue el AppNexusSDKDynamic.xcframework signo y OMSDK_AppNexus.xcframework.
  6. Si usa Carthage para una aplicación, seleccione Embed & Sign. En caso contrario, seleccione No insertar.

XCFramework

Descargue el SDK más reciente de iOS versión 9.x desde Azure CDN. El archivo ZIP descargado contiene el siguiente paquete de marcos y recursos. Asegúrese de usar el marco adecuado que mejor se adapte a sus necesidades. El AppNexusSDK es la recomendación para uso general.

Marco Descripción
AppNexusSDK Admite todos los tipos de anuncios.
AppNexusNativeSDK Este marco solo admite anuncios nativos en iOS.
AppNexusNativeMacOSSDK Este marco solo admite anuncios nativos en MacOS.
ANSmartAdapter Un adaptador de mediación para Smart Ad Server.
ANGoogleAdapter Un adaptador de mediación para AdMob de Google.
ANFacebookCSRAdapter Un adaptador de representación del lado cliente para Facebook Audience Network.
ANSDKResources.bundle Contiene los archivos necesarios que usa el SDK.
  1. Abre el proyecto o el área de trabajo de Xcode de la aplicación.

  2. Vaya a la página de configuración general del destino de la aplicación.

  3. Para usar el AppNexusSDK, debe agregar el AppNexusSDK.xcframework y .ANSDKResources.bundle

  4. Para importar el AppNexusSDK.xcframeworkarchivo ,

    • Vaya a la configuración de Destino del proyecto.
    • Vaya a General de destino>.
    • Haga clic en el + botón de la sección Marcos, bibliotecas y contenido incrustado .
    • Haga clic en Agregar otro y, a continuación, en Agregar Files.
    • Elija el AppNexusSDK.xcframework archivo y haga clic en Abrir.

    Captura de pantalla que muestra cómo agregar el SDK de AppNexus en XCF.

  5. Para incluir el ANSDKResources.bundle,

    • Vaya a lafase de compilaciónde destino>.
    • Expanda la fila Copiar recursos de agrupación y haga clic en el + icono.
    • Elija el ANSDKResources.bundle archivo y haga clic en Abrir.

    Captura de pantalla que muestra cómo agregar un conjunto de recursos ANDK en XCF.

Administrador de paquetes Swift

  1. Ve a Dependencias de paquete en tu proyecto Xcode y haz clic en el + botón. Captura de pantalla que muestra los pasos para abrir un proyecto de paquete Swift.
  2. Copie y pegue la dirección URL https://github.com/appnexus/mobile-sdk-ios-spm en el cuadro de búsqueda y presione Enter/Return. Captura de pantalla que muestra los pasos para buscar un paquete Swift.
  3. En la ventana emergente Elegir productos de paquete para mobile-sdk-ios-spm , estarán presentes diferentes productos de paquete. Seleccione AppNexusSDK y haga clic en Add Package. La captura de pantalla muestra la ventana emergente del paquete de paquete Swift.
  4. Se mostrará el paquete seleccionado y se hará clic en Add Package él para guardar la configuración en Dependencias del paquete.