nexxPLAY
  • Introduction
  • Javascript SDK
    • Basic Integration
    • Advanced Integration
    • Player Configuration
    • Player Management
    • Playback Control
  • iFrame Integration
    • Embed Codes
    • PostMessage Control
  • native Players
    • nexxPLAY for iOS
    • nexxPLAY for Android
    • nexxPLAY for Flutter
  • Platform Plugins
    • Google AMP
    • Wordpress Plugin
    • React Plugin
  • Integration Enhancements
    • Player UI
    • Audio Player
    • Player DataMode
    • Player Events
    • SDK Override Options
    • VAST Macros
    • GET Parameters
  • Widgets
    • Javascript SDK
    • iFrame Integration
    • Widgets for native Apps
      • iOS Widget
      • Android Widget
      • Android TV Channel
      • Windows 10 LiveTile
    • Widget React Plugin
    • Widget Override Options
  • more Integrations
    • WebViews
    • oEmbed Discovery
    • WebComponent
    • Preview Links
    • Cover Service
    • Reporting for external Players
  • Addons
  • Security and Accessibility
    • Data Protection and Security
    • GDPR and TCF 2.0
    • Accessibility and WCAG
  • Compatibility
  • Changelog
Powered by GitBook
On this page
  1. Widgets

iFrame Integration

PreviousJavascript SDKNextWidgets for native Apps

Last updated 3 years ago

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.

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.

PostMessage Control
Wordpress Plugin
React Plugin