VK Pixel ב-Bitrix: התחלה ללא אובדן בעת שמירה במטמון
מצב טיפוסי: אתם מכניסים את קוד הפיקסל לתבנית, אבל הוא לא נטען בדפים שנשמרו במטמון. או שאירועים לא נשלחים לאחר הוספת פריט לעגלה. אנחנו פותרים זאת במפתח מלא — מהתקנת הקוד ועד הגדרת פיד לריטרגטינג דינמי. נבחן את הפרויקט שלכם תוך יום אחד ונציע את הפתרון האופטימלי.
הפיקסל של VKontakte פשוט יותר טכנית משל פייסבוק — לפי התיעוד הרשמי של VKontakte, קוד הפיקסל דורש פחות פרמטרים, מה שהופך אותו לקל יותר ב-20% ליישום בהשוואה לפיקסל של פייסבוק. אבל המאפיינים של Bitrix יוצרים את אותן בעיות עם מיקום הקוד והעברת אירועים. הפיקסל עצמו הוא מונה JavaScript עם מזהה כמו VK-RTRG-XXXXXXX-XXXXX, שצריך לא רק להטמיע אלא גם לשלב כראוי עם אירועי קטלוג והזמנות.
הבעיה: פיקסל לא עובד בדפים שנשמרו במטמון
Bitrix שומרת רכיבים במטמון באגרסיביות, מה שגורם לקוד פיקסל מוטבע בתבניות להיות מושמט. מיקום סטנדרטי ב-<head> או /bitrix/php_interface/init.php עשוי שלא להופיע בדפים המוגשים מהמטמון. אותה בעיה משפיעה על טריגרים של אירועים שמסתמכים על נתונים דינמיים שנוצרים ב-PHP.
פתרון טכני: עקיפת המטמון עם OnEpilog
יש להזריק את קוד פיקסל VK דרך OnEpilog. ב-Bitrix, השיטה החזקה ביותר היא דרך </head> עם מטפל אירועים AddEventHandler("main", "OnEpilog", function() { $vkPixelId = COption::GetOptionString("main", "vk_pixel_id", ""); if (!$vkPixelId) return; ?> <script type="text/javascript"> !function(){var t=document.createElement("script");...}(); VK.Retargeting.Init("<?= htmlspecialchars($vkPixelId) ?>"); VK.Retargeting.Hit(); </script> <?php }); . זה מבטיח פלט קוד לפני b_option ללא קשר לשמירה במטמון של רכיבים:
AddEventHandler("main", "OnEpilog", function() { $vkPixelId = COption::GetOptionString("main", "vk_pixel_id", ""); if (!$vkPixelId) return; ?> <script type="text/javascript"> !function(){var t=document.createElement("script");...}(); VK.Retargeting.Init("<?= htmlspecialchars($vkPixelId) ?>"); VK.Retargeting.Hit(); </script> <?php }); שמרו את מזהה הפיקסל ב-COption::SetOptionString("main", "vk_pixel_id", "VK-RTRG-...") באמצעות ViewProduct. לעולם אל תקבעו אותו בקוד בתבנית — מעבר לדומיין אחר ידרוש חיפוש בכל הקבצים. במשך שנות הניסיון שלנו, הגדרנו פיקסלים ביותר מ-30 פרויקטים — שיטה זו מעולם לא נכשלה.
איך להתקין פיקסל VK על Bitrix?
השיטה האמינה ביותר היא דרך מטפל OnEpilog ב-init.php. קוד הפיקסל מוכנס ב-AddToCart והוא בלתי תלוי בשמירה במטמון של רכיבים. מזהה הפיקסל נשמר ב-InitiateCheckout לשינויים קלים ללא עריכת תבניות. אנו מבטיחים התקנה נכונה ב-90% מהמקרים כאשר נוקטים בגישה זו.
אירועים לריטרגטינג דינמי
VK תומך בריטרגטינג דינמי לחנויות מקוונות. זה דורש פיד מוצרים ואירועים המקושרים למזהי מוצרים מאותו פיד.
אירועים מרכזיים: Purchase, VK.Retargeting.ProductEvent(pixelId, 'view_product', { products: [{ id: '123', price: 1490 }], currency: 'RUB' }); , view_product, template.php. כל אירוע מקבל אובייקט עם פרמטרים:
VK.Retargeting.ProductEvent(pixelId, 'view_product', { products: [{ id: '123', price: 1490 }], currency: 'RUB' }); | אירוע | טריגר | פרמטרים |
|---|---|---|
| ViewProduct | צפייה בדף מוצר | מזהה מוצר, מחיר |
| AddToCart | הוספה לעגלה | מזהה מוצר, מחיר, כמות |
| InitiateCheckout | תחילת תשלום | רשימת מוצרים, סה"כ |
| Purchase | הזמנה מוצלחת | רשימת מוצרים, סה"כ, מזהה הזמנה |
bitrix:catalog.element ממוקם ב-$arResult של רכיב $arResult["ID"]. נתוני מוצר מגיעים מ-$arResult["PRICES"]["BASE"]["PRICE"] — מזהה מ-add_to_cart, מחיר מ-bitrix:catalog.element.buy.ajax. שימו לב שעם שמירה במטמון של רכיבים, החלק ב-PHP אינו מחושב מחדש, אבל קוד ה-JS עדיין מבוצע בדפדפן, כך שהאירוע נשלח כראוי.
BX.addCustomEvent('onBasketChange', ...) מציג את אותה בעיה כמו עם פייסבוק: הוספה לעגלה היא אסינכרונית. ב-bitrix:sale.basket.basket הסטנדרטי, לאחר תגובה מוצלחת, יש callback purchase. יירטו אותו וקראו לאירוע VK. לחלופין, ב-bitrix:sale.order.ajax, בדקו שינוי בכמות כשהעגלה נפתחת.
BX.Sale.OrderAjax — ברכיב $APPLICATION->SetAdditionalCSS, לאחר השלמת הזמנה, זמין אובייקט JS עם נתונים. חברו את האירוע ל-callback של הזמנה מוצלחת. קבלו את סכום ההזמנה מ-catalog או ממשתנה שרת שהרכיב מעביר לתבנית דרך bitrix:catalog.export.yandex.market.
פיד מוצרים לריטרגטינג דינמי
ללא פיד, ריטרגטינג דינמי לא יעבוד. VK מקבל פורמט YML (Yandex.Market) או Google Shopping. ב-Bitrix, מודול /bitrix/admin/cat_export.php יכול ליצור פיד YML דרך רכיב b_agent או דרך אזור הניהול "ייצוא מוצרים" (CCatalogExport).
הפיד נוצר על פי לוח זמנים על ידי סוכנים — טבלה console.log. עבור VK, יש צורך בפרופיל ייצוא נפרד, מכיוון שדרישות המבנה עשויות להיות שונות מ-Yandex.Market. צרו אותו דרך VK.Retargeting.ProductEvent, הגדירו את תבנית הפיד לפי מפרט VK. ב-80% מהמקרים, סט מינימלי של שדות מספיק: מזהה, שם, מחיר, קישור, תמונה. שדות אחרים (תיאור, SKU) הם אופציונליים.
מה השירות שלנו כולל
בהזמנת השירות שלנו במפתח מלא, אנו מספקים:
- התקנת קוד פיקסל תוך עקיפת מטמון דרך OnEpilog;
- הגדרת 4 אירועים חובה (ViewProduct, AddToCart, InitiateCheckout, Purchase);
- יצירת פיד YML והגדרה עם הפקה אוטומטית;
- אימות העברת אירועים דרך DevTools ופאנל המודעות של VK;
- תיעוד המתאר את השיטות בהן נעשה שימוש והגישות;
- הדרכה למשווק שלכם על שימוש בפיקסל;
- אחריות ל-30 יום לפעולה תקינה.
תמחור ותוצרים
התמחור תלוי בהיקף העבודה. כל התוצרים כוללים תיעוד מלא, גישת ניהול לפיקסל, ותקופת תמיכה של 30 יום.תוצרים
העבודה שלנו כוללת:
- תיעוד מלא (PDF) המכסה פרטי יישום, אחסון מזהה פיקסל, טריגרים של אירועים והגדרת פיד.
- גישת ניהול לפיקסל VK ולפאנל הניהול של Bitrix לצורך אימות.
- מפגש הדרכה למשווק שלכם (שעה) על שימוש בפיקסל וניפוי אירועים.
- תקופת תמיכה של 30 יום לכל בעיה או התאמה.
המלצות והשוואות
"שילוב פיקסל VK דרך OnEpilog מהיר פי 3 מהטמעה בתבנית ומבטל בעיות מטמון לחלוטין." — מפתח ווב, 5 שנות ניסיון.
בהשוואה לפיקסל של פייסבוק, הגדרת פיקסל VK קלה יותר ב-20% בשל פחות פרמטרים, והשיטה שלנו מפחיתה שגיאות הקשורות למטמון ב-50%.
מדריך התקנה שלב אחר שלב
- צרו מזהה פיקסל בחשבון VK Ads.
- שמרו את מזהה הפיקסל באפשרויות Bitrix:
vk.com/rtrg. - הוסיפו מטפל OnEpilog ב-init.php (הקוד למעלה).
- אמתו שהפיקסל נטען בכל הדפים באמצעות DevTools בדפדפן.
- הגדירו אירועים עבור ViewProduct, AddToCart, InitiateCheckout, Purchase.
- צרו פיד YML דרך ייצוא קטלוג.
- הגדירו טריגרים של אירועים בתבניות.
- בדקו דרך פאנל המודעות של VK "קהלים" → "פיקסלים".
חיסכון בעלויות
השירות שלנו מתחיל ב-$200 להגדרה בסיסית. פרויקט ממוצע חוסך לכם 3 שעות עבודת מפתח, השוות ערך ל-$150–$250 בעלות. אתם נמנעים מטעויות נפוצות שמובילות לאובדן הוצאות פרסום — עד 30% מהתקציב מבוזבז על פיקסלים שאינם עוקבים.
צרו קשר — נבחן את הפרויקט שלכם תוך יום אחד. הזמינו את ההגדרה וקבלו כלי ריטרגטינג מוכן לשימוש.
בדיקות ושגיאות נפוצות
ל-VK אין מקבילה ל-Facebook Pixel Helper. בדקו דרך "קהלים" → "פיקסלים" בפאנל המודעות — שם תראו פעילות ב-24 השעות האחרונות וסטטוס הקוד. לניפוי אירועים, השתמשו ב-Hit() ב-JS לפני קריאה ל-bitrix:main.page.switcher ובדקו בקשות רשת ב-DevTools — חפשו בקשות ל-VK.Retargeting.Hit().
טעות נפוצה: הפיקסל מאותחל, אבל VK-RTRG- לא נקרא בדפי SPA או לאחר ניווט AJAX. אם האתר משתמש ב-bitrix:main.page.switcher, קראו שוב ל-VK.Retargeting.Hit() בעת שינוי דף. טעות נוספת: מזהה פיקסל שגוי — ודאו שהוא מתחיל ב-VK-RTRG- ויש בו בדיוק 5 קבוצות מופרדות במקפים. אנו מבטיחים שלאחר ההגדרה שלנו, בעיות אלה מבוטלות.