Příručka pro vývojáře GT BOGO Engine pro WooCommerce

Pokud jste vývojář WooCommerce a hodnotíte GT BOGO Engine pro klientskou práci nebo pro svůj vlastní obchod, tato příručka pro vývojáře vás provede architektonickými rozhodnutími, která jsou důležitá pro produkční nasazení. Platforma je prvním celosvětově podnikovým automatizačním systémem Buy X Get Y vytvořeným speciálně pro WooCommerce, se 47 superschopnostmi, 200 předpřipravenými balíčky kampaní v 19 odvětvích a rozšiřujícím povrchem pro vývojáře, který podporuje čisté přizpůsobení bez fork nebo opičích záplat. Propagační logika běží na straně košíku spíše než prostřednictvím kuponové mechaniky, inteligence zákazníků běží kontinuálně, nikoli prostřednictvím manuální segmentace, a architektonické volby ovlivňují vše navazující – od způsobu implementace vlastních pravidel přes integraci platformy s bezhlavým nastavením až po fungování testovacích a pracovních postupů.

Tento příspěvek je pro vývojáře, kteří chtějí mít komplexní technickou orientaci na GT BOGO Engine, než se zaváží ke standardizaci platformy. Projdeme si základní architekturu, povrch rozšíření pro vývojáře, vzory integrace pro běžné nástroje ekosystému WooCommerce a provozní úvahy pro produkční nasazení. Cílem je poskytnout dostatek technických podrobností, aby vývojáři mohli přijímat informovaná rozhodnutí o hodnocení, aniž by se museli ponořit do vnitřních částí pluginu.

Základní architektura: Pravidla na straně košíku vs slevy založené na kupónech

Architektonický základ GT BOGO Engine spočívá v tom, že propagační logika běží na vrstvě výpočtu košíku spíše než prostřednictvím vyplácení kuponů. Když košík zákazníka odpovídá podmínkám nakonfigurovaného pravidla, platforma uplatní slevu jako jasně označenou řádkovou položku košíku – není vyžadován žádný kód kuponu, na stránce pokladny se neobjeví žádné pole kuponu a žádné kódy se neodesílají na weby agregátorů. Architektura na straně košíku eliminuje celou třídu provozních problémů souvisejících s kupóny, které vytvářejí tradiční propagační pluginy.

Architektura na straně vozíku má tři architektonické důsledky, kterým by vývojáři měli rozumět. Za prvé, logika slev platformy se spustí během výpočtových háků WooCommerce košíku, což znamená, že se integruje se standardním WooCommerce košíkem a tokem pokladny, aniž by jej vyměňovala. Vlastní přizpůsobení pokladny, vlastní integrace plateb a vlastní logika dopravy všechny nadále fungují, protože logika platformy je pod vrstvou pokladny. Za druhé, výpočet slevy je deterministický vzhledem k obsahu košíku a stavu zákazníka — stejný košík se stejným zákazníkem ve stejnou dobu produkuje stejnou slevu, což zjednodušuje ladění a testování.

Zatřetí, architektura na straně košíku znamená, že logika propagace nezávisí na tabulkách databáze kuponů, generování kódu kuponu nebo pracovních postupech ověřování kuponů. Schéma databáze pluginu je nezávislé na schématu kuponů WooCommerce, což znamená, že propagační pravidla se mohou rozšiřovat nad limity, které systémy založené na kuponech zasahují při vysokém objemu transakcí. Další informace o architektonických kompromisech najdete v článku proč kódy kupónů zabíjejí prodej WooCommerce.

Plocha rozšíření pro vývojáře

Platforma odkrývá prodlužovací povrch postavený na standardních vzorech háčků WordPress. Registrujte podmínky vlastních pravidel prostřednictvím zdokumentovaných háčků filtrů. Akce vlastních pravidel se registrují prostřednictvím zdokumentovaných háčků filtrů. Rozšíření zákaznické inteligence se zapojují do segmentace. Přizpůsobení e-mailu životního cyklu se zapojuje do kanálu vykreslování e-mailů. Rozšiřující povrch založený na háku znamená, že vývojáři mohou rozšířit platformu bez rozvětvení kódové základny nebo vnitřních záplatování opice.

