Custom-built Site Integration | Zoho Thrive

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 pa

  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

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

Integrate your site

  1. Navigate to 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.
    1. <script type="text/javascript">
    2. var platformType='custom_user_site';
    3. var thriveWidgetCode= '{{Brand code}}';
    4. var ztUserData = {};
    5. </script>
    6. <script id="thrive_script" src="{{Public Domain URL}}/thrive/publicpages/thrivewidget"></script>
  4. Replace the placeholders above with their corresponding variables 
    1. {{Brand code}} - This variable is same as you copied from More-> Installation Page
    2. {{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.
  5. Copy the below script and paste it between the <body> and </body> tags  on each page of your site.

    1. <script type="text/javascript">
    2. var ztUserData = {};
    3. ztUserData['za_email_id'] = {{Email Address of Customer}};
    4. ztUserData['user_unique_id'] = {{Unique Identifiable System ID of Customer}};
    5. ztUserData['thrive_digest'] = {{Server Generated HMAC}};
    6. ztUserData['signUpPage'] = {{Signup URL};
    7. ztUserData['signInPage'] = {{Login URL}};
    8. ztWidgetDelay = {{Time in secs}};
    9. </script>

  6. Replace the placeholders above with their corresponding variables defined in your system.

    1. {{Email Address of Customer}} - This variable must hold the email addresses of your customers.
    2. {{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.
    3. {{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:

      1. From the scripts below, select one based on your programming language preference. Copy the script and compute it on your server.

        NodeJS

        1. const crypto = require("crypto")
        2. let email_id="peter.prescott@zylker.com" // Email address of Customer
        3. let customer_id = "bfuyw3fiub3289uij" //Unique Identifiable System ID of Customer
        4. let digestRaw = email_id+customer_id
        5. let algorithm = "sha256"
        6. let secret = "e46788a75fe6a876ba83a3892cfd201f"; // Secret Key
        7. let HMACDigest = crypto.createHMAC(algorithm,secret).update(digestRaw).digest("hex")

        Ruby

        1. require 'base64'
        2. require 'openssl'

        3. email_id="peter.prescott@zylker.com" // Email address of Customer
        4. customer_id="bfuyw3fiub3289uij" //Unique Identifiable System ID of Customer
        5. digestRaw= email_id+customer_id;

        6. algorithm = OpenSSL::Digest.new('sha256')
        7. secret = 'e46788a75fe6a876ba83a3892cfd201f' //Secret Key
        8. HMACDigest = OpenSSL::HMAC.hexdigest(algorithm, secret, digestRaw)

        PHP

        1. $email_id = "peter.prescott@zylker.com"; //Email address of Customer
        2. $customer_id="bfuyw3fiub3289uij"; //Unique Identifiable System ID of Customer
        3. $digestRaw= $email_id.$customer_id;
        4. $algorithm = 'sha256';
        5. $secret = 'e46788a75fe6a876ba83a3892cfd201f'; //Secret Key
        6. $HMACDigest = hash_HMAC($algorithm, $digestRaw, $secret);

      2. 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.
      3. Replace the placeholder for secret, "e46788a75fe6a876ba83a3892cfd201f" with the Secret Key found on your Scripts page.
      4. Return the HMACDigest in a way that the HMAC code generated replaces the  {{Server Generated HMAC}} inside the tracking script.

    4. {{Signup URL}} - The URL of your site’s sign up page.
    5. {{Login URL}} - The URL of your site’s sign-in/log-in page.
    6. {{Time in secs}} - This will delay the widget from loading before the set time. It comes in handy 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 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









                                            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 is another platform integration that comes built-in with Zoho Thrive. 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 Home page, click Build ...
                                                                                                              • 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

                                                                                                                Besides other platform integrations, Shopify is another 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. On your Shopify home screen, ...
                                                                                                              • 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