Propojte e-shop na WooCommerce s Ecomailem a přenášejte do něj zákazníky, jejich objednávky i chování na webu. Článek popisuje plugin Ecomail ve verzi 2.5.0.
Jak využít získaná data z e-shopu?
V tomto článku naleznete:
1. Požadavky
WordPress 7.0 nebo novější
WooCommerce 10.9 nebo novější
PHP 8.2 nebo novější s rozšířením OpenSSL
funkční WP-Cron (plugin zpracovává data na pozadí přes plánovač WooCommerce)
Plugin podporuje nové úložiště objednávek WooCommerce (HPOS) i blokovou pokladnu. WordPress multisite zatím podporovaný není.
Pozor ⚠️: Pokud váš web běží na starší verzi PHP, WordPressu nebo WooCommerce, WordPress vám aktualizaci na verzi 2.5.0 nenabídne a plugin zůstane na verzi 2.4.3. Požádejte svůj hosting o aktualizaci PHP.
2. Funkce pluginu
Synchronizace kontaktů
Přihlášení kontaktu k newsletteru při objednávce, pokud zákazník nezaškrtne políčko o nezájmu. Funguje v klasické i blokové pokladně a při dodatečném zaplacení objednávky.
Přihlášení a odhlášení zákazníka v sekci Můj účet.
Volba seznamu kontaktů, do kterého se kontakty přenášejí.
Volba přenášených údajů: jméno, příjmení, adresa, firma, telefon a jazyk obchodu.
Vlastní název zdroje kontaktu (API zdroj), podle kterého kontakty v Ecomailu rozlišíte.
Vlastní text políčka pro odmítnutí newsletteru.
Nastavitelné přeskočení double opt-in, spouštění automatizací, aktualizace údajů kontaktu a opětovné přihlášení po nové objednávce.
Počáteční synchronizace stávajících zákazníků a objednávek, která běží na pozadí. Stránku můžete během ní zavřít.
Sledování a automatizace e-commerce (pouze tarify Marketer+ a CDP)
Přenos objednávek a změn jejich stavů.
Sledování obsahu košíku pro automatizaci opuštěného košíku.
Přenos až 20 kategorií u každého produktu, nejvýše 100 znaků na kategorii.
Sledování naposledy prohlíženého produktu (pro merge tag ECM_LAST_VIEW).
Vložení trackovacího kódu pro sledování návštěv webu.
Identifikace přihlášeného zákazníka při sledování.
Sledování na webu (trackovací kód, košík a naposledy prohlížený produkt) funguje jen u návštěvníků, kteří souhlasili s marketingovými cookies. Více v kapitole 5.2.
Nastavení, správa a údržba
Vypínač celé integrace. Vypnutím pozastavíte veškerou komunikaci s Ecomailem bez deaktivace pluginu. Rozpracované úlohy po zapnutí pokračují tam, kde skončily.
API klíč se ukládá šifrovaně.
Tlačítka pro otestování připojení a obnovení seznamů kontaktů.
Přehled komunikace s Ecomailem (Protokoly požadavků API) přímo v nastavení pluginu. Neobsahuje osobní údaje zákazníků ani API klíč a uchovává se 7 dní.
Podrobnější záznamy pro podporu najdete ve WooCommerce → Stav → Protokoly.
Administrace pluginu je v češtině, slovenštině, polštině a angličtině podle jazyka WordPressu.
Podpora WP Consent API a cookie lišt, například Complianz.
Obousměrná synchronizace stavu přihlášení
Stav přihlášení k newsletteru se synchronizuje oběma směry (Ecomail ⇆ WooCommerce). Je potřeba nastavit webhook, viz kapitola 5.3.
V přehledu Uživatelé ve WordPressu vidíte stav přihlášení každého zákazníka (1) a můžete podle něj filtrovat (2).
Zákazník vidí svůj stav v sekci Můj účet a může se zde přihlásit nebo odhlásit.
3. Jaké kontakty se do Ecomailu přenáší?
Od instalace pluginu se přenášejí:
zákazníci z objednávek (registrovaní i nakupující bez registrace), pokud nezaškrtli nezájem o newsletter,
zákazníci, kteří se přihlásí v sekci Můj účet.
Samotná registrace na e-shopu kontakt do Ecomailu nepřenese.
Zákazníky a objednávky, které už v e-shopu máte, nahrajete počáteční synchronizací (kapitola 5.4) nebo importem kontaktů.
Štítky
wp – kontakt přenesený z WooCommerce,
wp_order – kontakt s objednávkou,
wp_newsletter – kontakt přihlášený k newsletteru.
Plugin štítky jen přidává. Štítky, které má kontakt v Ecomailu z jiných zdrojů, zůstanou zachované. Když se zákazník odhlásí, odebere se štítek wp_newsletter.
Pozor ⚠️: Od verze 2.2.0 se zákazník přihlásí k newsletteru vždy, dokud nezaškrtne políčko Nechci dostávat newsletter. Text políčka můžete v nastavení pluginu změnit. Pokud políčko vypnete, přihlásí se každý zákazník. Ověřte si, že máte pro zasílání newsletterů právní důvod.
4. Instalace a aktualizace
Plugin nainstalujete přímo z administrace WordPressu, nebo ho stáhnete z wordpress.org a nahrajete ručně.
4.1. Instalace z administrace
V administraci WordPressu otevřete Pluginy → Instalace pluginů a do pole Hledat pluginy zadejte „ecomail“. U pluginu Ecomail klikněte na Instalovat a poté na Aktivovat. Pokud už plugin máte nainstalovaný, ukazuje tlačítko stav Aktivní.
Pokračujte konfigurací v kapitole 5.
4.2. Ruční instalace
Stáhněte plugin z wordpress.org. V administraci WordPressu otevřete Pluginy → Instalace pluginů → Nahrát plugin, vyberte stažený soubor a klikněte na Aktivovat plugin.
4.3. Aktualizace ze starší verze
Před aktualizací web zazálohujte.
Nastavení, zákazníci ani objednávky se aktualizací nesmažou. API klíč se automaticky převede do šifrované podoby.
Po aktualizaci otevřete Nastavení → Ecomail, klikněte na Otestovat připojení k Ecomailu a zkontrolujte vybraný seznam kontaktů.
Zkontrolujte, že URL webhooku v Ecomailu odpovídá URL zobrazené v pluginu (kapitola 5.3).
Zkontrolujte nastavení souhlasu s cookies (kapitola 5.2). Bez něj se sledování na webu neodesílá.
Udělejte zkušební objednávku a ověřte, že dorazila do Ecomailu.
Pokud se z jakéhokoli důvodu vrátíte ke starší verzi 2.4.3, zadejte API klíč znovu. Starší verze šifrovaný klíč nepřečte.
5. Konfigurace
Nastavení najdete v administraci WordPressu v Nastavení → Ecomail.
5.1. Připojení k Ecomailu
Do pole API klíč vložte API klíč z Ecomailu. Najdete ho v aplikaci Ecomail v sekci Správa účtu → Pro vývojáře.
Do pole App ID zadejte název svého účtu, tedy první část adresy, na které Ecomail používáte (například u adresy mujobchod.ecomailapp.cz je to „mujobchod“).
Klikněte na Uložit změny v liště, která se po úpravě nastavení objeví v horní části stránky.
Klikněte na Otestovat připojení k Ecomailu. Nahoře by se měl zobrazit stav připojení „připojeno“.
Klikněte na Obnovit seznamy kontaktů a v poli Seznam pro přihlášení v pokladně vyberte seznam, do kterého se mají kontakty přenášet.
V poli Pole v pokladně vyberte údaje, které se mají ke kontaktům přenášet.
Ostatní možnosti nastavte podle svých potřeb a změny uložte.
Po uložení zůstane pole API klíč prázdné, i když je klíč uložený. Klíč se z bezpečnostních důvodů už nezobrazuje. Pokud pole necháte prázdné, uložený klíč zůstane beze změny.
💡 TIP: V poli API zdroj si můžete nastavit vlastní název zdroje kontaktů (výchozí je „woocommerce“). Podle něj pak kontakty v Ecomailu snadno rozlišíte a segmentujete. Název může obsahovat malá písmena bez diakritiky, číslice a podtržítko.
5.2. Souhlas s cookies
Sledování na webu (návštěvy stránek, obsah košíku a naposledy prohlížený produkt) se odesílá jen u návštěvníků, kteří souhlasili s marketingovými cookies. Plugin souhlas zjistí jedním ze dvou způsobů:
WP Consent API – pokud máte nainstalovaný plugin WP Consent API a cookie lištu, která ho podporuje (například Complianz), plugin souhlas převezme automaticky a nic dalšího nastavovat nemusíte.
Název a hodnota cookie – jinak vyplňte v sekci Souhlas se sledováním chování pole Název marketingového cookie a Hodnota marketingového cookie. Pro plugin Complianz zadejte název cmplz_marketing a hodnotu allow. U jiné cookie lišty nebo vlastního řešení vyplňte název a hodnotu cookie, kterou ukládá při souhlasu s marketingovými cookies.
Plugin v sekci Souhlas se sledováním chování ukazuje, který způsob na vašem webu rozpoznal.
Pozor ⚠️: Od verze 2.5.0 platí, že pokud souhlas nejde ověřit (není nainstalované WP Consent API a pole pro cookie jsou prázdná), sledování na webu se neodesílá vůbec. Objednávky a přihlášení k newsletteru se přenášejí i bez souhlasu s cookies.
5.3. Obousměrná synchronizace (webhook)
V Nastavení → Ecomail najděte sekci Webhook pro změny odběru a zkopírujte celou URL webhooku.
V aplikaci Ecomail otevřete seznam kontaktů, který používáte pro WooCommerce, a přejděte do Nastavení seznamu → Nastavení webhooku.
Zapněte Posílat informace na webhook, vložte zkopírovanou URL a změny uložte.
Od teď se změna stavu kontaktu propíše z Ecomailu (odhlášení z kampaně, automatizace atd.) do WooCommerce a obráceně z WooCommerce (přihlášení nebo odhlášení v sekci Můj účet) do Ecomailu.
URL webhooku obsahuje tajný klíč, proto ji nikomu neposílejte. Pokud ji kliknutím na Znovu vygenerovat token webhooku změníte, stará URL přestane fungovat a novou musíte vložit i do Ecomailu.
5.4. Počáteční synchronizace
Sekci Počáteční synchronizace najdete pod hlavním nastavením v Nastavení → Ecomail. Můžete zvolit:
Synchronizovat zákazníky – nahraje registrované zákazníky a uživatele, kteří mají objednávku,
Synchronizovat zákazníky a objednávky – nahraje zákazníky i jejich dosud nepřenesené objednávky,
Aktualizovat známé objednávky – aktualizuje objednávky, které už v Ecomailu jsou.
Synchronizace běží na pozadí a průběh se ukládá. Stránku můžete zavřít a vrátit se později. Neúspěšnou synchronizaci můžete tlačítkem Opakovat úlohu obnovit tam, kde skončila. Po dokončení klikněte na Odstranit dokončenou úlohu, abyste mohli spustit další. Záznamy, které se nepodařilo přenést, najdete v rámečku Záznamy vyžadující kontrolu.
Co je dobré vědět:
Zákazníci, kteří se odhlásili nebo u poslední objednávky odmítli newsletter, se přeskočí.
Nakupující bez registrace se počáteční synchronizací nenahrávají. Jejich nové objednávky se přenášejí průběžně, pokud máte zapnuté sledování objednávek.
Registrovaný zákazník bez objednávky a bez známého souhlasu s newsletterem se nahraje jako odhlášený. Stav kontaktů, které už v Ecomailu jsou, se nemění.
Hromadně nahrané objednávky nespouštějí automatizace se spouštěčem „Udělá objednávku“.
Hromadné nahrání přeskakuje double opt-in. Před spuštěním si ověřte, že máte souhlas se zasíláním newsletterů.
Pokud synchronizace na pomalejším hostingu neprobíhá, zmenšete velikosti dávek v sekci Nastavení dávek a ověřte, že na webu funguje WP-Cron.
6. Časté dotazy
Z jakého důvodu se do objednávky nepřeneslo ID produktu?
Jako ID produktu se do Ecomailu přenáší kód SKU, který vyplníte u produktu ve WooCommerce. Pokud produkt SKU nemá, přenese se interní číslo produktu (případně varianty) z WooCommerce. Pokud chcete v Ecomailu vidět svá vlastní označení produktů, doplňte u produktů SKU. S nastavením SKU vám pomůže podpora WooCommerce.
Za jakých okolností se ke kontaktu budou posílat data o opuštěném košíku?
Aby se ke kontaktu přenášely události vložení zboží do košíku, musí plugin znát e-mailovou adresu návštěvníka a návštěvník musí souhlasit s marketingovými cookies. Podrobnosti najdete v článku o automatizaci opuštěného košíku.
U WooCommerce plugin zná e-mail návštěvníka v těchto případech:
návštěvník je přihlášený do svého zákaznického účtu na e-shopu,
návštěvník vyplnil svůj e-mail v pokladně.
Návštěvy webu sleduje trackovací kód samostatně. Ten může kontakt rozpoznat i po prokliku z newsletteru, více v článku o implementaci trackovacího kódu.
Proč je pole API klíč po uložení prázdné?
Klíč je uložený šifrovaně a z bezpečnostních důvodů se už nezobrazuje. Pole nechte prázdné, pokud klíč měnit nechcete. Nový klíč uložíte tak, že ho do pole vložíte a uložíte změny.
Připojení k Ecomailu přestalo po přesunu webu fungovat. Co s tím?
API klíč je zašifrovaný pomocí bezpečnostních klíčů vašeho WordPressu. Pokud se změní (například při přesunu webu na jiný hosting nebo po bezpečnostním zásahu), plugin uložený klíč nepřečte a zobrazí upozornění. Stačí API klíč znovu vložit, uložit a otestovat připojení.
Proč se neodesílá sledování košíku nebo návštěv webu?
Zkontrolujte, že máte příslušné sledování v nastavení zapnuté a že váš tarif sledování podporuje (Marketer+ a CDP).
Zkontrolujte nastavení souhlasu s cookies (kapitola 5.2). Bez ověřeného souhlasu se sledování neodesílá.
Vyzkoušejte to v anonymním okně prohlížeče: odsouhlaste marketingové cookies v cookie liště a pak vložte zboží do košíku.
Objednávka nebo kontakt se do Ecomailu nepřenesl. Kde zjistím proč?
V Nastavení → Ecomail klikněte na Otestovat připojení k Ecomailu.
Ve stejném nastavení otevřete Protokoly požadavků API a vyhledejte číslo objednávky. Uvidíte, jestli Ecomail požadavek přijal, nebo jakou vrátil chybu.
Ve WooCommerce → Stav → Naplánované akce ověřte, že se akce pluginu Ecomail zpracovávají. Pokud čekají dlouho, nefunguje na webu WP-Cron. Obraťte se na svůj hosting.
Pokud se obrátíte na naši podporu, pošlete nám čas a identifikátor (correlation ID) z protokolu. API klíč ani URL webhooku nám nikdy neposílejte.
Proč mi WordPress nenabízí aktualizaci na verzi 2.5.0?
Verze 2.5.0 vyžaduje PHP 8.2, WordPress 7.0 a WooCommerce 10.9 nebo novější. Pokud je váš web na starší verzi, WordPress aktualizaci nenabídne a plugin zůstane na verzi 2.4.3. Aktualizujte WordPress a WooCommerce a požádejte hosting o novější PHP.
Smaže odinstalace pluginu data e-shopu?
Ne. Zákazníci, objednávky ani produkty se nikdy nemažou. Nastavení pluginu a protokoly se smažou jen v případě, že to výslovně zapnete v sekci Odinstalace.
💭Nenašli jste odpověď?
Napište nám na chat nebo e-mail support@ecomail.cz.😊