com.my.target

Class InstreamResearch

java.lang.Object

com.my.target.common.BaseAd

com.my.target.InstreamResearch

public class InstreamResearch
extends BaseAd

Component for tracking video playback and visibility.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	InstreamResearch.InstreamResearchListener

Field Summary

Fields inherited from class com.my.target.common.BaseAd

adConfig, metricFactory

Method Summary

Modifier and Type	Method and Description
void	load() Method responsible for loading data.
static InstreamResearch	newResearch(int slotId, int duration, android.content.Context context) The static constructor of the object.
void	registerPlayerView(android.view.View v) Method for registering the View in which the creative will be displayed.
void	setListener(InstreamResearch.InstreamResearchListener listener) Method for setting the listener.
void	trackFullscreen(boolean fullscreen) Method for tracking full screen mode on / off.
void	trackMute(boolean mute) A method for tracking sound on / off.
void	trackPause() Method for pause tracking.
void	trackProgress(float progress) Method for tracking video progress.
void	trackResume() Method for tracking unpause.
void	unregisterPlayerView() Method for deregistering View, clears references to View.

Methods inherited from class com.my.target.common.BaseAd

getCustomParams, isLoadCalled

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

newResearch

@NonNull
public static InstreamResearch newResearch(int slotId,
                                                    int duration,
                                                    @NonNull
                                                    android.content.Context context)

The static constructor of the object.

Parameters:

slotId - slot number

duration - creative length in seconds. If the length is unknown (for example, streaming content), a value of 0 is acceptable.

context - application context

Returns:

InstreamResearch object

load

public void load()

Method responsible for loading data. In case of successful loading, the onLoad method will be called on the object passed as a listener, in case of loading error or lack of data - the onNoData method (see InstreamResearch.InstreamResearchListener). Listener must be added before loading

See Also:

setListener(InstreamResearchListener)

registerPlayerView

public void registerPlayerView(@NonNull
                               android.view.View v)

Method for registering the View in which the creative will be displayed. Visibility statistics will be calculated based on the data for this View.

Parameters:

v - view of the creative

unregisterPlayerView

public void unregisterPlayerView()

Method for deregistering View, clears references to View.

trackPause

public void trackPause()

Method for pause tracking. If the trackProgress method has never been called before, statistics will not be sent

trackResume

public void trackResume()

Method for tracking unpause. If the video is not paused, nothing will be sent

trackProgress

public void trackProgress(float progress)

Method for tracking video progress. If progress is less than the previous value, then rewind statistics will be sent, tracking MRC statistics will be reset. If two consecutive progress values differ by more than a second, MRC tracking will also be reset.

Parameters:

progress - progress in seconds with fractional part

trackMute

public void trackMute(boolean mute)

A method for tracking sound on / off.

Parameters:

mute - enable / disable sound flag

trackFullscreen

public void trackFullscreen(boolean fullscreen)

Method for tracking full screen mode on / off.

Parameters:

fullscreen - flag to enable / disable fullscreen mode

setListener

public void setListener(@Nullable
                        InstreamResearch.InstreamResearchListener listener)

Method for setting the listener. May be null. Must be called before load()

Parameters:

listener - listener for research