iFrame Integration

To enable a nexxPLAY Widget on your Pages via iFrame, you need the iFrame Embed URL. This URL can be received within the nexxOMNIA UI - or via the nexxOMNIA API.

The general Structure of a nexxPLAY Widget Embed URL looks like this

https://embed.nexx.cloud/:domainid/widget/:widgethash/:widgetsecret

The :domainid Parameter is the Domain ID of that Widget

The :widgethash Parameter is the Hash of the Widget

The :widgetsecret Parameter is the (optional) Secret for this Widget

The full Embed Code would then look like this:

<iframe width='640' height='360' 
    src='https://embed.nexx.cloud/:domainid/widget/:widgethash/:widgetsecret' 
    frameborder='0'>
</iframe>

If you need to modify the Widget Instance within the iFrame, this is more complicated than with the Javascript SDK. Nevertheless, you can use PostMessage Control to achieve this.

If the Media Objects within the Feed do not have a valid fixed Link (because nexxOMNIA couldnt define a Link via the "slug" Attribute or a Domain Pattern), you must listen to Widget Events via PostMessage and handle the Navigation via Script.

In Contrast to the nexxPLAY iFrame Codes, the allow Attributes are not necessary, as Widgets only show Images or inline Video.

PostMessage Control

The following Override Options from nexxPLAY are also available for Widget iFrames:

Parameter	Description
platform	manually set the Player Platform (necessary, if used in an AMP Environemnt without the AMP Plugin - set it to "amp" in this Case)
language	manually set the Player Language
affiliateCode	if the Widgetis launced on a Partner Website, this code indicates the Use of an Affiliate Partner - the corresponding Code can be found within nexxOMNIA
launchMode	If set to window, the Widget will try to open the Links of Click directly in a new Window. If you want to process the Event directly, set this to none.
userHash	a valid User Reference Hash for personalized Results

The Widget System is also supported by the nexxPLAY WordPress Plugin and by nexxPLAY for React.

Wordpress PluginReact Plugin