מדריך אינטגרציית אנליטיקס של WooAI

WooAI Chatbot Pro שולח אירועים סטנדרטיים ל-Google Analytics 4, Meta Pixel ו-Mixpanel, כולם בו-זמנית, בכל פעם שלקוח מתקשר עם ווידג’ט הצ’אט. הדביקו את המזהים שלכם ב-Analytics Settings והנתונים מתחילים לזרום מיד.

סקירה

WooAI Chatbot Pro עוקב אחר כל אינטראקציה בצ’אט אוטומטית בשלוש פלטפורמות האנליטיקס בו-זמנית. לוח הבקרה הפנימי של התוסף ב-WP Admin מתעד גם הוא את כל האירועים בנפרד: הוא לעולם לא נחסם על ידי חוסמי פרסומות ונותן לכם בסיס אמין גם כאשר ה-SDK החיצוניים אינם זמינים.

מה שאתם צריכים לעשות: עברו אל WP Admin → WooAI Assistant → Analytics Settings, הדביקו את מזהי הספקים שלכם ולחצו Save. זה הכול: בלי עריכת קוד, בלי GTM, בלי הגדרת תגיות.

ספקים נתמכים

ספק	מה נמדד	מה תקבלו
Google Analytics 4	כל אירועי הצ’אט + המסחר דרך `window.gtag()`	המרות, הכנסות, משפכים, קהלים
Meta Pixel	אירועים סטנדרטיים + מותאמים דרך `window.fbq()`	ייחוס המרות, קהלי רימרקטינג
Mixpanel	כל האירועים דרך `window.mixpanel.track()`	משפכים, קוהורטות, שימור, מסעות משתמש
לוח בקרה פנימי	כל האירועים בצד השרת אל טבלת `waa_events`	בסיס תמידי, לא מושפע מחוסמי פרסומות

הגדרה מהירה

Google Analytics 4

השיגו את ה-Measurement ID: עברו אל analytics.google.com → Admin → Data Streams → ה-web stream שלכם. המזהה בפורמט G-XXXXXXXXXX.
בממשק הניהול של WordPress: WooAI Assistant → Analytics Settings → Google Analytics 4 → הפעילו → הדביקו את המזהה → Save.
אופציונלי: הפעילו את מתג GA4 DebugView mode כדי לראות אירועים בזמן אמת בזמן בדיקות. כבו אותו לסביבת ייצור.

Meta Pixel

השיגו את ה-Pixel ID: עברו אל business.facebook.com → Events Manager. ה-Pixel ID הוא 10-16 ספרות.
בממשק הניהול של WordPress: WooAI Assistant → Analytics Settings → Meta Pixel → הפעילו → הדביקו את ה-Pixel ID → Save.

Mixpanel

השיגו את ה-Project Token: עברו אל mixpanel.com → Settings → Project Settings → Project Token.
בממשק הניהול של WordPress: WooAI Assistant → Analytics Settings → Mixpanel → הפעילו → הדביקו את ה-Token → Save.

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

בדיקה שזה עובד

ספק	איך לבדוק
GA4	פתחו Google Analytics → Configure → DebugView. הפעילו את מתג GA4 DebugView בהגדרות התוסף, אז גלשו באתר ופתחו את ווידג’ט הצ’אט. האירועים מופיעים תוך כמה שניות.
Meta Pixel	התקינו את תוסף ה-Chrome החינמי Meta Pixel Helper, ואז בקרו באתר. התג מציג ספירה של אירועים שנשלחו. ירוק = עובד.
Mixpanel	פתחו Mixpanel → Events → Live View. הפעילו אינטראקציה בצ’אט; האירועים מופיעים תוך שניות.
לוח בקרה פנימי	WP Admin → WooAI Assistant → Dashboard → Conversations. האירועים תמיד שם, ללא תלות בספקים חיצוניים.

טקסונומיית האירועים המלאה

הטבלה למטה מפרטת כל אירוע שהתוסף שולח. האירועים נשלחים לכל הספקים המופעלים בו-זמנית. אירועי מסחר מסומנים ב-🛒.

הערה על אירועים מותאמים: ל-Meta Pixel יש סט מוגבל של אירועים סטנדרטיים (מסומנים “standard” למטה). כל שאר האירועים משתמשים ב-custom event API של Meta תחת מרחב השמות WooAI*. GA4 משתמש בקידומת wooai_* לאירועים לא-סטנדרטיים.

