As follows, you could set FireworkSDK.getInstance().onVideoPlayback to receive video playback events. The event type is VideoPlaybackEvent.
FireworkSDK.getInstance().onVideoPlayback = (event) {if (event !=null) {switch (event.eventName) {caseVideoPlaybackEventName.impression:/// When video is shown to the user.break;caseVideoPlaybackEventName.start:/// Video started.break;caseVideoPlaybackEventName.pause:/// Video paused.break;caseVideoPlaybackEventName.resume:/// Video resume.break;caseVideoPlaybackEventName.firstQuartile:/// Video reached 25%.break;caseVideoPlaybackEventName.midpoint:/// Video reached 50%.break;caseVideoPlaybackEventName.thirdQuartile:/// Video reached 75%.break;caseVideoPlaybackEventName.complete:/// Video reached 100%.break;caseVideoPlaybackEventName.adStart:/// When ad video start playing.break;caseVideoPlaybackEventName.adEnd:/// When ad video finishes playing.break;caseVideoPlaybackEventName.clickCTA:/// When a visitor clicks on CTA button (if available).break;caseVideoPlaybackEventName.clickShare:/// When user clicks on "Share" button.break; } }};
Video feed click events
As follows, you could set FireworkSDK.getInstance().onVideoFeedClick to receive video feed click events. The event type is VideoFeedClickEvent.
As follows, you could set FireworkSDK.getInstance().liveStream.onLiveStreamChatEvent to receive live stream chat events. The event type is LiveStreamChatEvent.
The host app can record a purchase which will help get a full picture of the user journey flow. To do this, call FireworkSDK.getInstance().trackPurchase whenever the purchase happens. The following are the sample codes:
FireworkSDK.getInstance().trackPurchase(TrackPurchaseParameters( orderId:"<Order ID of User Purchase>", value:"total purchase value", currencyCode:"e.g. USD", countryCode:"e.g. US", additionalInfo:<String, String>{"additionalKey1":"additionalValue1","additionalKey2":"additionalValue2","additionalKey3":"additionalValue3" }, ),);
Conversion tracking
Get feed id for VideoFeed and StoryBlock during widget initialization
You could use onVideoFeedGetFeedId callback to get feed id for VideoFeed and StoryBlock during widget initialization. The related reference links are:
Map<String, String> globalMap =<String, String>{};VideoFeed( height:200, source:VideoFeedSource.discover, onVideoFeedGetFeedId: (feedId) {// The host app could store some custom info based on the feed id,// such as widget name, widget type etc. globalMap[feedId] ="VideoFeed Widget1"; },);VideoFeed( height:200, source:VideoFeedSource.discover, onVideoFeedGetFeedId: (feedId) {// The host app could store some custom info based on the feed id,// such as widget name, widget type etc. globalMap[feedId] ="VideoFeed Widget2"; },);StoryBlock( height:200, source:StoryBlockSource.discover, onStoryBlockGetFeedId: (feedId) {// The host app could store some custom info based on the feed id,// such as widget name, widget type etc. globalMap[feedId] ="StoryBlock Widget1"; },);StoryBlock( height:200, source:StoryBlockSource.discover, onStoryBlockGetFeedId: (feedId) {// The host app could store some custom info based on the feed id,// such as widget name, widget type etc. globalMap[feedId] ="StoryBlock Widget2"; },);
Get feed id and video id from event callbacks
Currently, the host app could get feed id and video id from some event callbacks. For example:
FireworkSDK.getInstance().shopping.onShoppingCTA =async (event:ShoppingCTAEvent) => {final feedId = event?.video.feedIdif (feedId !=null) {// Get custom info based on the feed idfinal widgetName = globalMap[feedId]; }final videoId = event?.video.videoId;if (videoId !=null) {// Use the video id to do custom logic }}FireworkSDK.getInstance().shopping.onCustomClickCartIcon =async (event) => {final feedId = event?.video.feedIdif (feedId !=null) {// Get custom info based on the feed idfinal widgetName = globalMap[feedId]; }final videoId = event?.video.videoId;if (videoId !=null) {// Use the video id to do custom logic }};FireworkSDK.getInstance().shopping.onUpdateProductDetails = (UpdateProductDetailsEvent? event) async {final feedId = event?.video.feedIdif (feedId !=null) {// Get custom info based on the feed idfinal widgetName = globalMap[feedId]; }final videoId = event?.video.videoId;if (videoId !=null) {// Use the video id to do custom logic }};FireworkSDK.getInstance().shopping.onCustomTapProductCard =async (event) => {final feedId = event?.video.feedIdif (feedId !=null) {// Get custom info based on the feed idfinal widgetName = globalMap[feedId]; }final videoId = event?.video.videoId;if (videoId !=null) {// Use the video id to do custom logic }};FireworkSDK.getInstance().onCustomCTAClick =async (event) => {final feedId = event?.video.feedIdif (feedId !=null) {// Get custom info based on the feed idfinal widgetName = globalMap[feedId]; }final videoId = event?.video.videoId;if (videoId !=null) {// Use the video id to do custom logic }}