Escucha de eventos de anuncios nativos en Android

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 registerTracking, 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 unregisterTracking cuando terminen con las vistas de la respuesta o quieran reutilizar los objetos de vista 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: registerTracking

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.

public static void registerTracking(final NativeAdResponse response, final View view, final NativeAdEventListener listener)
public static void registerTracking(final NativeAdResponse response, final View container, final List<View> views, final NativeAdEventListener listener)

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

public static void registerTracking(final NativeAdResponse response, final View view, final NativeAdEventListener listener, final List<View> friendlyObstructionsList)
public static void registerTracking(final NativeAdResponse response, final View container, final List<View> views, final NativeAdEventListener listener, final List<View> friendlyObstructionsList)

Puede pasar un valor booleano que indica si se va a habilitar la optimización de OMID. Establézcalo en true para habilitar la optimización de OMID, que desencadena comprobaciones de visibilidad y administra la sesión de anuncios de OMID.

public static void registerTracking(final NativeAdResponse response, final View view, final NativeAdEventListener listener, final List friendlyObstructionsList, final boolean enableOMIDOptimization)

public static void registerTracking(final NativeAdResponse response, final View container, final List views, final NativeAdEventListener listener, final List friendlyObstructionsList, final boolean enableOMIDOptimization)

public static void registerTracking(final NativeAdResponse response, final View view, final NativeAdEventListener listener, final boolean enableOMIDOptimization)

public static void registerTracking(final NativeAdResponse response, final View container, final List views, final NativeAdEventListener listener, final boolean enableOMIDOptimization)

Seguimiento de eventos de anuncios: NativeAdEventListener

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

• cuando se establece el clic en el anuncio para que lo controle la aplicación o el SDK.

• cuando el anuncio quita al usuario de la aplicación.

• cuando se registra una impresión para un creativo nativo.

  /**
  * Called when the developer sets the ad click to be handled by the SDK
  */
  public void onAdWasClicked();
  
  /**
  * Called when the ad takes the user away from the application
  */
  public void onAdWillLeaveApplication();
  
  /**
  * Called when the developer sets the ad click to be handled by the app
  * @param clickUrl the click url
  * @param fallbackURL the fallback url
  */
  public void onAdWasClicked(String clickUrl,String fallbackURL);
  
  /**
  * Called when an impression is recorded for an native ad
  */
  public void onAdImpression();
  

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

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

public static void unRegisterTracking(final View view)

Ejemplo

// Register the Native Ad to listen to the Ad events
NativeAdSDK.registerTracking(response, nativeAdContainer, nativeAdEventListener);
// Initialise NativeAdEventListener
NativeAdEventListener nativeAdEventListener = new NativeAdEventListener() {
        @Override
        public void onAdWasClicked() {
            Log.d(LOG_TAG, "Native  onAdWasClicked");
        }
 
        @Override
        public void onAdWillLeaveApplication() {
            Log.d(LOG_TAG, "Native onAdWillLeaveApplication");
        }
 
        @Override
        public void onAdWasClicked(String clickUrl, String fallbackURL) {
            Log.d(LOG_TAG, "onAdWasClicked::clickUrl" + clickUrl + "::fallbackURL::" + fallbackURL);
        }
 
        @Override
        public void onAdImpression() {
            Log.d(LOG_TAG, "Native  onAdImpression");
        }
    };