Přeskočit na hlavní obsah

WPJ integrace

Vlastníte e-shop na platformě WPJ? Integrujte jej s Ecomailem a využijte data z vašeho e-shopu pro vaši rozesílku.

Autor: Pavel Manda

👉 Tato integrace je dostupná pouze v tarifech Marketer+ nebo CDP.

Aktuální verze tohoto propojení přenáší následující entity:

  • Zákazník

  • Objednávka

  • Produkt

Přenos probíhá 1x denně v ranních hodinách. Jestliže chcete využít přenos dat v reálném čase je zapotřebí využít tzv. sGTM tagu ve vašem Google Tag Manageru (GTM). Jak na jeho nastavení vám ukážeme v samostatné části tohoto článku.

  1. Co doplněk umožní

  2. Jak nainstalovat doplněk

    2.1 Základní nastavení integrace

    2.2 Rozšířené nastavení integrace - sGTM tag pro realtime přenosy

    1. Nastavení datových proměnných

    2. Subscribe kontaktu (souhlas s NL)

    3. Unsubscribe kontaktu (nesouhlas s NL)

    4. Objednávky

    5. Multijazyčné e-shopy

    2.3 Nastavení opuštěného košíku

1 . Co doplněk umožní?

Integrace nabízí v plném nastavení následující:

  • synchronizaci kontaktů z e-shopu do seznamu kontaktů v Ecomailu

    • kontakty se přenáší se zdrojem wpj_import nebo wpj_import_daily

    • vlastní pole pro přenos dalších zákaznických atributů - nutné konzultovat a nastavit individuálně s WPJ

    • přenos zákazníků do vybraných seznamů dle jazykové mutace vaše webu (pokud ji máte)

  • přenos objednávek

    • přenáší se maximálně 20 (pod)kategorií produktů, max. 100 znaků na jednu kategorii

    • možnost přenosu také objednávek z vašich kamenných prodejen

  • sledování pohybu uživatele na vašem webu (page_views)

  • sledování opuštěného košíku (web_events)

Jaké kontakty se do Ecomailu přenášejí?

Integrace přenáší kontakty, ale také kontakty z objednávek.

Ke kontaktům se přenášejí následující štítky, podle kterých je možné je dále třídit:

  • WPJ - všechny kontakty z vašeho e-shopu na platformě WPJ

  • WPJ_newsletter - ti kteří souhlasí s odběrem newsletteru

TIP: Potřebujete např. vyhledat jen kontakty, které udělily výslovný souhlas s rozesílkou? Tento segment doporučujeme pro každou rozesílku newsletteru. Využijte toto segmentační pravidlo:

Informaci o tom, zda kontakt je nebo není registrován, se přenáší společně s kontaktem ve vlastním poli wpj_registered. Hodnota nabývá stavu 0 (není) a 1 (je registrován) - synchronizace probíhá 1x denně.

V základním nastavení integrace je přenášena také informace o zákaznických skupinách ve vlastním poli user_groups - synchronizace probíhá 1x denně.

2. Jak integraci zprovoznit

⚠️ Nezbytnou součástí je žádost v klientské sekci vašeho e-shopu na platformě WPJ, kde zadejte ticket na zpřístupnění datových feedů pro integraci s Ecomail. Zde následně také nastavte vaše individuální požadavky na přenos zákaznických dat.

👉 Ve chvíli, kdy vám budou tyto datové feedy zpřístupněny, můžete pokračovat v nastavování samotného propojení.

