Escucha de eventos de anuncios nativos en iOS

Información general

Un publicador puede optar por el SDK para controlar varios eventos de anuncios, como AdClick, la aparición de impresiones, etc., mediante el registro en NativeAdEventListener API. Con la API, el SDK controla todos los eventos mencionados y notifica a los publicadores si los seguimientos de impresiones se desencadenan o no para los creativos. Para escuchar los eventos de Ad, los publicadores deben registrarse primero mediante registerViewForTracking, después de lo cual el SDK usa NativeAdEventListener para realizar un seguimiento de los eventos del anuncio. Los publicadores deben anular el registro mediante NativeAdResponse cuando terminen con las vistas de la respuesta o quieran reutilizar los objetos vieww para un nuevo NativeAdResponse.

Ámbito de escucha de eventos de anuncios nativos

El ámbito de esta característica se limita solo a las creatividades nativas.

Métodos

Registro para el seguimiento de eventos de anuncios: registerViewForTracking

Método que registra una única o una lista de las vistas de desarrollador que realizarán un seguimiento de las impresiones y responderán a los clics del anuncio nativo.

- (BOOL)registerViewForTracking:(nonnull UIView *)view
         withRootViewController:(nonnull UIViewController *)rvc
                 clickableViews:(nullable NSArray *)views
                          error:(NSError *__nullable*__nullable)error

También puede pasar una lista de obstrucción amistosa en este método. Para obtener más información sobre las obstrucciones amistosas, consulte OMID-Friendly Obstruction for iOS.

- (BOOL)registerViewForTracking:(nonnull UIView *)view
         withRootViewController:(nonnull UIViewController *)rvc
                 clickableViews:(nullable NSArray<UIView *> *)views
                 openMeasurementFriendlyObstructions:(nonnull NSArray<UIView *> *)obstructionViews
                          error:(NSError *__nullable*__nullable)error;

Seguimiento de eventos de anuncios: NativeAdEventListener

API con métodos para realizar un seguimiento de los eventos de anuncios, como:

• cuando el usuario hace clic en la vista nativa.

• cuando la vista nativa devuelve la dirección URL de click-through y la dirección URL de reserva de click-through.

• cuando se hizo clic en la vista nativa y el clic en destino está a punto de abrirse en el explorador desde la aplicación.

• cuando el explorador en la aplicación haya terminado de presentar y tomar el control de la aplicación.

• cuando se cerrará el explorador en la aplicación y se devolverá el control a la aplicación.

• cuando el explorador en la aplicación se ha cerrado y se ha devuelto el control a la aplicación.

• cuando el anuncio está a punto de salir de la aplicación o cuando se registra una impresión para un creativo nativo.

  /*!
  * Sent when the native view is clicked by the user.
  */
  - (void)adWasClicked:(nonnull id)response;
  
  
  /*!
  * Sent when the native view returns the click-through URL and click-through fallback URL
  *   to the user instead of opening it in a browser.
  */
  - (void)adWasClicked: (nonnull id)response
               withURL: (nonnull NSString *)clickURLString
           fallbackURL: (nonnull NSString *)clickFallbackURLString;
  
  
  /*!
  * Sent when the native view was clicked, and the click through
  * destination is about to open in the in-app browser.
  *
  * @note If it is preferred that the destination open in the
  * native browser instead, then set clickThroughAction to ANClickThroughActionOpenDeviceBrowser.
  */
  - (void)adWillPresent:(nonnull id)response;
  
  
  /*!
  * Sent when the in-app browser has finished presenting and taken
  * control from your application.
  */
  - (void)adDidPresent:(nonnull id)response;
  
  
  /*!
  * Sent when the in-app browser will close and before
  * control has been returned to your application.
  */
  - (void)adWillClose:(nonnull id)response;
  
  
  /*!
  * Sent when the in-app browser has closed and control
  * has been returned to your application.
  */
  - (void)adDidClose:(nonnull id)response;
  
  
  /*!
  * Sent when the ad is about to leave the app.
  * This will happen in a number of cases, including when
  *   clickThroughAction is set to ANClickThroughActionOpenDeviceBrowser.
  */
  - (void)adWillLeaveApplication:(nonnull id)response;
  
  
  
  /*!
  * Sent when  an impression is recorded for an native ad
  */
  - (void)adDidLogImpression:(nonnull id)response;
  

Anulación del registro para el seguimiento de eventos de anuncios: unregisterTracking

Método para anular el registro de un creativo nativo del seguimiento.

self.nativeAdResponse = nil

Ejemplo

- (void)adWasClicked: (nonnull id)response
             withURL: (nonnull NSString *)clickURLString
         fallbackURL: (nonnull NSString *)clickFallbackURLString
{
    NSLog(@"adWasClicked callback called wadWillExpireithURLString");
}
- (void)adWasClicked:(nonnull id)response {
    NSLog(@"adWasClicked callback called");
}
 
 
- (void)adWillPresent:(nonnull id)response {
    NSLog(@"adWillPresent callback called");
}
 
 
- (void)adDidPresent:(nonnull id)response {
    NSLog(@"adDidPresent callback called");
}
 
 
- (void)adWillClose:(nonnull id)response {
    NSLog(@"adWillClose callback called");
}
 
 
- (void)adDidClose:(nonnull id)response {
    NSLog(@"adDidClose callback called");
}
 
 
- (void)adWillLeaveApplication:(nonnull id)response {
    NSLog(@"adWillLeaveApplication callback called");
}
 
 
- (void)adDidLogImpression:(id)ad {
    NSLog(@"adDidLogImpression callback called");
}