This post is also available in:

Po povolení přijímání oznámení již můžete skrze Push kampaně Samby vytvářet vlastní notifikace, které mohou vypadat například následovně:

Jak převést dosud nasbírané web push odběratele?

Pokud jste již dříve službu Push notifikací využívali, zajistí Samba u již dříve nasbíraných odběratelů automaticky tzv. resubskripci. To znamená, že po uživatelově návštěvě vašeho webu dojde na pozadí k předání této informace z prohlížeče uživatele Sambě a ta jej tak může zařadit opět mezi vaše odběratele aniž by uživatel musel opětovně projít celým procesem přihlášení.

---

Podporovaná zařízení

Webové prohlížeče

• Push notifikace jsou aktuálně podporovány pro prohlížeč Chrome, Firefox, Edge a Opera.
• Internet Explorer tuto funkci nemá.

Operační systémy

• Standardně funguje zobrazení dobře pro Windows OS a Android OS – na ostatních zařízeních nemusí být některé funkcionality funkční.
• Na mobilních telefonech značky Apple bohužel nejsou v tuto chvíli Push notifikace dostupné – jedná se o limitaci tohoto operačního systému, nikoliv Samby.

Způsoby integrace Push notifikací

V Sambě máte na výběr mezi 2 způsoby integrace:

1. Vlastní hosting
   

   Tuto možnost doporučujeme, pokud máte přístup do kořenového adresáře vaší domény, kam je třeba umístit speciální skript.

1. • Výhody:
     • V notifikacích se zobrazí vaše doména.
     • Vaši dříve shromáždění odběratelé mohou být automaticky znovu přihlášeni k odběru (resubskripce funguje).
     • Uživatelé se mohou přihlásit k odběru jediným kliknutím, vlastní vyskakovací okno je volitelné.
   • Nevýhody:
     • Musíte mít přístup do kořenového adresáře domény pro umístění skriptu.
     • Vaše doména musí mít HTTPS certifikát.
2. Hostováno Samba.ai

• • Výhody:
    • Nepotřebujete přístup ke kořenovému adresáři domény.
    • Vaše doména nemusí mít HTTPS certifikát.
  • Nevýhody:
    • V notifikacích bude zobrazena doména samba.ai.
    • Odběratelé jsou spojeni s doménou samba.ai, automatické přihlášení již existujících odběratelů nebude fungovat (resubskripce funguje).
    • Před zobrazením nativního okna prohlížeče je nutné vyvolat interakci uživatele s vlastním vyskakovacím oknem pro odběr. Uživatelé pak musí odběr potvrdit v novém okně.

Způsob integrace lze změnit v sekci Rozšíření pod tlačítkem Nastavení u Push notifikací

a poté klikem na Změnit typ integrace.

Integrace pro vlastní hosting

Pro spuštění Push notifikací je třeba splnit následující kroky:

1. Mít úspěšně implementovaný základní trackovací skript. Rozhraní toto samo indikuje zelenou fajfkou.
2. Vložit malý skript, tzv. service worker skript,  v nezměněné podobě (stejný obsah, stejný název) do kořenového adresáře hostingu domény, kde se nachází Váš e-shop.
   • Například pokud váš obchod běží na adrese https://muj-eshop.cz, musí být service worker skript dostupný na adrese https://muj-eshop.cz/samba-sw.js.
   • Skript je ke stažení přímo v aplikaci. 
   • Lze upravit doménu, na které se váš e-shop vyskytuje. Pozor si dejte zejména na to, zda má být pro váš případ včetně „www“ či nikoli. Protokol http/https zde nesmí být uveden.
   • Je třeba, aby MIME typ souboru byl „application/javascript“.
   • Pokud máte více domén s jedním kořenovým adresářem, postupujte podle tohoto návodu.
     
3. Zapnout Push službu
   • Tím dojde k aktivaci sběru odběratelů vašich push notifikací a je umožněno odesílat push kampaně.
   • Žádost o přihlášení k odběru push notifikací je funkční pouze na té doméně, na které je úspěšně implementován trackovací skript  a service worker skript.

Integrace s hostováním Samba.ai

Pro spuštění Push notifikací je třeba splnit následující kroky:

1. Mít úspěšně implementovaný základní trackovací skript. Rozhraní toto samo indikuje zelenou fajfkou.
2. Zapnout Push službu
   • Tím dojde k aktivaci sběru odběratelů vašich push notifikací a je umožněno odesílat push kampaně.

Subdoména, která se společně s doménou „push.samba.ai“ zobrazuje v notifikacích, je automaticky vytvořena z domény vašeho eshopu. Lze ji změnit pomocí změny Domény v režimu Typ integrace: Vlastní hosting.

Další vlastnosti nastavení

Ikona push notifikace

U každé push zprávy lze zobrazit vaší ikonu, která musí splňovat následující požadavky:

• Velikost: min. 192x192px nebo větší pro displeje s vysokým rozlišením
• Poměr stran: 1:1
• Formát obrázku: .jpg, .png

Ikona se zobrazuje také v popup okně, které se zobrazuje v případě typu integrace Hostováno Samba.ai.

Vlastní výzva k odběru

V rámci integrace Push notifikací máte možnost vytvořit vlastní, personalizovanou výzvu k odběru Push notifikací. V rámci vlastní výzvy k odběru je možné upravit text, díky čemuž se okno stane nedílnou součástí Vašeho eshopu.

Úpravu okna naleznete pod záložkou Nastavení účtu > Rozšíření:

Po kliknutí na tlačítko „Upravit výzvu“ se Vám otevře dialogové okno, kde můžete upravit nejen obsah výzvy, ale také text samotných tlačítek.

Vlastní výzvu aktivujete přepínačem po levé straně:

Okno se po aktivaci zobrazí vždy po přistoupení na eshop. Je však třeba brát v potaz, že jakmile zákazník potvrdí zájem o Push notifikace, zobrazí se mu následně běžné okno k přihlášení k Push notifikacím – toto je správné chování, které je závislé na samotném webovém prohlížeči.

Více domén s jedním kořenovým adresářem

Pokud chcete využít integraci s vlastním hostingem a máte v rámci jednoho filehostingu více domén s jedním kořenovým adresářem (například pro .CZ a .SK), můžete využít pouze jednoho skriptu samba-sw.js. V takovém případě je třeba upravit obsah skriptu na následující:

switch (self.location.hostname) {
   case "domain1.com":
      importScripts("https://yottlyscript.com/push/service-worker.js?tp=*TRACKPOINT FOR DOMAIN1*");
      break;
   case "domain2.com":
      importScripts("https://yottlyscript.com/push/service-worker.js?tp=*TRACKPOINT FOR DOMAIN2*");
      break;
   .
   .
   .
}

Hodnotu zmíněného trackpointu můžete zjistit například po přihlášení do Samby přímo z adresního řádku, tedy například (tučně označená část je hodnota trackpointu):

https://enterprise.samba.ai/shop/123456789/dashboard

Věnujte pozornost doméně, kterou do skriptu použijete – www.domain.com není to samé jako domain.com. Doporučujeme proto pomocí konzole ověřit, co je vráceno jako hodnota self.location.hostname a to ve skriptu nastavit do podmínky.

Ujistěte se, že používáte v importScripts(...) vaší aktuální trackovací doménu.

This post is also available in: