How can we make the Joyned experience better for you?
How can we make the Joyned experience better for you?
Platform Integration
🔌

Platform Integration

Integrating our platform 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=xx-XX" 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 platform, replace en-XX (in lang=xx-XX in the script - YOUR-API-KEY-HERE&lang=xx-XX") with the language and locale of your choice (such as lang=en-GB.

The first 2 characters are representing the country (f.e - en = english) and the latter two represent the exact locale (en-gb - GB represents the Great Britain as a locale using the English language).

We will be using this code for selecting the language for the platform and also for formatting price and date.

Examples of our currently supported languages their format including a locale:

  • Czech (🇨🇿): cs-CZ
  • Dutch (The Netherlands 🇳🇱): nl-NL
  • English:
    • US (🇺🇸): en-US
    • UK (🇬🇧): en-GB
  • Finish (Finland 🇫🇮): fi-FI
  • French (France 🇫🇷): fr-FR
  • German:
    • Switzerland (🇨🇭): de-CH
    • Germany (🇩🇪): de-DE
  • Italian (Italy 🇮🇹): it-IT
  • Spanish:
    • Spain (🇪🇸): es-ES
    • Mexico (🇲🇽) : es-MX
    • Argentina (🇦🇷) : es-AR
  • Polish (Poland 🇵🇱): pl-PL
  • Portuguese (Portugal 🇵🇹): pt-PT
  • Romanian (Romania 🇷🇴): ro-RO
  • Russian (Russia 🇷🇺): ru-RU
  • Swedish (Sweden 🇸🇪): sv-SE
  • Ukranian (Ukraine 🇺🇦): uk-UA

If you are unsure whether your language is supported, please feel free to contact us for more information.

This script must be added to every page where the Joyned platform 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.

💡
Please note: The Joyned platform will only appear on the subdomains in which it is embedded. If you only want the Joyned tool on specific subdomains, please only add us there. As long as you remember to add us to the Homepage!

Adding Joyned via Google Tag Manager?

image

All you have to do is add the following script tag to the website as a custom HTML tag and add a trigger to fire the tag only on the pages you want the platform to appear on.

Enabling the Platform

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.