контакти

Triple Whale за OpenCart: как изградихме пълна интеграция с pixel tracking, API sync и monitoring

Ако използвате OpenCart и искате реална интеграция с Triple Whale, обикновеният pixel snippet рядко е достатъчен. За да виждате коректно потребители, сесии, add to cart, checkout събития, покупки, продукти, поръчки и клиенти, е нужна по-дълбока разработка, която обхваща и storefront tracking, и server-side sync.

Точно това реализирахме в тази разработка: разширен Triple Whale модул за OpenCart, който комбинира:

  • pixel tracking за storefront
  • tracking на customer journey
  • contact capture от различни форми
  • add-to-cart и checkout събития
  • purchase tracking
  • sync на продукти, поръчки и клиенти към Triple Whale API
  • monitoring панел в администрацията
  • вътрешен dashboard с ключови метрики
  • health checks и sync history

Защо стандартният подход не е достатъчен

При custom OpenCart инсталации Triple Whale често вижда само част от данните:

  • page load и basic web analytics
  • частични add-to-cart събития
  • липсващи или непълни purchases
  • липсващи Orders API и Products API данни
  • неточни conversion metrics
  • липса на контрол върху това какво точно се изпраща

Това води до проблеми като:

  • Orders API: Not Installed
  • Products API: Not Installed
  • conversion rate = 0.00%
  • orders и revenue не се разпознават коректно
  • ограничена видимост върху реалното поведение на потребителите

Какво включва разработката

1. Pixel интеграция за OpenCart storefront

Модулът инжектира Triple Whale snippet глобално и поддържа конфигурация на:

  • TripleName
  • platform
  • snippet version
  • debug режим
  • consent gate

Това осигурява стабилна базова интеграция за всички storefront страници.

2. Tracking на реалния customer journey

Имплементирахме проследяване на ключовите действия в магазина:

  • page load
  • product view
  • category view
  • search
  • add to cart
  • cart view
  • checkout start
  • payment step
  • purchase

Така Triple Whale получава не само трафик, а реална последователност от потребителски действия.

3. Contact tracking от различни типове форми

Един от по-важните елементи беше проследяването на контактни форми и lead форми, включително:

  • стандартна contact page форма
  • fast order popup на продуктова страница
  • Journal 3 / custom form конфигурации
  • форми с едно поле за име
  • форми с отделни полета за име и фамилия

Логиката вече поддържа:

  • ако има само едно поле за име, то се подава като firstName
  • ако има пълно име с интервал, системата разделя на firstName и lastName
  • телефонът и email адресът се разпознават и подават коректно

4. Purchase tracking

За OpenCart това е критична част, защото покупката често не се отчита надеждно само с frontend pixel.

Решението включва:

  • засичане на checkout/success
  • работа с custom checkout flow
  • извличане на order_id
  • подаване на purchase payload с order данни
  • защита от дублиране при reload/повторно отваряне

5. Products API, Orders API и Customers API sync

За да бъде Triple Whale наистина полезен, не е достатъчен само pixel tracking. Затова добавихме и server-side sync към Triple Whale Data-In API:

  • Products sync
  • Orders sync
  • Customers sync

Това позволява:

  • Triple Whale да разпознава продуктите в системата
  • Orders API да бъде реално активен
  • purchases да се свързват по-надеждно с order данните
  • dashboard метриките да станат по-пълни

Допълнителни екстри в модула

Monitoring панел в администрацията

Изградихме вътрешен monitoring панел с:

  • филтър по събитие
  • филтър по route
  • филтър по status
  • търсене по текст
  • избор на брой редове
  • summary блокове
  • sync history
  • duplicate/error видимост

Това дава реален operational контрол върху интеграцията.

API Tools

В модула има отделна секция с инструменти за работа с Triple Whale API:

  • Validate API Key
  • Sync Products
  • Sync Orders
  • Sync Customers
  • Clear Sync State

Добавени са и полезни филтри:

  • limit
  • force resync
  • only failed
  • order ID
  • date from / date to
  • order status
  • product ID
  • customer ID

Sync state и idempotent логика

За да не се изпращат едни и същи записи без нужда, добавихме:

  • sync table в базата
  • payload hash проверка
  • skip на непроменени записи
  • force resync при нужда
  • retry на failed записи

Вътрешен dashboard

Създадохме и вътрешен dashboard в администрацията, който показва ключови карти и health индикатори за интеграцията:

  • sessions
  • users
  • product views
  • add to carts
  • checkout starts
  • purchases
  • synced products
  • synced orders
  • synced customers
  • sync health

Health checks

За по-бърза диагностика модулът следи и readiness/status показатели като:

  • Pixel status
  • Products API status
  • Orders API status
  • last successful sync
  • last purchase event

Какви са ползите за един OpenCart магазин

Тази разработка дава много повече от стандартен tracking snippet.

По-добра видимост върху потребителското поведение

Виждате не само трафика, а как хората:

  • разглеждат продукти
  • добавят в количка
  • започват checkout
  • подават контактни данни
  • финализират поръчка

По-добри данни в Triple Whale

Когато Products API, Orders API и Customers API работят коректно, Triple Whale може да използва много по-точна база данни за:

  • store metrics
  • web analytics
  • attribution
  • conversion calculations

По-лесна поддръжка

С monitoring, sync history и API tools проблемите се локализират много по-бързо.

Гъвкавост за бъдещи клиенти

Модулът вече е подготвен да бъде разширяван с допълнителни switches и настройки според конкретния магазин.

За кого е подходящ такъв модул

Тази интеграция е особено подходяща за:

  • OpenCart магазини с по-сериозен трафик
  • магазини, които искат по-добра аналитика
  • eCommerce брандове, работещи с Triple Whale
  • проекти с custom checkout или custom forms
  • магазини, които искат backend sync, а не само frontend pixel

Какво можем да добавим допълнително

В зависимост от нуждите можем да надградим с:

  • още tracking switches
  • DB-backed event storage
  • export на monitoring logs
  • по-богат dashboard
  • SQL/Data-Out интеграции към Triple Whale
  • auto-sync logic при specific order statuses
  • още custom journey събития
  • разширен attribution capture за campaign parameters

Ако искате същата интеграция за ваш OpenCart магазин

Ако използвате OpenCart и искате Triple Whale интеграция, която не е само “поставен snippet”, а реално завършено решение с:

  • tracking
  • API sync
  • monitoring
  • health checks
  • dashboard
  • гъвкава конфигурация

пишете ни.

За запитване, разработка или адаптация за ваш проект, изпратете email на: smart@itech.bg