com.criteo.publisher

Interface BidResponseListener

public interface BidResponseListener

Method Summary

Modifier and Type	Method and Description
void	onResponse(Bid bid) Callback invoked when a response for a bid is given to the publisher.

Method Detail

onResponse

@UiThread
void onResponse(@Nullable
                          Bid bid)

Callback invoked when a response for a bid is given to the publisher.

In case of no bid, the given response is null. In case of successful bid, the given response is not null and its CPM is accessible through Bid.getPrice().

InHouse integration

When using the In-House integration, the response can be given to one of these methods, to display the Ad:

• CriteoBannerView.loadAd(Bid): display a banner
• CriteoInterstitial.loadAd(Bid): display an interstitial
• CriteoNativeLoader.loadAd(Bid): display a native ad

Please note that the loadAd method should match the kind of AdUnit the bid was asked for.

AppBidding integration

When using the AppBidding integration, the response can be given to the Criteo.enrichAdObjectWithBid(Object, Bid) method, to enrich your ad server object.

Memory management

This listener can be retained few seconds until it is notified. As an effect, if this listener holds a reference to an activity, when the activity is closed, then it can still be retained briefly in memory. If drastic memory management is required, few actions can be applied:

• Prefer lambda expression or static inner class over anonymous class: anonymous classes implicitly hold the outer class
• Use WeakReference to capture Activity or View (or any big object)

Here is a sample code showing this:

   class MyActivity extends Activity {
     private CriteoBannerView bannerView;

     void sample() {
       // This is an anonymous class, "this" is implicitly hold and is retained until listener is notified
       Criteo.getInstance().loadBid(adUnit, new BidResponseListener() {
       });

       // "this" is explicitly held and is retained until listener is notified
       Criteo.getInstance().loadBid(adUnit, bid -> {
         this.bannerView.loadAd(bid);
       });

       // "this" is weakly held and is not retained
       WeakReference≶MyActivity> weakThis = new WeakReference(this);
       Criteo.getInstance().loadBid(adUnit, bid -> {
         MyActivity activity = weakThis.get();
         if (activity != null) {
           activity.bannerView.loadAd(bid);
         }
       });
     }
   }
 

Parameters:

bid - null in case of no bid, or a bid object that can be used to display an Ad

See Also:

InHouse documentation, AppBidding documentation, Criteo.loadBid(AdUnit, BidResponseListener)