Demanda de Vungle para iOS

En esta página se proporcionan pasos detallados para integrar y mostrar anuncios de vídeo intersticiales mediante el SDK de Vungle en la aplicación iOS.

Requisitos previos

Antes de integrar Vungle Demand, asegúrese de que tiene instaladas las siguientes versiones del SDK:

• SDK de Microsoft Ads: versión 9.3.0
• ANVungleAdapter: necesario para la integración de Vungle
• SDK de VungleAds: versión 7.3.2

Instalación del SDK

Para integrar Vungle Demand, deberá instalar mobile SDK y el paquete ANVungleAdapter . Siga los pasos siguientes para instalar las dependencias necesarias mediante CocoaPods.

Paso 1: Instalar CocoaPods

Si no ha instalado CocoaPods, siga la guía de instalación de CocoaPods.org.

Paso 2: Creación y configuración del podfile

1. Abra Terminal o el editor de línea de comandos que prefiera.

2. Vaya al directorio del proyecto.

3. Cree un nuevo podfile mediante la ejecución del comando :

   pod init
   

4. Abra el podfile recién creado mediante un editor de texto.

5. Asegúrese de que la plataforma está establecida en iOS 12.0 e incluya las siguientes dependencias en la target sección :

Configuración de podfile de ejemplo

    platform :ios, '12.0'
    project 'SampleApp'

    target 'SampleApp' do
        pod 'AppNexusSDK'
        pod 'AppNexusSDK/ANVungleAdapter'
    end

Paso 3: Instalar los pods

1. Guarde los cambios en podfile y, a continuación, continúe con la instalación de las dependencias.
2. En Terminal, ejecute el siguiente comando para instalar los pods.

Inicializar el SDK de Vungle

Para inicializar el SDK de Vungle, agregue el código siguiente al ciclo de vida temprano de la aplicación. Reemplace "YOUR_APP_ID" por el identificador de aplicación proporcionado por Vungle.

Ejemplo

VungleAds.initWithAppId("YOUR_APP_ID") { error in
    if let error = error {
        print("VUNGLE - Error initializing SDK: \(error.localizedDescription)")
    } else {
        print("VUNGLE - SDK initialization successful")
        ANVungleSettings.setVungleInitialize(true)
    }
}

[VungleAds initWithAppId:@"" completion:^(NSError * _Nullable error) {
    if (error) {
        NSLog(@"Error initializing SDK");
    } else {
        NSLog(@"Init is complete");
    }
}];

if ([VungleAds isInitialized]) {
    NSLog(@"SDK is initialized");
} else {
    NSLog(@"SDK is NOT initialized");
}

• Si la inicialización se realiza correctamente, ANVungleSettings.setVungleInitialize(true) se establecerá.
• Si se produce un error en la inicialización, ANVungleSettings.setVungleInitialize(false) se establecerá.
• Cuando se inicializa correctamente, el getBidderToken método devuelve un token de pujador válido, mientras que si se produce un error en la inicialización, devuelve nil.

Inicializar un objeto intersticial y establecer la palabra clave requerida

Después de inicializar correctamente el SDK de Vungle, nuestro SDK capturará automáticamente el token del pujador de Vungle e lo incluirá en la solicitud de anuncio, que luego se pasará a PSP. Siga estos pasos para inicializar un objeto intersticial y establecer la palabra clave necesaria:

1. Inicialice un ANInterstitialAd objeto.
2. Conserve una referencia a esta instancia correctamente.
3. Establezca una palabra clave personalizada en la solicitud antes de llamar al load() método :
   • La clave debe ser la cadena : VUNGLE_PLACEMENT_ID_FOR_CSR.
   • El valor debe ser la ubicación de Vungle, asignada a la ubicación Monetizar.

Código de ejemplo

import VungleAdsSDK
import AppNexusSDK
import ANVungleAdapter

var interstitialAd = ANInterstitialAd()

// Initialize the interstitial ad object
interstitialAd = ANInterstitialAd(placementId: "1234567")

// Set the required keyword
interstitialAd.addCustomKeyword(withKey: "VUNGLE_PLACEMENT_ID_FOR_CSR", value: "VUNGLE_PLACEMENT_123")

// Assign a delegate
interstitialAd.delegate = self

// Make a request to load the ad
interstitialAd.load()

@property (nonatomic, strong)ANInterstitialAd *interstitialAd;

    self.interstitialAd = [[ANInterstitialAd alloc] initWithPlacementId:@"12345"];
    self.interstitialAd.delegate = self;
    [self.interstitialAd addCustomKeywordWithKey:@"VUNGLE_PLACEMENT_ID_FOR_CSR" value: @"VUNGLE_PLACEMENT_123"];
    [self.interstitialAd loadAd];

Representación creativa

Una vez que el anuncio intersticial se haya cargado correctamente, puedes mostrarlo a los usuarios en función de la lógica de la aplicación. En el ejemplo siguiente, el anuncio se muestra inmediatamente después de la carga.

Ejemplo

func adDidReceiveAd(_ ad: Any) {
    self.interstitialAd.display(from: self)
}

- (void)adDidReceiveAd:(id<ANAdProtocol>)ad {
    [self.interstitialAd displayAdFromViewController: self];
}