Custom-built Site Integration
Zoho Thrive provides a way for businesses with custom-built sites (built from scratch without the help of any builder software) to integrate with Zoho Thrive and run loyalty program.
Before proceeding with the integration, you'll need to create a brand for your site.
Create a brand
- In the Thrive console, go to the top-right corner and click the Settings icon.
- Then navigate to Integrations -> Store Integrations -> Custom-built.
- Click Configure.
- In the pop-up, do the following:
- Enter your Brand Name.
- Enter your Brand URL (the URL of your website where you wish to run the program).
- Click Create.
After a brand is created, follow the steps below to establish a connection between your custom-built site and Zoho Thrive.
Integrate your site
- In the Thrive console, go to the top-right corner and click the Settings icon.
- Then navigate to the Developer Settings.
- Copy Secret Key, Brand Code, and save it securely.
- Copy the below script and paste it between the <head> and </head> tags on each page of your site.
<script type="text/javascript">
var platformType='custom_user_site';
var thriveWidgetCode= '{{Brand code}}';
var ztUserData = {};
</script>
<script id="thrive_script" src="{{Public Domain URL}}/thrive/publicpages/thrivewidget"></script>
- Replace the placeholders above with their corresponding variables
- {{Brand code}} - This variable is the same as the one you copied from More -> Installation Page
- {{Public Domain URL}} - Copy the Public Domain URL for your data center from the table below. You can find out which data center you’re accessing Zoho Thrive from by visiting the Zoho Thrive web app and checking its URL.
Data Center | Domain URL | Public Domain URL |
United States | ||
India | ||
Europe | ||
South Africa | ||
Australia | ||
Canada |
- Copy the below script and paste it between the <body> and </body> tags on each page of your site.
<script type="text/javascript">
var ztUserData = {};
ztUserData['za_email_id'] = {{Email Address of Customer}};
ztUserData['user_unique_id'] = {{Unique Identifiable System ID of Customer}};
ztUserData['thrive_digest'] = {{Server Generated HMAC}};
ztUserData['signUpPage'] = {{Signup URL};
ztUserData['signInPage'] = {{Login URL}};
ztWidgetDelay = {{Time in secs}};
</script>
- Replace the placeholders above with their corresponding variables defined in your system.
- {{Email Address of Customer}} - This variable must hold the email addresses of your customers.
- {{Unique Identifiable System ID of Customer}} - This variable must hold the unique identifiers of the customers in your system. We use it to distinguish customers and their data.
- {{Server Generated HMAC}} - We use HMAC (Hash-based Message Authentication Code) as a means to avoid tampering with the above customer data when sent from your end. You must generate an HMAC and replace it here.
Steps to generate a HMAC:
- From the scripts below, select one based on your programming language preference. Copy the script and compute it on your server.
NodeJS
const crypto = require("crypto")
let customer_id = "bfuyw3fiub3289uij" //Unique Identifiable System ID of Customer
let digestRaw = email_id+customer_id
let algorithm = "sha256"
let secret = "e46788a75fe6a876ba83a3892cfd201f"; // Secret Key
let HMACDigest = crypto.createHMAC(algorithm,secret).update(digestRaw).digest("hex")
Ruby
require 'base64'
require 'openssl'
customer_id="bfuyw3fiub3289uij" //Unique Identifiable System ID of Customer
digestRaw= email_id+customer_id;
algorithm = OpenSSL::Digest.new('sha256')
secret = 'e46788a75fe6a876ba83a3892cfd201f' //Secret Key
HMACDigest = OpenSSL::HMAC.hexdigest(algorithm, secret, digestRaw)
PHP
$customer_id="bfuyw3fiub3289uij"; //Unique Identifiable System ID of Customer
$digestRaw= $email_id.$customer_id;
$algorithm = 'sha256';
$secret = 'e46788a75fe6a876ba83a3892cfd201f'; //Secret Key
$HMACDigest = hash_HMAC($algorithm, $digestRaw, $secret);
- In the above scripts instead of "peter.prescott@zylker.com" and "bfuyw3fiub3289uij" substitute their respective variables. The variable for email_id must contain the email addresses of your customers, while the customer_id's must hold the customer's unique identifiable system ID.
- Replace the placeholder for secret, "e46788a75fe6a876ba83a3892cfd201f" with the Secret Key found on your Scripts page.
- Return the HMACDigest in a way that the HMAC code generated replaces the {{Server Generated HMAC}} inside the tracking script.
- {{Signup URL}} - The URL of your site’s sign up page.
- {{Login URL}} - The URL of your site’s sign-in/log-in page.
- {{Time in secs}} - This will delay the widget from loading before the set time. It's helpful for sites where the data takes time to process. You can set the delay for up to a maximum of 40 secs.
It is not necessary to modify the {{Signup URL}} and {{Login URL}} if you do not plan to run a loyalty program.
Your site will now be successfully integrated with Zoho Thrive.
Now, while building the program, there are two other instances that require a manual data push from your end.
- If you plan on using any of the following tasks, Make a Purchase, Referral Purchase, for your program - Create an HTTP request to push the purchase details to Zoho Thrive.
- If you create a custom task for your loyalty program - Create an HTTP request to push the task details to Zoho Thrive after its completion.
If you face any difficulties or require assistance with any of the steps above, feel free to write to us at support@zohothrive.com.
Access your files securely from anywhere
Zoho CRM Training Programs
Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.
Zoho DataPrep Personalized Demo
If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
Zoho FSM Video Tutorials
Centralize Knowledge. Transform Learning.
All-in-one knowledge management and training platform for your employees and customers.
New to Zoho Writer?
Create. Review. Publish.
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.
New to Zoho Survey?
Zoho Sheet Resources
Zoho Forms Resources
New to Zoho Sign?
Zoho Sign Resources
Sign, Paperless!
New to Zoho TeamInbox?
Zoho TeamInbox Resources
New to Zoho ZeptoMail?
Design. Discuss. Deliver.
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
New to Bigin?
Related Articles
Wix Platform Integration
Wix is another platform integration that comes with Zoho Thrive built in. Follow the steps below to integrate your Wix site with Thrive: Create a new app Go to Wix Developers site and log in using your Wix credentials. On the My Apps page, click ...Can I create custom tasks for my program?
Yes, you can. Follow the steps below to create custom tasks for your program. Custom task functionality is only available for brands with a custom-built site integration. Navigate to Points in the navigation bar on the left. Select Tasks, and then ...Shopify Platform Integration
Like other platform integrations, Shopify is a built-in platform integration available in Zoho Thrive. You can easily integrate your Shopify store with Thrive by following the steps below. Create a custom app: 1. Open the Shopify Developer Dashboard ...Configuring coupon rewards for custom-built websites
Overview For businesses running custom-built websites, Zoho Thrive supports coupon-based rewards through a configurable endpoint. Using the Coupon Configuration feature, you can set up a Request URL that allows Thrive to send coupon and redemption ...Zoho Commerce Platform Integration
Zoho Thrive integrates effortlessly with Zoho Commerce, allowing you to connect your store with a single click. If your store runs on the Zoho Commerce platform, setup is quick and effortless; no additional configuration required. Steps to integrate ...
New to Zoho LandingPage?
Zoho LandingPage Resources