> ## 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.

# Pelacakan konversi

> Lacak pendaftaran situs web, demo, dan pembelian dengan Scribe JavaScript SDK dan atribusikan setiap konversi kembali ke tanda tangan email yang mendorongnya.

Pelacakan konversi menutup siklus tanda tangan email Anda. Analitik tanda tangan sudah menampilkan tayangan dan klik. Dengan Scribe JavaScript SDK, Anda juga dapat merekam apa yang terjadi selanjutnya di situs web Anda sendiri — pendaftaran, demo yang dipesan, dan pembelian — lalu menautkan masing-masing kembali ke tanda tangan, rekan tim, dan link yang mendorongnya. Inilah bagian bawah funnel: tayangan, lalu klik, lalu konversi.

Di Scribe konversi ini disebut **event**. Anda merekamnya dengan beberapa baris JavaScript, dan Scribe mengatribusikannya secara otomatis menggunakan pelacakan klik yang sama yang menggerakkan sisa analitik Anda.

<Note>
  Pelacakan konversi tersedia pada paket berbayar. Jika paket ruang kerja Anda tidak menyertakannya, snippet pelacakan tidak akan merekam apa pun.
</Note>

## Cara kerjanya

1. Penerima mengklik link di salah satu tanda tangan email Anda.
2. Scribe mengalihkan mereka ke situs Anda dan menambahkan parameter `scribe_click_id` ke URL tujuan.
3. Scribe SDK di halaman landing Anda membaca `scribe_click_id` tersebut, menyimpannya sebagai first-party, dan melampirkannya ke setiap event yang Anda rekam.
4. Ketika pengunjung melakukan konversi, Anda memanggil `scribe.track('signup')`. Scribe menggabungkan event kembali ke klik asalnya.

Hasilnya: Anda dapat melihat tanda tangan, rekan tim, dan elemen yang diklik mana yang menghasilkan konversi dan pendapatan nyata, bukan sekadar klik. Atribusi bekerja pada tingkat pengirim, tanda tangan, dan elemen, dan Scribe mencocokkan konversi dengan klik hingga 30 hari setelah klik terjadi.

Jika sebuah event tiba tanpa `scribe_click_id` yang dikenal (trafik langsung, tautan yang kedaluwarsa, atau parameter yang terpotong), event tersebut tetap dicatat. Hanya saja, event tidak diatribusikan ke sebuah klik.

## Sebelum Anda mulai

Anda memerlukan tiga hal:

