# 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í**.&#x20;
{% 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://napoveda.rocketoo.cz/rocketoo/rozsireni/boldem.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
