PrestaShop

Модул CookiePilot за PrestaShop с Consent Mode v2

Качете един ZIP файл през Module Manager, свържете домейна на магазина и модулът ще зарежда банера за съгласие в head на всяка страница. Поддържат се версии на PrestaShop от 8.0.0 до 9.99.99.

Изисквания и поддържани версии

  • PrestaShop от версия 8.0.0 до 9.99.99.
  • Достъп до административния панел с право за инсталиране на модули.
  • Акаунт в CookiePilot. Можете да се регистрирате, да потвърдите имейла си и да влезете директно от модула.
  • ZIP файлът на модула, версия 1.0.0, изтеглен от връзката по-долу. Не го разархивирайте.

Изтегляне на модула

ZIP файлът се предоставя от приложението CookiePilot на посочения по-долу адрес, а не чрез външен marketplace. След изтеглянето сравнете контролната сума SHA-256 с публикуваната стойност, за да потвърдите, че файлът не е променян.

Размер: 228.8 KBSHA-256: 9ac5668263574e760e6f860a4a939c3ee67445d15624e02f6b03d14e5fdb95d9
Изтегляне на ZIP файла

В Linux или macOS изпълнете командата по-долу. В Windows използвайте certutil -hashfile за изтегления файл. Резултатът трябва да съвпада точно с публикуваната стойност.

tmp=$(mktemp)
trap 'rm -f "$tmp"' EXIT
curl -fsSL https://app.cookiepilot.io/downloads/cookiepilot-prestashop-addons-1.0.0.zip -o "$tmp"
echo "9ac5668263574e760e6f860a4a939c3ee67445d15624e02f6b03d14e5fdb95d9  $tmp" | sha256sum --check

Инсталиране на ZIP файла през Module Manager

  1. 1.В административния панел отворете Modules, след това Module Manager и изберете Upload a module.
  2. 2.Поставете изтегления ZIP файл в прозореца за качване. PrestaShop ще го инсталира под името CookiePilot CMP.
  3. 3.Изберете Configure при CookiePilot CMP, за да отворите страницата за настройки.
  4. 4.Ако качването бъде отхвърлено, проверете дали версията на PrestaShop е между 8.0.0 и 9.99.99 и дали ZIP файлът е оригинален и непроменен.

Регистрация, потвърждение на имейла и свързване на магазина

  1. 1.В страницата за настройки създайте акаунт в CookiePilot или влезте в съществуващ. За регистрацията са нужни имейл адрес и парола.
  2. 2.Отворете писмото за потвърждение. След потвърждаване на адреса модулът завършва влизането.
  3. 3.Свържете магазина. Модулът автоматично създава домейна в акаунта ви или се свързва отново със съществуващ домейн със същото име на хост.
  4. 4.В панела Shop connection се показват свързаният домейн, акаунтът, текущият план и състояние CONNECTED.

Къде се добавя скриптът

  1. 1.Модулът добавя скрипта на CookiePilot в head на всяка страница на магазина точно веднъж и преди аналитичните тагове. Не е нужно да променяте темата, а дублирани hooks не добавят второ копие.
  2. 2.Премахнете ръчно добавен CookiePilot snippet или друг банер за съгласие от темата и tag container. Два слоя за съгласие си пречат и повреждат измерването.
  3. 3.Панелът Storefront status съдържа превключвател Enable CookiePilot banner and Consent Mode, чрез който проверявате дали скриптът се зарежда.

Съответствие с Consent Mode v2

  1. 1.Модулът задава началните стойности на Google Consent Mode v2 като denied, преди посетителят да направи избор. Съхранението за анализи и маркетинг остава отказано до получаване на съгласие.
  2. 2.Accept All разрешава всички категории. Reject All ги оставя като denied. При подробен избор се разрешават само категориите, избрани от посетителя.
  3. 3.Допълнителните статични и динамични скриптове, регистрирани в модула, се блокират и освобождават по същите категории.

Работа в multistore

  1. 1.При multistore настройките се пазят отделно за всеки магазин. Всеки магазин свързва свой домейн и използва собствени ключове.
  2. 2.Нов магазин не наследява ключовете на основния магазин. Отворете настройките на модула в контекста на всеки магазин и го свържете отделно.

Проверка на dataLayer в конзолата

Отворете магазина в частен прозорец, стартирайте конзолата и поставете кода по-долу. Преди избор трябва да има един default запис със стойности denied, а след избора трябва да се появи update с разрешените категории.

(window.dataLayer || []).forEach(function (entry) {
  if (entry && entry[0] === 'consent') {
    console.log(entry[1], entry[2]);
  }
});

Тестове на тракерите в пет състояния

Изпълнете всеки тест в нова частна сесия с отворен раздел Network. Модулът е проверен спрямо тези пет приемателни теста.

Преди съгласие: докато банерът е отворен, няма заявки за анализи или маркетинг и не се записват проследяващи cookies.
Само анализи: разрешете единствено аналитичната категория. Аналитичните заявки започват, а маркетинговите заявки и cookies остават блокирани.
Само маркетинг: разрешете единствено маркетинга. Маркетинговите тагове могат да се задействат, докато analytics storage остава denied.
Accept All: разрешените категории се стартират и dataLayer съдържа consent update със стойности granted.
Reject All: магазинът, количката и checkout продължават да работят, а тракерите остават бездействащи и след презареждане.

Meta Pixel и TikTok Pixel не разчитат Consent Mode, затова Consent Mode v2 сам по себе си не ги спира. Покрийте ги с автоматичното блокиране на модула или с event gating след маркетингово съгласие.

Деактивиране, деинсталиране и повторно инсталиране

Деактивирането премахва скрипта на CookiePilot от магазина, без да променя домейна в акаунта ви.

Деинсталирането изтрива локалните тайни и hooks от базата данни. То не изтрива отдалечения домейн или съхранените доказателства за съгласие.

Можете да инсталирате модула отново и да свържете същия домейн. Модулът се закача към съществуващия домейн, вместо да създава дубликат.

Отстраняване на проблеми

Банерът не се показва след инсталиране

Изчистете кеша на PrestaShop от Advanced Parameters, Performance и кеша на CDN, ако използвате такъв. Кешираният HTML може да е създаден преди активирането.

Два банера или противоречиво състояние

Премахнете ръчно поставените snippets от темата, hosting tools и tag containers. Трябва да работи само един слой за съгласие, а модулът вече го добавя веднъж.

Тракерите се стартират преди банера

Тема или друг модул зарежда GA4, Meta или TikTok извън слоя за съгласие. Преместете таговете зад автоматичното блокиране или настройка, управлявана от съгласието.

Настройки с Google Tag Manager

Оставете модула като единствен източник на съгласие. Обвържете всеки GTM таг с правилното състояние и не добавяйте втори CookiePilot loader в контейнера.

Заявките към Meta или TikTok продължават

Тези pixels пренебрегват Consent Mode. Проверете автоматичното блокиране или event gating и преместете ръчно добавения pixel зад маркетинговото съгласие.

Модулът в реален магазин

Инсталирайте модула и тествайте магазина

Изтеглете ZIP файла, свържете домейна и изпълнете петте теста в чиста сесия. Цялата настройка се извършва в административния панел.