Custom-built Site Integration | Zoho Thrive

Custom-built Site Integration

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 affiliate and loyalty programs.

Before proceeding with the integration, you'll need to create a brand for your site.

 

Create a brand  

  1. In the Selection page, select Custom-built.

  2. Click Connect.

    Platform selection page in Zoho Thrive

  3. In the pop-up, do the following:

    1. Enter your Brand Name.

    2. Enter your Brand URL (the URL of your website where you wish to run the programs).

    3. Provide a Support Email Address we can use to contact you.

    4. Select the Currency you use for payment transactions.

  4. Click Create.

    Brand Details popup in Zoho Thrive

 

After a brand is created, follow the steps below to establish a connection between your custom-built site and Zoho Thrive.

 

  Integrate your site  

  1. Navigate to the More -> Installation page inside Zoho Thrive.

  2. Copy Secret Key, Brand Code, and save it securely.

  3. 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>

  1. 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

https://thrive.zoho.com

https://thrive.zohopublic.com

India

https://thrive.zoho.in

https://thrive.zohopublic.in

Europe

https://thrive.zoho.eu

https://thrive.zohopublic.eu

South Africa

https://thrive.zoho.sa

https://thrive.zohopublic.sa

Australia

https://thrive.zoho.com.au

https://thrive.zohopublic.com.au

Canada

https://thrive.zohocloud.ca

https://thrive.zohopublic.ca


  1. 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>

 

  1. 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 email_id="peter.prescott@zylker.com" // Email address of Customer

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'

 

email_id="peter.prescott@zylker.com" // Email address of Customer

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

$email_id = "peter.prescott@zylker.com"; //Email address of Customer

$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.

 

Note: 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 programs, there are two other instances that require a manual data push from your end.

 

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 CRM Training
        Redefine the way you work
        with Zoho Workplace

          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 CRM Training

            Create, share, and deliver

            beautiful slides from anywhere.

            Get Started Now


              Zoho Sign now offers specialized one-on-one training for both administrators and developers.

              BOOK A SESSION






                          Quick Links Workflow Automation Data Collection
                          Web Forms Enterprise Begin Data Collection
                          Interactive Forms Workplace Data Collection App
                          Offline Forms Customer Service Accessible Forms
                          Digital Forms Marketing Forms for Small Business
                          HTML Forms Education Forms for Enterprise
                          Contact Forms E-commerce Forms for any business
                          Lead Generation Forms Healthcare Forms for Startups
                          Wordpress Forms Customer onboarding Order Forms for Small Business
                          No Code Forms Construction RSVP tool for holidays
                          Free Forms Travel
                          Prefill Forms Non-Profit

                          Intake Forms Legal

                          Form Designer HR

                          Card Forms Food
                          Assign Forms Photography

                          Translate Forms Real Estate
                          Electronic Forms

                          Notification Emails for Forms Alternatives
                          Holiday Forms Google Forms alternative 
                          Form to PDF Jotform alternative





                                            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.




                                                Manage your brands on social media

                                                  Zoho Desk Resources

                                                  • Desk Community Learning Series


                                                  • Digest


                                                  • Functions


                                                  • Meetups


                                                  • Kbase


                                                  • Resources


                                                  • Glossary


                                                  • Desk Marketplace


                                                  • MVP Corner


                                                  • Word of the Day


                                                    Zoho Marketing Automation

                                                      Zoho Sheet Resources

                                                       

                                                          Zoho Forms Resources


                                                            Secure your business
                                                            communication with Zoho Mail


                                                            Mail on the move with
                                                            Zoho Mail mobile application

                                                              Stay on top of your schedule
                                                              at all times


                                                              Carry your calendar with you
                                                              Anytime, anywhere




                                                                    Zoho Sign Resources

                                                                      Sign, Paperless!

                                                                      Sign and send business documents on the go!

                                                                      Get Started Now




                                                                              Zoho TeamInbox Resources



                                                                                      Zoho DataPrep Resources



                                                                                        Zoho DataPrep Demo

                                                                                        Get a personalized demo or POC

                                                                                        REGISTER NOW


                                                                                          Design. Discuss. Deliver.

                                                                                          Create visually engaging stories with Zoho Show.

                                                                                          Get Started Now









                                                                                                              • Related Articles

                                                                                                              • Wix Platform Integration

                                                                                                                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 ...
                                                                                                              • 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 Under Programs, select Loyalty > Points Under Tasks, click + Add Task. From the ...
                                                                                                              • Zoho Commerce Platform Integration

                                                                                                                Zoho Commerce Platform Integration Zoho Thrive comes with a built-in integration with Zoho Commerce. If your store is part of the Zoho Commerce platform, you can connect it with Thrive with just one click. In the platform selection page: Select Zoho ...
                                                                                                              • Shopify Platform Integration

                                                                                                                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: On your ...
                                                                                                              • How do I update my brand's currency details?

                                                                                                                The steps to update your brand's currency details differ depending on the platform integration you've chosen: Zoho Commerce, Shopify, or Wix Regardless of the seamless integration, updating the currency of a Zoho Commerce, Shopify, or Wix brand ...
                                                                                                                Wherever you are is as good as
                                                                                                                your workplace

                                                                                                                  Resources

                                                                                                                  Videos

                                                                                                                  Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                                  eBooks

                                                                                                                  Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                                  Webinars

                                                                                                                  Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                                  CRM Tips

                                                                                                                  Make the most of Zoho CRM with these useful tips.



                                                                                                                    Zoho Show Resources