Video player events

circle-info

Please note most components initiate Video player upon user interaction (e.g. thumbnail click in Embed Feed), some use it directly (Storyblock in autoplay mode)

Video events

Name
Description

fw:video:impression

Dispatched on loaddata video event. Metadata are loaded and player is ready to start the video.

fw:video:start

Video started. Dispatched on first timeupdate video event. Fired for autoplayed thumbnails as well.

fw:video:first-quartile

Video reached 25%.

fw:video:midpoint

Video reached 50%.

fw:video:third-quartile

Video reached 75%.

fw:video:complete

Video reached at least 90%.

fw:video:session

After visitor's engagement with the video is finished. On video end, close or skip to another video.

fw:video:interactable-engaged-view

Dispatched when a user meets the attributable engagement criteria for the given widget type (view duration threshold or CTA click)

fw:video:click-cta

When visitor clicks on CTA button (if available).

fw:video:click-share

When user clicks on "Share" button.

fw:video:share

When visitor chooses one of the share options.

These events are universal across our Livestream and short video products. These events are used to track the status of the video.

User Interaction events

These events are universal across our Livestream and short video product and triggered by the user taking an action.

Event Name
Description

fw:video:click-cta

When a visitor clicks on the Call to action (CTA) button

fw:video:click-share

When a user clicks on "Share" button.

fw:video:share

When a visitor chooses one of the share options.

fw:video:submit-answer

When a user submits an answer to the question. Response data contains answer and email if collection is required.

fw:video:submit-choice

When a user submits a choice to the poll. Response contains choice text.

Live Steam events

These are events that are specific to the Live Stream and can be used in conjunction with the above events.

Event Name
Description

fw:livestream:join

A user starts watching the livestream via tap to watch OR start watching with the share link

fw:livestream:quit

A user clicks the "x" or swipes to quit the live stream event

fw:livestream:send-chat

A user sends a chat message

fw:livestream:send-heart

A User clicks heart button

circle-info

Note fw:livestream:add-to-cart, fw:livestream:checkout and fw:livestream:click-pdp-link are only avaiable for "in-stream" Shopping

Player events

Event Name
Description

fw:player:transition

Player goes to fullscreen/minimized

fw:player:quit

A user quits the player

fw:player:navigate

A user navigates with a link or a button on the player. Can be used to programmatically navigate SPA's in conjunction with pip_navigate=false

Response

Response objects available in event.detail

Name
Description

video

encoded_id - video ID

badge - null | ad | demo | featured

caption - video caption

hashtags - list of hashtag strings

extra

autoplay - true if played as thumbnail, false for full player has_cta - true if CTA action is available

duration - video duration is seconds

progress - current progress in seconds

width - current width of a video element

height - current height of a video element

state - paused | playing_auto | playing_manual (see autoplay)

Attributable criteria

Widget

Attribution Criteria

Example

Short video Player (Fullscreen + PiP)

3s view or click CTA

The user opens a video in fullscreen and watches for 3s, or clicks a product card that opens a PDP with PiP.

Showroom Player (Fullscreen + PiP)

10s cumulative view or CTA click

The user clicks a floating video to enter the showroom (watches 5s), then clicks a product card to a PDP with PiP (watches another 5s) — the combined 10s meets the threshold.

Carousel (no clicking)

Only count click CTA

Passive autoplay does not count. Attribution is only triggered when the user clicks a CTA within the Carousel.

Player Deck

10s view or click CTA

The user lands on or scrolls to a Player Deck in the viewport and watches for 10s, or clicks a CTA or product card.

Storyblock

10s view or click CTA

The user lands on or scrolls to a Storyblock in the viewport and watches for 10s, or clicks a CTA or product card within the Storyblock.

Floating player

Not attributed

The Floating Player is a passive entry point and does not count toward attribution.

Horizontal video

10s view or click CTA

The user lands on or scrolls to a Horizontal Video player in the viewport and watches for 10s, or clicks a CTA or product card within the player.

*Note: "10s view" includes complete video views shorter than 10 seconds.

Last updated

Was this helpful?