הגדרת קודי QR עבור 1C-Bitrix: הפניות ואנליטיקה
אנו מגדירים קודי QR עבור חנויות מקוונות על 1C-Bitrix כך שהערוץ הלא-מקוון שלכם ייצר מכירות מדידות. תרחיש טיפוסי: הדפסתם 1000 תוויות עם קודי QR, אך כעבור חודש מבנה הקטלוג השתנה—כל הקישורים נשברו.
המהנדסים שלנו פותרים זאת בשלב התכנון על ידי בחירת אסטרטגיית URL נכונה—לפי מק"ט או לפי מזהה מוצר. במהלך שנים רבות יישמנו יותר מ-30 פרויקטים של שילוב קודי QR בקטלוגי מסחר—מחנויות מקוונות קטנות ועד לרשתות עם 50,000 מוצרים.
במאמר זה אנו מפרקים אילו פתרונות טכניים עובדים בפרודקשן, כיצד להימנע מקישורים שבורים, ומדוע מטמון (caching) הוא קריטי עבור אלפי מוצרים. אם אתם זקוקים להגדרה מוכנה, צרו קשר—אנו נעריך את הפרויקט בתוך יום אחד.
עובד מחסן סורק קוד QR על קופסה ומגיע לעמוד המוצר בקטלוג. משווק מדפיס קוד QR על תג מחיר בחנות לא-מקוונת—הלקוח סורק ורואה ביקורות, מפרט וכפתור "קנה". המשימה פשוטה מבחינה טכנית, אך פרטי המימוש קובעים האם המערכת תעבוד ביציבות עם אלפי מוצרים.
איזה URL לבחור עבור קוד ה-QR?
קוד QR הוא URL מקודד. השאלה היא איזה URL לקודד כך שהוא לא יישבר כאשר מבנה הקטלוג משתנה. קישור ישיר למוצר (https://shop.by/catalog/product/artikul-123/) — עובד עד שה-URL SEO משתנה. משנים שם של קטע בקטלוג — כל קודי ה-QR המודפסים נשברים.
הפניה מחדש לפי ID (https://shop.by/qr/1234/) — אמין יותר. נוצר עמוד PHP או מטפל ב-urlrewrite.php אשר, בהתבסס על ה-ID של המוצר, מקבל את ה-URL הנוכחי דרך CIBlockElement::GetByID() ומבצע הפניית 301. קוד ה-QR אינו תלוי במבנה הקטלוג.
הפניה מחדש לפי XML_ID או מק"ט (https://shop.by/qr/?sku=ART-0042) — האפשרות הטובה ביותר עבור אינטגרציה עם 1C, שבה המק"ט הוא המזהה העיקרי. לפי התיעוד של Bitrix, ה-API מאפשר חיפוש אלמנט לפי כל מאפיין. המטפל מחפש את האלמנט לפי המאפיין ARTICLE ומבצע הפניה מחדש.
| סוג הקישור | אמינות | מתי להשתמש |
|---|---|---|
| URL ישיר | נמוכה (נשבר בעת שינוי SEO) | מבצעים זמניים שבהם הקטלוג אינו נערך |
| הפניה מחדש לפי ID | גבוהה (בלתי תלוי ב-SEO) | קודי QR יציבים על מדיה קבועה |
| הפניה מחדש לפי מק"ט | גבוהה מאוד (עמיד בפני העברות) | אינטגרציה עם 1C, עדכונים תכופים של הקטלוג |
כיצד להאיץ יצירת קודי QR?
בשרת, קודי QR נוצרים באמצעות ספריית PHP. שתי אפשרויות עובדות:
- chillerlan/php-qrcode—קומפקטית, ללא תלויות, מייצרת SVG ו-PNG.
- endroid/qr-code—יותר תכונות (לוגו בתוך ה-QR, צבעים), אך כבדה יותר.
התקנה באמצעות Composer: composer require chillerlan/php-qrcode. יצירה ברכיב catalog.element: בקובץ result_modifier.php, הוסיפו קוד שיוצר מחרוזת SVG של ה-QR עבור המוצר הנוכחי. ה-SVG מוטמע בתבנית באמצעות $arResult['QR_CODE_SVG'].
ליצירה בכמות גדולה (הדפסת קטלוג, תוויות), צרו עמוד נפרד /admin/qr-export/ שמייצר PDF עם קודי QR עבור מוצרים נבחרים. הספרייה TCPDF או Dompdf מטפלת במשימה.
מטמון וביצועים
יצירת קוד QR אחד אורכת 5–15 מ"ש. בעמוד קטלוג עם 30 מוצרים, מדובר בעד 450 מ"ש רק עבור קודי QR. הפתרון: ליצור את קוד ה-QR פעם אחת ולשמור אותו כקובץ ב-/upload/qr/{ELEMENT_ID}.svg.
כאשר כתובת ה-URL של המוצר משתנה (אירוע OnAfterIBlockElementUpdate), יש למחוק את הקובץ כך שקובץ חדש ייווצר בבקשה הבאה.
דוגמה לאופטימיזציה: עם קטלוג של 10,000 מוצרים, חיסכון בזמן השרת מגיע עד 80%
ללא מטמון, בכל פעם שנצפית רשימת המוצרים, ייווצרו מחדש 10,000 קודי QR. עם מטמון, הדבר קורה רק בגישה הראשונה או לאחר עדכון מוצר. זה מפחית את העומס על השרת ומאיץ את טעינת העמוד.
פרמטרים של UTM ואנליטיקה
הוסיפו פרמטרים של UTM לכתובת ה-URL שבתוך ה-QR: ?utm_source=qr&utm_medium=offline&utm_campaign=price_tag. זה מאפשר מעקב ב-Yandex.Metrica וב-Google Analytics אחרי מספר ההמרות שמדיה אופליין מייצרת. הפרמטרים לא משפיעים על ההפניה—המטפל פשוט מעביר אותם הלאה.
איך עובדת ההגדרה המלאה?
| שלב | פעולה | תוצאה |
|---|---|---|
| ניתוח | בחינת מבנה הקטלוג והדרישות | בחירת אסטרטגיית URL (מאמר או ID) |
| פיתוח | יצירת מטפל הפניה ומטמון | קודי QR יציבים |
| אינטגרציה | יצירת QR בעמוד המוצר (SVG) + ייצוא PDF מרובה | קבצים מוכנים להדפסה |
| בדיקות | בדיקת הפניות, UTM, ביצועים | פעולה ללא שגיאות |
| פריסה | העלאה לשרת הייצור, תיעוד | תמיכה ל-30 יום |
מה כלול בהגדרת QR מלאה?
ההגדרה המקיפה כוללת:
- ניתוח מבנה ה-URL הנוכחי ובחירת האסטרטגיה האופטימלית (מאמר או ID)
- פיתוח מטפל הפניה עם מטמון
- שילוב יצירת קודי QR בעמוד המוצר (הטמעת SVG)
- הגדרת ייצוא קודי QR מרובה ל-PDF להדפסה על תגי מחיר ותוויות
- הוספת פרמטרי UTM עם אפשרות לשנות קמפיינים ללא הדפסה מחדש של קודי QR
- תיעוד משתמש והוראות למשווקים
- תמיכה חינם למשך 30 יום לאחר ההשקה
הזמינו את הגדרת קוד ה-QR—אנו נחשב את העלות בתוך יום עסקים אחד. קבלו פתרון מוכן עם אחריות לפעולה יציבה לכל גודל קטלוג. צרו קשר לייעוץ.