Údaje o opuštění košíku z Baymard Institute, založené na 50 samostatných studiích opuštění košíku, udávají celosvětový průměr 70,22 %. Plocha rozšíření platformy umožňuje vývojářům řešit vzorce opouštění košíku specifické pro klienta prostřednictvím vlastní logiky, aniž by opustili vestavěné možnosti obnovení košíku platformy. Vlastní podmínka může upřesnit, když se spustí e-maily pro obnovení opuštění; vlastní akce může použít přizpůsobení specifické pro klienta na zasílání zpráv pro obnovu; vlastní pravidlo segmentace může identifikovat vzorce opuštění specifické pro zákaznickou základnu klienta.

Plocha rozšíření se řídí třemi architektonickými principy, které jsou důležité pro produkční kód. Za prvé, háčky jsou zdokumentované a stabilní – zpětně kompatibilní změny se dějí volně a zpětně nekompatibilní změny se dějí při přechodech hlavních verzí s dokumentovanými cestami migrace. Za druhé, hákové callables přijímají strukturované kontextové objekty spíše než surová pole, což znamená, že vlastní kód je typově bezpečný a přežije interní refaktoring. Zatřetí, povrch rozšíření lze testovat izolovaně prostřednictvím zdokumentovaných objektů simulovaného kontextu, což znamená, že vlastní kód lze testovat na jednotku, aniž by bylo nutné provést úplné integrační testy WordPress. Další informace o testovacích vzorech naleznete v části developer WooCommerce testovací staging.

Vrstva Customer Intelligence Layer

Vrstva inteligence zákazníků běží nepřetržitě napříč zákaznickou základnou obchodu WooCommerce a označuje zákazníky strukturovaným stavem, na který mohou cílit propagační pravidla. Skóre LTV přiděluje stříbrné, zlaté a VIP role na základě vzorců utrácení zákazníků. Anniversary intelligence detekuje datum výročí nákupu každého zákazníka. Segmentace zákazníků probíhá nepřetržitě a označuje zákazníky jako nové, vracející se, ohrožené, propadlé, VIP, předplatitele, šampiona v doporučení nebo nakupující narozeniny na základě skutečného chování.

Průzkum McKinsey týkající se integrace cen a věrnosti soustavně zjišťuje, že maloobchodníci, kteří přizpůsobují nabídky na základě historie zákazníků, vytvářejí 2 až 4 procentní body zlepšení marže ve srovnání s nabídkami vysílání. Vrstva inteligence zákazníků je základem platformy pro tento druh personalizace – propagační pravidla se zaměřují na stavy zákazníků jako na přirozené podmínky, spíše než aby vyžadovala manuální segmentaci v samostatném nástroji. Inteligenční vrstva snižuje provozní režii a zároveň zlepšuje přesnost propagace.

Vývojářům poskytuje vrstva inteligence zákazníků strukturovaná rozhraní API, na která se může uživatelský kód dotazovat. Stav zákazníka je přístupný prostřednictvím zdokumentovaných metod, nikoli vyžadováním vlastních dotazů proti databázi WooCommerce. Strukturované API znamená, že vlastní logika podmínek může využít zákaznickou inteligenci platformy bez opětovné implementace práce na segmentaci. Data inteligentní vrstvy jsou také přístupná prostřednictvím koncových bodů REST API pro scénáře bezhlavé a externí integrace. Další informace o vrstvě inteligence naleznete v části WooCommerce propagace segmentace zákazníků.

E-mailový systém životního cyklu

E-mailový systém životního cyklu zpracovává e-mailovou automatizaci, kterou tradiční nastavení WooCommerce rozděluje mezi více pluginů. E-maily k výročí, e-maily k narozeninám, kampaně se zpětným ziskem, obnovení opuštěného košíku, upsell po nákupu, připomenutí doplnění a upozornění na upgrade úrovně, to vše běží jako součást platformy, nikoli jako samostatně licencované integrace. E-maily se spouštějí automaticky na základě změn stavu zákazníka a běží zcela pod značkou klienta bez viditelné značky GT BOGO.

