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.
trackstringNama 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_opensbooleanMenghitung 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_clicksbooleanMenghitung 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
unsubscribebooleanGunakan 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_liststringDaftar 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 AnalyticsKontak
Setiap penerima, tersimpan
Penerima disimpan di list kontak pilihan Anda (atau "API Contacts"). Setiap kontak menyimpan riwayatnya: diterima, dibuka, diklik, bounce, berhenti berlangganan.
Buka KontakOrang
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 membukaRespons
Respons pengiriman biasa, ditambah apa yang dilakukan tracking.
{
"success": true,
"code": "EMAIL_QUEUED_SUCCESS",
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"recipients": 1,
"track": "Weekly Newsletter",
"track_id": "6ad757c8aaf59feb",
"contact_list": "Newsletter"
}trackNama track yang dipakai, setelah spasi di awal/akhir dipangkas. Tidak ada jika email tidak memiliki track.
track_idID track yang stabil: nama yang sama selalu menghasilkan ID yang sama.
contact_listDaftar tempat penerima disimpan. Tidak ada jika tidak ada yang disimpan.
warningsApa yang kami sesuaikan tanpa menggagalkan pengiriman: [[Name]] lama ditemukan, batas track tercapai.
| Kode | HTTP | Kapan |
|---|---|---|
MISSING_UNSUBSCRIBE_PLACEHOLDER | 400 | unsubscribe bernilai true tetapi body tidak berisi [unsubscribe]. Tidak ada yang dikirim. |
UNSUBSCRIBE_UNAVAILABLE | 503 | Unsubscribe 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.
<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.