Nasazení skriptu

Tato část příručky se zaměřuje na vystavení skriptu na zvolený web či do zvolené aplikace a doporučené postupy pro nasazení a konfiguraci skriptu.

1. Základní instalace

Na všechny stránky, na kterých chcete sledovat akce uživatelů, vložte následující úryvek před uzavírací tag </head> tag:

<script>
  (function (w, d, s, l, u, i) {
    w[l] = { project_url: u, project_id: i };
    var f = d.getElementsByTagName(s)[0];
    var j = d.createElement(s);
    var t = new Date().getTime();
    j.async = true;
    j.type = 'module';
    j.src = 'https://cdn.carecloud.cz/engagement/script.js?t=' + t;
    f.parentNode.insertBefore(j, f);
    w.ccce = w.ccce || [];
  })(window, document, 'script', 'ccce_config', '${YOUR_PROJECT_URL}', '${YOUR_EXTERNAL_APPLICATION_ID}');
</script>

Doporučení: Skript doporučujeme načítat pomocí Google Tag Manageru při současném zajištění správného nastavení cookies.

Doporučení

  • Skript se načítá Asynchronně (již nastaveno).
  • Úryvek vždy umístěte na konec sekce <head>, aby byla vytvořena fronta interakcí ccce
    • Nakonfigurujte vlastní hodnoty ${VAŠE_URL_PROJEKTU} a ${VAŠE_EXTERNÍ_ID_APLIKACE}.

2. IdentifIkace přihlášených uživatelů

Aby bylo možné propojit akce s konkrétním zákazníkem, je potřeba po přihlášení uživatele odeslat událost přihlášení.

  • Bez login eventu se data sbírají anonymně a pro relaci prohlížeče se vytvoří anonymní účet.
  • ⚠️ Událost přihlášení volejte pouze jednou.
<script type="text/javascript">
  window.addEventListener('load', function () {
    window.ccce = window.ccce || [];
    window.ccce.push({
      trigger: 'login',
      data: {
        contact_type: "customer_id",
        contact_value: `${CUSTOMER_ID}`
      }
    })
  });
</script>

Podporované hodnoty contact_type

  • customer_id → identifikátor zákazníka v systému CareCloud CRM & CDP. Příklad: 8f9de85354bdb777ae1482019b
  • email → e-mailová adresa zákazníka Příklad: info@carecloud.cz
  • phone → telefonní číslo zákazníka. Příklad: 420123456789

  • external_id → objekt ve formátu:

    {
"customer_source_id": "contact-source-id",
"external_id": "unique-id"
}

3. Bezpečnost a ochrana soukromí

Skript používá soubory COOKIES.

  • Transparentně informujte uživatele (cookie banner, zásady ochrany osobních údajů).
  • Nikdy neodesílejte citlivá data (hesla, tokeny).
  • Vždy používejte hashované identifikátory.
  • Dodržujte požadavky GDPR i platné místní legislativy.

4. Debugging a monitoring

  • Pro debuggování, můžete použít debugovací režim:

    w[l] = { project_url: u, project_id: i, debug: true };
  • Sledujte obsah window.ccce v konzoli prohlížeče.
  • Ověřte, že se události správně ukládají do CareCloud CRM & CDP.

5. Doporučený postup nasazení

  1. Vývoj – integrace s debug: true.
  2. Staging – ověření funkčnosti v předprodukčním prostředí s testovací instalací CareCloud CRM & CDP.
  3. Produkce (Production) – nastavte produkční project_url a project_id a vypněte debug režim.

6. Příklad použití external_id

<script type="text/javascript">
  window.addEventListener('load', function () {
    window.ccce = window.ccce || [];
    window.ccce.push({
      trigger: 'login',
      data: {
        contact_type: "external_id",
        contact_value: {
          customer_source_id: "eshop_system",
          external_id: "usr_123456789"
        }
      }
    })
  });
</script>

7. Sekce pro vývojáře

Testování v konzoli

Během vývoje můžete odesílat události přímo z konzole:

window.ccce.push({
  trigger: 'login',
  data: {
    contact_type: "email",
    contact_value: "test@example.com"
  }
});