התחלה מהירה

זהו המסלול הקצר ביותר מאפס להגדרה עובדת של Agent Analytics.

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

אם הסוכן שלכם כבר מותקן ואתם רוצים את המדריך הכי ברור ליצירת פרויקט, שתילת סניפט ואימות ה-page view הראשון, השתמשו ב-הפרויקט הראשון ב-5 דקות.

1. בחרו והשלימו מסלול התקנה

עברו אל מרכז ההתקנה והשלימו את ההגדרה לסביבה שבה אתם באמת משתמשים:

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

2. פתחו את הסוכן בתוך תיקיית הפרויקט

התחילו מהקוד או מהאתר שבאמת רוצים למדוד.

אחר כך בקשו מהסוכן את כל מהלך ההגדרה:

Set up Agent Analytics for this project. Install it here if needed. Open the browser for me or send me the login link, then wait. I will sign in with Google or GitHub, approve it, and paste back any finish code if you need it. Then create the project, add tracking, and verify the first event.

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

3. צרו את הפרויקט הראשון שלכם

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

Create a project called my-site.com
Create a project called my-site.com and give me the tracking snippet

אם לסוכן יש גישת כתיבה לקוד של האתר, בקשו ממנו:

Set up analytics for my-site.com

הסוכן שלכם אמור ליצור את הפרויקט ואז:

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

4. הוסיפו את הטרקר ידנית אם צריך

אם הסוכן כבר הוסיף את הטרקר לאתר, אפשר לדלג על השלב הזה.

אם הוא רק יצר את הפרויקט והחזיר סניפט, הוסיפו את הסקריפט לפני </body>:

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

ה-page view הראשוני נמדד אוטומטית. אם האפליקציה שלכם היא SPA ואתם רוצים שגם שינויי route יימדדו אוטומטית, הוסיפו data-track-spa="true" לתגית ה-script; אחרת שלחו קריאות page ידניות ומכוונות למסכים וירטואליים.

שדות URL אוטומטיים בטוחים לפרטיות כברירת מחדל: url ו-referrer מנוקים ל-origin פלוס pathname, ו-attribution אוטומטי קורא רק את מפתחות ה-UTM ברשימת ההרשאה: utm_source, utm_medium, utm_campaign, utm_content ו-utm_term. אירועים מותאמים אישית אפשר להוסיף אחר כך עם מאפייני data-aa-event או עם window.aa.track().

אם למוצר שלכם יש login או signup, שמרו את signup לרגע שבו החשבון באמת נוצר, עדיף בצד השרת. אחרי auth מוצלח בדפדפן, קראו ל-window.aa.identify(account.id, { email: account.email }) רק כשאתם מתכוונים לאפשר lookup לתמיכה לפי אימייל. השתמשו ב-app/account ID יציב בתור מזהה המשתמש, לא בכתובת אימייל. Agent Analytics מחשב HMAC lookup בטווח הפרויקט בצד השרת ומסיר אימייל גולמי משורות event ומ-profile traits כברירת מחדל.

Browser storage מוגבל לטווח הפרויקט לפי token/name. מזהים אנונימיים ישנים ללא scope לא מועברים, ולכן מבקר עשוי לקבל מזהה אנונימי חדש בטווח הפרויקט אחרי שדרוג מטרקר ישן.

אם האתר שלכם משתמש ב-Astro, הוסיפו is:inline לתגית הטרקר.

לאפשרויות מתקדמות כמו אירועים דקלרטיביים, זהות חוצת-דומיינים, consent, עומק גלילה, vitals ומעקב שגיאות, השתמשו ב-מדריך Tracker.js. אם האפליקציה שלכם היא SPA, השתמשו ב-מעקב SPA ועמודים וירטואליים כדי לבחור בין מעקב route עם data-track-spa="true" לבין קריאות page_view וירטואליות ידניות. אם אתם רוצים שהסוכן שלכם ישיק את ניסוי ה-A/B הראשון שלכם אחרי ההגדרה, המשיכו אל מעקב ניסויים לסוכני AI.

5. ודאו שהלולאה נסגרת

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

List my projects
How is my-site doing this week?
What are the top pages for my-site this week?
Show bot traffic for my-site this week

אם ההגדרה תקינה, הסוכן אמור לענות בלי שתצטרכו לכתוב בקשות HTTP ידנית.

fallback מתקדם: מפתח API

אם אתם צריכים גישת HTTP ישירה לריצה משלכם, עדיין אפשר לייצר מפתח API מתוך app.agentanalytics.sh. זהו המסלול הידני/המתקדם. עבור CLI, MCP ו-onboarding לסוכנים, עדיף להשתמש באישור בדפדפן וב-agent sessions.

השלב הבא

השתמשו ב-התקנה למסלול ההגדרה המהיר ביותר לכל סוכן.
השתמשו ב-הפרויקט הראשון ב-5 דקות בשביל מדריך ההפעלה המלא, מסוכן שכבר הותקן ועד פרויקט חי ראשון.
השתמשו ב-מעקב SPA ועמודים וירטואליים כשהאפליקציה שלכם מחליפה מסכים בצד הלקוח ואתם רוצים מדידת page tracking מדויקת בלי ספירה כפולה.
השתמשו ב-מעקב ניסויים לסוכני AI כשאתם רוצים שהסוכן ישיק ויקרא עבורכם ניסויים בצד הדפדפן.
השתמשו ב-Tracker.js לאפשרויות מעקב בצד הדפדפן.
השתמשו ב-Bot Traffic כדי לבדוק תעבורה אוטומטית שמסוננת מהאנליטיקה הרגילה.
השתמשו ב-Authentication כשאתם צריכים להבין את ההבדל בין טוקן קריאה לטוקן כתיבה.
השתמשו ב-API Reference כשאתם צריכים פירוט ברמת נקודת קצה.