אירוע פנימי	טריגר	GA4	Meta Pixel	Mixpanel
`conversation_start`	הודעת המשתמש הראשונה בסשן צ’אט	`engage_widget`	`WooAIConversationStart` (custom)	`Chat Started`
`widget_open`	המשתמש לוחץ על כפתור ה-FAB לפתיחת הווידג’ט	`widget_open`	`WooAIWidgetOpen` (custom)	`Widget Opened`
`widget_close`	המשתמש סוגר את ווידג’ט הצ’אט	`widget_close`	`WooAIWidgetClose` (custom)	`Widget Closed`
`message_sent`	המשתמש שולח הודעה בצ’אט	`chat_message`	`WooAIMessageSent` (custom)	`Message Sent`
`message_received`	תשובת ה-AI נמסרת למשתמש	`chat_response`	`WooAIMessageReceived` (custom)	`Response Received`
`topic_detected`	ה-AI מסווג את הכוונה/הנושא של המשתמש	`topic_detected`	`WooAITopicDetected` (custom)	`Topic Detected`
🛒 `product_view`	כרטיס מוצר בודד מוצג בצ’אט	`view_item` (standard)	`ViewContent` (standard)	`Product Viewed`
🛒 `product_click`	המשתמש לוחץ על כרטיס מוצר בצ’אט	`select_item` (standard)	`ViewContent` (standard)	`Product Clicked`
🛒 `products_viewed`	רשימת מוצרים או קרוסלה מוצגת בצ’אט	`view_item_list` (standard)	`WooAIProductsViewed` (custom)	`Products Viewed`
🛒 `add_to_cart`	המשתמש מוסיף מוצר לעגלה דרך הצ’אט	`add_to_cart` (standard)	`AddToCart` (standard)	`Added to Cart`
🛒 `remove_from_cart`	המשתמש מסיר מוצר מהעגלה דרך הצ’אט	`remove_from_cart` (standard)	`WooAIRemoveFromCart` (custom)	`Removed from Cart`
🛒 `checkout_start`	המשתמש מתחיל צ’קאאוט מהצ’אט	`begin_checkout` (standard)	`InitiateCheckout` (standard)	`Checkout Started`
🛒 `purchase`	הזמנה אושרה (רכישה המיוחסת לצ’אטבוט)	`purchase` (standard)	`Purchase` (standard)	`Purchase Completed`
`session_start`	סשן אנליטיקס חדש נוצר למבקר	`session_start` (standard)	`WooAISessionStart` (custom)	`Session Started`
`session_end`	סשן הצ’אט נסגר (עזיבת עמוד או timeout)	`session_end`	`WooAISessionEnd` (custom)	`Session Ended`
`error`	שגיאה טכנית מתרחשת בצ’אטבוט	`exception` (standard)	`WooAIError` (custom)	`Error Occurred`
`recommendation_click`	המשתמש לוחץ על צ’יפ המלצה (quick-reply)	`wooai_recommendation_click`	`WooAIRecommendationClick` (custom)	`WooAI Recommendation Click`
`response_thumbs_up`	המשתמש נותן דירוג חיובי לתשובת AI	`wooai_response_thumbs_up`	`WooAIResponseThumbsUp` (custom)	`WooAI Response Thumbs Up`
`response_thumbs_down`	המשתמש נותן דירוג שלילי לתשובת AI	`wooai_response_thumbs_down`	`WooAIResponseThumbsDown` (custom)	`WooAI Response Thumbs Down`
`escalation_requested`	המשתמש לוחץ על כפתור המעבר ל-WhatsApp / נציג אנושי	`wooai_escalation_requested`	`WooAIEscalationRequested` (custom)	`WooAI Escalation Requested`

הערה על product_view מול products_viewed ב-Meta Pixel: כדי להימנע משליחה כפולה של אירועי ViewContent כשקרוסלת מוצרים מציגה כמה מוצרים, products_viewed (ברמת הרשימה) נשלח כאירוע custom של Meta (WooAIProductsViewed), בעוד אירועי product_view בודדים משתמשים ב-ViewContent הסטנדרטי לרימרקטינג. החל מגרסה v0.38.19.

כללי שמות לאירועים מותאמים: GA4 מוסיף אוטומטית קידומת wooai_* לאירועים לא-ממופים. Meta Pixel מעצב אוטומטית אירועים לא-ממופים כ-WooAI<PascalCase>. Mixpanel משתמש ב-WooAI <Title Case> לאירועים לא-ממופים.

פרמטרים סטנדרטיים של אירועי מסחר

כל ארבעת אירועי המסחר (add_to_cart, view_item, begin_checkout, purchase) שולחים נתוני מוצר עשירים לכל ספק. הנה בדיוק מה שכל פלטפורמה מקבלת.

Google Analytics 4

נשלח דרך window.gtag('event', eventName, params):

