Mediar con iOS

En este artículo se describe cómo instalar y configurar adaptadores de mediación para el SDK de iOS.

Información general

La mediación permite que la aplicación solicite anuncios de varias redes de anuncios a través del SDK de iOS. Cada adaptador conecta el SDK de iOS a un SDK de red. Durante una solicitud de anuncio, la mediación comprueba los orígenes de demanda configurados hasta que uno llena la solicitud o no queda ninguna demanda.

Redes y tipos de medios admitidos

Se admiten los siguientes adaptadores de mediación y tipos de medios:

Requisitos

• La aplicación debe tener como destino iOS 15.0 o posterior.
• Instale una versión del SDK de iOS compatible. Para obtener instrucciones, consulte las instrucciones de integración del SDK de iOS.
• Agregue un adaptador para cada red en la que desee mediar.

Instalar adaptadores de mediación

Utilice el Administrador de paquetes Swift para agregar uno o ambos paquetes de adaptadores de mediación. Cada paquete declara las dependencias compatibles del SDK de iOS y del SDK de red de terceros, que el Administrador de paquetes Swift resuelve automáticamente.

Para Google AdMob o Google Ad Manager, agrega el siguiente paquete y selecciona el ANGoogleAdapter producto:

https://github.com/appnexus/mobile-sdk-ios-mediation-google

Para SmartAdServer, agregue el siguiente paquete y seleccione el ANSmartAdapter producto:

https://github.com/appnexus/mobile-sdk-ios-mediation-smartadserver

Para cada adaptador:

1. Abra el proyecto en Xcode.
2. Seleccione el proyecto en el navegador de proyectos y, a continuación, seleccione Dependencias del paquete.
3. Selecciona el + botón, escribe una de las direcciones URL de paquete que se muestran arriba y presiona Retorno.
4. Elija la configuración de versión que se adapte a su proyecto. Para proyectos nuevos, seleccione Hasta la siguiente versión principal. Luego seleccione Agregar paquete.
5. Seleccione el producto de adaptador identificado anteriormente y el destino de la aplicación, y luego seleccione Agregar paquete.
6. Compruebe que el adaptador aparece en Dependencias del paquete.

Después de instalar los adaptadores, completa la configuración de cada adaptador antes de cargar los anuncios.

SDK de anuncios de Google para móviles

El ANGoogleAdapter paquete admite la demanda de Google AdMob y Google Ad Manager. Ambas fuentes de demanda admiten anuncios publicitarios e intersticiales. La mediación nativa solo está disponible para AdMob.

Agregar el id. de la aplicación de Google (AdMob y Google Ad Manager)

Agregue la GADApplicationIdentifier clave al Info.plistarchivo . Establece su valor en el id. de tu aplicación de AdMob o Google Ad Manager. Esta configuración a nivel de aplicación se aplica a todos los formatos de anuncios de Google:

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-################~##########</string>

Pasar una URL de contenido (AdMob y Google Ad Manager)

Para pasar la URL del contenido que rodea a un anuncio a Google, agréguela content_url como palabra clave personalizada al bloque de anuncios. Esto se aplica a las solicitudes de banners e intersticiales de AdMob y Google Ad Manager, y a las solicitudes nativas de AdMob. En el ejemplo siguiente se usa ANBannerAdView:

let size = CGSize(width: 320, height: 50)
let banner = ANBannerAdView(frame: CGRect(origin: .zero, size: size), placementId: "123456", adSize: size) // Create the banner ad view
banner.addCustomKeywords(withKey: "content_url", values: ["https://www.example.com"]) // Set the content URL

CGSize size = CGSizeMake(320, 50);
ANBannerAdView *banner = [ANBannerAdView adViewWithFrame:CGRectMake(0, 0, 320, 50) placementId:@"123456" adSize:size]; // Create the banner ad view
[banner addCustomKeywordsWithKey:@"content_url" values:@[@"https://www.example.com"]]; // Set the content URL

Admite múltiples ventanas de iPad (AdMob y Google Ad Manager)

Para cargar anuncios de banner mediados por Google en una aplicación para iPad que admita varias ventanas, habilita la compatibilidad con varias escenas antes de cargar anuncios. Cargar el banner desde viewDidAppear(_:) en lugar de viewDidLoad(). Esta configuración solo se aplica a los anuncios de banner mediados por Google en aplicaciones de iPad de varias ventanas:

ANGoogleMediationSettings.setIPadMultiSceneSupport(true) // Enable iPad multi-scene support

[ANGoogleMediationSettings setIPadMultiSceneSupport:YES]; // Enable iPad multi-scene support

Establecer un ID proporcionado por el editor (solo Google Ad Manager)

Para pasar un identificador definido por el editor a Google Ad Manager para la segmentación y la generación de informes de anuncios, establece un ID proporcionado por el editor (PPID) antes de realizar solicitudes de anuncios. Esto solo se aplica a petición de Google Ad Manager:

ANGoogleMediationSettings.setGooglePublisherProvidedId("example-ppid-123") // Set the Google PPID

[ANGoogleMediationSettings setGooglePublisherProvidedId:@"example-ppid-123"]; // Set the Google PPID

Configurar la mediación nativa (solo AdMob)

Para renderizar una respuesta nativa de AdMob, carga la vista de anuncios nativos desde un XIB. Establezca la vista raíz del XIB en NativeAdView en Swift o GADNativeAdView en Objective-C. En el siguiente ejemplo se verifica que AdMob haya rellenado la solicitud, procese el título y registre la vista para su seguimiento:

func adRequest(_ request: ANNativeAdRequest, didReceive response: ANNativeAdResponse) {
  guard response.networkCode == .adMob else { return }

  let adNib = UINib(nibName: "NativeAdView", bundle: .main)
  guard let nativeAdView = adNib.instantiate(withOwner: self).first as? NativeAdView else { return }
  (nativeAdView.headlineView as? UILabel)?.text = response.title // Render the native ad title

  do {
    try response.registerView(
      forTracking: nativeAdView,
      withRootViewController: self,
      clickableViews: [nativeAdView.callToActionView as Any]
    ) // Register the AdMob native view
  } catch {
    print("Unable to register the AdMob native view: \(error)")
  }
}

- (void)adRequest:(ANNativeAdRequest *)request
    didReceiveResponse:(ANNativeAdResponse *)response {
  if (response.networkCode != ANNativeAdNetworkCodeAdMob) {
    return;
  }

  NSArray *objects = [[NSBundle mainBundle] loadNibNamed:@"NativeAdView"
                           owner:self
                           options:nil];
  GADNativeAdView *nativeAdView = objects.firstObject;
  ((UILabel *)nativeAdView.headlineView).text = response.title; // Render the native ad title

  NSError *registrationError = nil;
  [response registerViewForTracking:nativeAdView
         withRootViewController:self
             clickableViews:@[nativeAdView.callToActionView]
                error:&registrationError]; // Register the AdMob native view
}

SmartAdServer

El adaptador SmartAdServer no requiere configuración adicional después de agregar su dependencia de paquete.

Redes de mediación personalizadas

Microsoft Monetize proporciona compatibilidad integrada para varias redes de anuncios móviles. Para mediar en otra red:

• Escribir un adaptador de mediación personalizado que permita que el SDK de iOS reciba eventos del SDK de red.
• Siga las instrucciones de Agregar una red para crear una red móvil personalizada.

Temas relacionados

• Instrucciones de integración del SDK de iOS
• Adaptadores personalizados de iOS