2.1 Základní nastavení integrace v aplikaci Ecomail

  1. Možnosti nastavení naleznete ve vašem účtu u Ecomail v sekci “Správa účtu -> Integrace” pod možnostmi vašeho uživatelského profilu.
    V sekci integrace nově uvidíte dlaždici s e-shopovou platformou WPJ.

  2. Klikněte na odkaz “Podrobnosti” pro nastavení potřebných hodnot nutných k napojení integrace.

  3. Nastavovat budete:

    1. Připojený seznam kontaktů
      ​      Jedná se o seznam kontaktů v Ecomailu, kam chcete, aby se přenášeli vaši zákazníci z e-shopu na platformě WPJ (na straně Ecomail se jedná o kontakty). V rámci nastavení vyberte jeden seznam kontaktů z již existujících seznamů kontaktů. Tento seznam kontaktů bude váš výchozí seznam kontaktů.

      Následně doplňte URL na datové feedy z administračního rozhraní vašeho e-shopu u WPJ. Ty najdete v administraci vašeho e-shopu zde:

    2. URL objednávkového feedu e-shop

      Jedná se o datový zdroj, prostřednictvím kterého jsou přenášeny informace o objednávkách vašich zákazníků ve vašem e-shopu. Jako název e-shopu je přenášena doména, na které je váš e-shop provozován.

      Po kliknutí na feed “Ecomail objednávky” v novém okně zkopírujte URL adresu tohoto feedu

      a vložte ji do nastavení integrace s WPJ ve vašem účtu u Ecomail.

    3. URL objednávkového feedu retail (nepovinný)

      Jedná se o datový zdroj, prostřednictvím kterého jsou přenášeny informace o objednávkách vašich zákazníků z prodejen. Pokud taková data máte ve vaší správě e-shopu a chcete je přenášet do Ecomail, tak hodnotu vyplňte. Takové objednávky jsou označeny "WPJ_retail" pro možnost segmentace, a to pomocí atributu "props".

      Tento datový zdroj je pro nastavení integrace nepovinný.

    4. URL uživatelského feedu

      Obdobně postupujte se zadáním URL pro přenos dat o vašich zákaznících.

    5. URL produktového feedu

      Vložte také URL pro přenos dat k vašim produktům.

      Doporučujeme vedle této možnosti využívat pro správnou funkci merge tagů na straně Ecomail zbožové feedy v některém z formátů: Heureka, Zboží či Google Merchant. Nastavení najdete v Ecomail aplikaci pod "Další -> Zbožové feedy"

    6. Jazykové mutace

      Provozujete váš e-shop ve více jazykových mutacích / používáte různé domény? Pak využijte možnosti, které vám nabízí jazykové mutace.

      Zde vám výjimečně doporučujeme využít více seznamů kontaktů a pro každou jazykovou mutaci mějte vlastní seznam kontaktů. Defaultně se připojený seznam kontaktů zvolený výše páruje na český jazyk. Pro další zvolte možnost "+ Jazykové mutace" a nadefinujte dvojice jazyk/země a seznamy kontaktů.

      Takto nastavená integrace bude synchronizovat jednotlivé vaše zákazníky dle jazyka do přiřazených seznamů kontaktů. Platforma WPJ přenáší do Ecomail všechny objednávky s hodnotou převedenou na Kč.

      ​⚠️ Pokud využíváte přenos real time dat prostřednictvím sGTM tagu, viz dále, je nutné stejné nastavení i v sGTM tagu.

  4. Po vložení všech těchto údajů, klikněte na tlačítko “Uložit změny”. Po tomto kroku se integrace v přehledu integrací označí jako aktivní.

    Současně bude zahájena úvodní synchronizace všech dat (objednávky, zákaznáci a produkty) z vašeho e-shopu do vašeho účtu u Ecomail.

    Délka této úvodní synchronizace závisí na množství vašich dat v e-shopu

    a je ovlivněna zejména počtem objednávek. Úvodní synchronizace tak může trvat i několik hodin.

Tímto nastavením máte zajištěn přenos objednávek, produktů a vašich zákazníků včetně jejich úprav, a to každý den vždy v ranních hodinách. Pro synchronizaci dat od posledního automatického denního přenosu můžete využít tlačítko "Aktualizovat feedy".

Pokud chcete zajistit přenos dat v reálném čase, je zapotřebí nastavit ve vašem Google Tag Manageru (GTM) Ecomail sGTM tag. Tento přenos je podporován
​e-shopovou platformou WPJ a je jedinou možností, jak přenos v reálném čase zajistit.

2.2 Rozšíření propojení prostřednictvím sGTM tagu

Předpokladem pro úspěšné propojení je existující přenos dat z vašich webových stránek / e-shopu do vašeho Google Tag Manageru (GTM), konkrétně do serverového kontejneru.

Publikovaný Ecomail sGTM tag nabízí přenos následujících entit postavených na enhanced e-commerce datové vrstvě GA4 (Google Analytics 4). Přenášeny mohou být následující data:

  • Zákazníci (kontakty, vytvoření, update či odhlášení)

  • Objednávky

  • Webové události (jako je např. opuštěný košík)

S takto připravenými daty v GTM serverovém kontejneru můžete přistoupit k instalaci Ecomail sGTM tagu, a to následovně:

