Getting Started

Setting up tracking on your vanity site is simple. The process involves creating an account, setting up a project workspace, configuring your allowed domains, and installing the script.

1. Create an Account

Navigate to the Cogwheel Attribute Dashboard:

• Production Dashboard: https://attribute.cogwheelmarketing.com
• Sign-Up Direct Link: https://attribute.cogwheelmarketing.com/sign-up

Fill out the registration form with your name, work email, and password. Confirm your email if prompted by your system administrator.

2. The Projects Workspace

Once logged in, you will land on the Projects directory (/dashboard):

• This page showcases account-level summary tiles (active domains, total page views, intercepted clicks).
• Each Project represents an isolated workspace for a specific brand or property website (e.g., a single vanity site or campaign domain).

3. Create a Project

To set up a new tracking container:

1. Click the New Project button.
2. Enter a Project Name (e.g., Boutique Hotel Vanity).
3. Under Primary Domain, enter your vanity website's root hostname (e.g., www.vanityresort.com).
4. Click Create Project.

You will automatically be redirected to your newly created project workspace.

4. Domain Whitelist Configuration

For security, the client-side script only loads and rewrites links on domains that you explicitly authorize. This prevents bad actors from copy-pasting your script onto other sites.

To whitelist additional hostnames:

1. In your project workspace, click the Settings tab.
2. Under Additional Allowed Domains, add other environments where you expect to run or test the script (e.g., localhost:3000, staging.vanityresort.com).
3. Click Save Changes.

5. Install the Snippet

To install the tracking container on your site:

1. Click on the Integration tab.
2. Copy the generated HTML <script> block. It will look like this:

<script src="https://cdn.cogwheelmarketing.com/sdk.min.js"
  data-project-id="YOUR_UNIQUE_PROJECT_ID"
  data-api-url="https://attribute-api.cogwheelmarketing.com"></script>

3. Place this code block just before the closing </body> tag on every page of your vanity website.
4. If you deploy the tag via a tag manager (like Google Tag Manager), follow the instructions in the Deployment & QA Guide for specific sandbox requirements.

Once loaded, the script checks if the current page hostname is whitelisted, fetches the active ruleset from the edge API, and initializes the link interceptor.

6. Training & Risk-Free Testing: Demo Mode

If you want to practice creating rules, building Hyatt source codes, or testing the campaigns interface without affecting production database records or live traffic configurations, you can use the built-in Demo Mode.

• Access URL: https://attribute.cogwheelmarketing.com/demo
• How it Works:
  • The Demo Mode provides a full sandbox replica of the dashboard interface.
  • It runs entirely on in-memory sandbox data (defined in apps/web/lib/demo-data.ts).
  • Any projects, rules, campaigns, or domains you create in Demo Mode are temporary and will be reset once you refresh your browser.
  • This is an excellent tool for training agency staff or testing rule configurations prior to creating them in your active production workspace.