Tracker.js

tracker.js הוא החלק הדפדפני של Agent Analytics. השתמשו בו כשאתם רוצים צפיות דף, אירועים מותאמים אישית וניסויים בצד הלקוח בלי לשלוח SDK כבד.

עיון ה-API מתייחס עכשיו ל-GET /tracker.js כנקודת הקצה של הסקריפט בלבד. מדריך ההגדרה והיכולות נמצא כאן.

סניפט בסיסי

הוסיפו את זה לפני </body>:

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

מאפיינים נדרשים:

data-project: שם הפרויקט שלכם
data-token: טוקן הפרויקט הציבורי (aat_*)

הטרקר אוסף אוטומטית את כתובת הדף, pathname, referrer, דפדפן, מערכת הפעלה, מכשיר, שפה, אזור זמן, פרמטרי UTM, מספר session ו-first-touch attribution. אין צורך בעוגיות.

תעבורה אוטומטית שמגיעה לטרקר מסוננת מהאנליטיקה הרגילה שלכם. השתמשו ב-Bot Traffic אם אתם רוצים לבדוק את הבקשות האוטומטיות בנפרד.

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

אפשרויות נפוצות

Attribute	מה זה עושה
`data-link-domains="example.com"`	מחבר זהות אנונימית בין דומיינים או תתי-דומיינים אחים
`data-do-not-track="true"`	מכבד את אות Do Not Track של הדפדפן
`data-heartbeat="15"`	מודד זמן פעיל בדף בזמן שהטאב גלוי
`data-track-outgoing="true"`	עוקב אחרי קליקים על קישורים חיצוניים בתור `outgoing_link`
`data-track-clicks="true"`	עוקב אחרי קליקים על `<a>` ו-`<button>` בתור `$click`
`data-track-errors="true"`	לוכד שגיאות JS לא מטופלות ו-promise rejections בתור `$error`
`data-track-performance="true"`	מוסיף מדדי Navigation Timing ל-`page_view`
`data-track-vitals="true"`	מוסיף Core Web Vitals ל-`page_view`
`data-track-downloads="true"`	עוקב אחרי קליקים על קישורי הורדה בתור `$download`
`data-track-forms="true"`	עוקב אחרי שליחת טפסים בתור `$form_submit`
`data-track-404="true"`	עוקב אחרי דפי 404 בתור `$404`
`data-track-scroll-depth="true"`	מוסיף עומק גלילה מקסימלי ל-`page_view`
`data-require-consent="true"`	מחזיק אירועים בבאפר עד שניתן consent

דוגמה:

<script defer src="https://api.agentanalytics.sh/tracker.js"
        data-project="my-site"
        data-token="aat_..."
        data-track-outgoing="true"
        data-track-performance="true"
        data-track-vitals="true"
        data-track-errors="true"
        data-track-scroll-depth="true"
        data-heartbeat="15"></script>

אירועים דקלרטיביים

למעקב קליקים פשוט, לרוב לא צריך JavaScript מותאם אישית. הוסיפו data-aa-event ישירות ל-HTML:

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

זה ישלח אירוע signup עם { plan: "pro" }.

ברוב המקרים זהו גם המסלול הקל ביותר לסוכנים. הם יכולים להוסיף מאפיינים ל-markup קיים במקום לחווט onclick handlers או לערוך קוד אפליקציה.

חשיפות

עקבו אחרי האם מקטע מסוים באמת נצפה:

<section data-aa-impression="pricing_table"
         data-aa-impression-plan="pro">
  ...
</section>

כשהאלמנט הופך לגלוי, הטרקר שולח אירוע $impression.

API של `window.aa`

השתמשו ב-JavaScript API כשהאירוע תלוי במצב runtime:

window.aa?.track('checkout_started', { plan: 'pro' });
window.aa?.identify('user_123');
window.aa?.set({ plan: 'pro', team: 'acme' });

שיטות שימושיות:

aa.track(event, properties): שליחת אירוע מותאם אישית
aa.page(name): שליחת page view ידנית
aa.identify(id): קישור התנהגות אנונימית למזהה משתמש ידוע
aa.set(properties): צירוף מאפיינים גלובליים לאירועים עתידיים
aa.experiment(name, variants): שיוך וריאנטים בצד הלקוח בצורה דטרמיניסטית
aa.grantConsent() / aa.revokeConsent(): ניהול מצב consent

מתכונים נפוצים

זהות חוצת-דומיינים

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

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

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

ניסויים

<h1 data-aa-experiment="hero_text"
    data-aa-variant-b="Try it free today!">
  Start your free trial
</h1>

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

פיתוח מקומי

ב-localhost הטרקר עובר למצב פיתוח ורושם פעילות לקונסול של הדפדפן במקום לשלוח נתוני production. כך בדיקות מקומיות לא מזהמות את האנליטיקה האמיתית שלכם.