Integrating our plugin with your website is simple and straightforward. We do lots of the heavy lifting and keep your task simple so you can concentrate on making your products and website excellent while we make sure your users have a Joyful experience.
Including the Script
Add the following
script tag to the end of the
body of your webpage:
<script src="https://cdn.joyned.app/latest/script.js?api_key=YOUR-API-KEY-HERE&lang=en" defer crossorigin="anonymous"></script>
Make sure to replace
YOUR-API-KEY-HERE with the API key that you have received from customer success when creating your account with Joyned.
If you want to change the language of the plugin, replace
lang=en) with the language of your choice (such as
Examples of languages we support:
If you are not sure your language is supported, contact us for more information.
This script must be added to every page where the Joyned plugin is displayed. Such as the homepage, category pages, search result pages and product details pages. If you don't want our buttons to appear in any one of the aforementioned pages, please contact our customer success team.
Remember not to place our script in any page that contains personal identifiable information like checkout or account management pages.
Adding Joyned via Google Tag Manager?
All you have to do is add the following script tag to the website as a custom HTML tag.
Managing an A/B test with our product is slightly more complex than your typical integration script. Simply omitting the script for a certain variant/user group raises the issue whereby a user may be invited to a wish list, but won’t be able to see the list because they don’t have the script embedded in the web page.
For customers wishing to A/B test our product we offer fully managed testing capabilities. Let your customer success manager know and we can set it up for you without any additional integration.
We also offer a solution for customers who wish to manage the A/B test themselves. If
hide=1 is included in the query string of the script URL (
https://cdn.joyned.app/latest/script.js?api_key=YOUR-API-KEY-HERE&lang=en&hide=1), any new user that is created will have the plugin hidden by default. When any user reaches your website via a Joyned invite link, the plugin will identify that this user was invited and immediately start showing our plugin to this user. For users who are in the “see Joyned” variant/user group, simply use the script URL as normal (without
gamiteeSID=[SOME-SESSION-ID]will be included in the URL of the website. You can use this to track when a user is being invited and ensure that they are associated with the “see Joyned” variant. This is especially important to do, in order to verify the right A/B test group allocation in cases such as a “hide” group member being invited by a friend to join the “show” group.
Are you using Google Optimize and would like to launch our product there? See our dedicated manual:
Enabling the Plugin
After the deployment of the code, contact your customer success manager to enable the service.
After adding the code users still won't be able to see our service, as it is disabled by default by us.
While the service is live but disabled we will run a few last tests to make sure that everything works perfectly and we will notify you before enabling the service on our end.