iFrame Integration
Last updated
Last updated
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:
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.
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.