@blotoutio/providers-evo-popup-sdk
v1.60.0
Published
Evo Popup SDK for EdgeTag
Readme
@blotoutio/providers-evo-popup-sdk
Browser-side Evo Popup runtime for EdgeTag. Renders popup rules authored in the evo dashboard into the merchant storefront — modal, slide-in, bar, floating box, and fullscreen takeover formats.
Loading
The CDN worker emits the bundle URL on every storefront page-load when the
provider's uiPreferences.mode is enabled or preview. The bundle's init
entry point reads manifest.variables.popupRules, picks the first rule whose
conditions, schedule, and fatigue all pass, and appends the rendered popup to
document.body.
Events
The SDK dispatches custom DOM events on the popup root for host integrations:
| Event | Detail |
| ----------------------- | ------------------------------------- |
| evopopup:submit | { ruleId, formData, integrations? } |
| evopopup:dismiss | — |
| evopopup:gotostep | { ruleId, stepId } |
| evopopup:couponcopied | { ruleId, code } |
Fatigue + Schedule
Per-rule impression count, dismiss state, and conversion state are persisted
to sessionStorage or localStorage (keys prefixed evopopup:fatigue:) based
on the rule's fatigue settings. The schedule window is re-checked at fire
time.
CSP
The SDK appends a <style> element to document.head for keyframe animations
and, when the rule defines rule.css, appends a second <style> inside the
popup root. Storefronts with style-src 'self' (no unsafe-inline) will
block both — keyframe animations and merchant CSS won't apply.
