Package com.ooyala.pulse
Interface PulsePauseAd
-
- All Superinterfaces:
PulseAd
public interface PulsePauseAd extends PulseAd
This interface is used to notify the owningPulseSessionabout events regarding a pause ad, and provides access to relevant properties.You must notify this object of the following events:
- The ad has been displayed:
adDisplayed() - The ad has been closed by the user:
adClosed() - The ad failed to be displayed:
adFailed(PulseAdError)
Depending on your application, some of the other methods may need to be called in response to user interaction.
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface com.ooyala.pulse.PulseAd
PulseAd.Variant
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description voidadClickThroughTriggered()Notify the session that the user has opened the clickthrough link.voidadClosed()Notify the session that the pause ad has been closed by the user.voidadDisplayed()Notify the session that the ad has been displayedvoidadFailed(PulseAdError error)Notify the session that, due to an error, the ad could not be displayed.java.lang.StringgetAdvertiserIdentifier()The identifier of the advertiser to which the ad belongs.java.lang.StringgetCampaignIdentifier()The identifier of the campaign to which the ad belongs.java.util.List<AdCategory>getCategories()The category labels identifying the ad's value.java.net.URLgetClickThroughURL()Returns a URL for a web page that should be displayed to the user when they tap the ad.java.util.List<PulseCompanionAd>getCompanions()The companions to show along with this ad.java.lang.StringgetCustomCampaignIdentifier()The custom identifier of the campaign to which the ad belongs; set in the Pulse UI.java.lang.StringgetCustomGoalIdentifier()The custom identifier of the goal to which the ad belongs; set in the Pulse UI.java.lang.StringgetCustomIdentifier()The custom ad identifier set in the Pulse UI.java.lang.StringgetGoalIdentifier()The identifier of the goal to which the ad belongs.java.lang.StringgetIdentifier()The ad identifier.java.lang.StringgetResourceType()Returns the MIME type of the resource for this ad.java.net.URLgetResourceURL()Returns the URL where the ad's resource is located.java.lang.StringgetTitle()The title of the ad.booleanisPartOfAnExclusiveCampaign()Indicates whether the ad is part of an exclusive campaign.
-
-
-
Method Detail
-
adDisplayed
void adDisplayed()
Notify the session that the ad has been displayedThis should only be called after your listener has been instructed to show the ad through
PulseSessionListener.showPauseAd(PulsePauseAd).
-
adClosed
void adClosed()
Notify the session that the pause ad has been closed by the user. Do not call if the ad was closed because the user resumed playback of the video content.
-
adClickThroughTriggered
void adClickThroughTriggered()
Notify the session that the user has opened the clickthrough link.
-
adFailed
void adFailed(PulseAdError error)
Notify the session that, due to an error, the ad could not be displayed.- Parameters:
error- ThePulseAdErrorthat best describes the problem.
-
getResourceURL
java.net.URL getResourceURL()
Returns the URL where the ad's resource is located.- Returns:
- the resource URL for this ad.
-
getResourceType
java.lang.String getResourceType()
Returns the MIME type of the resource for this ad.- Returns:
- The resource type.
-
getClickThroughURL
java.net.URL getClickThroughURL()
Returns a URL for a web page that should be displayed to the user when they tap the ad.- Returns:
- the URL to be displayed.
-
getCompanions
java.util.List<PulseCompanionAd> getCompanions()
The companions to show along with this ad. Bear in mind that only companion banners with resources of typeStaticResourceare returned.- Returns:
- The companion(s) for this ad.
-
getTitle
java.lang.String getTitle()
The title of the ad.- Returns:
- A string that provides a common name for the ad
-
getIdentifier
java.lang.String getIdentifier()
The ad identifier.- Returns:
- The ad identifier.
-
getCustomIdentifier
java.lang.String getCustomIdentifier()
The custom ad identifier set in the Pulse UI.- Returns:
- The custom ad identifier.
-
getCampaignIdentifier
java.lang.String getCampaignIdentifier()
The identifier of the campaign to which the ad belongs.- Returns:
- The campaign identifier of the ad.
-
getAdvertiserIdentifier
java.lang.String getAdvertiserIdentifier()
The identifier of the advertiser to which the ad belongs.- Returns:
- The identifier of advertiser.
-
getCustomCampaignIdentifier
java.lang.String getCustomCampaignIdentifier()
The custom identifier of the campaign to which the ad belongs; set in the Pulse UI.- Returns:
- The custom campaign identifier of the ad.
-
getGoalIdentifier
java.lang.String getGoalIdentifier()
The identifier of the goal to which the ad belongs.- Returns:
- The goal identifier of the ad.
-
getCustomGoalIdentifier
java.lang.String getCustomGoalIdentifier()
The custom identifier of the goal to which the ad belongs; set in the Pulse UI.- Returns:
- The custom goal identifier of the ad.
-
isPartOfAnExclusiveCampaign
boolean isPartOfAnExclusiveCampaign()
Indicates whether the ad is part of an exclusive campaign.- Returns:
- true if the ad is part of an exclusive campaign, otherwise false.
-
getCategories
java.util.List<AdCategory> getCategories()
The category labels identifying the ad's value.- Returns:
- The List of AdCategory
AdCategorycontaining the categories of the Ad and their responsible authorities.
-
-