פרמטר	סוג	תיאור
`currency`	string	קוד מטבע החנות, מזוהה אוטומטית מ-WooCommerce (למשל `ILS`, `USD`, `EUR`)
`value`	number	ערך כספי כולל (מחיר x כמות, מסוכם על פני כל הפריטים)
`transaction_id`	string	מזהה הזמנה (אירוע `purchase` בלבד)
`items[]`	array	מערך של אובייקטי מוצר (ראו למטה)

שדות לכל מוצר בתוך items[]:

שדה	סוג	תיאור
`item_id`	string	מזהה מוצר של WooCommerce
`item_name`	string	שם המוצר
`item_category`	string	קטגוריית המוצר הראשית
`item_brand`	string	מותג המוצר (אם הוגדר)
`item_variant`	string	מאפייני וריאציה (צבע, מידה וכו’)
`price`	number	מחיר ליחידה
`quantity`	number	כמות
`item_list_name`	string	`"Chat Recommendations"`: מזהה את הצ’אטבוט כרשימת המקור
`item_list_id`	string	מזהה רשימה פנימי
`discount`	number	סכום הנחה (אם רלוונטי)
`index`	number	מיקום ברשימה (לאירועים מסוג רשימה)

Meta Pixel

נשלח דרך window.fbq('track', eventName, params):

פרמטר	סוג	אירועים	תיאור
`content_ids`	string[]	הכול	מערך של מזהי מוצר
`content_name`	string	ViewContent, AddToCart	שם(ות) המוצר
`content_type`	string	הכול	תמיד `'product'`
`value`	number	AddToCart, InitiateCheckout, Purchase	ערך כספי כולל
`currency`	string	AddToCart, InitiateCheckout, Purchase	קוד מטבע החנות
`num_items`	number	InitiateCheckout	ספירת פריטים כוללת בעגלה
`contents`	array	AddToCart, Purchase	אובייקטים לכל פריט עם `id`, `quantity`, `item_price`

Mixpanel

נשלח דרך window.mixpanel.track(eventName, properties):

מאפיין	תיאור
`source`	תמיד `'wooai_chatbot'`: מזהה את הצ’אטבוט כמקור הייחוס
`timestamp`	חותמת זמן של האירוע בפורמט ISO 8601
`items[]`	מערך המוצרים המלא (אותם שדות כמו items ב-GA4)
`item_count`	כמות כוללת של פריטים
`value`	ערך כספי כולל
הקשר הסשן	מזהה סשן צ’אט, ספירת הודעות, שפה (מצורף לכל אירועי המסחר)

עם פלטפורמת ניהול הסכמה (CMP) מותקנת

WooAI משתלב עם WordPress Consent API. CMP תואמים כוללים את Complianz, CookieYes, Cookiebot וכל תוסף שמיישם את תקן ה-WP Consent API.

אירועי אנליטיקס נשלחים רק לאחר שהמבקר מאשר עוגיות אנליטיקס/סטטיסטיקה.
יש תמיכה ב-GA4 Consent Mode v2: מצב ברירת המחדל שנשלח לפני ההסכמה הוא analytics_storage: denied ו-ad_storage: denied. כשהמבקר מאשר, ה-CMP קורא ל-gtag('consent', 'update', ...) כדי להעניק את הקטגוריות הרלוונטיות.
ה-SDK של Meta Pixel ו-Mixpanel מאותחלים אך אינם שולחים אירועים עד שההסכמה ניתנת.

בלי CMP מותקן

האירועים נשלחים מיד כאשר מזהי הספקים מוגדרים. מצב ברירת המחדל של GA4 Consent Mode v2 הוא analytics_storage: granted.

המלצה לתעבורה מהאיחוד האירופי: התקינו CMP (Complianz חינמי ומתוחזק היטב) כדי לעמוד בדרישות GDPR ו-ePrivacy.

אילו נתונים נשלחים

אין נתונים אישיים: רק מזהי סשן צ’אט אנונימיים, מזהי מוצר וערכים כספיים.
משתמשים מזדהים רק אם הם משתפים מרצונם מידע אישי בצ’אט.
עוגיית המבקר ל-90 יום (waa_visitor_id) נשמרת רק עם הסכמה לאנליטיקס. בלי הסכמה, נעשה שימוש במזהה ארעי לסשן בלבד שלעולם לא נשמר.

עקיפת התנהגות ההסכמה (developer filter)

add_filter( 'woo_ai_chatbot_consent_default', function( $state, $cmp ) {
    // Force denied by default regardless of CMP detection
    return 'denied';
}, 10, 2 );

זרימת הנתונים


User action in chat widget
          |
          v
  trackEvent() central dispatcher
  (analytics/index.ts)
          |
    +-----+--------------------------------------------+
    |                                                  |
    v                                                  v
