DGטל — מעקב פתיחת מיילים (תוסף דפדפן)
=========================================

מה זה?
תוסף אמיתי ל-Chrome / Edge (או כל דפדפן מבוסס-Chromium) שמוסיף לכל מייל
שאתם כותבים ב-Gmail תמונת מעקב שקופה בגודל פיקסל אחד. כשהתמונה נטענת אצל
הנמען, אתם רואים בתוסף שהמייל "נפתח" — בדיוק העיקרון שעומד מאחורי כלים
כמו Mailtrack או Mailsuite, רק כאן זה רץ מול שרת משלכם (dgtal.xyz) בלי
חשבון בחברה זרה ובלי להתקין כלום אצל הנמען.

כנות מלאה לפני שמתקינים — תקרא/י את זה, זה חשוב יותר מרשימת הפיצ'רים:

1. "פתיחה" זה לא תמיד בנאדם. חלק ניכר משרתי הדוא"ל (בעיקר Gmail עצמו,
   וגם Apple Mail עם "הגנת פרטיות בדוא\"ל") טוענים תמונות באופן אוטומטי
   ברגע שהמייל מגיע לתיבה — לפעמים תוך שניות משליחה, לפני שמישהו בכלל
   פתח את המייל. בגלל זה כל פתיחה שקרתה פחות מ-5 דקות אחרי השליחה
   מסומנת בתוסף כ"ככל הנראה טעינה אוטומטית" ולא כפתיחה אמיתית. זו לא
   תקלה בתוסף — זו מגבלה שקיימת בכל כלי מעקב פתיחה שקיים, בלי יוצא מן
   הכלל. חשוב לדעת גם: אחרי שהתמונה נשמרת ככה אצל גוגל, לפעמים אין בכלל
   פינג נוסף לשרת שלנו גם כשהאדם באמת פותח וקורא — כי הוא מקבל אותה
   מהעותק השמור של גוגל, לא ישירות מכם.
2. אם הנמען חוסם תמונות חיצוניות (הגדרה נפוצה בהרבה תוכנות מייל
   ארגוניות), המייל ייחשב "לא נפתח" גם אם הוא כן נקרא. זו לא בעיה
   שאפשר לפתור — זה הרעיון הבסיסי שמאחורי כל טכניקת מעקב מהסוג הזה.
3. Gmail היא חברה שמשנה את מבנה הדף הפנימי שלה בלי הודעה מראש. התוסף
   מזהה את חלון הכתיבה לפי סימנים פנימיים יציבים יחסית שגוגל עצמה
   משתמשת בהם (ולא לפי מחלקות CSS, שמשתנות כמעט בכל עדכון) — אבל
   "יציב יחסית" זה לא "לנצח". אם יום אחד גוגל תשנה את המבנה הזה, הזיהוי
   עלול להפסיק לעבוד עד שהתוסף יעודכן. שלחו מייל בדיקה לעצמכם אחרי
   ההתקנה כדי לוודא שזה עובד אצלכם לפני שאתם סומכים עליו.
4. המעקב פועל רק על מיילים שנכתבים בדפדפן דרך mail.google.com — לא
   באפליקציית Gmail בנייד, לא ב-Outlook, ולא במייל שנשלח מכל מקום אחר.

5. בתיקיית "נשלחו" ב-Gmail עצמה מופיע גם וי (אחד אפור = נשלח, שניים
   ירוקים = נפתח) ליד כל מייל במעקב — וגם ליד כותרת הנושא כשפותחים מייל
   ספציפי לקריאה. שום פתיחה של התוסף לא נדרשת, זה אוטומטי. ההתאמה נעשית
   לפי טקסט הנושא בלבד (אין לתוסף גישה למזהה הפנימי של גוגל) — אם שולחים
   שני מיילים עם בדיוק אותו נושא, הוי עלול להופיע ליד המייל הלא נכון.
   לתמונה מדויקת תמיד, בלי הבעיה הזו, יש את הפופאפ של התוסף.

6. צליל התראה קצר (בנוי מתוך הדפדפן, לא קובץ שיכול להישבר) כשמייל נפתח —
   אפשר לכבות בנפרד מההתראה הכתובה, בפופאפ.
7. סיכום שבועי אוטומטי (התראת דפדפן) עם כמה מיילים נשלחו ואחוז שנפתחו.
8. בפופאפ: סטטיסטיקה כללית (נשלחו / אחוז פתיחה / זמן פתיחה ממוצע),
   "לוח מובילים" של הנמענים שהכי פותחים אצלכם, וייצוא כל ההיסטוריה לקובץ CSV.

9. הישגים (Achievements) שנפתחים לפי הפעילות שלכם — מוצגים כתגיות בפופאפ.
10. תובנה אוטומטית "מתי הכי כדאי לשלוח" — לפי אילו שעות ביום המיילים שלכם
    הכי נפתחים בפועל (על סמך ההיסטוריה שלכם, לא ניחוש כללי).
11. "שעות שקטות" — טווח שעות (למשל 22:00–07:00) שבו התראה וצליל מושתקים
    אוטומטית; מספר הפתיחות על אייקון התוסף עדיין מתעדכן, בשקט, כדי שלא
    תפספסו כלום כשתחזרו למחשב.

מה כן עובד, בפועל:
- כל חלון כתיבה חדש ב-Gmail מקבל תגית קטנה "מעקב פתיחה: פעיל" — אפשר
  ללחוץ עליה לכבות מעקב למייל הספציפי הזה לפני השליחה.
- כשהנמען (או שרת המייל שלו) טוען את התמונה, זה נרשם בשרת ומופיע בתוסף
  עם שעה וכמות פתיחות.
- אפשר לקבל התראת דפדפן כשמייל נפתח (ניתן לכיבוי בהגדרות בתוך התוסף).
- כל ההיסטוריה נשמרת 90 יום ואז נמחקת אוטומטית מהשרת.

איך מתקינים (חנות התוספים לא רלוונטית — זה קובץ מקומי):
1. פתחו את כרום/edge, גשו לכתובת: chrome://extensions
2. הפעילו את המתג "מצב מפתח" (Developer mode) בפינה הימנית/שמאלית העליונה.
3. לחצו "טעינת תוסף לא ארוז" (Load unpacked).
4. בחרו את התיקייה dgtal-mail-tracker-extension (בדיוק את התיקייה הזו,
   שמכילה את הקובץ manifest.json).
5. פתחו Gmail, התחילו הודעה חדשה — תראו את התגית "מעקב פתיחה: פעיל"
   בפינה התחתונה של חלון הכתיבה.
6. לבדיקה: שלחו מייל לכתובת שנייה שלכם ופתחו אותו משם. תוך דקה-שתיים
   (התוסף בודק כל 2 דקות) הוא אמור להופיע כ"נפתח" בפופאפ של התוסף.

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

הערה לגבי צד-שרת: התוסף מדבר עם https://dgtal.xyz/api/mail-track —
כדי שהמעקב יעבוד בפועל, הפונקציה api/mail-track.js צריכה להיות פרוסה
תחת הדומיין הזה (או שצריך לעדכן את הכתובת בקוד popup/background אם
הדומיין שונה), ומשתני הסביבה KV_REST_API_URL / KV_REST_API_TOKEN
(אותם שכבר משמשים את api/track.js ו-api/kv.js) צריכים להיות מוגדרים
כדי שההיסטוריה תישמר בין ביקורים ולא רק בזיכרון זמני של השרת.
