Shogun

Shogun outputs standard Shopify theme markup—treat script loading like any Shopify Plus or OS 2.0 deployment, then place embeds at the section level.

Where to paste code

Shogun custom code / HTML components.
Shopify Additional scripts or app embed if you centralize SDK loading.

Setup guide

Load SDK according to Shopify best practices.
Allowlist myshopify.com preview origins if you test in Shopify admin.
Add embed in Shogun; publish and regression-test cart/checkout.

Example snippet

<script src="https://reactify-cdn.s3.us-east-2.amazonaws.com/sdk.js" defer></script>
<script>
  window.addEventListener('DOMContentLoaded', function () {
    if (!window.Reactify) return;
    Reactify.init({
      apiKey: 'YOUR_API_KEY',
      accountId: 'YOUR_ACCOUNT_ID',
      baseUrl: 'https://api.reactionsaas.com',
      mode: 'production',
      allowedOrigins: [window.location.origin]
    });
  });
</script>
<reaction-video
  src="https://cdn.example.com/hero.mp4"
  overlays="tap,poll,rating,slider,cta"
  poll-question="Ready to continue?"
  cta-text="Continue"
  interaction-type="tap"
></reaction-video>

ReactionSDK here means overlays on reaction-video (tap, poll, rating, slider, and CTA). For ReactifySDK—recorded video reactions and threads—load reactify.js and use reactify-video / reactify-thread per ReactifySDK HTML install.

Verification

Publish to a live URL; open in a clean session and confirm the SDK loads without CSP errors.
Trigger first render and first interaction; check ReactionSaaS analytics.
Use the SDK playground with Shogun selected to mirror overlay settings.

Template `platform_config`

Marketplace templates can declare a Shogun block inside platform_config:

{
  "shogun": {
    "embed_type": "shopify_section_or_html",
    "host": "shogun",
    "placements": [
      "product_page",
      "collection_page",
      "landing_page"
    ]
  }
}

UI presets (reference)

Product page overlay — Impression when section is visible; CTA after engagement. Events: first_render, first_interaction, template_used, platform_used.
Inline product / collection block — Lazy-load; mobile-first height. Events: first_render, first_interaction.
Landing / offer CTA widget — Timer or scroll-based reveal. Events: first_render, first_interaction, verification_heartbeat.

Troubleshooting

Script does not run — Use a raw HTML or global script area; rich-text-only fields often strip JavaScript.
403 from API — Add the exact published origin (including www) to allowed domains.
Duplicate events — Ensure only one SDK init per page when combining global and section-level code.

FAQ

Checkout customization? Keep reactions on pre-checkout surfaces unless you use Shopify checkout UI extensions with approved patterns.

← Platform overview · Templates