Help

The detailed guides are currently available in German only: Hilfe (Deutsch).

Quick start

  1. Record 30–90 seconds in front of a green wall, even lighting, camera at eye level.
  2. Log in to the dashboard, upload the video, set size, position and buttons, save.
  3. Copy the embed code to your website before </body>.

Without consent the avatar sets no cookies and sends no usage data. Your dashboard then shows how often the avatar was delivered (“loads”, counted on our server without IP addresses). When a visitor agrees to statistics in your cookie banner, run this line and the dashboard also shows impressions, starts with sound, watch time and button clicks:

<script>(window.sayswData=window.sayswData||[]).push({cookiesAccept:true});</script>

On withdrawal, push {cookiesAccept:false}. Most banners (Borlabs, Real Cookie Banner, Cookiebot, Usercentrics, Complianz …) can run code on opt-in: create a service “SAYSW Video Avatar” in the category “statistics” and add the line there. Details with examples (German): Cookie-Banner anbinden.

JavaScript API

Reopen a closed avatar without JavaScript: <button data-saysw-open>Watch video</button>, or with a product ID data-saysw-open="12345678" to open a specific avatar.

window.SAYSW = window.SAYSW || {};
(SAYSW.cmd = SAYSW.cmd || []).push(function (api) {
  api.on('close', function () { setTimeout(function () { api.open(); }, 60000); });
  api.on('ctaclick', function (e) { e.preventDefault(); myRouter.push(e.detail.url); });
  api.consent(true); // pass consent from your banner
});

Methods: open(pid?), consent(v?), get(pid), list(), ready(), on/off(type, fn), scan(). Per avatar: play(), mute(), stop(), close(), reopen(), seek(s), volume(v), openInfo(), clickCta(). Events: ready, statechange, unmute, mute, stop, progress, timeupdate, ctashow, ctahide, ctaclick, infoopen, infoclose, ended, close. Full reference (German): JavaScript-API.

Questions? Contact us.