Syncing Project Settings
Why this matters
The PageSense SDK works off a local copy of your project settings. When you update an experiment — change a variation, adjust traffic, modify targeting rules — the SDK needs to pick up those changes.
getAndUpdateProjectSettings does exactly that: it pulls the latest settings from PageSense and refreshes the SDK's internal state. You can trigger this via webhooks (real-time) or polling (scheduled).
Changes that trigger a sync:
- New or updated experiments
- Variation or traffic allocation changes
- Updated audience targeting rules
- Goal configuration changes
- Experiment status updates
Option 1 — Webhook-based Sync (recommended)
Webhooks give you real-time updates. When you modify a FullStack experiment in PageSense, the flow looks like this:
- Pause the experiment.
- Apply the changes.
- Relaunch the experiment.
If a webhook URL is set in your Environment Settings, PageSense sends a POST notification to that URL on relaunch. Your server should handle that event and call getAndUpdateProjectSettings immediately.
Retry behaviour if the webhook fails:
- PageSense retries every 30 seconds.
- Retries run for up to 15 minutes.
- After that window, retries stop.
- A new relaunch triggers a fresh notification.
Option 2 — Polling-based Sync
No webhook setup? Use polling instead. The SDK runs a background loop at a configured interval, calls the settings API, and updates the configuration if anything has changed. Nothing to manage manually — it just runs.
getAndUpdateProjectSettings API
Method
- await pageSenseClient.getAndUpdateProjectSettings(
- accountId,
- sdkKey,
- projectName
- );
Parameters
Parameter | Type | Required | Description |
accountId | String | Yes | Your PageSense account identifier. |
sdkKey | String | Yes | Secure SDK key for your environment. |
projectName | String | Yes | The PageSense project to sync. |
Return Value
- true — settings fetched and updated successfully.
- false — update failed (invalid params, network issue, or server error).
Usage Example
- await pageSenseClient.getAndUpdateProjectSettings(
- "ZylkerUser1",
- "xyz123abdscd",
- "ZylkerFullStackProject"
- );
After this runs, all subsequent experiment evaluations use the refreshed configuration.
Polling Lifecycle Methods
Method | What it does |
startPolling() | Kicks off the polling loop. |
runPollingCycle() | Runs one sync cycle manually. |
stopPolling() | Stops the loop and frees resources. |
registerShutdownHooks() | Ensures polling stops cleanly when the Node.js process exits. |
Quick comparison
Approach | Best for |
Webhook | Real-time updates, minimal latency. |
Polling | Environments where webhook setup isn't possible. |
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
Project Settings
The Project Settings section in Zoho PageSense allows you to configure advanced controls that affect how your website is tracked and how experiments behave across your project. These settings help you customize tracking behavior, organize pages, run ...General settings
The General section in Settings provides an overview of your project’s essential information and subscription details in Zoho PageSense. It helps you quickly identify the configuration of your project and monitor how your current subscription plan is ...Settings Overview
The Settings section in Zoho PageSense allows you to configure how your project tracks visitor behavior, manages privacy preferences, controls user access, and connects integrations.These settings ensure that PageSense collects accurate data from ...Content and Privacy Settings
The Content and Privacy section in Zoho PageSense Settings allows you to manage how visitor data is collected, stored, and protected on your website. These settings help ensure that your tracking activities remain transparent to visitors while also ...Get and Update Project Settings
The Get and Update Project Settings feature ensures that your Android application always stays in sync with the latest Full Stack configuration defined in PageSense. Project settings include: Active experiments Variations and traffic allocation Goals ...
New to Zoho LandingPage?
Zoho LandingPage Resources