HowdyGo SDK

The HowdyGo SDK lets your site interact with embedded demos. Use it to identify viewers and personalize demo content, or to open demos in a pop-up modal and control playback from your own UI.

Add the SDK to your page

Add the SDK snippet near the top of your page, ideally in the <head> of your website.


<script>
!function(h,o,w,d,y,g,o0){if(!(h.HowdyGoSDK||h[y]&&(h[y].q||h[y]._stub)||h._howdygo_loading)){var e=h.HOWDYGO_CONFIG||{};d=e.sdkUrl||d;var n=null,t=o.currentScript;if(t instanceof HTMLScriptElement&&!(n=t.getAttribute("data-key"))&&t.src)try{n=new URL(t.src).searchParams.get("key")}catch(e){n=null}o.querySelector('script[src="'.concat(d,'"]'))||(h._howdygo_loading=!0,Object.keys(e.config||{}).length>0&&(h.howdygo_config=e.config),n&&(h.howdygo_config=h.howdygo_config||{},h.howdygo_config.key=n),h[y]=h[y]||new Proxy({},{get:function(e,n){return"q"===n?e[n]||[]:"_stub"===n||function(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];try{for(var r=[n],c=0;c<arguments.length;c++)r.push(arguments[c]);r.push({timestamp:Date.now()}),(h[y].q=h[y].q||[]).push(r)}catch(e){console.error("HowdyGo SDK Snippet: Failed to queue method call:",e)}return h[y]}}}),(g=o.createElement(w)).async=!0,g.src=d,g.onload=function(){return h._howdygo_loading=!1},g.onerror=function(){h._howdygo_loading=!1,console.error("HowdyGo SDK: Failed to load",d)},(o0=o.getElementsByTagName(w)[0])&&o0.parentNode?o0.parentNode.insertBefore(g,o0):o.head&&o.head.appendChild(g))}}(window,document,"script","https://app.howdygo.com/sdk/index.js","howdygo");
</script>

Once the snippet loads, the global window.howdygo object is available.

Choose an API

Tracking Script Identification & Personalization Pop-up Modal Embeds Player Control

Calls made before a demo loads

The SDK finds HowdyGo iframes on the page and registers them by ID. If you call a method before an iframe registers, the SDK queues it until the iframe loads. It keeps stored identity locally so it survives page navigation.

For identity from CRM cookies, forms, query parameters, or existing analytics tools, install the keyed Tracking Script.