Инсталация и използване
Стъпка по стъпка за инсталация, обновяване от версия 2.x, настройки и справки на модула Източници на поръчки.
Инсталация на нов магазин
Модулът се инсталира през стандартния Installer на OpenCart. Работи през събитията на OpenCart и не променя файловете на магазина, затова няма модификация за обновяване.
Качете ZIP файла
Отидете в Разширения / Installer (Extensions / Installer) и качете получения файл utm-tracking-v3.0.ocmod.zip. Файловете се копират в магазина.
Инсталирайте модула
В Разширения / Разширения / Модули намерете Източници на поръчки и натиснете зеления бутон Инсталирай. Таблиците, събитията и правата се създават автоматично.
Въведете лиценза
Отворете настройките на модула, въведете лицензния ключ и натиснете Запази. При успех виждате зелен надпис Лицензът е активен. Проследяването работи и без лиценз, справките изискват активен лиценз.
Изчистете кеша
Ако магазинът ползва пълностраничен кеш (OpenCart Lightning, Journal кеш), изчистете го, за да се зареди скриптът на всяка страница. От този момент новите поръчки получават източник.
Обновяване от версия 2.x
Версия 3.0 заменя модификацията на 2.x със събития. Старите данни в поръчките остават и се превеждат към новите правила. На магазините с активни обновявания обновяването правим ние.
Качете новите файлове
През Разширения / Installer качете utm-tracking-v3.0.ocmod.zip. Старите файлове на модула се заменят.
Натиснете "Провери и поправи"
В настройките на модула бутонът създава новите таблици и събития и премахва старата модификация. Лицензът и настройките остават.
Обновете модификациите
В Разширения / Модификации натиснете синия бутон Обнови, за да спре старият код на 2.x. Докато това не е направено, настройките показват предупреждение.
Обработете старите поръчки
Бутонът Обработи старите поръчки в настройките превежда поръчките от версия 2.x към новите канали, така че отчетите за миналите месеци остават. Данните в поръчките не се променят.
Настройки
Разширения / Разширения / Модули / Източници на поръчки
| Настройка | Какво прави |
|---|---|
| Проследяване | Включва и изключва скрипта и записа към поръчките. |
| Колона в списъка с поръчки | Показва източника до всяка поръчка. Избирате първо посещение, последен разпознат или последно посещение. |
| Статуси, които се броят като продажба | Справките броят само поръчки с тези статуси. Празно означава всички поръчки със статус. |
| Съгласие за бисквитки | Записва само след съгласие. Посочвате името на бисквитката на банера и стойността, която означава съгласие. Банерът не се променя. |
| Роботи | Записва заявките на Googlebot, Bingbot, ChatGPT, Perplexity, Claude и другите известни роботи по ден и страница. |
| Пази пътя на посетителите (дни) | Посетител без посещение толкова дни се изтрива. Данните в поръчките остават. |
| Допълнителни източници | Домейни, които модулът още не познава, с категория - търсачка, социална мрежа, каталог, поща, AI асистент. |
| Собствени домейни | Други домейни на магазина, например платежна страница или стар домейн. Преходите от тях не са нов източник. |
Справки
Меню Източници на поръчки в админа. Данните се смятат в магазина и не напускат сървъра.
| Раздел | Какво показва |
|---|---|
| Източници | Поръчки, приход, средна поръчка и нови клиенти по канал, източник или кампания, за период и по ден, седмица, месец или година. Четири правила за това кой източник получава поръчката. Дни до поръчка. CSV. |
| Страници | Продукти, категории, статии и информационни страници с брой поръчки като първа страница, участвала и последна преди количката, с приписан приход. |
| AI асистенти | По асистент - поръчки с участие, приход, първо посещение, последен разпознат източник, страниците, на които асистентите пращат клиентите, и списък с поръчките. |
| Роботи | Заявки по робот и по страница, графика по дни и проверка кои роботи са спрени от robots.txt на магазина. |
| Проверка | Поръчки с пълни и с непълни данни, непознати сайтове, противоречиви етикети, състояние на събитията и настройките. |
Кой източник получава поръчката
- Последният разпознат източник (без директните) - основният отчет за ефективност на рекламата.
- Първото посещение - кои канали водят нови клиенти.
- Последното посещение - включва директните влизания.
- Поравно - поръчката се дели между всички идвания отвън. Поръчките и приходите са дробни.
Как работи проследяването
На всяка страница малък скрипт изпраща към магазина адреса, откъде е дошъл клиентът и рекламните параметри от линка (utm_source, gclid, fbclid, srsltid, msclkid, ttclid и други).
Магазинът разпознава източника по правилата на модула - реклами по параметрите, търсачки, AI асистенти, социални мрежи, каталози и пощи по адреса - и записва посещението към номера на посетителя. В браузъра стои само този номер, в бисквитка без лични данни.
При създаване на поръчката източниците на посетителя се записват към нея, преди плащането. Старите колони в поръчката се пълнят както при версия 2.x, за да работят и другите модули на TEDBG.
Каналите се групират по схемата на Google Analytics 4 - платено търсене, платени социални, Shopping, дисплей, имейл, партньори, AI асистенти, органично търсене, социални мрежи, видео, препратки, директни - плюс каталози, обяви и съобщения.
Граници на данните. Клиент, който изтрие бисквитките, разглежда в частен режим, ползва блокиращо разширение или поръча от друго устройство, може да остане без източник. Посещенията от Google AI Overviews и AI Mode идват със същия адрес като търсенето в Google и остават в органичното търсене. Значенията на параметъра gad_source на Google не са публикувани, затова видът на рекламната мрежа не се определя от него. Заявките на роботите са заявки, не препоръки. Страници, отговорени от кеш преди OpenCart, не се виждат в справката за роботите.
Лиценз, изисквания и поддръжка
Лиценз и изисквания
- +Безсрочен лиценз за 1 домейн, без прехвърляне
- +OpenCart 3.0.2 до 3.0.4, Journal 3 или стандартна тема
- +PHP 7.2 или по-нов
- +MySQL 5.6+ или MariaDB 10+
- +cURL за проверката на лиценза
Поддръжка
- hello@tedbg.com
- tedbg.com/opencart-moduli
- Версия 3.0 от 01.11.2026
Отстраняване на проблеми
Новите поръчки нямат източник
- В настройките на модула проверете дали пише "Модулът е инсталиран и работи". Ако не, натиснете "Провери и поправи".
- Изчистете кеша на магазина (Lightning, Journal), за да се зареди скриптът на всяка страница. В кода на страницата трябва да има tedbgUtmConfig.
- Ако е включено "Записвай само при съгласие", проверете името на бисквитката на банера и стойността за съгласие.
- Разделът "Проверка" в справките показва колко от поръчките за периода са с данни.
Справките са празни или искат лиценз
- Проверете дали лицензът е активен в настройките и дали ключът е за този домейн.
- Проверете периода и статусите, които се броят като продажба.
- След обновяване от 2.x натиснете "Обработи старите поръчки", за да влязат миналите месеци.
- Лицензът се проверява през tedbg.com, затова сървърът трябва да има cURL и достъп навън.
Няма колона в списъка с поръчки или раздел в поръчката
- Проверете дали събитията на модула са на място (настройки, "Състояние на модула") и дали колоната е включена.
- При админ тема, различна от стандартната, колоната може да не се покаже. Разделът в поръчката и справките работят и тогава.
Настройките показват предупреждение за старата модификация
- Отидете в Разширения / Модификации и натиснете синия бутон "Обнови". Старият код на 2.x спира и предупреждението изчезва.