🦞 מה חדש ב-Tracker.js

ה-tracker של Agent Analytics קיבל שדרוג גדול.

הרבה דברים שבעבר דרשו JavaScript מותאם אישית אפשר עכשיו להגדיר עם HTML attributes בלבד, ובנוסף הוספנו יכולות חדשות שנועדו להפוך instrumenting ו-QA להרבה יותר פשוטים.

Declarative Event Tracking

החידוש המרכזי: אפשר לעקוב אחרי events בלי לכתוב JavaScript.

<button data-aa-event="signup" data-aa-event-plan="pro">
  Sign Up for Pro
</button>

לחיצה על הכפתור תשלח signup עם { plan: "pro" }.

אפשר לצרף properties נוספים דרך data-aa-event-*:

<a href="/pricing"
   data-aa-event="cta_click"
   data-aa-event-id="hero_pricing"
   data-aa-event-section="hero">
  See Pricing →
</a>

זה הופך הוספת tracking על ידי agent או על ידי מפתח לדבר כמעט טריוויאלי.

Outgoing Link Tracking

אם חשוב לכם לדעת לאן משתמשים יוצאים, אפשר לאפשר מעקב אוטומטי:

<script src="https://api.agentanalytics.sh/tracker.js"
  data-project="my-site"
  data-token="aat_..."
  data-track-outgoing="true"></script>

כל לחיצה על קישור חיצוני תיצור outgoing_link עם ה-URL, הטקסט וה-hostname.

User Identification

אחרי signup או login אפשר לחבר session אנונימי למשתמש אמיתי:

window.aa.identify('user_123');

כך היסטוריית הגלישה והאירועים לפני ההתחברות לא הולכת לאיבוד.

Rich HTML Experiment Variants

ניסויים כבר לא מוגבלים להחלפת טקסט. אפשר לבדוק HTML עשיר:

<div data-aa-experiment="hero_test"
     data-aa-variant-b="<h1>Ship Faster</h1><p>Your agent handles the rest</p><img src='/new-hero.png'>">
  <h1>Build Better</h1>
  <p>Analytics your agent can read</p>
  <img src="/hero.png">
</div>

זה מאפשר לבדוק sections שלמים ולא רק headline אחת.

Forced Variants ל-QA

אפשר לכפות וריאנט דרך URL:

https://my-site.com?aa_variant_hero_test=b

שימושי ל-screenshots, QA ושיתוף פנימי לפני shipping.

Cross-Domain Tracking

אם יש לכם כמה subdomains, אפשר לשמור על אותה זהות אנונימית ביניהם:

<script src="https://api.agentanalytics.sh/tracker.js"
  data-project="my-site"
  data-token="aat_..."
  data-link-domains="yoursite.com,app.yoursite.com,docs.yoursite.com"></script>

זה שימושי במיוחד כשיש journey שחוצה marketing site, docs ו-app.

פרטיות ו-Do Not Track

ה-tracker יודע לכבד גם DNT של הדפדפן וגם opt-out מקומי:

<script src="https://api.agentanalytics.sh/tracker.js"
  data-project="my-site"
  data-token="aat_..."
  data-do-not-track="true"></script>

ואפשר גם לכבות tracking דרך:

localStorage.setItem('aa_disabled', 'true');

Performance Timing

אפשר לקבל אוטומטית metrics של טעינת דף:

<script src="https://api.agentanalytics.sh/tracker.js"
  data-project="my-site"
  data-token="aat_..."
  data-track-performance="true"></script>

המערכת שולחת $performance עם מדדים כמו TTFB, DOM interactive ו-load time.

Time-on-Page

כדי למדוד כמה זמן באמת משתמשים שהו בעמוד:

<script src="https://api.agentanalytics.sh/tracker.js"
  data-project="my-site"
  data-token="aat_..."
  data-heartbeat="30"></script>

הטרקר יודע לעצור כשהטאב מוסתר ולחדש כשהוא נראה, כך שהמדידה שימושית יותר מ-”הטאב נשאר פתוח”.

JS Error Tracking

אפשר ללכוד שגיאות JavaScript בסיסיות בלי להוסיף כלי נפרד:

<script src="https://api.agentanalytics.sh/tracker.js"
  data-project="my-site"
  data-token="aat_..."
  data-track-errors="true"></script>

שגיאות לא מטופלות ו-promise rejections נשלחות כ-$error.

Global Properties

עם aa.set() אפשר להוסיף properties לכל האירועים הבאים:

window.aa.set({ plan: 'pro', team: 'acme-corp' });
window.aa.set({ plan: null });

זה נוח ל-segmentation לפי plan, team או user type.

Consent Management

למקרים שבהם צריך consent לפני tracking:

<script src="https://api.agentanalytics.sh/tracker.js"
  data-project="my-site"
  data-token="aat_..."
  data-require-consent="true"></script>

ואז אפשר:

window.aa.grantConsent();
window.aa.revokeConsent();

Scroll Depth, Impressions ו-Web Vitals

הגרסה החדשה מוסיפה גם:

• $scroll_depth כדי לדעת עד כמה גוללים
• data-aa-impression כדי למדוד אם section באמת נצפה
• $web_vitals עבור LCP, CLS ו-INP
• מעקב automatic file downloads

אלה metrics שעוזרים להבין לא רק “האם הדף נטען”, אלא האם משתמשים באמת ראו והרגישו את החוויה.

למה זה חשוב

הכיוון הכללי ברור: פחות קוד מותאם אישית, יותר instrumentation declarative.

זה טוב למפתחים, אבל זה חשוב במיוחד ל-agents. כשסוכן יכול להוסיף tracking על ידי הוספת attributes במקום לכתוב layer שלם של custom JS, הרבה יותר קל לו לסגור את הלופ בין product changes לבין measurement.

זו בדיוק הסיבה שבנינו את השדרוג הזה.