Android Video Behavior Data Collection Methods

This section details the methods that are available for capturing behavior data when the end users interact with video content on mobile applications.

Each of these methods require the below parameters to be passed.

• eventMeta: This is an object that stores the parameters attached to an event.

  • eventPath: This parameter is used to specify the path in the application in which the event occurs.

  • eventDesc: This parameter is used to specify the name of the screen on which the event occurs.

  • customData (optional): This is an object used to store a set of custom key-value pairs to pass additional data that is relevant to the event.

• videoMeta: Specifies an ORAVideoMeta object that stores additional parameters related to the event.

The methods from the methods are mapped parameters in the Infinity library. The complete list of parameters in the Infinity library are available here.

The Core module collects a set of parameters from the device and mobile application by default. The default parameters collected by the core module are listed here.

• Video content events

  • Video meta data load event

  • Video load event

  • Video play event

  • Video pause event

  • Video resume event

  • Video seek event

  • Video completion event

  • Video volume change event

  • Video watching behavior

  • Video beacon event

  • Video error event

Video content events

Video meta data load event

This method collects data when a video meta information is available/loaded.

Method:

triggerVideoLoadMetaEvent

Syntax:

public Map<String, String> triggerVideoLoadMetaEvent(final ORAEventMeta eventMeta, final ORAVideoMeta videoMeta);

Example: triggerVideoLoadMetaEventsample code

Event specific parameter for this method:

• None

Oracle Infinity Parameters and values: (Complete list is available here)

• dcsuri: eventMeta.eventPath

• WT.ti: eventMeta.eventDescr

• WT.pi: eventMeta.eventDescr

• Wt.clip_id: "Video Name"

• Wt.clip_ev: "LoadMeta"

• WT.sys: clip_load_meta

• WT.dl: 41

Video load event

This method collects data when the video content is loaded.

Method:

triggerVideoLoadEvent

Syntax:

public Map<String, String> triggerVideoLoadEvent(final ORAEventMeta eventMeta, final ORAVideoMeta videoMeta);

Example: triggerVideoLoadEvent sample code

// Send custom key/value pairs as arguments to event methods (optional)
Map <String, String> customData = new HashMap<String, String>();
customData.put("custom_key", "custom_value");
final ORAEventMeta eventMeta = new ORAEventMeta("/video/load/event", "HelloWorld Video Load Event", "Video Load Event", customData);
final ORAVideoMeta videoMeta = new ORAVideoMeta.ORAVideoMetaBuilder("VideoName", "Load").build();
ORADataCollector.getInstance(). triggerVideoLoadEvent(eventMeta, videoMeta);

Event specific parameter for this method:

• None

Oracle Infinity Parameters and values: (Complete list is available here)

• dcsuri: eventMeta.eventPath

• WT.ti: eventMeta.eventDescr

• WT.pi: eventMeta.eventDescr

• Wt.clip_id: "Video Name"

• Wt.clip_ev: "Load"

• WT.sys: clip_load

• WT.dl: 41

Video play event

This method collects data when a video played.

Method:

triggerVideoPlayEvent

Syntax:

public Map<String, String> triggerVideoPlayEvent(final ORAEventMeta eventMeta, final ORAVideoMeta videoMeta);

Example: triggerVideoLoadEvent sample code

// Send custom key/value pairs as arguments to event methods (optional)
Map <String, String> customData = new HashMap<String, String>();
customData.put("custom_key", "custom_value");
final ORAEventMeta eventMeta = new ORAEventMeta("/video/play/event", "HelloWorld Video Play Event", "Video Play Event", customData);
final ORAVideoMeta videoMeta = new ORAVideoMeta.ORAVideoMetaBuilder("VideoName", "Play").build();
ORADataCollector.getInstance(). triggerVideoPlayEvent(eventMeta, videoMeta);

Event specific parameter for this method:

• None

Oracle Infinity Parameters and values: (Complete list is available here)

• dcsuri: eventMeta.eventPath

• WT.ti: eventMeta.eventDescr

• WT.pi: eventMeta.eventDescr

• Wt.clip_id: "Video Name"

• Wt.clip_ev: "Play"

• WT.sys: clip_play

• WT.dl: 40

Video pause event

This method collects data when a video paused.

Method:

triggerVideoPauseEvent

Syntax:

public Map<String, String> triggerVideoPauseEvent(final ORAEventMeta eventMeta, final ORAVideoMeta videoMeta);

Example: triggerVideoPauseEvent sample code

