> ## Documentation Index
> Fetch the complete documentation index at: https://help.scribe-mail.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Śledzenie konwersji

> Śledź rejestracje, dema i zakupy w witrynie za pomocą Scribe JavaScript SDK i przypisuj każdą konwersję do podpisu e-mailowego, który ją wygenerował.

Śledzenie konwersji zamyka pętlę wokół twoich podpisów e-mailowych. Analityka podpisów pokazuje już wyświetlenia i kliknięcia. Dzięki Scribe JavaScript SDK rejestrujesz też, co dzieje się dalej we własnej witrynie — rejestracje, umówione dema i zakupy — i wiążesz każde z nich z podpisem, członkiem zespołu i linkiem, który je wywołał. To dno lejka: wyświetlenia, potem kliknięcia, potem konwersje.

W Scribe te konwersje nazywamy **zdarzeniami**. Rejestrujesz je kilkoma linijkami JavaScriptu, a Scribe przypisuje je automatycznie na podstawie tego samego śledzenia kliknięć, które zasila resztę twojej analityki.

<Note>
  Śledzenie konwersji jest dostępne w planach płatnych. Jeśli plan twojego Workspace go nie obejmuje, snippet śledzący niczego nie zarejestruje.
</Note>

## Jak to działa

1. Odbiorca klika link w jednym z twoich podpisów e-mailowych.
2. Scribe przekierowuje go do twojej witryny i dodaje parametr `scribe_click_id` do docelowego adresu URL.
3. Scribe SDK na twojej stronie docelowej odczytuje ten `scribe_click_id`, zapisuje go w kontekście first-party i dołącza do każdego rejestrowanego zdarzenia.
4. Gdy odwiedzający dokonuje konwersji, wywołujesz `scribe.track('signup')`. Scribe łączy zdarzenie z pierwotnym kliknięciem.

Efekt: widzisz, które podpisy, członkowie zespołu i klikane elementy przynoszą realne konwersje i przychód, a nie tylko kliknięcia. Atrybucja działa na poziomie nadawcy, podpisu i elementu, a Scribe dopasowuje konwersję do kliknięcia nawet 30 dni po jego wystąpieniu.

Jeśli zdarzenie przychodzi bez znanego `scribe_click_id` (ruch bezpośredni, wygasły link lub usunięty parametr), i tak zostaje zarejestrowane. Po prostu nie jest przypisane do kliknięcia.

## Zanim zaczniesz

Potrzebujesz trzech rzeczy:

