Настройките на CDP: проследяване, API ключове, workspace и webhooks
Всяка настройка на CDP — скриптът за проследяване и профилът на сайта, ключовете за разработчици, страницата на workspace-а и webhooks, които пращат събития към вашите системи.
Настройките на CDP са в Configure → Settings, в три таба: Tracking & SDK, API Keys и Workspace. Webhooks имат своя страница в Activate → Webhooks. Промяната на ключове, интеграции и webhooks иска роля Admin в CDP; собствениците и администраторите на workspace-а я имат.
Tracking & SDK
Домейнът и видът на сайта, скриптът за проследяване, проверката, че работи, и Advanced tracking configuration — съгласие, бисквитки за поддомейните, кои събития за четене се пращат. Всичко е обяснено в Сайтовете в CDP: домейните, които ви пращат данни и Съгласие и бисквитки в сайта.
API Keys
Ключовете позволяват на други системи да говорят с CDP. Трябват ви само когато разработчик свързва нещо; услугите на Monfri говорят помежду си без тях.
API Keys — натиснете Create New API Key, дайте Name (например Production SDK) и Type:
- Write (SDK tracking) — праща събития навътре, като ключа в скрипта ви за проследяване;
- Read (API access) — чете данни навън.
External API Keys — за назована външна система, с точно това, което може да прави. Натиснете Create External API Key, въведете Name, Description (optional) и правата (Scopes): Profiles (Read), Events (Read), Segments (Read), Analytics (Read), Webhooks (Manage). Изберете поне едно — Select at least one scope.
Новият ключ се показва веднъж — копирайте го веднага. За да спрете ключ, натиснете Revoke key до него: Revoke this API key? This cannot be undone. Всичко, което го ползва, спира веднага, затова първо създайте заместника.
Workspace
General показва Workspace Name, Workspace ID, Slug и Plan. Members изрежда кой има достъп до CDP; хората се канят, променят и премахват в Monfri Hub — Manage in Monfri Hub. Вижте До какво има достъп всеки: достъп по услуги. Промяната важи от следващото отваряне на CDP от човека.
Workspace се изтрива в Hub, за всички услуги наведнъж, с 30 дни за възстановяване или експорт на данните — вижте Отказ, експорт на всичко, изтриване на workspace или акаунт.
Webhooks
Webhook праща събития от CDP към ваш адрес в момента, в който стават — например към ваша система или външен инструмент. Отворете Activate → Webhooks: Receive real-time notifications when events occur in your CDP.
- Въведете Name и Endpoint URL —
https://адрес на вашата система. - Под Subscribed Events изберете системните събития (System Events) — всички събития, получено или обработено събитие, създаден, слят или разпознат профил, влизане или излизане от сегмент, промяна на съгласие, завършен GDPR експорт или изтриване — и събития от данните ви (Track Events (from your data)).
- Задайте Max Retries и Timeout (ms) за бавен получател.
Всеки webhook има Secret: системата ви го ползва, за да провери, че обаждането наистина е от Monfri. Recent Deliveries показва всяко обаждане и резултата му. За да пускате потоци в Monfri от събития в CDP, webhook не ви трябва — Automation слуша CDP сам.
Ако нещо не работи
Не мога да създавам ключове или webhooks
Ролята ви в CDP не е Admin. Помолете собственик или администратор на workspace-а.
Webhook показва неуспешни доставки
Адресът ви не е отговорил навреме или е отговорил с грешка. Проверете дали е достъпен от интернет и отговаря бързо с успех; Monfri опитва отново до Max Retries пъти.
Система, която ползваше ключ, спря да работи
Ключът е отменен. Създайте нов ключ и го сложете в тази система.