White-label doručení znamená, že e-maily dorazí pod značkou klienta. Barvy zvýraznění, hlas značky, umístění loga a vzory kopírování jsou konfigurovatelné pro každého klienta. U agenturních nasazení je bílý štítek konfigurovatelný pro klientský obchod, což znamená, že e-mailový povrch každého klienta používá značku daného klienta spíše než značku agentury nebo platformy. E-mailový systém běží nativně, spíše než vyžaduje integraci s externími poskytovateli e-mailových služeb, i když externí integrace je podporována, pokud to pracovní postupy klienta vyžadují.

Vývojářům e-mailový systém životního cyklu odhaluje háčky pro vlastní e-mailovou logiku, vlastní šablony vykreslování a vlastní integrace doručování. Vlastní e-mailová logika může spouštět e-maily na spouštěče specifické pro klienta; vlastní šablony mohou vykreslovat e-maily s obsahem specifickým pro klienta; integrace vlastního doručování mohou směrovat e-maily přes externí poskytovatele služeb, pokud to pracovní postup klienta vyžaduje. Povrch rozšíření založený na háku znamená, že vlastní přizpůsobení e-mailu žije v kódu specifickém pro klienta a čistě přežije aktualizace pluginů. Další informace o e-mailech během životního cyklu najdete v části WooCommerce e-mailové marketingové akce.

Integrační vzory pro ekosystém WooCommerce

Platforma se integruje s běžnými pluginy ekosystému WooCommerce prostřednictvím standardních vzorů háčků WordPress. Integrace předplatného WooCommerce umožňuje propagační logiku s ohledem na předplatné. WooCommerce Vícejazyčná integrace umožňuje překlad e-mailů během životního cyklu a kopírování pro zákazníky. WooCommerce Integrace členství umožňuje logiku propagace na úrovni členství. WooCommerce Multi-Currency integrace umožňuje zasílání zpráv o prahu s ohledem na měnu. Integrace se řídí standardními vzory WordPress spíše než vyžadují rozšíření zásuvných modulů pro konkrétní platformu.

Pro bezhlavá nastavení WooCommerce platforma zpřístupňuje koncové body REST API pro vrstvu výpočtu košíku, vrstvu inteligence zákazníků a vrstvu konfigurace kampaně. Bezhlavé výlohy se mohou dotazovat na propagační logiku prostřednictvím REST API, místo aby se spoléhaly na standardní frontend WooCommerce. Podpora REST API je dostatečně komplexní, aby bezhlavá nasazení mohla využívat celý povrch možností platformy bez významných kompromisů. Další informace o bezhlavé integraci naleznete v článku developer headless WooCommerce BOGO.

Pro integraci analytiky a externích sestav platforma zpřístupňuje strukturovaná data událostí prostřednictvím háčků a prostřednictvím koncových bodů REST API. Vlastní integrace mohou využívat propagační akce pro analytické sklady, nástroje business intelligence nebo externí systémy výkaznictví. Data událostí se řídí konzistentními schématy, která přežívají aktualizace pluginů, což znamená, že vlastní integrace zůstávají během upgradů stabilní. Další informace o rozhraní API naleznete v části WooCommerce REST API slevy.

Srovnání: Standardní WooCommerce Promotional Architecture vs GT BOGO Engine

| Schopnost | Standardní propagační architektura | GT BOGO Engine architektura | |---|---|---| | Umístění logiky slevy | Vrstva pro uplatnění kupónů | Výpočtová vrstva košíku | | Rozšíření vlastního pravidla | Vidličky nebo opice-patching | Zdokumentované filtrační háčky | | Inteligence zákazníků | Ruční nebo externí nástroje | Nativní spojitá segmentace | | Automatizace e-mailu životního cyklu | Více samostatných pluginů | Nativní jednotný systém | | Konzistence bílé značky | Pro každý plugin nebo žádný | Nativní, konfigurovatelné | | Podpora Headless WooCommerce | Omezené nebo žádné | Komplexní REST API | | Zabezpečení aktualizace pluginu pro vlastní kód | Zakázková práce se často přerušuje | Vlastní práce přežije aktualizace | | Testovací nástroje pro vlastní kód | Omezená | Mock kontexty pro testování jednotek | | Integrace s předplatitelskými pluginy | Ruční konstrukce pravidel | Nativní detekce předplatného | | Roční cena licence | Různé, stack 400 – 1 200 USD | 199 $/rok byt |

