Pelacakan · Email API

Lacak email API Anda

Tambahkan beberapa field ke pengiriman yang sudah Anda lakukan. Anda mendapatkan open, klik, unsubscribe satu klik, dan setiap penerima tersimpan sebagai kontak — tanpa perlu membuat apa pun dulu.

POST mail.sendcorex.com/v3.0/send

Field-field

Semuanya opsional. Tambahkan di samping to, from, subject dan body — gunakan hanya yang Anda butuhkan.

trackstring

Nama pengelompokan email-email ini di Analytics.

  • Dibuat pada pengiriman pertama — tidak ada yang perlu disiapkan sebelumnya.
  • Nama sama, track sama: huruf besar/kecil dan spasi berlebih tidak berpengaruh ("Welcome Email" = "welcome email").
  • Hingga 100 karakter. Gunakan satu per jenis email, misalnya "Welcome" atau "Invoice".
"track": "Weekly Newsletter"
track_opensboolean

Menghitung siapa yang membuka email.

  • Menambahkan pixel tak terlihat ke HTML.
  • Open otomatis (privasi Apple Mail, pemindai keamanan) dihitung terpisah — tidak pernah menggelembungkan open rate Anda.
  • Tanpa track, open tetap disimpan di kontak, hanya tidak dikelompokkan di Analytics.
"track_opens": true
track_clicksboolean

Menghitung siapa yang mengklik setiap tautan.

  • Tautan di body melewati Sendcorex dan langsung dialihkan ke halaman Anda.
  • Anda melihat tautan teratas dan kontak mana yang mengkliknya.
"track_clicks": true
unsubscribeboolean

Gunakan tautan unsubscribe Sendcorex.

  • Letakkan [unsubscribe] di body (atau [unsubscribe_url], [unsub_url], [opt_out_url]). Setiap penerima mendapat tautan pribadi.
  • Juga menambahkan header List-Unsubscribe dan one-click yang diminta Gmail dan Yahoo. List-Unsubscribe yang Anda kirim sendiri akan diabaikan.
  • Siapa pun yang berhenti berlangganan tidak lagi menerima email dari seluruh akun Anda: kampanye, API, dan SMTP.
  • true tanpa placeholder mengembalikan MISSING_UNSUBSCRIBE_PLACEHOLDER dan tidak ada yang dikirim.
"unsubscribe": true
contact_liststring

Daftar kontak tempat penerima disimpan.

  • Dibuat jika belum ada. Tanpanya, penerima masuk ke "API Contacts".
  • Penerima hanya disimpan jika Anda menggunakan track, track_opens, track_clicks, unsubscribe, atau contact_list. Pengiriman biasa tidak menyimpan apa pun.
  • Orang yang sudah ada di kontak Anda diperbarui, tidak pernah diduplikasi.
"contact_list": "Newsletter"

Contoh

Newsletter dengan semua fitur aktif.

curl -X POST https://mail.sendcorex.com/v3.0/send \
  -H "Authorization: Bearer $SENDCOREX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "to": "subscriber@example.com",
  "from": "news@yourdomain.com",
  "sender_name": "The Weekly",
  "subject": "Issue #42",
  "body": "<p>This week in tech...</p><a href=\"[unsubscribe]\">Unsubscribe</a>",
  "track": "Weekly Newsletter",
  "track_opens": true,
  "track_clicks": true,
  "unsubscribe": true,
  "contact_list": "Newsletter"
}'

Tempat melihat hasilnya

Tidak ada yang perlu dikonfigurasi. Email pertama dengan track langsung muncul di dashboard Anda.

Analytics

Berapa yang membuka dan mengklik

Setiap track adalah satu baris di tabel Sends, di samping kampanye Anda. Buka untuk laporan lengkap: aktivitas per jam, waktu kirim terbaik, provider, perangkat, negara, dan link teratas.

Buka Analytics

Kontak

Setiap penerima, tersimpan

Penerima disimpan di list kontak pilihan Anda (atau "API Contacts"). Setiap kontak menyimpan riwayatnya: diterima, dibuka, diklik, bounce, berhenti berlangganan.

Buka Kontak

Orang

Siapa yang membuka, siapa yang mengklik

Di Analytics, buka track Anda lalu tekan "Who opened", "Who clicked", atau "Unsubscribed". Kontak Anda terbuka sudah terfilter — ekspor, beri tag, atau tambahkan ke list.

Lihat siapa yang membuka

Respons

Respons pengiriman biasa, ditambah apa yang dilakukan tracking.

200 OK
{
  "success": true,
  "code": "EMAIL_QUEUED_SUCCESS",
  "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "recipients": 1,
  "track": "Weekly Newsletter",
  "track_id": "6ad757c8aaf59feb",
  "contact_list": "Newsletter"
}
track

Nama track yang dipakai, setelah spasi di awal/akhir dipangkas. Tidak ada jika email tidak memiliki track.

track_id

ID track yang stabil: nama yang sama selalu menghasilkan ID yang sama.

contact_list

Daftar tempat penerima disimpan. Tidak ada jika tidak ada yang disimpan.

warnings

Apa yang kami sesuaikan tanpa menggagalkan pengiriman: [[Name]] lama ditemukan, batas track tercapai.

KodeHTTPKapan
MISSING_UNSUBSCRIBE_PLACEHOLDER400unsubscribe bernilai true tetapi body tidak berisi [unsubscribe]. Tidak ada yang dikirim.
UNSUBSCRIBE_UNAVAILABLE503Unsubscribe sedang tidak tersedia sementara. Tidak ada yang dikirim — coba lagi sebentar lagi.

Perlu diketahui

Penulisan apa pun bisa

sender_name, senderName, dan SENDER-NAME adalah field yang sama: huruf besar/kecil, _ dan - tidak berpengaruh. Field ya/tidak menerima true, 1, atau "true".

500 track per akun

Melewati batas, email tetap terkirim, hanya tanpa track, dan respons memberi tahu di warnings.

Banyak penerima

Dengan hingga 50 alamat di to, masing-masing mendapat tracking dan tautan unsubscribe sendiri.

Email terjadwal

scheduled_at berfungsi dengan semua field di halaman ini — tracking dimulai saat email dikirim.

Lama

Tag lama [[Name]]

Email yang masih memakai tag tetap berfungsi. Integrasi baru sebaiknya memakai field di atas.

Di mana saja di body
<p>Welcome aboard!</p>
<p>[[CRM Welcome List]]</p>

Fungsinya

Tag dihapus dari email. "CRM Welcome List" menjadi track dan list kontak, dengan open dan klik aktif serta unsubscribe nonaktif.

Memakai keduanya

Jika Anda juga mengirim field baru, field itulah yang dipakai: tag hanya mengisi yang Anda lewatkan.

Usang

Akun yang masih memakai tag menerima email, paling banyak seminggu sekali, yang meminta untuk beralih. Tag tetap berfungsi sampai saat itu.

Kode referensi lama

Kode seperti [[7CK-JDL-Y1L]] kini dibaca sebagai track dengan nama tersebut. Endpoint pelacakan lama sudah dihapus — semuanya ada di Analytics.