* **Płatnego planu** obejmującego śledzenie konwersji.
* **Włączonego śledzenia** w twoim Workspace. To to samo ustawienie, które zasila statystyki wyświetleń i kliknięć podpisu. Włącz je dopiero po uzyskaniu niezbędnej zgody (zob. [Prywatność i zgody](#privacy-and-consent)).
* **Twojego Event Tracking ID.** To publiczny, niepoufny identyfikator twojego Workspace. Można go bezpiecznie umieścić w kodzie HTML strony.

<Steps>
  <Step title="Skopiuj swój Event Tracking ID">
    W Scribe otwórz **Settings**, przejdź do zakładki **Workspace** i skopiuj wartość spod pozycji **Event Tracking ID**. Przy okazji upewnij się, że **Tracking** jest włączony.
  </Step>

  <Step title="Dodaj SDK do swojej strony">
    Użyj fragmentu skryptu dla zwykłej strony lub pakietu npm dla aplikacji albo aplikacji jednostronicowej. Oba udostępniają to samo API `scribe.track(...)`.

    **Opcja A. Fragment skryptu.** Dodaj go na każdej stronie, którą chcesz śledzić, tuż przed zamykającym znacznikiem `</head>`. Fragment inicjalizuje się automatycznie z `data-workspace`, więc nie trzeba wywoływać `init()`.

    ```html theme={null}
    <!-- Scribe conversion tracking -->
    <script src="https://cdn-1.scribe-mail.com/v1/tracking.js"
            data-workspace="YOUR_EVENT_TRACKING_ID" async></script>
    ```

    **Opcja B. npm lub yarn.** Zainstaluj pakiet, a następnie zainicjalizuj go raz przy starcie aplikacji.

    ```bash theme={null}
    npm install @scribemail/js
    # or: yarn add @scribemail/js
    ```

    ```js theme={null}
    import scribe from '@scribemail/js';

    scribe.init({ id: 'YOUR_EVENT_TRACKING_ID' }); // once, at app startup
    ```

    Zaimportowanie modułu nie ma efektów ubocznych (jest bezpieczne dla renderowania po stronie serwera). Nic nie jest wysyłane, dopóki nie wywołasz `init()`.
  </Step>

  <Step title="Zarejestruj swoją pierwszą konwersję">
    Wywołaj `scribe.track` wszędzie tam, gdzie następuje konwersja, na przykład w obsłudze udanej rejestracji.

    ```js theme={null}
    scribe.track('signup', { value: 99.0, currency: 'USD', plan: 'pro' });
    ```

    SDK przechwytuje atrybucję kliknięcia Scribe z adresu URL strony docelowej, grupuje twoje zdarzenia w partie i niezawodnie je wysyła — również wtedy, gdy odwiedzający opuści stronę.
  </Step>

  <Step title="Sprawdź, czy działa">
    Wywołaj zdarzenie na swojej stronie, a następnie otwórz **Analytics** w Scribe. Konwersje pojawią się obok wyświetleń i kliknięć, w podziale na podpis, członka zespołu, kampanię i kraj.
  </Step>
</Steps>

## Dokumentacja SDK

### `scribe.track(name, metadata)`

Rejestruje zdarzenie. `name` jest wymagane, na przykład `signup`, `demo_booked` lub `purchase`.

```js theme={null}
scribe.track('purchase', {
  value: 149.0,           // optional, monetary value of the conversion
  currency: 'EUR',        // optional, ISO currency code
  event_id: 'order_8821', // optional, your own id, used for idempotency
  plan: 'team',           // any other key becomes an event "property"
  seats: 5
});
```

* `value`, `currency` i `event_id` to rozpoznawane pola najwyższego poziomu.
* **Każdy inny klucz** staje się częścią `properties` zdarzenia. Ograniczaj właściwości do płaskich wartości skalarnych (ciągi znaków, liczby, wartości logiczne). Nie umieszczaj w właściwościach danych osobowych, takich jak adresy e-mail czy numery telefonów: Scribe automatycznie odrzuca klucze wyglądające na dane osobowe.
* Podaj własny `event_id`, aby wysyłkę można było bezpiecznie ponowić. Ten sam `event_id` otrzymany dwukrotnie w ciągu 24 godzin zostanie zarejestrowany tylko raz.

### `scribe.identify(userId, traits)`

Wiąże odwiedzającego z jednym z twoich użytkowników, dzięki czemu widzisz, które podpisy pozyskują których klientów. Przydatne w pracy B2B i podejściu opartym na kontach.

```js theme={null}
scribe.identify('user_42', { email: 'ada@example.com', name: 'Ada', plan: 'pro' });
```

Po wywołaniu `identify` kolejne wywołania `track` są powiązane z tym użytkownikiem. Przy wylogowaniu wywołaj `scribe.reset()`, aby wyczyścić tożsamość.

### `scribe.flush()`

Zdarzenia są grupowane w partie i wysyłane automatycznie, zawsze przy ukrywaniu strony. Wywołuj `flush()` tylko wtedy, gdy potrzebujesz natychmiast wypchnąć bieżącą partię.

### Atrybuty snippetu

Gdy używasz snippetu skryptu, skonfiguruj go za pomocą atrybutów `data-*`:

| Atrybut              | Wymagany | Opis                                                                                            |
| -------------------- | -------- | ----------------------------------------------------------------------------------------------- |
| `data-workspace`     | Tak      | Twój identyfikator śledzenia zdarzeń.                                                           |
| `data-consent`       | Nie      | Ustaw na `"denied"`, aby wyłączyć magazyn własny do czasu wyrażenia zgody przez odwiedzającego. |
| `data-cookie-domain` | Nie      | Ustaw swoją domenę główną, aby współdzielić tożsamość między subdomenami.                       |

### Content Security Policy

Jeśli twoja witryna ustawia Content Security Policy, dodaj hosty Scribe do listy dozwolonych:

```
script-src  https://cdn-1.scribe-mail.com;
connect-src https://t.scribe-mail.com;
```

<Tip>
  Chcesz zapisać wiarygodne zdarzenie ze swojego backendu, na przykład płatność potwierdzoną przez serwer? Scribe przyjmuje zdarzenia także przez API, z kluczem `events:write`, dzięki czemu wartości przychodu pozostają zaufane, a nie dostarczane przez klienta. Szczegóły znajdziesz w [dokumentacji API](/api-reference/introduction).
</Tip>

## Zastosowania: zamień konwersje we wzrost

Śledzenie konwersji zamienia twoje podpisy e-mailowe w mierzalny kanał pozyskiwania klientów. Oto jak zespoły wykorzystują te dane, w tym zasilając nimi remarketing płatny.

### Prowadź kampanie remarketingowe w Google Ads i Meta Ads

Uruchom piksele konwersji platform reklamowych w tym samym miejscu, w którym wywołujesz `scribe.track` — jedna konwersja trafi jednocześnie do Scribe, Google Ads i Meta. Scribe informuje, że konwersja pochodzi z podpisu e-mailowego; Google i Meta wykorzystują ten sam sygnał do licytacji i tworzenia grup odbiorców.

```js theme={null}
function onSignupComplete(plan, price) {
  // 1. Attribute the conversion to the email signature that drove it
  scribe.track('signup', { value: price, currency: 'USD', plan });

  // 2. Send the same conversion to your ad platforms for bidding and audiences
  // gtag('event', 'conversion', { send_to: 'AW-XXXXXXXXX/abc', value: price, currency: 'USD' });
  // fbq('track', 'CompleteRegistration', { value: price, currency: 'USD' });
}
```

### Buduj grupy retargetingowe o wysokim zamiarze zakupowym

Osoby, które kliknęły w twój podpis i trafiły na witrynę, ale nie dokonały konwersji, są ciepłymi kontaktami. Użyj Scribe, aby potwierdzić ruch z podpisów e-mailowych, a następnie retargetuj tych odwiedzających dopasowaną ofertą w Google i Meta. Ponieważ ruch pochodzi z twoich własnych e-maili, te grupy zwykle konwertują lepiej niż zimne prospekty.

### Zasilaj grupy podobne (lookalike i similar) danymi osób, które dokonały konwersji

Najlepszą grupą źródłową są osoby, które już dokonały konwersji przez zaufany kanał. Pobierz odwiedzających pozyskanych przez podpisy e-mailowe (filtruj według podpisu, członka zespołu lub kampanii), wgraj ich jako Custom Audience w Meta lub listę Customer Match w Google Ads i zbuduj z tej wysokiej jakości próbki grupy Lookalike lub Similar.

### Wyklucz obecnych klientów z wydatków na pozyskiwanie

Przestań płacić za pozyskiwanie osób, które już się zarejestrowały lub coś kupiły. Wyeksportuj osoby, które dokonały konwersji, i dodaj je jako listę wykluczeń lub wstrzymań w kampaniach prospectingowych — budżet trafi wtedy do zupełnie nowych potencjalnych klientów.

### Optymalizuj pod kątem przychodu, nie samych kliknięć

Przekazuj rzeczywiste `value` oraz `currency` wraz z każdą konwersją. Z przypisanym przychodem możesz przełączyć Google i Meta na strategie ustalania stawek oparte na wartości, a w Scribe uszeregować podpisy e-mailowe, członków zespołu i kampanie według wygenerowanego przychodu, a nie samych kliknięć.

### Udowodnij skuteczność kanału i realokuj budżet

Śledzenie konwersji pozwala porównywać przychód z podpisów e-mailowych z płatnymi kanałami na tych samych zasadach. Gdy kampania w podpisie e-mailowym przewyższa płatną, masz twarde liczby, żeby przenieść budżet tam, gdzie działa.

## Poproś agenta AI o konfigurację

Nie musisz podłączać tego ręcznie. Jeśli korzystasz z asystenta AI do kodowania (np. Claude Code, Cursor lub podobnego agenta w edytorze), wklej mu prompt taki jak poniżej, z własnym Event Tracking ID i konwersjami, na których ci zależy:

```text theme={null}
Install the Scribe conversion tracking SDK on my website.

- If this is an app or single-page app, add the @scribemail/js package and call
  scribe.init({ id: 'YOUR_EVENT_TRACKING_ID' }) once at startup. If it is a plain
  HTML site, add the https://cdn-1.scribe-mail.com/v1/tracking.js script with
  data-workspace="YOUR_EVENT_TRACKING_ID" before </head> instead.
- Call scribe.track('signup', { value, currency }) from my signup success handler
  and scribe.track('purchase', { value, currency }) from my checkout confirmation.
- If I have logged-in users, call scribe.identify(userId, { email, plan }) after login.
- Add https://cdn-1.scribe-mail.com and https://t.scribe-mail.com to my Content
  Security Policy if I have one.
```

Gdy konwersje już spływają, agent podłączony do [serwera MCP Scribe](/pl/ai-agents/connect) odczyta i wyjaśni wyniki. Zapytaj go np. „które podpisy e-mailowe i którzy członkowie zespołu wygenerowali w tym miesiącu najwięcej konwersji i przychodu?“ albo „wypisz osoby odwiedzające, które pozyskały moje podpisy e-mailowe w tym tygodniu“. Zobacz [Scribe dla agentów AI](/pl/ai-agents) i [umiejętność analityczną Scribe](/pl/ai-agents/skills), aby sprawdzić, co asystent może pobrać.

## Prywatność i zgody

Śledzenie konwersji projektujemy z poszanowaniem osób odwiedzających i twoich obowiązków:

* **Adresy IP są anonimizowane.** Scribe haszuje adres IP przed zapisem. Surowe adresy IP nigdy nie są przechowywane.
* **Brak danych osobowych we właściwościach.** Klucze wyglądające na dane osobowe (e-mail, telefon, hasło, tokeny, numery kart i podobne) są automatycznie usuwane z właściwości zdarzeń. Użyj `identify`, gdy świadomie chcesz powiązać zdarzenie z użytkownikiem.
* **Przechowywanie zależne od zgody.** Ustaw `data-consent="denied"` (snippet) lub `consent: false` (npm `init`), aby SDK nie zapisywał identyfikatora kliknięcia, dopóki odwiedzający nie wyrazi zgody.
* **Uzyskaj zgodę przed włączeniem śledzenia.** Ustawienie śledzenia w Workspace wiąże się z taką samą odpowiedzialnością jak każdy piksel analityczny. Zanim je włączysz, upewnij się, że masz zgodę wymaganą w twoim regionie.

## Powiązane artykuły

* [Przegląd analityki](/pl/analytics-overview): wyświetlenia, kliknięcia, zasięg i CTR w całym Workspace.
* [Panel analityczny](/pl/analytics-dashboard): odczytuj konwersje obok wyświetleń i kliknięć w każdej zakładce.
* [Analityka podpisu](/pl/signature-analytics): skuteczność pojedynczego podpisu.
* [Kampanie marketingowe](/pl/marketing-overview): prowadź i mierz kampanie banerowe w podpisach.
* [Scribe dla agentów AI](/pl/ai-agents): pozwól asystentowi skonfigurować śledzenie i raportować konwersje.