Custom Data Integration

Ever faced the challenge finding out who watched your videos within your website, software or mobile app? Now you can securely pass your user’s details directly to the ZiMovi player/recorder/questionnaire and we will stamp those data on the users’ activities.

10-minute setup guide (see the integration example below)

Step 1	Include jQuery if your site doesn’t have it already.
Step 2	Include zimovi.js script anywhere after the jQuery script. You can either use our CDN or download it to your server.
Step 3	Create a JavaScript object with your user’s data on the pages that embed our players, playlists or questionnaires; the name of the object need to be ziData.
Step 4 optional	If you want to adjust the iframe height to fit its content, you can easily add data-zi-resize=true to each of the iframes. (e.g. questionnaire embedding with different length)

ziData Parameters (JavaScript object)

u.r optional	User ID, reference number or session id in your system
u.n optional	User’s name
u.e optional	User’s email address
Need more options?	(Let us know your suggestions)

Website Integration Example

<html>
<head>
    <style> iframe {min-width: 640px;}</style>
</head>

<body>
    <h2>Quesitonnaire Embedding</h2>
    <iframe data-zi-resize="true" src="https://zimovi.com/channel/staff/questionnaire/15448b5f1e0e2cfe?iframe=true" frameborder="0"></iframe>

    <h2>Video Player Embedding</h2>
    <iframe src="https://zimovi.com/channel/staff/player/video/8ef80cb7874b34ab" width="640" height="360" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>
</body>

<footer>
    <script>
        if (!window.jQuery) {
            document.write('<script src="//ajax.googleapis.com/ajax/libs/jquery/2.1.1/jquery.min.js"><\/script>');
        }
    </script>
    <script type="text/javascript" src="//d1teylh2i3wa1w.cloudfront.net/assets/js/zimovi.js"></script>
    <script>
        var ziData = {u: {r: "SAMPLE_USER_ID", n: "Alex Sample", e: "alex.sample@company.com"}};
    </script>
</footer>
</html>

How do I resize the iframes to fit their content (Cross-domain)?

All you need to do is to set data-zi-resize=true within your embedding code.

Can I pass data to my ZiMovi channel pages?

Yes, you can set a user reference parameter within your url query string. e.g. &ur=SAMPLE_USER_ID

ZiMovi cache the user reference and join user’s further activities together.

How do I retrieve the data?

You will see all the data on ZiMovi analytics reports; you can also retrieve the data via our RESTful APIs.