Internal: POST /woo-ai/v1/analytics/events     External providers (parallel):
          |                                           |-- window.gtag(...)        --> GA4
          v                                           |-- window.fbq(...)         --> Meta Pixel
  waa_events DB table                                +-- window.mixpanel.track() --> Mixpanel
          |
          v
  WP Admin Dashboard
  (Conversations + KPIs)

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

מגבלות ומפת דרכים

חוסמי פרסומות (כ-25-30% ממשתמשי הדסקטופ) חוסמים את ה-SDK החיצוניים. לוח הבקרה הפנימי תמיד פעיל ואינו מושפע. השתמשו בו כמקור האמת למספרים מוחלטים.
ייחוס בצד השרת (GA4 Measurement Protocol, Meta Conversions API): מתוכנן לגרסה v0.40+. כשיהיה זמין, הוא ישחזר כ-30% מהרכישות שחוסמי פרסומות מסתירים כיום מהספקים החיצוניים.
צ’קאאוט בין-דומייני: אם דומיין הצ’קאאוט שלכם שונה מדומיין החנות, המשכיות סשן ב-GA4 דורשת הגדרת linker ידנית. פנו לתמיכה לעזרה.
מטבע ההכנסות: דורש תוסף בגרסה v0.38.17+. גרסאות מוקדמות יותר עלולות לדווח הכנסות ב-USD ללא קשר למטבע החנות.

פתרון בעיות

תסמין	סיבה סבירה	פתרון
לא מופיעים אירועים ב-GA4 DebugView	ה-Measurement ID לא נשמר, או שמתג Debug Mode כבוי	ודאו שהמזהה בפורמט `G-XXXXXXXXXX`. הפעילו את מתג GA4 DebugView בהגדרות התוסף. התקינו את תוסף ה-Chrome “GA Debugger” לאבחון נוסף.
Meta Pixel Helper מציג 0 אירועים	חוסם פרסומות פעיל, או פורמט Pixel ID שגוי	כבו חוסם פרסומות לסשן הבדיקה. Pixel IDs הם 10-16 ספרות ללא אותיות. שמרו מחדש את ההגדרות לאחר תיקון.
Mixpanel Live View ריק	Project Token שגוי, או CMP שחוסם הסכמה	העתיקו את ה-token מ-Mixpanel → Settings → Project Settings. אם CMP מותקן, אשרו עוגיות קודם, כי Mixpanel נשלח רק לאחר שההסכמה לאנליטיקס ניתנת.
הכנסות מוצגות במטבע שגוי ב-GA4	גרסת תוסף מתחת ל-0.38.17	עדכנו את התוסף לגרסה האחרונה.
אירועי Meta Pixel נשלחים פעמיים	גרסת תוסף מתחת ל-0.38.19	עדכנו את התוסף לגרסה האחרונה.
אין אירועי מסחר בכלל	WooCommerce לא פעיל, או שמוצרים לא מוצגים בצ’אט	אירועי מסחר דורשים ש-WooCommerce יהיה פעיל ושכרטיס מוצר יופיע בתשובת הצ’אט. ודאו שכרטיס מוצר מוצג בצ’אט, ואז בדקו בכלי ה-debug של הספק.
אירועים נשלחים לפני הסכמה (חשש GDPR)	אין CMP מותקן; אירועים נשלחים מיד כברירת מחדל	התקינו CMP תואם ל-WordPress Consent API (למשל Complianz). התוסף מזהה אותו אוטומטית ועובר למצב מותנה-הסכמה.

עדיין תקועים? פתחו את WP Admin → WooAI Assistant → Analytics Settings והשתמשו בכפתור בדיקת החיבור המובנה, או בדקו בקונסולת הדפדפן הודעות log של [GA4Tracker], [MetaPixel] ו-[Mixpanel].

קישור ישיר לעמוד ההגדרות: /wp-admin/admin.php?page=woo-ai-chatbot-analytics-settings

מדריך אינטגרציית אנליטיקס של WooAI

סקירה

ספקים נתמכים

הגדרה מהירה

Google Analytics 4

Meta Pixel

Mixpanel

בדיקה שזה עובד

טקסונומיית האירועים המלאה

פרמטרים סטנדרטיים של אירועי מסחר

Google Analytics 4

Meta Pixel

Mixpanel

פרטיות / GDPR / התנהגות הסכמה

עם פלטפורמת ניהול הסכמה (CMP) מותקנת

בלי CMP מותקן

אילו נתונים נשלחים

עקיפת התנהגות ההסכמה (developer filter)

זרימת הנתונים

מגבלות ומפת דרכים

פתרון בעיות