> ## Documentation Index
> Fetch the complete documentation index at: https://docs.totemdigital.ro/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrarea Digimap Consent pe site, în OpenCart și în Google Tag Manager

> Unde puneți codul bannerului, cum îl integrați în OpenCart, cum configurați Google Tag Manager și cum blochează scripturile și videoclipurile până la acord.

Codul de instalare se află în panou, la site-ul dorit, în tab-ul **Integrare**. Are forma:

```html theme={null}
<script src="https://totemdigital.ro/digimap/consent/c.php?s=CHEIA_SITE-ULUI"></script>
```

> [!WARNING]
>
> Puneți codul **imediat după `<head>`**, înaintea codului Google Tag Manager sau gtag.js, și **fără** `async` sau `defer`. Scriptul trebuie să transmită valorile implicite către Google înainte ca etichetele Google să pornească.

## OpenCart 3

**1. Deschideți fișierul temei**

În File Manager, deschideți `catalog/view/theme/<tema>/template/common/header.twig`.

**2. Lipiți codul**

Lipiți codul imediat după tag-ul `<head>`. Dacă în fișier există scriptul Cookiebot (`consent.cookiebot.com/uc.js`), ștergeți-l.

**3. Reîmprospătați cache-ul**

În adminul OpenCart: **Dashboard → rotița din dreapta sus → Theme: Refresh**. Dacă folosiți OCMOD, și **Extensions → Modifications → Refresh**.

### Magazin multistore

Când mai multe magazine folosesc aceeași temă și vreți bannere separate, încărcați cheia potrivită pentru fiecare domeniu:

```twig theme={null}
{% if 'info-kiosk.ro' in base %}
<script src="https://totemdigital.ro/digimap/consent/c.php?s=CHEIA_INFO_KIOSK"></script>
{% else %}
<script src="https://totemdigital.ro/digimap/consent/c.php?s=CHEIA_TOTEMDIGITAL"></script>
{% endif %}
```

## Google Consent Mode v2

La încărcarea paginii, aplicația trimite toate categoriile cu valoarea `denied` (mai puțin `security_storage`). Dacă vizitatorul a ales deja, trimite imediat actualizarea. La fiecare decizie trimite `update` și evenimentul `dc_consent_update` în dataLayer, cu variabilele `dc_preferences`, `dc_statistics`, `dc_marketing` și `dc_consent_id`.

Etichetele Google din Tag Manager (Google Ads, GA4, Conversion Linker, Remarketing) respectă automat aceste semnale. În lipsă de acord, ele trimit semnale fără cookie-uri, iar Google modelează conversiile.

> [!NOTE]
>
> Ca advertiser (cumpărați reclame Google care aduc trafic pe site-ul dumneavoastră), Google cere transmiterea semnalelor Consent Mode v2 pentru vizitatorii din Spațiul Economic European, ceea ce face Digimap Consent. Cerința unui CMP certificat de Google cu IAB TCF se aplică site-urilor care **afișează** reclame Google (AdSense, Ad Manager, AdMob).

## Google Tag Manager

**1. Activați prezentarea consimțământului**

**Admin → Container Settings → Enable consent overview**.

**2. Scoateți Cookiebot**

Ștergeți eticheta sau șablonul **Cookiebot CMP** din container.

**3. Setați etichetele non-Google**

Pentru Meta Pixel, TikTok Pixel sau Clarity: **Advanced Settings → Consent Settings → Require additional consent** cu `ad_storage` (marketing) sau `analytics_storage` (statistici).

**4. Publică containerul**

Apăsați **Submit** și publicați versiunea.

Alternativ, folosiți un declanșator **Custom Event** cu numele `dc_consent_update` și condiția `dc_marketing` egal cu `true`.

### Compatibilitate cu Cookiebot

Când opțiunea **Compatibilitate Cookiebot** este bifată în **Setări**, aplicația trimite și evenimentele `cookie_consent_update`, `cookie_consent_statistics`, `cookie_consent_marketing` și `cookie_consent_preferences` și creează obiectul `window.Cookiebot`. Declanșatorii și scripturile făcute pentru Cookiebot funcționează în continuare.

## Blocarea scripturilor puse direct în temă

Schimbați `type` în `text/plain` și adăugați categoria. Scriptul pornește doar după acordul vizitatorului:

```html theme={null}
<script type="text/plain" data-dc-category="marketing">
  /* codul Meta Pixel */
</script>
<script type="text/plain" data-dc-category="statistics" src="https://exemplu.ro/analytics.js"></script>
```

Pentru mai multe categorii: `data-dc-category="statistics marketing"`. Atributul Cookiebot `data-cookieconsent` este recunoscut și el.

### Videoclipuri și hărți încorporate

```html theme={null}
<div class="dc-placeholder">Acceptați cookie-urile de marketing pentru a vedea videoclipul.</div>
<iframe data-dc-src="https://www.youtube-nocookie.com/embed/ID" data-dc-category="marketing" width="560" height="315"></iframe>
```

După acord, mesajul dispare și videoclipul se încarcă.

## Legătura din subsolul site-ului

Retragerea acordului trebuie să fie la fel de ușoară ca acordarea. Pe lângă butonul plutitor, adăugați în subsol:

```html theme={null}
<a href="#" onclick="DigimapConsent.settings();return false;">Setări cookie-uri</a>
```

## Verificarea

**1. Fereastră privată**

Deschideți site-ul într-o fereastră privată: bannerul trebuie să apară.

**2. Google Tag Assistant**

În [Tag Assistant](https://tagassistant.google.com/), la evenimentul **Consent**, trebuie să vedeți **Default: denied**, apoi după clic **Update: granted**.

**3. Google Ads**

În Google Ads, la **Obiective → Conversii → Diagnostic**, starea Consent Mode se actualizează în câteva zile.

## API JavaScript

| Comandă | Efect |
| - | - |
| `DigimapConsent.settings()` | Deschide fereastra de setări |
| `DigimapConsent.show()` | Afișează bannerul |
| `DigimapConsent.has('marketing')` | `true` sau `false` |
| `DigimapConsent.consent` | Obiect cu toate categoriile |
| `DigimapConsent.onChange(fn)` | Apelează `fn` la fiecare decizie |
| `DigimapConsent.withdraw()` | Retrage consimțământul |
| Evenimentul `dc:consent` | `window.addEventListener('dc:consent', ...)` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.