Provozní úvahy pro produkční nasazení

Produkční nasazení GT BOGO Engine se řídí standardními operačními vzory WordPress a WooCommerce. Plugin se instaluje prostřednictvím standardního rozhraní pluginu WordPress, konfiguruje se prostřednictvím správce WordPress a funguje prostřednictvím standardních háčků WordPress a WooCommerce. Neexistují žádné speciální požadavky na hostování nad rámec toho, co vyžaduje samotný WooCommerce – doporučeno PHP 7.4+, MySQL 5.7+ nebo MariaDB 10.3+ a standardní serverové zdroje WooCommerce.

Operace zálohování a obnovy fungují prostřednictvím standardních nástrojů zálohování WordPress (UpdraftPlus, BlogVault, ManageWP, JetBackup). The plugin's data is stored in standard WordPress database tables, which means standard backup tools capture the platform's data alongside WooCommerce data. Recovery operations follow the standard WordPress recovery pattern — restore the database backup, restore the file backup, and the platform resumes normal operation.

Pracovní postupy nasazení se řídí standardními vzory nasazení WordPress včetně propagace od fáze po produkci, řízení verzí konfigurací zásuvných modulů a integrace CI/CD, kdy agentura nebo tým vývojářů udržuje formální kanály pro vydání. Konfigurace platformy je exportovatelná jako JSON, což znamená, že propagaci od staging-to-production lze skriptovat spíše než vyžadovat ruční rekonfiguraci v každém prostředí. Další informace o pracovních postupech stagingu najdete v tématu developer WooCommerce testování staging.

Úvahy o výkonu

Logika slev na straně košíku přidává minimální režii k výpočtu košíku. Platforma se optimalizuje pro běžný případ, kdy většina vozíků nemá žádná platná pravidla – vyhodnocení pravidel běží efektivně, když neexistují žádné shody, a přidává smysluplnou režii pouze tehdy, když pravidla skutečně platí. U typických obchodů WooCommerce je režie platformy pod úrovní hluku běžného načasování výpočtu vozíku.

U velkoobjemových obchodů platforma podporuje strategie ukládání do mezipaměti, které snižují opakovanou práci. Výpočty inteligence zákazníků se vhodně ukládají do mezipaměti, mezipaměť členství segmentů s explicitním zrušením platnosti událostí objednávky a mezipaměť výsledků vyhodnocení pravidel, pokud se stav košíku nezměnil. Strategie ukládání do mezipaměti znamená, že platforma se škáluje na vysoké objemy transakcí, aniž by vyžadovala vyhodnocení pravidel na základě požadavku v celé sadě pravidel.

Vzory databázových dotazů se řídí osvědčenými postupy WordPress a WooCommerce. Platforma používá připravené příkazy prostřednictvím abstrakční vrstvy wpdb, vhodně indexuje své vlastní databázové tabulky a vyhýbá se vzorům dotazů N+1 prostřednictvím dávkového načítání tam, kde je to možné. Produkční weby běžící ve smysluplném měřítku nezaznamenávají problémy s výkonem databáze z platformy za normálních provozních podmínek.

Ceny a licenční struktura

GT BOGO Engine PRO je 199 $ za rok na obchod WooCommerce bez cenových úrovní pro jednotlivé funkce. Za knihovnu balíčků kampaní, vrstvu inteligence zákazníků, e-mailový systém životního cyklu, funkci white-label, geografické cílení, podporu více měn, modul A/B testování nebo Revenue Guard se neplatí žádný příplatek. Ceny jsou předvídatelné v rámci složitosti nasazení – weby s různými zásobníky pluginů, vlastní integrací, bezhlavými frontendy nebo vysokými objemy transakcí platí stejnou paušální sazbu. Jednotlivé balíčky PRO specifické pro dané odvětví jsou za 39,99 $. Tři úrovně balíčků nabízejí významné úspory pro klienty s více odvětvími: Starter Bundle (149 $ za 5 balíčků, ušetříte 50,95 $), Growth Bundle (299 $ za 9 balíčků, ušetřete 60,91 $) a Kompletní arzenál (399 $ za 15 balíčků, ušetřete 200,85 $).

