Mengaitkan konversi dan penjualan

Konversi adalah penjualan atau pembayaran pendukung yang bisa dikaitkan LinkHarbor dengan sebuah klik di halaman Anda. Dengan begitu Anda tidak hanya melihat seberapa sering tautan diklik, tetapi juga hasilnya. Artikel ini ditujukan bagi kreator yang punya toko sendiri dan bagi developer yang menghubungkan toko tersebut. Anda bisa menganalisis konversi dan membuat rahasia callback mulai Creator Pro.

#Asal konversi

• Penjualan yang dilaporkan toko atau server Anda lewat sale callback
• Pembayaran pendukung lewat Stripe; pengembalian dana menghapus konversinya lagi, lihat Pembayaran pendukung dengan Stripe

Setiap konversi mewarisi data dari klik yang terkait: halaman, tautan, negara, perangkat, perujuk, dan parameter UTM. Karena itu konversi muncul di statistik tepat di tempat asal kliknya.

#Cara kerja atribusi

1. Pengunjung mengeklik tautan di halaman Anda
2. LinkHarbor menghitung klik dan, saat mengalihkan, menambahkan parameter lt_click_id berisi ID klik unik ke URL tujuan
3. Halaman tujuan Anda (misalnya toko) membaca lt_click_id dari alamat dan menyimpannya sampai pembelian
4. Setelah pembelian, server Anda mengirim sale callback dengan ID klik ini ke LinkHarbor
5. Konversi muncul di dasbor dan di statistik halaman

ID klik hanya ditambahkan ke tujuan yang diawali http:// atau https://. Tautan ke mailto: atau tel: tidak mendapatkannya, karena parameter itu akan merusak subjek atau nomor telepon di sana. Klik dari bot juga tidak mendapat ID klik.

#Membuat rahasia callback

Sale callback harus mengidentifikasi diri dengan rahasia callback. Pemilik dan admin mengelola rahasia mulai Creator Pro di “Callback & API” pada bagian akun di menu.

1. Buka “Callback & API”
2. Di kartu “Rahasia callback”, klik “+ Buat rahasia baru”
3. Jika mau, masukkan nama, misalnya “Callback toko”
4. Klik “Buat rahasia”
5. Segera salin rahasianya: rahasia hanya ditampilkan satu kali

“Edit”

Mengubah nama dan status (Aktif atau Nonaktif). Rahasia yang nonaktif ditolak.

“↺ Rotasi”

Membuat rahasia baru. Rahasia lama langsung berhenti berfungsi – jadi segera masukkan yang baru di toko Anda.

“Hapus”

Menghapus rahasia setelah konfirmasi.

“Callback terakhir:”

Menunjukkan kapan rahasia terakhir dipakai, jika belum pernah “Belum pernah digunakan”.

Anda bisa membuat hingga 5 rahasia callback per workspace.

#Mengirim sale callback

Server Anda mengirim permintaan POST ke API LinkHarbor. Rahasianya dikirim di header X-Callback-Secret.

curl -X POST https://dock.at-harbor.com/v1/callbacks/sale \
  -H "Content-Type: application/json" \
  -H "X-Callback-Secret: YOUR_CALLBACK_SECRET" \
  -d '{
    "click_id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a23",
    "order_id": "B-10042",
    "amount": "49.90",
    "currency": "EUR"
  }'

click_id

Wajib. ID klik dari lt_click_id (10–36 karakter).

order_id

Wajib. Nomor pesanan Anda (1–128 karakter). Hanya satu konversi yang dihitung per nomor pesanan, jadi callback berulang tidak membuat konversi kedua.

amount

Wajib. Jumlah sebagai angka desimal.

currency

Wajib. Kode mata uang 3 huruf, misalnya EUR.

occurred_at, meta

Opsional. Waktu pembelian dan hingga 50 kunci kustom (masing-masing 1–64 karakter) berisi informasi tambahan. Nilainya berupa teks maksimal 500 karakter, angka, true/false, atau null; API menolak objek bersarang.

Respons

Semua kolom dan kode kesalahan untuk developer ada di Mengirim penjualan dan data kustom.

#Menganalisis konversi

• Dasbor: ubin “Konversi” dan “CVR” serta kartu “Konversi” menurut sumber dan medium UTM
• Statistik halaman: kartu “Konversi” dengan “CVR total”, “CVR unik”, dan “Rincian”
• CVR total = konversi dibagi klik; CVR unik = konversi dibagi klik unik