☝ Ujistěte se, že pro váš kontejner máte nastavenu cílovou platformu server. V opačném případě Ecomail tag nenajdete. Ten je určen právě pro server-side eventy.

  1. V projektu, ve kterém chcete propojení nastavit, klikněte na položku "Tags".

  2. Zvolte nový tag.

  3. Přes konfiguraci tagu - "Tag Configuration" vyberte volbu vyhledání tagu v galerie - "Community Template Gallery"

  4. Vyhledejte "Ecomail" a ten následně přidejte do vašeho projektu - "Add to workspace".

  5. Nyní už zbývá jen nakonfigurovat samotné propojení. K tomu je zapotřebí doplnit následující hodnoty:

    • API klíč

    • Integration name - zadáte název štítku, podle kterého budete vědět, že kontakt se dostal do seznamů kontaktů právě díky sGTM tagu. V případě nastavení pro integrace s WPJ ponechte toto pole prázdné! Štítky se pro tuto integraci doplňují automaticky ve tvaru 'WPJ_xxx'.

    • Přenos souhlasu s rozesílkou newsletterů vašich zákazníků (ANO/NE) - zde nastavíte zda chcete pro daný typu requestu:

      • objednávka - "Transactions"

      • zákazník - "Contact"

      • událost - "Event"

      instantně nastavit souhlas s rozesílkou. To znamená, že při odeslání dat daného typu do Ecomali bude souvisejícímu kontaktu přiřazen štítek "WPJ_newsletter", bez ohledu na data přicházející z platformy WPJ.

      Pokud se chceteřídit pouze zasílanými informacemi v ED.email - consent
      (⚠️ doporučujeme ) ponechte toto pole "Newsletter consent" na hodnotu NE, tedy nezaškrtnuté / prázdné.

  6. V případě, že využíváte více jazykových mutací a máte pro ně v Ecomail vlastní seznamy kontaktů viz kapitola 2.1 bod 3f, nezapoměňte v nastavení všech sGTM šablon, viz dále, nastavit sekci Multistore lists definitions. Bez tohoto nastavení by se všechny události zapisovaly k výchozímu seznamu kontaktů.

  7. Podrobné nastavení jednotlivých šablon událostí pro Ecomail tag najdete dále.

2.2.1 Nastavení sGTM šablon

2.2.1.1 Nastavení variables

Pro správné fungování přenosů je zapotřebí pro integraci na WPJ platformu definovat následující variables. A to v sekci "Variables" vašeho workspace v GTM.

Výčet potřebný variables ukazuje tato tabulka.

Name

Type

Key path

ED.email - consent

Event Data

email

ED.event_id

Event Data

event_id

ED.items

Event Data

items

ED.language

Event Data

language

ED.page_hostname

Event Data

page_hostname

ED.purchase.delivery_type

Event Data

delivery_type

ED.purchase.payment_type

Event Data

payment_type

ED.transaction_id

Event Data

transaction_id

ED.transaction_shipping

Event Data

shipping

ED.transaction_value

Event Data

value

ED.transaction_vat

Event Data

vat

ED.user_data.address.city

Event Data

user_data.address.city

ED.user_data.address.country

Event Data

user_data.address.country

ED.user_data.address.first_name

Event Data

user_data.address.first_name

ED.user_data.address.last_name

Event Data

user_data.address.last_name

ED.user_data.address.postal_code

Event Data

user_data.address.postal_code

ED.user_data.address.street

Event Data

user_data.address.street

ED.user_data.email_address

Event Data

user_data.email_address

ED.user_data.phone

Event Data

user_data.phone

2.2.1.2 Ecomail - subscribe (souhlas s NL)

Pro nastavení přenosu informací o přihlášení k odběru na straně e-shopu. Vytvořte nový záznam / šablonu pro Ecomail tag s request type "Contact".

Pro přenos informací o souhlasu se zasíláním newsletterů vám postačují pouze tato data.

"Data about users"

{{ED.email - consent}}

User e-mail

Trigger zvolte jak je uvedeno.

Šablonu tagu nezapomeňte uložit.

2.2.1.3 Ecomail - unsubscribe (nesouhlas s NL)

Identicky postupujte pro získání informace o nesouhlasu k odběru newsletterů ze strany zákazníka vašeho e-shopu na platformě WPJ.

"Data about users"

{{ED.email - consent}}

User e-mail

Trigger zvolte event.success_newsletter_unsubscribe.

⚠️ Zaškrtnutí pole "Update existing" pro správnou funkci odhlašování je nutné.

2.2.1.4 Transaction

