Package com.ooyala.pulse
Interface PulsePauseAd
- All Superinterfaces:
PulseAd
This interface is used to notify the owning
PulseSession
about 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
Modifier and TypeMethodDescriptionvoid
Notify the session that the user has opened the clickthrough link.void
adClosed()
Notify the session that the pause ad has been closed by the user.void
Notify the session that the ad has been displayedvoid
adFailed
(PulseAdError error) Notify the session that, due to an error, the ad could not be displayed.The identifier of the advertiser to which the ad belongs.The identifier of the campaign to which the ad belongs.The category labels identifying the ad's value.Returns a URL for a web page that should be displayed to the user when they tap the ad.The companions to show along with this ad.The custom identifier of the campaign to which the ad belongs; set in the Pulse UI.The custom identifier of the goal to which the ad belongs; set in the Pulse UI.The custom ad identifier set in the Pulse UI.The identifier of the goal to which the ad belongs.The ad identifier.Returns the MIME type of the resource for this ad.Returns the URL where the ad's resource is located.getTitle()
The title of the ad.boolean
Indicates whether the ad is part of an exclusive campaign.
-
Method Details
-
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
Notify the session that, due to an error, the ad could not be displayed.- Parameters:
error
- ThePulseAdError
that best describes the problem.
-
getResourceURL
URL getResourceURL()Returns the URL where the ad's resource is located.- Returns:
- the resource URL for this ad.
-
getResourceType
String getResourceType()Returns the MIME type of the resource for this ad.- Returns:
- The resource type.
-
getClickThroughURL
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
List<PulseCompanionAd> getCompanions()The companions to show along with this ad. Bear in mind that only companion banners with resources of typeStaticResource
are returned.- Returns:
- The companion(s) for this ad.
-
getTitle
String getTitle()The title of the ad.- Returns:
- A string that provides a common name for the ad
-
getIdentifier
String getIdentifier()The ad identifier.- Returns:
- The ad identifier.
-
getCustomIdentifier
String getCustomIdentifier()The custom ad identifier set in the Pulse UI.- Returns:
- The custom ad identifier.
-
getCampaignIdentifier
String getCampaignIdentifier()The identifier of the campaign to which the ad belongs.- Returns:
- The campaign identifier of the ad.
-
getAdvertiserIdentifier
String getAdvertiserIdentifier()The identifier of the advertiser to which the ad belongs.- Returns:
- The identifier of advertiser.
-
getCustomCampaignIdentifier
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
String getGoalIdentifier()The identifier of the goal to which the ad belongs.- Returns:
- The goal identifier of the ad.
-
getCustomGoalIdentifier
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
List<AdCategory> getCategories()The category labels identifying the ad's value.- Returns:
- The List of AdCategory
AdCategory
containing the categories of the Ad and their responsible authorities.
-