// Send custom key/value pairs as arguments to event methods (optional)
Map <String, String> customData = new HashMap<String, String>();
customData.put("custom_key", "custom_value");
final ORAEventMeta eventMeta = new ORAEventMeta("/video/pause/event", "HelloWorld Video Pause Event", "Video Pause Event", customData);
final ORAVideoMeta videoMeta = new ORAVideoMeta.ORAVideoMetaBuilder("VideoName", "Pause").build();
ORADataCollector.getInstance(). triggerVideoPauseEvent(eventMeta, videoMeta);

Event specific parameter for this method:

• None

Oracle Infinity Parameters and values: (Complete list is available here)

• dcsuri: eventMeta.eventPath

• WT.ti: eventMeta.eventDescr

• WT.pi: eventMeta.eventDescr

• Wt.clip_id: "Video Name"

• Wt.clip_ev: "Pause"

• WT.sys: clip_pause

• WT.dl: 40

Video resume event

This method collects data when a video is resumed.

Method:

triggerVideoResumeEvent

Syntax:

public Map<String, String> triggerVideoResumeEvent(final ORAEventMeta eventMeta, final ORAVideoMeta videoMeta);

Example: triggerVideoResumeEvent sample code

// Send custom key/value pairs as arguments to event methods (optional)
Map <String, String> customData = new HashMap<String, String>();
customData.put("custom_key", "custom_value");
final ORAEventMeta eventMeta = new ORAEventMeta("/video/resume/event", "HelloWorld Video Resume Event", "Video Resume Event", customData);
final ORAVideoMeta videoMeta = new ORAVideoMeta.ORAVideoMetaBuilder("VideoName", "Resume").build();
ORADataCollector.getInstance(). triggerVideoResumeEvent(eventMeta, videoMeta);

Event specific parameter for this method:

• None

Oracle Infinity Parameters and values: (Complete list is available here)

• dcsuri: eventMeta.eventPath

• WT.ti: eventMeta.eventDescr

• WT.pi: eventMeta.eventDescr

• Wt.clip_id: "Video Name"

• Wt.clip_ev: "Resume"

• WT.sys: clip_resume

• WT.dl: 40

Video seek event

This method collects data when a mobile app user navigates a video by seeking to a point in the duration of the video.

Method:

triggerVideoSeekEvent

Syntax:

public Map<String, String> triggerVideoSeekEvent(final ORAEventMeta eventMeta, final ORAVideoMeta videoMeta);

Example: triggerVideoSeekEvent sample code

// Send custom key/value pairs as arguments to event methods (optional)
Map <String, String> customData = new HashMap<String, String>();
customData.put("custom_key", "custom_value");
final ORAEventMeta eventMeta = new ORAEventMeta("/video/seek/event", "HelloWorld Video Seek Event", "Video Seek Event", customData);
final ORAVideoMeta videoMeta = new ORAVideoMeta.ORAVideoMetaBuilder("VideoName", "Seek").build();
ORADataCollector.getInstance(). triggerVideoSeekEvent(eventMeta, videoMeta);

Event specific parameter for this method:

• None

Oracle Infinity Parameters and values: (Complete list is available here)

• dcsuri: eventMeta.eventPath

• WT.ti: eventMeta.eventDescr

• WT.pi: eventMeta.eventDescr

• Wt.clip_id: "Video Name"

• Wt.clip_ev: "Seek"

• WT.sys: clip_seek

• WT.dl: 40

Video completion event

This method collects data when a video is completed.

Method:

triggerVideoCompletionEvent

Syntax:

public Map<String, String> triggerVideoCompletionEvent(final ORAEventMeta eventMeta, final ORAVideoMeta videoMeta);

Example: triggerVideoSeekEvent sample code

// Send custom key/value pairs as arguments to event methods (optional)
Map <String, String> customData = new HashMap<String, String>();
customData.put("custom_key", "custom_value");
final ORAEventMeta eventMeta = new ORAEventMeta("/video/completion/event", "HelloWorld Video Completion Event", "Video Completion Event", customData);
final ORAVideoMeta videoMeta = new ORAVideoMeta.ORAVideoMetaBuilder("VideoName", "Completion").build();
ORADataCollector.getInstance(). triggerVideoCompletionEvent(eventMeta, videoMeta);

Event specific parameter for this method:

• None

Oracle Infinity Parameters and values: (Complete list is available here)

• dcsuri: eventMeta.eventPath

• WT.ti: eventMeta.eventDescr

• WT.pi: eventMeta.eventDescr

• Wt.clip_id: "Video Name"

• Wt.clip_ev: "Completion"

• WT.sys: clip_completion

• WT.dl: 40

Video volume change event

This method collects data when volume is changed during a video.

Method:

triggerVideoVolumeChangeEvent

Syntax:

public Map<String, String> triggerVideoVolumeChangeEvent(final ORAEventMeta eventMeta, final ORAVideoMeta videoMeta);

Example: triggerVideoVolumeChangeEvent sample code