* **Paket berbayar** yang mencakup pelacakan konversi.
* **Pelacakan diaktifkan** untuk ruang kerja Anda. Ini adalah pengaturan yang sama dengan yang menjalankan analitik tayangan dan klik tanda tangan. Aktifkan hanya setelah Anda memperoleh persetujuan yang diperlukan (lihat [Privasi dan persetujuan](#privacy-and-consent)).
* **Event Tracking ID Anda.** Ini adalah pengenal publik dan non-rahasia untuk ruang kerja Anda. Aman untuk disematkan di HTML situs web Anda.

<Steps>
  <Step title="Salin Event Tracking ID Anda">
    Di Scribe, buka **Settings**, masuk ke tab **Workspace**, lalu salin nilai di bawah **Event Tracking ID**. Selagi di sana, pastikan **Tracking** sudah aktif.
  </Step>

  <Step title="Tambahkan SDK ke situs Anda">
    Gunakan cuplikan skrip untuk situs web biasa, atau paket npm untuk aplikasi atau single-page app. Keduanya memaparkan API `scribe.track(...)` yang sama.

    **Opsi A. Cuplikan skrip.** Tambahkan ini ke setiap halaman yang ingin Anda lacak, tepat sebelum tag `</head>` penutup. Cuplikan ini melakukan inisialisasi otomatis dari `data-workspace`, jadi tidak perlu memanggil `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>
    ```

    **Opsi B. npm atau yarn.** Instal paketnya, lalu inisialisasi sekali saat aplikasi dijalankan.

    ```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
    ```

    Mengimpor modul tidak memiliki efek samping (aman untuk server-side rendering). Tidak ada yang dikirim sampai Anda memanggil `init()`.
  </Step>

  <Step title="Catat konversi pertama Anda">
    Panggil `scribe.track` di mana pun konversi terjadi, misalnya di handler keberhasilan pendaftaran Anda.

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

    SDK menangkap atribusi klik Scribe dari URL landing untuk Anda, mengelompokkan event, dan mengirimkannya dengan andal, termasuk ketika pengunjung meninggalkan halaman.
  </Step>

  <Step title="Periksa apakah berfungsi">
    Picu event di situs Anda, lalu buka **Analytics** di Scribe. Konversi Anda muncul bersama tampilan dan klik, dipecah berdasarkan tanda tangan, rekan tim, kampanye, dan negara.
  </Step>
</Steps>

## Referensi SDK

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

Mencatat sebuah event. `name` wajib diisi, misalnya `signup`, `demo_booked`, atau `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`, dan `event_id` adalah field tingkat atas yang dikenali.
* **Setiap key lainnya** menjadi bagian dari `properties` event. Pertahankan properti sebagai nilai skalar datar (string, angka, boolean). Jangan masukkan data pribadi seperti email atau nomor telepon ke dalam properti: Scribe otomatis membuang key yang terlihat sebagai data pribadi.
* Sediakan `event_id` Anda sendiri agar pengiriman aman untuk diulang. `event_id` yang sama diterima dua kali dalam 24 jam hanya dicatat sekali.

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

Mengaitkan pengunjung dengan salah satu pengguna Anda sendiri, sehingga Anda dapat melihat tanda tangan mana yang memperoleh pelanggan mana. Berguna untuk kerja B2B dan berbasis akun.

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

Setelah panggilan `identify`, panggilan `track` berikutnya terikat pada pengguna tersebut. Panggil `scribe.reset()` saat logout untuk menghapus identitas.

### `scribe.flush()`

Event dikelompokkan dan dikirim otomatis, dan selalu saat halaman disembunyikan. Panggil `flush()` hanya jika Anda perlu memaksa batch saat ini keluar segera.

### Atribut snippet

Ketika Anda menggunakan snippet skrip, konfigurasikan dengan atribut `data-*`:

| Atribut              | Wajib | Deskripsi                                                                                                 |
| -------------------- | ----- | --------------------------------------------------------------------------------------------------------- |
| `data-workspace`     | Ya    | Event Tracking ID Anda.                                                                                   |
| `data-consent`       | Tidak | Setel ke `"denied"` untuk menonaktifkan penyimpanan first-party hingga pengunjung memberikan persetujuan. |
| `data-cookie-domain` | Tidak | Setel domain apex Anda untuk berbagi identitas antar subdomain.                                           |

### Content Security Policy

Jika situs Anda menerapkan Content Security Policy, izinkan host Scribe berikut:

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

<Tip>
  Perlu merekam event otoritatif dari backend Anda, misalnya pembayaran yang sudah dikonfirmasi server? Scribe juga menerima event melalui API dengan API key `events:write`, sehingga nilai pendapatan tetap tepercaya dan tidak bergantung pada data dari klien. Lihat [Referensi API](/api-reference/introduction) untuk detailnya.
</Tip>

## Kasus penggunaan: ubah konversi menjadi pertumbuhan

Pelacakan konversi mengubah tanda tangan email Anda menjadi kanal akuisisi yang terukur. Berikut cara tim memanfaatkan datanya, termasuk mengalirkannya ke remarketing berbayar.

### Jalankan kampanye remarketing di Google Ads dan Meta Ads

Picu pixel konversi platform iklan Anda di tempat yang sama saat memanggil `scribe.track`, sehingga satu konversi masuk ke Scribe, Google Ads, dan Meta sekaligus. Scribe memberi tahu bahwa konversi berasal dari tanda tangan email; Google dan Meta menggunakan sinyal yang sama untuk bidding dan audiens.

```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' });
}
```

### Bangun audiens retargeting bernilai tinggi

Orang yang mengeklik tanda tangan Anda dan sampai di situs, tetapi belum konversi, adalah audiens hangat. Gunakan Scribe untuk memastikan trafik berasal dari tanda tangan, lalu targetkan ulang pengunjung tersebut dengan penawaran khusus di Google dan Meta. Karena trafik berasal dari email Anda sendiri, audiens ini cenderung berkonversi lebih baik daripada prospek dingin.

### Kembangkan audiens lookalike dan similar dari pengunjung yang sudah konversi

Audiens dasar terbaik adalah orang yang sudah berkonversi melalui kanal tepercaya. Ambil pengunjung yang diperoleh dari tanda tangan (filter berdasarkan tanda tangan, rekan tim, atau kampanye), unggah sebagai Custom Audience di Meta atau daftar Customer Match di Google Ads, dan bangun audiens Lookalike atau Similar dari basis berkualitas tinggi tersebut.

### Kecualikan pelanggan yang sudah ada dari belanja akuisisi

Berhenti membayar untuk mengakuisisi orang yang sudah mendaftar atau membeli. Ekspor pengguna yang sudah berkonversi dan tambahkan mereka sebagai daftar pengecualian atau supresi pada kampanye prospeksi Anda, sehingga anggaran mengalir ke prospek baru.

### Optimalkan untuk pendapatan, bukan sekadar klik

Kirimkan `value` dan `currency` yang riil pada setiap konversi. Dengan data pendapatan yang menyertai, Anda dapat mengalihkan Google dan Meta ke value-based bidding, dan di Scribe Anda dapat memeringkat tanda tangan email, rekan tim, dan kampanye berdasarkan pendapatan yang dihasilkan, bukan hanya klik.

### Buktikan performa kanal dan realokasikan anggaran

Pelacakan konversi memungkinkan Anda membandingkan pendapatan dari tanda tangan email dengan kanal berbayar Anda dalam parameter yang sama. Ketika kampanye tanda tangan mengungguli kampanye berbayar, Anda punya angka untuk mengalihkan anggaran ke yang benar-benar berhasil.

## Minta agen AI menyiapkannya

Anda tidak perlu menyusun ini secara manual. Jika Anda memakai asisten coding AI (seperti Claude Code, Cursor, atau agen serupa di editor Anda), tempelkan prompt seperti ini, dengan Event Tracking ID milik Anda sendiri dan konversi yang Anda pedulikan:

```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.
```

Setelah konversi mulai mengalir, agen yang terhubung ke [server MCP Scribe](/id/ai-agents/connect) dapat membaca dan menjelaskan hasilnya untuk Anda. Tanyakan hal seperti "tanda tangan dan rekan tim mana yang menghasilkan konversi dan pendapatan terbanyak bulan ini?" atau "tampilkan pengunjung yang diakuisisi tanda tangan email saya minggu ini." Lihat [Scribe untuk agen AI](/id/ai-agents) dan [skill analitik Scribe](/id/ai-agents/skills) untuk mengetahui apa yang bisa diambil asisten Anda.

## Privasi dan persetujuan

Pelacakan konversi dirancang untuk menghormati pengunjung Anda dan kewajiban Anda:

* **Alamat IP dianonimkan.** Scribe melakukan hash pada IP sebelum menyimpannya. IP mentah tidak pernah disimpan.
* **Tidak ada data pribadi dalam properti.** Kunci yang tampak sebagai data pribadi (email, nomor telepon, kata sandi, token, nomor kartu, dan sejenisnya) otomatis dihapus dari properti peristiwa. Gunakan `identify` jika Anda memang ingin mengaitkan seorang pengguna.
* **Penyimpanan berbasis persetujuan.** Atur `data-consent="denied"` (snippet) atau `consent: false` (npm `init`) agar SDK tidak menyimpan pengenal klik sampai pengunjung Anda memberikan persetujuan.
* **Dapatkan persetujuan sebelum mengaktifkan pelacakan.** Pengaturan pelacakan ruang kerja memiliki tanggung jawab yang sama dengan piksel analitik mana pun. Pastikan Anda memiliki persetujuan yang dipersyaratkan di wilayah Anda sebelum mengaktifkannya.

## Artikel terkait

* [Ringkasan Analitik](/id/analytics-overview): tampilan, klik, jangkauan, dan CTR di seluruh ruang kerja Anda.
* [Dashboard Analitik](/id/analytics-dashboard): baca konversi bersama tampilan dan klik di setiap tab.
* [Analitik tanda tangan](/id/signature-analytics): performa untuk tanda tangan individual.
* [Kampanye Pemasaran](/id/marketing-overview): jalankan dan ukur kampanye banner di dalam tanda tangan.
* [Scribe untuk agen AI](/id/ai-agents): biarkan asisten menyiapkan pelacakan dan melaporkan konversi.