> For the complete documentation index, see [llms.txt](https://napoveda.rocketoo.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://napoveda.rocketoo.cz/rocketoo/rozsireni/boldem.md).

# Boldem

Modul **Boldem** propojuje váš e-shop s chytrým nástrojem pro e-mail marketing. Umožňuje vám:

* Automaticky ukládat e-mailové adresy zákazníků do [Boldem](https://www.boldem.cz/)
* Spravovat newsletter registrace
* Sledovat chování návštěvníků na e-shopu
* Měřit efektivitu e-mail kampaní
* Segmentovat zákazníky podle jejich aktivit

## Co je Boldem?

Boldem je komplexní služba pro e-mail marketing, která pomáhá firmám:

* Sbírat data o chování zákazníků
* Vytvářet personalizované e-mailové kampaně
* Zvyšovat konverze díky přesnějšímu cílení
* Automatizovat marketingové aktivity

### Kde najdu modul?

{% hint style="info" %}
Modul je nutné nejprve nainstalovat ve **Správci rozšíření**. 
{% endhint %}

V hlavním menu administrace klikněte na **Nastavení** a poté vyberte **Boldem** v sekci rozšíření.

## Základní nastavení

### Krok 1: Získání API přístupů

{% stepper %}
{% step %}

### Získání API přístupů

Než začnete používat modul, potřebujete získat přístupové údaje od Boldem:

* Přihlaste se do svého účtu na [Boldem.cz](https://boldem.cz/)
* Přejděte do sekce **API** nebo **Nastavení**
* Vytvořte nové API přístupy nebo si zkopírujte existující

Poznamenejte si:

* **Client ID** (Klíč API / ID klienta)
* **Client Secret** (Tajný klíč klienta)
  {% endstep %}

{% step %}

### Nastavení v administraci

* V administraci e-shopu klikněte na **Nastavení**
* Najděte a otevřete **Boldem**
* V sekci **Nastavení** vyplňte:
  * **Klíč API (ID klienta)** - vložte Client ID z Boldem
  * **Tajný klíč klienta** - vložte Client Secret z Boldem
    {% endstep %}

{% step %}

### Výběr mailového seznamu

Po zadání správných přístupových údajů:

* Uložte nastavení (tlačítko **Uložit**)
* Po chvíli se načte seznam vašich mailových seznamů z Boldem
* V poli **Seznam příjemců** vyberte seznam, do kterého se mají ukládat e-maily
* Znovu uložte nastavení
  {% endstep %}

{% step %}

### Aktivace modulu

* Zaškrtněte možnost **Ukládat e-mailové adresy zákazníků do Boldem**
* Uložte nastavení

Modul je nyní aktivní.
{% endstep %}
{% endstepper %}

## Newsletter a správa kontaktů

### Automatická registrace při objednávce

Když zákazník při vytváření objednávky zaškrtne souhlas s odběrem newsletteru:

* E-mailová adresa se automaticky odešle do Boldem
* Kontakt se přidá do vybraného mailového seznamu
* Uloží se základní informace:
  * Křestní jméno
  * Příjmení
  * E-mail

### Registrace přes newsletter formulář

Pokud zákazník vyplní samostatný formulář pro přihlášení k odběru:

* E-mail se automaticky synchronizuje s Boldem
* Kontakt se přidá do mailového seznamu
* V Boldem můžete následně spravovat tento kontakt a posílat mu kampaně

### Odhlášení z newsletteru

Když se zákazník odhlásí z odběru newsletteru:

* V e-shopu se změní nastavení jeho účtu
* Kontakt se automaticky odstraní z Boldem
* Zákazník přestane dostávat e-maily z kampaní

## Měření a tracking

### Co je Boldem tracking?

Tracking (měření) umožňuje sledovat aktivitu návštěvníků na vašem e-shopu:

* Zobrazené produkty
* Přidání produktů do košíku
* Dokončené objednávky
* Návratnost zákazníků

Tato data pomáhají:

* Lépe cílit e-mailové kampaně
* Posílat personalizované nabídky
* Reagovat na opuštěné košíky
* Analyzovat efektivitu kampaní

### Získání tracking kódu

Pro zapnutí měření potřebujete tracking kód z Boldem:

* Přihlaste se do administrace Boldem
* Najděte tracking kód (obvykle v sekci **Měření** nebo **Tracking**)

V kódu najdete dva parametry:

* **uc** - číselný identifikátor (např. 846947)
* **wg** - textový identifikátor (např. 241c53c9-8a12-432c-b140-3ac7d2436604)

### Nastavení trackingu v e-shopu

{% stepper %}
{% step %}

### Zapnutí měření

* V nastavení Boldem modulu přejděte do sekce **Měření**
* Zaškrtněte **Zapnout měření**
  {% endstep %}

{% step %}

### Vyplnění parametrů

* Vyplňte pole:
  * **Boldem UC** - zadejte hodnotu parametru "uc"
  * **Boldem WG** - zadejte hodnotu parametru "wg"
* Uložte nastavení
  {% endstep %}
  {% endstepper %}

### Co se začne sledovat?

Po aktivaci trackingu se automaticky měří:

Zobrazení stránek:

* Na každé stránce se načte tracking kód
* Boldem zaznamená návštěvu stránky
* Pokud je zákazník přihlášen, zaznamená se jeho e-mail

Přidání do košíku:

* Při přidání produktu do košíku se odešle událost
* Zaznamenává se:
  * Název produktu
  * SKU (kód produktu)
  * Cena
  * Měna

Dokončení objednávky:

* Po úspěšném dokončení objednávky se odešle událost
* Zaznamenává se:
  * Číslo objednávky
  * E-mail zákazníka
  * Telefon zákazníka
  * Celková hodnota objednávky
  * Seznam zakoupených produktů včetně cen

### Využití naměřených dat

V administraci Boldem můžete:

* Prohlížet aktivity jednotlivých zákazníků
* Vytvářet segmenty podle chování
* Nastavit automatické kampaně (např. při opuštění košíku)
* Analyzovat, které produkty zákazníky nejvíce zajímají
* Měřit ROI (návratnost investic) jednotlivých kampaní

## Import existujících zákazníků

### Co je import zákazníků?

Import umožňuje jednorázově přenést všechny stávající zákazníky z e-shopu do Boldem. Je užitečný při:

* První instalaci modulu
* Přechodu z jiného nástroje na Boldem
* Potřebě synchronizovat historická data

### Kdy provést import?

Import doporučujeme provést:

* Po dokončení základního nastavení modulu
* Před spuštěním první e-mail kampaně
* Pouze jednou (opakovaný import přidá kontakty znovu)

### Jak provést import?

{% stepper %}
{% step %}

### Kontrola před importem

Ujistěte se, že máte správně nastavené:

* API klíče (Client ID a Client Secret)
* Vybraný mailový seznam
* Zapnuté ukládání e-mailů do Boldem
  {% endstep %}

{% step %}

### Spuštění importu

* V nastavení Boldem modulu přejděte do sekce **Jednorázový import zákazníků**
* Přečtěte si upozornění:
  * Import přenese všechny zákazníky, kteří mají souhlas s newsletterem
  * Proces může trvat několik minut u velkého množství zákazníků
  * Nelze jednoduše vrátit zpět
* Klikněte na tlačítko **Importovat do Boldemu**
  {% endstep %}

{% step %}

### Dokončení a kontrola

* Vyčkejte na dokončení:
  * Zobrazí se zpráva "Zákazníci se importují..."
  * Po dokončení se zobrazí potvrzení "Zákazníci byli úspěšně naimportováni"
    {% endstep %}
    {% endstepper %}

### Co se importuje?

Pro každého zákazníka, který má souhlas s newsletterem, se přenese:

* E-mailová adresa
* Křestní jméno
* Příjmení
* Informace o registraci
* Informace o objednávkách (zda zákazník již nakoupil)

### Řešení problémů při importu

Import se nespustí:

* Zkontrolujte, zda jsou správně vyplněny API klíče
* Ověřte, že je vybraný mailový seznam
* Ujistěte se, že je modul aktivní

Import proběhl, ale kontakty chybí:

* Zkontrolujte, zda máte v e-shopu zákazníky se souhlasem s newsletterem
* Ověřte v Boldem, že prohlížíte správný mailový seznam
* Kontaktujte podporu Boldem pro kontrolu API logů

Import trval příliš dlouho:

* Import velkého množství kontaktů (1000+) může trvat několik minut
* Pokud import trvá déle než 10 minut, aktualizujte stránku a zkontrolujte Boldem

## Často kladené otázky

### Obecné otázky

<details>

<summary><strong>Je modul zdarma?</strong></summary>

Modul je součástí Rocketoo. Za služby Boldem (e-mail marketing) se platí podle zvoleného tarifu na Boldem.cz.

</details>

<details>

<summary><strong>Potřebuji účet na Boldem?</strong></summary>

Ano, pro použití modulu potřebujete aktivní účet na Boldem.cz a platné API přístupy.

</details>

<details>

<summary><strong>Mohu modul kdykoliv vypnout?</strong></summary>

Ano, jednoduše odškrtněte možnost "Ukládat e-mailové adresy zákazníků do Boldem" v nastavení.

</details>

<details>

<summary><strong>Co se stane s daty v Boldem, když modul vypnu?</strong></summary>

Kontakty a data zůstanou v Boldem. Pouze se přestane automatická synchronizace nových zákazníků.

</details>

### API a připojení

<details>

<summary><strong>Kde získám API klíče?</strong></summary>

Přihlaste se na Boldem.cz a v nastavení účtu najdete sekci API, kde můžete vygenerovat přístupové údaje.

</details>

<details>

<summary><strong>Je spojení zabezpečené?</strong></summary>

Ano, veškerá komunikace mezi e-shopem a Boldem probíhá šifrovaně přes HTTPS protokol.

</details>

<details>

<summary><strong>Jak poznám, že je modul správně připojen?</strong></summary>

Po zadání správných API klíčů se v poli "Seznam příjemců" načte seznam vašich mailových seznamů z Boldem.

</details>

<details>

<summary><strong>Co když se mailové seznamy nenačtou?</strong></summary>

Zkontrolujte správnost API klíčů. Pokud problém přetrvává, může být dočasný výpadek API Boldem nebo neplatné přístupové údaje.

</details>

### Newsletter a kontakty

<details>

<summary><strong>Automaticky se přidají všichni zákazníci?</strong></summary>

Ne, přidávají se pouze zákazníci, kteří souhlasili s odběrem newsletteru (zaškrtli checkbox při objednávce nebo registraci).

</details>

<details>

<summary><strong>Co když zákazník změní e-mail?</strong></summary>

Při příští aktivitě se vytvoří nový kontakt s novým e-mailem. Starý e-mail zůstává v seznamu, dokud ho ručně nesmažete v Boldem.

</details>

<details>

<summary><strong>Mohu v Boldem upravovat kontakty?</strong></summary>

Ano, kontakty v Boldem můžete libovolně upravovat, přesouvat mezi seznamy, segmentovat a spravovat.

</details>

<details>

<summary><strong>Přenáší se i zákaznická historie?</strong></summary>

Modul přenáší základní informace (jméno, e-mail) a informaci o registraci. Detailní nákupní historie se přenáší pouze při zapnutém trackingu.

</details>

### Tracking a měření

<details>

<summary><strong>Je tracking nutný pro funkci modulu?</strong></summary>

Ne, tracking je volitelný. Newsletter registrace funguje i bez něj. Tracking přidává pokročilé funkce měření.

</details>

<details>

<summary><strong>Ovlivní tracking rychlost e-shopu?</strong></summary>

Ne, tracking kód je optimalizovaný a načítá se asynchronně, takže neovlivňuje rychlost stránky.

</details>

<details>

<summary><strong>Vidí zákazníci tracking kód?</strong></summary>

Tracking kód se načte v pozadí, zákazníci ho nevidí. Je to standardní marketingový nástroj podobný Google Analytics.

</details>

<details>

<summary><strong>Jsou data v souladu s GDPR?</strong></summary>

Ano, modul označuje tracking jako marketingový script, který se načte pouze se souhlasem zákazníka s cookies.

</details>

<details>

<summary><strong>Co se měří u nepřihlášených návštěvníků?</strong></summary>

U nepřihlášených návštěvníků se měří anonymní návštěvy stránek. Po přihlášení nebo zadání e-mailu se aktivity propojí s konkrétním kontaktem.

</details>

### Import zákazníků

<details>

<summary><strong>Mohu import opakovat?</strong></summary>

Technicky ano, ale nedoporučujeme. Opakovaný import přidá kontakty znovu. Pro synchronizaci používejte automatickou registraci.

</details>

<details>

<summary><strong>Kolik zákazníků se importuje?</strong></summary>

Importují se všichni zákazníci, kteří mají v e-shopu zaškrtnutý souhlas s newsletterem.

</details>

<details>

<summary><strong>Jak dlouho trvá import?</strong></summary>

Záleží na počtu zákazníků. Orientačně: 100 kontaktů = 1 minuta, 1000 kontaktů = 5-10 minut.

</details>

<details>

<summary><strong>Co když import selže?</strong></summary>

Zkontrolujte připojení k internetu a platnost API klíčů. Pokud problém přetrvává, kontaktujte podporu.

</details>

### Řešení problémů

<details>

<summary><strong>Kontakty se nepřidávají do Boldem</strong></summary>

Zkontrolujte:

* Je modul aktivní? (zaškrtnuto "Ukládat e-mailové adresy")
* Jsou správně vyplněny API klíče?
* Je vybraný mailový seznam?
* Má zákazník souhlas s newsletterem?

</details>

<details>

<summary><strong>Tracking nefunguje</strong></summary>

Zkontrolujte:&#x20;

* Je zapnuté měření? (zaškrtnuto "Zapnout měření")
* Jsou vyplněny parametry UC a WG?
* Jsou parametry správně zkopírovány z Boldem?
* Je na e-shopu povolen souhlas s marketingovými cookies?

</details>

<details>

<summary><strong>Zobrazuje se chyba připojení</strong></summary>

Nejčastější příčiny:&#x20;

* Špatně zadané API klíče (zkontrolujte, zda neobsahují mezery na začátku/konci)
* API přístupy byly zneplatněny v Boldem
* Dočasný výpadek služby Boldem

</details>

<details>

<summary><strong>E-maily se duplikují v Boldem</strong></summary>

Boldem automaticky sloučí duplicitní e-maily. Pokud problém přetrvává, zkontrolujte nastavení režimu přepsání kontaktů v Boldem.

</details>