Pro přenos objednávek a zákaznických dat v reálném čase zvolte typ requestu "Transaction" a dále postupujte dle následujícího popisu. Toto nastavení je nejobsáhlejší, protože obsahuje nejen kompletní data o zákazníkovi, ale také o položkách objednávky.

Pro přenos je nezbytné doplnit data o uživatele prostřednictvím následujícího mapování dříve vytvořených variables, a to v jednotlivých sekcích:

  • "Data_about_user"

  • "Data for transaction"

  • "Data for items"

Data_about_user

"Data for transaction"

"Data for transaction"

viz tabulka:

"Data_about_user"

User e-mail

{{ED.user_data.email_address}}

Name

{{ED.user_data.address.first_name}}

Surname

{{ED.user_data.address.last_name}}

City

{{ED.user_data.address.city}}

Street

{{ED.user_data.address.street}}

Zip code

{{ED.user_data.address.postal_code}}

Country

{{ED.user_data.address.country}}

Phone number

{{ED.user_data.phone}}

Languague

{{ED.language}}

"Data for transaction"

Order ID

{{ED.transaction_id}}

Order shop

{{ED.page_hostname}}

Order amount (value)

{{ED.transaction_value}}

Tax of order

{{ED.transaction_vat}}

Shipping price

{{ED.transaction_shipping}}

"Data for items"

Items (for transaction ...)

{{ED.items}}

price

price

Šablonu tagu nezapomeňte uložit.

2.2.1.5 Multijazyčné e-shopy

V případě, že využíváte více jazykových mutací a máte pro ně v Ecomail vlastní seznamy kontaktů viz kapitola 2.1 bod 3f, nezapomeňte v nastavení všech sGTM šablon, viz výše, nastavit sekci Multistore lists definitions. Bez tohoto nastavení by se všechny události zapisovaly k výchozímu seznamu kontaktů.

viz tabulka.

"Multistore lists definitions"

List Id - Czech

Doplňte statickou hodnotu Id z Ecomail

List Id - English

Doplňte statickou hodnotu Id z Ecomail

List Id - Slovakia

Doplňte statickou hodnotu Id z Ecomail

TIP💡Doporučujeme nastavení Ecomail tagu otestovat v preview módu Google Tag Manageru pro váš e-shopu. Ať již v manuálním režimu, či přímo v preview módu vašeho e-shopu.

​V případě nejasností se obraťte na vašeho specialistu / správce vašeho Google Tag Manageru.

2.3 Opuštěný košík a sledování chování zákazníků na webu

Díky implementaci Ecomail trackovacího kódu do webových stránek vašeho e-shopu můžete lépe personalizovat rozesílku díky událostem prohlížených stránek, naposledy prohlíženého produktu či sledování události opuštěného košíku.


Více o principech trackovacího kódu se dočtete v našem článku Implementace trackovacího kódu.

Samotnou implementaci do prostředí e-shopové platformy WPJ je nutné provést skrze váš Google Tag Manager, viz implementace přes platformy třetích stran.

Pro potřeby správné funkčnosti vložte následující kód html kód.

<script type="text/javascript" id="" charset="">(function(a,e,f,g,b,c,d){a[b]||(a.GlobalSnowplowNamespace=a.GlobalSnowplowNamespace||[],a.GlobalSnowplowNamespace.push(b),a[b]=function(){(a[b].q=a[b].q||[]).push(arguments)},a[b].q=a[b].q||[],c=e.createElement(f),d=e.getElementsByTagName(f)[0],c.async=1,c.src=g,d.parentNode.insertBefore(c,d))})(window,document,"script","//d70shl7vidtft.cloudfront.net/ecmtr-2.4.2.js","ecotrack");window.ecotrack("newTracker","cf","d2dpiwfhf3tz0r.cloudfront.net",{appId:"",consentModeV2: true, integration: 'wpj'}); window.ecotrack("setUserIdFromLocation","ecmid");window.ecotrack("trackPageView");</script>

za appId:"" doplňte appId:"název vašeho účtu v Ecomail", nezapomeňte uvést integration: 'wpj', aby trackovací kód pracoval správně s datovou vrstvou e-shopů na platformě WPJ.

Název vašeho účtu v ecomail najdete v aplikaci Ecomail na záložce Přehled v sekci Váš účet ve spodní části obrazovky.

💭 Nenašli jste odpověď?

Napište nám na chat nebo e-mail support@ecomail.cz. 😊

Související články
Dostali jste odpověď na svou otázku?