===========================================
 AI Citation Tracker – White-Label Setup
===========================================

Thank you for trying out our white-label AI Citation Tracker demo.
This tool is designed for SEO agencies who want to offer real-time 
AI mention tracking to their clients, fully branded as their own.

This file contains everything you need to customize and deploy the tool.

-------------------------------------------
1. FILE STRUCTURE
-------------------------------------------
The demo files are organized in the following way:

 /demo/
  +-- ai_citation_log.php        - Main dashboard demo
  +-- tracker.js                 - Tracking script
  +-- placeholder-logo.png       - Replace with your own logo
  +-- style.css                  - Optional styling overrides
  +-- ReadMe.txt                 - This file
  +-- /log/                      - JSON log folder (for tracking entries)

You can copy or rename the `/demo/` folder to /youragency/ or any folder name
you prefer before uploading it to your server.

-------------------------------------------
2. BASIC SETUP
-------------------------------------------

? STEP 1: Upload to Your Hosting
---------------------------------
Upload the entire folder to your preferred hosting.
This can be a subdirectory of your site (e.g., youragency.com/ai-tracker/),
or hosted on a neutral domain (e.g., your-own-url.com/embed/).

? STEP 2: Replace Branding
----------------------------
Replace the file `placeholder-logo.png` with your agency’s logo.
The recommended size is 250x80px (PNG or SVG preferred).
Make sure to name your logo file exactly the same OR update the `src` in the HTML.

Also, update any visible text such as:
- "Laughing Professor"
- "Demo" references
- Meta titles and descriptions (if page is public-facing)

? STEP 3: Customize the tracker.js File
----------------------------------------
In `tracker.js`, find the line where it logs data to the JSON or database.
Replace the domain used in the script (if necessary) with the client’s domain
or your white-label hosted domain.

Example:
// Replace with your domain
let domain = "your-client-domain.com";

? STEP 4: Embed the Tracker on Client Sites
--------------------------------------------
Use the following embed code on your client’s site, just before the `</body>` tag:

<script src="https://your-own-url.com/embed/tracker.js" defer></script>

This script tracks visits and AI bot interactions on their site
and logs them to your server (the one hosting the embed folder).

? STEP 5: Test It
-------------------
After embedding the script, visit the client site using a bot user-agent
(e.g., GPTBot, Claude, Perplexity). These entries will show up in the dashboard.

You can also manually simulate a bot visit using:
https://your-own-url.com/embed/?simulate_ai=1

-------------------------------------------
3. CLIENT USE CASES
-------------------------------------------
This tool is ideal for:
- SEO & marketing agencies managing multiple client sites
- White-labeled dashboards for client reporting
- Monthly citation audits from AI sources

You maintain full control, and no data is sent to 3rd-party APIs.

-------------------------------------------
4. OPTIONAL CUSTOMIZATIONS
-------------------------------------------
You can:
- Modify `style.css` to match your agency’s colors and fonts.
- Integrate login access if offering per-client dashboards.
- Export log data to CSV or JSON for offline use.

Want customizations done for you? Contact: 
?? hello@laughingprofessor.net

-------------------------------------------
5. NOTES
-------------------------------------------
- This demo version is hosted in: /demo/
- The live white-label version will be hosted on your white-label folder:
    https://your-own-url.com/embed/

- Logs are currently saved to a local JSON file in `/log/`
  You can change this to use a database if preferred.

-------------------------------------------
Let’s Track Some AI Bots!
-------------------------------------------
Thank you for trying out the AI Citation Tracker.

Want the full white-label package zipped and ready to go?
Get in touch or request your custom folder setup.

#TheProfessor | laughingprofessor.net/ai-bot-tracker