Skip to content
Optima docs
ConsoleEdgeDigital content

Digital content

Publish the banners, personalised blocks, consent banner and recommendations that your website and apps fetch from Optima.

Digital content is what your site and apps ask Optima for when a visitor arrives: a hero banner, a notice, a block of recommended products, the consent banner. Each item belongs to a slot, a name your page or app uses to say where the content goes. You write it here, publish it, and every visitor holding the SDK key sees it. Targeted, per-profile content is different: it is delivered through campaigns using the on-site channels, and is monitored on the campaign.

Who uses it

Campaign creators. Reading needs content_viewer and creating, editing and publishing needs content_editor, or another role your administrator has given access to this area — see Licences and roles. It needs the content feature of the Digital package; consent banner items need the banners feature. The screen is under On-site in the navigation.

The Digital content screen with slot and status filters above a table of content items and their publish buttons

The list

Filter by Slot (type to search) or by status (All statuses, Draft, Published, Archived). Columns: Slot, Name, Status, Type, Priority and Schedule (always when there is no window). Beside Type, badges show HTML for unstructured items and Personalized for personalised ones; a consent banner is badged Consent banner.

On each row: Publish or Unpublish, the pencil (edit) and the trash can (delete). Only published items inside their schedule are served. Select a name to edit.

The editor

The New content item dialog with slot, name, type, priority, schedule, URL targeting, payload and display settings

New content item opens the dialog.

FieldMeaningValid valuesDefault
SlotThe place the content is for. Your page or app asks for a slot by name.Text, for example homepage_heroNone (required)
NameA label for you.TextNone (required)
TypeWhat kind of content.Banner, Inline, Custom, Consent bannerBanner
Payload formatStructured data your page renders, or a ready HTML document.Structured (JSON), Unstructured (HTML/CSS/JS)Structured (JSON)
PriorityWhen several items fit a slot, higher numbers go first.A whole number0
Starts at, Ends atThe schedule window, in your local time.Date and time, or empty for alwaysEmpty
PersonalizedFill the item in from the visitor's profile; see Web personalization.On or offOff
URL targeting (glob patterns)Serve the item only on matching pages.Patterns; empty means everywhereEmpty
Payload (JSON)For structured items under Raw JSON: any JSON object your surface renders.A JSON object. Display rules go in Display, not in the JSON.{}
HTML / CSS / JSFor unstructured items: one self-contained document, served as is. Inline your CSS and JS.Up to 256 KBEmpty

A structured item has two ways to write its payload, as tabs: Recommended items (see Recommended items) and Raw JSON. An unstructured item shows Live preview, a sandboxed frame where scripts run but the network and the parent page are blocked.

Display

Banner, inline and custom items have a Display section controlling how the SDK shows them. A consent banner has its own layout settings instead; see Consent banner and CMP.

FieldMeaningValid valuesDefault
Where it showsPlacement. The web SDK draws Automatic content in its slot if the page has one; Android and iOS draw it over the app, so set it for apps.Automatic, In its slot on the page, Over the pageAutomatic
PositionWhere over the page.Default (bottom), Bottom, Top, Center, Bottom left, Bottom rightDefault (bottom)
LookThe shape.Default (card), Card, Full-width bar, Dialog that dims the pageDefault (card)
When it showsThe trigger.As soon as the page loads, After a delay, After the visitor scrolls, When the visitor is about to leave (web only), When your code raises an eventPage load
Delay in seconds / How far down the page (%) / Event nameThe detail for the chosen trigger. The event is one your site or app raises; on the web, an event dispatched on the window.A number above 0; a whole number from 1 to 100; textEmpty
How oftenHow often the same visitor sees it.Default (once per visit over the page, every time in a slot), Every time, Once per visit, Only once, ever, Once every few daysDefault
Every how many daysFor Once every few days.A whole number above 0Empty
Can visitors close itClose button.Default (yes over the page, no in a slot), Yes, with a close button, NoDefault
After a close, show it againWhether a closed item returns.Never, After a number of daysNever
Days until it shows againFor After a number of days.A whole number above 0Empty

Actions

  • Create or Save stores the item as a draft. Publish makes it live within about 30 seconds; Unpublish takes it down.
  • Delete removes the item for good. This cannot be undone.
  • Changing the schedule is the safe way to take something down at a given time.

Examples

A spring banner. Slot homepage_hero, Type Banner, Structured (JSON), Raw JSON {"title": "Spring sale", "cta": "Shop now"}, Starts at 1 March, Ends at 31 March, How often Once per visit. Publish.

A product block. Slot product_sidebar, Recommended items, Catalogue products, Strategy Trending. See Recommended items.

A cookie notice. Type Consent banner; see Consent banner and CMP.

Common problems

  • The item is not served. It is a draft, outside its schedule, or its URL targeting does not match the page. Check the status and window in the list.
  • The page shows nothing in a slot. The slot name must match exactly what your page or app requests.
  • The payload is refused. Not valid JSON., Payload must be a JSON object., or "Set display rules in the Display section below, not in the JSON."
  • Personalised content looks empty. The visitor is unknown; add a fallback. See Web personalization.
  • A banner shows to everyone. Digital content is broadcast. Use a campaign on an on-site channel to target a segment.

On this page