// Send custom key/value pairs as arguments to event methods (optional)
Map <String, String> customData = new HashMap<String, String>();
customData.put("custom_key", "custom_value");
final ORAEventMeta eventMeta = new ORAEventMeta("/video/volume_change/event", "HelloWorld Video VolumeChange Event", "Video VolumeChange Event", customData);
final ORAVideoMeta videoMeta = new ORAVideoMeta.ORAVideoMetaBuilder("VideoName", "VolumeChange").build();
ORADataCollector.getInstance(). triggerVideoVolumeChangeEvent(eventMeta, videoMeta);

Event specific parameter for this method:

• None

Oracle Infinity Parameters and values: (Complete list is available here)

• dcsuri: eventMeta.eventPath

• WT.ti: eventMeta.eventDescr

• WT.pi: eventMeta.eventDescr

• Wt.clip_id: "Video Name"

• Wt.clip_ev: "VolumeChange"

• WT.sys: clip_volume_change

• WT.dl: 41

Video watching behavior

This method collects data when a specific percentage of a video is completed.

Method:

triggerVideoQuartileEvent

Syntax:

public Map<String, String> triggerVideoVolumeChangeEvent(final ORAEventMeta eventMeta, final ORAVideoMeta videoMeta);

Example: triggerVideoQuartileEvent sample code

// Send custom key/value pairs as arguments to event methods (optional)
Map <String, String> customData = new HashMap<String, String>();
customData.put("custom_key", "custom_value");
final ORAEventMeta eventMeta = new ORAEventMeta("/video/quartile/event", "HelloWorld Video Quartile Event", "Video Quartile Event", customData);
final ORAVideoMeta videoMeta = new ORAVideoMeta.ORAVideoMetaBuilder("VideoName", "Quartile").build();
ORADataCollector.getInstance(). triggerVideoQuartileEvent(eventMeta, videoMeta);

Event specific parameter for this method:

• None

Oracle Infinity Parameters and values: (Complete list is available here)

• dcsuri: eventMeta.eventPath

• WT.ti: eventMeta.eventDescr

• WT.pi: eventMeta.eventDescr

• Wt.clip_id: "Video Name"

• Wt.clip_ev: "Quartile"

• WT.sys: clip_quartile

• WT.dl: 41

Video beacon event

This method collects data when a specific duration of a video is watched by the mobile application user.

Method:

triggerVideoBeaconEvent

Syntax:

public Map<String, String> triggerVideoBeaconEvent(final ORAEventMeta eventMeta, final ORAVideoMeta videoMeta);

Example: triggerVideoBeaconEvent sample code

// Send custom key/value pairs as arguments to event methods (optional)
Map <String, String> customData = new HashMap<String, String>();
customData.put("custom_key", "custom_value");
final ORAEventMeta eventMeta = new ORAEventMeta("/video/beacon/event", "HelloWorld Video Beacon Event", "Video Beacon Event", customData);
final ORAVideoMeta videoMeta = new ORAVideoMeta.ORAVideoMetaBuilder("VideoName", "Beacon").build();
ORADataCollector.getInstance(). triggerVideoBeaconEvent(eventMeta, videoMeta);

Event specific parameter for this method:

• None

Oracle Infinity Parameters and values: (Complete list is available here)

• dcsuri: eventMeta.eventPath

• WT.ti: eventMeta.eventDescr

• WT.pi: eventMeta.eventDescr

• Wt.clip_id: "Video Name"

• Wt.clip_ev: "Beacon"

• WT.sys: clip_beacon

• WT.dl: 41

Video error event

This method collects data when an error occurs during the loading and playing of a video.

Method:

triggerVideoErrorEvent

Syntax:

public Map<String, String> triggerVideoErrorEvent(final ORAEventMeta eventMeta, final ORAVideoMeta videoMeta);

Example: triggerVideoErrorEvent sample code

// Send custom key/value pairs as arguments to event methods (optional)
Map <String, String> customData = new HashMap<String, String>();
customData.put("custom_key", "custom_value");
final ORAEventMeta eventMeta = new ORAEventMeta("/video/error/event", "HelloWorld Video Error Event", "Video Error Event", customData);
final ORAVideoMeta videoMeta = new ORAVideoMeta.ORAVideoMetaBuilder("VideoName", "Error").build();
ORADataCollector.getInstance(). triggerVideoErrorEvent(eventMeta, videoMeta);

Event specific parameter for this method:

• None

Oracle Infinity Parameters and values: (Complete list is available here)

• dcsuri: eventMeta.eventPath

• WT.ti: eventMeta.eventDescr

• WT.pi: eventMeta.eventDescr

• Wt.clip_id: "Video Name"

• Wt.clip_ev: "Error"

• WT.sys: clip_error

• WT.dl: 41