בדיקת פיקסלים מותאמים אישית
לאחר יצירת פיקסל מותאם אישית, תצטרך לבדוק אותו כדי לוודא שהוא שולח נתונים כהלכה כאשר אירועים מתרחשים באתר שלך.
תוכל להשתמש ב-Shopify Pixel Helper כדי לבדוק אם אירועי הפיקסל שלך נטענים ושהרשמתך לאירועי Shopify בוצעה כראוי. ה-Shopify Pixel Helper מאפשר לך לבדוק את הפיקסל המותאם אישית בחנות המקוונת שלך כדי לצפות באירועים המתקבלים בזמן אמת, לצד הנתונים עבור אירועים אלה.
אם הפיקסל המותאם אישית שלך משולב עם פלטפורמה של צד שלישי שיש לה כלי עזר משלה לפיקסלים, תוכל להשתמש בכלי העזר לפיקסלים של הצד השלישי בנוסף ל-Shopify Pixel Helper כדי לבדוק אם אירועי הפיקסל שלך מעובדים ומתקבלים על ידי הפלטפורמה של הצד השלישי. לדוגמה, אם אתה מוסיף פיקסל מותאם אישית של TikTok לחנות שלך, תוכל להשתמש גם ב-Shopify Pixel Helper וגם ב-TikTok Pixel Helper כדי לבדוק את הפיקסל שלך.
ניתן להשתמש ב-Shopify Pixel Helper באותו סשן דפדפן שבו פועל כלי עזר לפיקסלים של צד שלישי כדי לבדוק אירועים עבור שתי הפלטפורמות בו-זמנית.
לפניך סקריפט לפיקסל מותאם אישית שיפעיל את כל האירועים הסטנדרטיים לסביבת ה-sandbox ויתעד את נתוני האירוע ב-console. האירועים הסטנדרטיים יהיו גלויים ב-Shopify Pixel Helper. בנוסף, תוכל להירשם למינויים גורפים אחרים, all_events, all_custom_events ו-all_dom_events, כדי לגלות את כל מה ש-web pixels יכולים לספק. לקבלת מידע נוסף, יש לבקר ב-web pixels API.
analytics.subscribe("all_standard_events", event => {
console.log("Event data ", event?.data);
});בדף זה
וידוא שפיקסל מותאם אישית מחובר
לפני שתבדוק את הפיקסל המותאם אישית שלך, ודא שהפיקסל המותאם אישית מחובר.
שלבים:
מלוח המנהל של Shopify, יש לעבור אל הגדרות > אירועי לקוח.
לצד הפיקסל שברצונך לבדוק, ודא שמוצג עבורו סטטוס מחובר בעמודה סטטוס.
אם הפיקסל לא מחובר, יש לבצע את הפעולות הבאות:
- יש ללחוץ על
> הצגת פרטים.
- אופציונלי: יש לעיין בקוד של הפיקסל ולעדכן אותו, ולאחר מכן ללחוץ על שמירה.
- יש ללחוץ על חיבור.
- בתיבת דו-שיח האישור, יש ללחוץ על חיבור.
- יש ללחוץ על
בדיקת פיקסל מותאם אישית באמצעות Shopify Pixel Helper
לאחר שמוודאים שפיקסל המותאם אישית שלך מחובר, ניתן להשתמש ב-Shopify Pixel Helper כדי לבדוק אם הוא שולח נתונים ומקבל את נתוני החנות שלך.
כדאי לעיין בשיקולים הבאים לפני השימוש ב-Shopify Pixel Helper:
- באמצעות Shopify Pixel Helper, ניתן לבדוק רק פיקסל מותאם אישית אחד בכל פעם.
- לא ניתן לבצע שינויים בפיקסל שנבדק כאשר Shopify Pixel Helper פועל. כדי לבדוק שינויים חדשים, יש לשמור את הפיקסל, לסגור את הכרטיסייה של Shopify Pixel Helper, ולאחר מכן לפתוח שוב את Shopify Pixel Helper.
- יומני אירועים נמחקים בעת ניווט לדף חדש. לדוגמה, אם הוספת מוצר לסל ו-Shopify Pixel Helper רושם את האירוע
product_added_to_cart, אז רישום היומן הזה נמחק בעת ניווט לדף מוצר חדש או לדף הסל. - ל-Shopify Pixel Helper אין לחצן סגירה. כדי להפסיק את הבדיקה, יש לסגור את הכרטיסייה ש-Shopify Pixel Helper פתח.
- Shopify Pixel Helper אינו תואם לחנויות מסחר headless או לחנויות המוגנות בסיסמה.
- אם החנות המקוונת שלך מוגנת בסיסמה, כדאי לשקול להסיר את סיסמת החנות המקוונת שלך כדי להשתמש ב-Shopify Pixel Helper.
שלבים:
מלוח המנהל של Shopify, יש לעבור אל הגדרות > אירועי לקוח.
לחץ על הפיקסל המותאם אישית שברצונך לבדוק.
לחץ על בדיקה כדי לפתוח את הפיקסל המותאם אישית באתר האינטרנט שלך לבדיקה.
אופציונלי: בהתאם להגדרות ההסכמה של החנות שלך ול-הגדרות פרטיות לקוחות של הפיקסל המותאם אישית, תיבת הדו-שיח Pixel helper עשויה להציג את ההודעה הפיקסל ממתין להסכמה. יש לבצע אחת מהפעולות הבאות כדי להמשיך בבדיקה:
- אשר את המעקב בבאנר של קובצי cookie או בהעדפות של החנות שלך.
- לחץ על תן הסכמה כדי להמשיך בבדיקה.
- אם הפיקסל עדיין לא נטען, בדוק את הגדרות פרטיות לקוחות שלך.
כדי להציג אילו אירועים נטענים, בקר בכל דף שעבורו ברצונך לבדוק את הפיקסל, ובדוק בתיבת הדו-שיח Pixel helper כדי לוודא שהרישום לאירוע בוצע בהצלחה ופונקציית הקריאה החוזרת (callback) הצליחה במקטע אירועים שהתקבלו:
- עבור אל דף חדש כדי לבדוק את האירוע page_viewed.
- לחץ על מוצר כדי לבדוק את האירוע product_viewed.
- הוסף מוצר לסל כדי לבדוק את האירוע product_added_to_cart.
- עבור לעמוד התשלום שלך כדי לבדוק את האירוע checkout_started.
- הזן את פרטי השילוח בתשלום כדי לבדוק שהאירוע checkout_shipping_info_submitted מחליף את האירוע checkout_started.
- השלם את התשלום כדי לבדוק שהאירוע checkout_completed מחליף את האירוע checkout_shipping_info_submitted. למידע נוסף על ביצוע הזמנת ניסיון.
כדי להציג את נתוני האירוע שהתקבלו, לחץ על
כדי להרחיב את תיבת הדו-שיח Pixel helper.
צפייה במקטע 'אירועים שהתקבלו'
בעת בדיקת האירועים הנטענים בשלב 5, אחד מהסטטוסים הבאים יוצג במקטע אירועים שהתקבלו בתיבת הדו-שיח Pixel helper:
- נקודה ירוקה מציינת שהרישום לאירוע בוצע בהצלחה ופונקציית הקריאה החוזרת (callback) הסתיימה בהצלחה.
- נקודה אדומה מציינת שהרישום לאירוע בוצע בהצלחה, אך פונקציית הקריאה החוזרת נכשלה. למד כיצד לפתור בעיות בפיקסל המותאם אישית שלך.
- ה-Pixel helper מציג שגיאות שלא טופלו (uncaught errors) המתרחשות ברמה העליונה (top level) או בפונקציית הקריאה החוזרת. שגיאות ברמה העליונה מוצגות בעת טעינת ה-Pixel helper. הודעות שגיאה של קריאה חוזרת מוצגות בעת לחיצה להרחבת אירוע עם נקודה אדומה.
- דוגמת הקוד הבאה מכילה שגיאת קריאה חוזרת ושגיאה ברמה העליונה. בהתאם למיקום השגיאה ברמה העליונה, ייתכן שהפיקסל יתפקד באופן חלקי.
analytics.subscribe("all_standard_events", event => {
console.log("Event data ", event?.data);
throw new Error("callback error");
});
throw new Error("top level error")למידע נוסף על תיקון שגיאות ב-JavaScript, בקר ב-פתרון בעיות ב-JavaScript.
פתרון בעיות בפיקסל המותאם אישית שלך
אם הפיקסל שלך לא נטען או לא מופעל במהלך הבדיקה, וכבר בדקת את נתוני האירוע ואת קוד הפיקסל לאיתור שגיאות, נסה את האמצעים הבאים לפתרון בעיות.
בדיקת הגדרות פרטיות לקוחות
אם הפיקסל שלך לא נטען או לא מופעל במהלך הבדיקה, ייתכן שקיימות הגדרות פרטיות לקוחות שמונעות את טעינתו.
ממנהל Shopify שלך, עבור אל הגדרות > פרטיות הלקוח כדי לבדוק אם קיימות הגדרות פרטיות לקוחות במנהל Shopify שעשויות לחול על הסשן שלך. בהתאם להגדרות פרטיות לקוחות שלך, בצע את השלבים הבאים:
- אם יש לך הגדרות פרטיות לקוחות הדורשות הסכמה באזור שלך, ודא שסיפקת הסכמה באמצעות הבאנר של קובצי cookie שלך.
- אם אין לך הגדרות פרטיות לקוחות שחוסמות את טעינת הפיקסל, נקה את קובצי ה-cookie בדפדפן שלך כדי לאפס את הבאנר של קובצי cookie ולספק הסכמה.
- אם אתה משתמש בכלי של צד שלישי לניהול הסכמות, כגון אפליקציית באנר של קובצי cookie, על הכלי הזה לסנכרן את ההסכמה מול Shopify דרך Customer Privacy API. אם ההסכמה לא מסונכרנת מול Shopify, ייתכן שהפיקסל שלך לא יופעל אפילו לאחר שלקוח יספק הסכמה. יש לפנות אל ספק הצד השלישי שלך כדי לוודא שהסכמות מסונכרנות מול Shopify, או לקבלת תמיכה נוספת.
אמצעים נוספים לפתרון בעיות
אם עדיין לא ברור האם הפיקסל המותאם אישית שלך רשום כראוי לאירוע לקוח, נסה את האמצעים הבאים לפתרון בעיות:
- נקה את קובצי ה-cookie של הדפדפן שלך.
- אם אתה בודק אירוע רגיל, עיין בתיעוד המפתחים של תיאורי אירועים רגילים ב-Shopify כדי לוודא שאתה מבצע את השלבים הדרושים כדי להפעיל את האירוע.
אם הבחנת בהבדלים במספר האירועים שבמעקב לאחר העברה מהגדרת פיקסל ישנה יותר, יש לעיין בסעיף פתרון בעיות לאחר העברה.
בדיקה עם מסייע פיקסלים (Pixel helper) של צד שלישי
SDK (ערכת פיתוח תוכנה) של פיקסל מכילה את הכלים המאפשרים לפיקסל שלך לאסוף מידע על התנהגות לקוחות. באפשרותך להשתמש ב-Pixel helper של ספק הפיקסל מצד שלישי שלך כדי לבדוק את הפעולות הבאות של הפיקסל ולוודא שה-SDK של הפיקסל פועל כמצופה:
בדיקה אם נטען SDK של פיקסל מצד שלישי
השלבים לבדיקת כרטיסיית הרשת תלויים בדפדפן האינטרנט שבו אתה משתמש. לדוגמה, כדי ללמוד כיצד לבדוק את כרטיסיית הרשת שלך ב-Google Chrome, עיין בתיעוד של בדיקת פעילות רשת (Inspect network activity) ב-Chrome for Developers.
כדי לבדוק אם נטען SDK של פיקסל מצד שלישי, תחילה עליך לאחזר את הקוד של ספק הצד השלישי שלך עבור כתובת ה-URL של ה-SDK כדי שתוכל להוסיף אותו לקוד הפיקסל שלך. לקבלת תמיכה, צור קשר עם ספק הפיקסל מצד שלישי שלך.
שלבים:
מלוח המנהל של Shopify, יש לעבור אל הגדרות > אירועי לקוח.
לחץ על הפיקסל המותאם אישית שברצונך לבדוק.
במקטע קוד, הזן את ה-SDK של הפיקסל שסופק על-ידי ספק הצד השלישי שלך בסוף קוד הפיקסל.
לחץ על שמירה.
בקר בחנות המקוונת שלך, ולאחר מכן בדוק את כרטיסיית הרשת שלך כדי לוודא שכתובת ה-URL של ה-SDK של ספק הצד השלישי נטענת.
אופציונלי: אם ה-SDK של הפיקסל מצד שלישי אינו נטען, בדוק אם קיימות שגיאות זמן ריצה (runtime) של JavaScript בארגז החול (sandbox). לדוגמה, ב-Chrome ניתן לבחור iFrame ספציפי כדי לבדוק את יומני ה-console עבורו, ולאחר מכן למקד את היומנים לפיקסל הספציפי שאותו אתה בודק. למידע נוסף על בדיקת שגיאות זמן ריצה של JavaScript ב-Chrome, עיין בתיעוד ניפוי שגיאות ב-JavaScript של Chrome.
אם ה-SDK של הפיקסל מצד שלישי לא נטען במהלך הבדיקה, פנה לספק הפיקסל מצד שלישי שלך לקבלת תמיכה.
בדיקות נוספות ל-SDK של פיקסלים מצד שלישי
כדי לבדוק אם SDK של פיקסל מצד שלישי מאותחל או אוסף אירועים, עיין בתיעוד של ספק הפיקסל מצד שלישי שלך.
כדי לבדוק אם SDK של פיקסל אוסף אירועים, ייתכן שתתבקש לבדוק את כרטיסיית הרשת של הדפדפן שלך. השלבים לבדיקת כרטיסיית הרשת תלויים בדפדפן האינטרנט שבו אתה משתמש. לדוגמה, כדי ללמוד כיצד לבדוק את כרטיסיית הרשת בדפדפן Google Chrome, עיין בתיעוד של בדיקת פעילות רשת (Inspect network activity) ב-Chrome for Developers.