NativeAd provides ad creative for apps to rendered in custom layout.
To use NativeAd, do the following:
NativeAd nativeAd = new NativeAd(context, PLACEMENT_ID); nativeAd.setAdListener(new AdListener() { public void onAdLoaded(Ad ad) { if (ad == nativeAd) { // Renders the ad using creative properties String adTitle = getAdTitle(); } } // rest of AdListener implementation omitted }); nativeAd.loadAd();
Before displaying the ad, call NativeAd.registerViewForInteraction(View viewContainer) to handle logging of ad impressions and clicks.
| Extends: | Object |
| Implements: | Ad |
| Package: | ads |
NativeAd(Context, String)Constructs an NativeAd using the given context and placement id.
public NativeAd(Context context, String placementId) | Parameter | Description |
|---|---|
context | Android context |
placementId | Id of ad placement |
downloadAndDisplayImage(Image, ImageView)Downloads the given Image and displays it in the given ImageView.
This method always returns immediately. Image is downloaded asynchronously.
public static void downloadAndDisplayImage(Image image, ImageView imageView) | Parameter | Description |
|---|---|
image | Image to be downloaded |
imageView | View to show the downloaded image |
setAdListener(AdListener)Sets an AdListener to be notified on events happened in control lifecycle.
public void setAdListener(AdListener adListener) | Parameter | Description |
|---|---|
adListener | The listener |
setImpressionListener(ImpressionListener)Sets an ImpressionListener to be notified of impression events in ad control lifecycle.
public void setImpressionListener(ImpressionListener impListener) | Parameter | Description |
|---|---|
impListener | The listener |
loadAd()Loads an ad.
This method always returns immediately. The ad is loaded asynchronously. The control's ad listener will be called when loading finishes or fails.
public void loadAd() loadAd()public void loadAd() destroy()Destroys the ad control.
This method should be called when the hosting activity of the ad control is destroyed.
public void destroy() destroy()public void destroy() isAdLoaded()Gets whether an ad is loaded and ready to show.
public boolean isAdLoaded() getAdIcon()Gets the icon creative.
public Image getAdIcon() getAdCoverImage()Gets the cover image creative.
public Image getAdCoverImage() getAdTitle()Gets the title.
public String getAdTitle() getAdBody()Gets the body, usually a longer description of the ad.
public String getAdBody() getAdCallToAction()Gets the call to action phrase.
public String getAdCallToAction() getAdSocialContext()Gets the social context.
public String getAdSocialContext() getAdStarRating()Gets the star rating.
public Rating getAdStarRating() getId()public String getId() registerViewForInteraction(View)Registers the given view as the container for this NativeAd to handle impressions and clicks. Applies a click handler to the entire unit.
public void registerViewForInteraction(View view) | Parameter | Description |
|---|---|
view | The View containing this NativeAd for display |
registerViewForInteraction(View, List)Registers the given view as the container for this NativeAd to handle impressions and clicks. Applies a click handler all views provided in clickableViews.
public void registerViewForInteraction(View view, List clickableViews) | Parameter | Description |
|---|---|
view | The View containing this NativeAd for display |
clickableViews | A list of all view elements that should handle taps on this unit |
unregisterView()public void unregisterView()