Bezplatný základní plugin zahrnuje mechanismus slev na straně košíku, možnost rozšíření pravidel, zdokumentované háky filtrů, povrch REST API a testovací nástroje – dost na to, aby vývojáři ověřili architekturu předtím, než se pustí do PRO. Většina vývojářů používá bezplatnou vrstvu pro počáteční ověření architektury a poté upgraduje na PRO, když produkční nasazení zahrnuje knihovnu balíčků kampaní, vrstvu inteligence zákazníků a e-mailový systém životního cyklu, což jsou funkce pouze PRO.

Často kladené otázky od vývojářů

Jaký je požadavek na verzi PHP platformy?

Platforma vyžaduje minimálně PHP 7.4, přičemž PHP 8.x je podporováno a doporučeno pro nová nasazení. Kódová základna vhodně využívá moderní funkce PHP při zachování kompatibility s verzemi PHP, které samotný WooCommerce podporuje. PHP 8.3 je doporučená verze pro nová produkční nasazení.

Podporuje platforma WooCommerce HPOS (High-Performance Order Storage)?

Ano. Platforma podporuje HPOS prostřednictvím standardních abstrakcí WooCommerce. Vlastní kód, který interaguje s daty objednávek, by měl používat standardní API objednávek WooCommerce spíše než přímé databázové dotazy, což znamená, že vrstva inteligence zákazníků platformy nadále funguje správně pod HPOS. U webů, které ještě nemigrovaly na HPOS, platforma funguje také se starším úložištěm objednávek.

Jak platforma zpracovává instalace WordPress na více místech?

Platforma podporuje instalace WordPress na jednom místě i na více místech. V případě více míst je licencování spíše na místo než na síť, což znamená, že každý web v síti s více místy vyžaduje vlastní licenci. Vlastní kód lze instalovat v celé síti, zatímco konfigurace platformy běží pro jednotlivé lokality, což poskytuje vývojářům flexibilitu při správě nasazení klientů na více místech.

Jaký je přístup platformy k zabezpečení?

Platforma se řídí osvědčenými bezpečnostními postupy WordPress a WooCommerce. Všechny akce správce ověřují nonce a kontroly schopností. Všechny databázové dotazy využívají připravené příkazy prostřednictvím abstrakční vrstvy databáze WordPress. Veškerý výstup je escapován odpovídajícím způsobem pro kontext. Plugin nepřenáší zákaznická data do externích služeb bez explicitní konfigurace. Aktualizace zabezpečení jsou vydávány okamžitě po zjištění zranitelnosti podle standardních vzorů WordPress.

Jak platforma zpracovává vlastní kód, který závisí na knihovně balíčků kampaní?

Balíčky kampaně jsou konfigurační data, nikoli kód, což znamená, že vlastní kód může odkazovat na konfigurace balíčků prostřednictvím stabilních identifikátorů, aniž by byl spojen s implementací interního balíčku. Vlastní kód, který rozšiřuje chování balíčku, to obvykle dělá prostřednictvím standardního povrchu rozšíření pravidel, což znamená, že vlastní kód žije odděleně od dat balíčku a přežije aktualizace zásuvných modulů i aktualizace balíčku. Další informace o logice vlastních pravidel naleznete v části podmínky vlastních pravidel pro vývojáře.

GT BOGO Engine vytvořil GRAPHIC T-SHIRTS, skutečný obchod WooCommerce s více než 1200 originálními návrhy běžícími ve velkém měřítku. Navštivte gtbogoengine.com a stáhněte si bezplatný základní plugin, zhodnoťte povrch rozšíření pro vývojáře a architektonické volby a rozhodněte, zda platforma vyhovuje technickým požadavkům vámi podporovaných nasazení. Pro širší kontext viz WooCommerce vysvětlené propagační zpravodajství.