Apa itu postback? – Affiliate Top Help Center

Apa itu Postback

Postback adalah permintaan HTTP otomatis yang dikirim dari sistem kami (Affiliate TOP) ke alat pemantauan kinerja Anda (misalnya, Keitaro, Voluum, RedTrack) atau CRM ketika seorang pengguna melakukan tindakan: mendaftar, melakukan deposit, menarik dana, menginstal aplikasi, melakukan perdagangan, dll.

Dengan postback, semua data konversi sampai ke alat pelacakan Anda tanpa upaya manual.

Postback memungkinkan Anda untuk:

• Menganalisis trafik secara real-time

• Dengan cepat menyesuaikan iklan dan strategi Anda untuk meningkatkan hasil kampanye dan meningkatkan keuntungan

• Menemukan dan meningkatkan paket dan sumber trafik yang menguntungkan dengan lebih cepat

Apa itu URL Postback

Ini adalah tautan khusus yang dikirimkan sistem kami untuk mengirim data konversi. URL ini berisi parameter – "sel" yang diisi dengan nilai selama suatu peristiwa: ID klik, jumlah deposit, ID trader, ID kampanye, dll. Ketika suatu peristiwa terjadi, sistem kami secara otomatis mengirimkan permintaan ke URL ini dengan data.

Di mana menemukan URL Postback?

Ambil dari alat pemantauan kinerja Anda atau CRM (Keitaro, Voluum, RedTrack, dll.). Periksa dokumentasi atau antarmukanya di bawah pengaturan postback/pelacakan S2S.

Contoh URL Postback dari 3 Pelacak Teratas

Cari tahu seperti apa umumnya dan kenali cara menambahkan parameter kami.

Keitaro

Contoh URL Postback: http://your-keitaro.com/postback?clickid={click_id}&status=approved&payout={sumdep}

Nama parameter clickid berasal dari dokumentasi Keitaro
{click_id}, {sumdep} adalah placeholder kami

Voluum

Contoh URL Postback: https://your-voluum.com/postback?cid={click_id}&payout={sumdep}

Nama parameter cid adalah nama standar ID Klik untuk pelacak Voluum
{click_id}, {sumdep} adalah placeholder kami

RedTrack

Contoh URL Postback:

https://your-redtrack.com/postback?clickid={click_id}&revenue={sumdep}&status=approved

Nama parameter clickid dan revenue berasal dari dokumentasi RedTrack
{click_id}, {sumdep} adalah placeholder kami

Penting: Nama parameter (clickid, cid, revenue) harus sesuai dengan persyaratan pelacak Anda. Placeholder dalam kurung kurawal ({click_id}, {sumdep}) adalah milik kami.

Bagaimana URL Postback dan Parameter Bekerja

Setiap parameter terdiri dari dua bagian:

nama parameter – apa yang diharapkan pelacak/CRM Anda (diambil dari dokumentasinya)
placeholder kami dalam kurung kurawal – apa yang kami masukkan secara otomatis.

Contoh – visitor_id={click_id}

Di mana:

visitor_id – nama parameter dari dokumentasi pelacak. Dikirim apa adanya. Ini adalah nama pasti yang diharapkan pelacak Anda untuk data.
{click_id} – placeholder kami. Diganti dengan ID Klik yang sebenarnya selama peristiwa.

Sisi kiri (visitor_id, campaign_id, sub_id) – persyaratan pelacak.
Sisi kanan ({click_id}, {campaign_id}) – data Affiliate Top.

Di mana Mendapatkan URL Postback dan Nama Parameter

Masuk ke alat pemantauan kinerja Anda (pelacak atau CRM)
Temukan bagian Postback/Pelacakan Server-ke-Server (S2S)
Salin URL Postback dasar dan nama parameter dari antarmuka atau dokumentasi
Tempel URL ke pengaturan kami dan tambahkan placeholder kami: visitor_id={click_id}, amount={sumdep}, dll.

Contoh Struktur URL Postback Penuh

Sebelum peristiwa (dengan placeholder) – https://your-tracker.com/postback?visitor_id={click_id}&site_id={site_id}&trader={trader_id}&amount={deposit_amount}&campaign_id={campaign_id}

Setelah peristiwa (nilai nyata) – https://your-tracker.com/postback?visitor_id=1234567&site_id=4458&trader=902134&amount=23.22&campaign_id=YT_BR_01

Parameter Postback: Format, Contoh, dan Tujuan

1. ID Klik

Placeholder kami: {click_id}
Dalam URL pelacak: visitor_id={click_id} → visitor_id=1234567
Tujuan: Menghubungkan konversi ke klik iklan tertentu. Pelacak tahu sumber trafik mana yang dikonversi
Arti: Nomor klik unik yang diterima dari pelacak Anda saat klik terjadi

2. ID Situs

Placeholder kami: {site_id}
Dalam URL: site_id={site_id} → site_id=4458
Tujuan: Menunjukkan situs/penempatan mana yang menghasilkan trafik yang mengonversi. Membantu mengoptimalkan pembelian trafik
Arti: ID situs web atau penempatan dalam jaringan iklan Anda

3. ID Trader

Placeholder kami: {trader_id}
Dalam URL: trader={trader_id} → trader=902134
Tujuan: Menghubungkan semua tindakan satu pengguna (beberapa akun, deposit, perdagangan) ke dalam statistik terpadu
Arti: Pengenal trader permanen yang diterbitkan saat pendaftaran pertama

4. ID akun Anda

Placeholder kami: {a}
Dalam URL: account={a} → account=a182haj2nn
Tujuan: Mengidentifikasi tautan afiliasi Anda. Berguna jika mengelola beberapa akun
Arti: Kode referensi mitra Anda. Biasanya satu per mitra

5. Jumlah deposit

Placeholder kami: {sumdep}
Dalam URL: amount={sumdep} → amount=23.22
Tujuan: Menunjukkan jumlah deposit pasti (pertama atau berulang). Untuk perhitungan ROI dan analisis LTV
Arti: Jumlah deposit dalam mata uang yang dipilih ($ atau ¢). Hanya muncul dalam peristiwa deposit, seperti FTD atau Deposit Ulang

6. ID transaksi

Placeholder kami: {transcation}
Dalam URL: tx_id={transaction} → tx_id=81283192873
Tujuan: Mengidentifikasi setiap konversi secara unik. Mencegah duplikasi dan memungkinkan atribusi yang akurat
Arti: ID internal dari peristiwa spesifik (deposit, penarikan, dll.)

7. ID kampanye iklan

Placeholder kami: {ac}
Dalam URL: campaign_id={ac} → campaign_id=YT_BR_01
Tujuan: Memisahkan statistik di berbagai kampanye (geo, kreatif, landers)
Arti: Nama atau ID kampanye iklan Anda dari tautan rujukan

8. ID postback subakun

Placeholder kami: {sa}
Dalam URL: sub_id={sa} → sub_id=teaser_01
Tujuan: Analitik tambahan Anda (jenis trafik, kreatif, webmaster)
Arti: Nilai apa pun dari tautan rujukan Anda (sub1, sub2, dll.)

9. Profit

Placeholder kami: {profit}
Dalam URL: profit={profit} → profit=15.75
Tujuan: Menunjukkan jumlah keuntungan/kerugian perdagangan untuk perdagangan riil. Penting untuk pelacakan pendapatan dan analisis kinerja
Arti: Keuntungan bersih (positif atau negatif) dari aktivitas perdagangan riil pengguna. Tersedia dalam peristiwa perdagangan riil

Peristiwa Pemicu untuk Postback

Affiliate TOP mendukung postback untuk tindakan pengguna yang terdaftar di bawah ini. Satu postback = satu peristiwa. Putuskan peristiwa apa yang ingin Anda lacak dan ketik atau klik pada parameter yang diperlukan untuk menambahkannya ke URL Postback Anda.

Pendaftaran – pengguna menyelesaikan pendaftaran akun
Konfirmasi email – pengguna memverifikasi alamat email
Deposit pertama (FTD) – deposit pertama pengguna
Deposit ulang – deposit berikutnya (deposit ulang)
Aplikasi terinstal – pengguna menginstal aplikasi seluler
Perdagangan demo pertama – perdagangan pertama pengguna di akun demo
Penarikan – pengguna menyelesaikan penarikan dana
Perdagangan riil – pengguna mengeksekusi perdagangan di akun trading riil

Setiap peristiwa memiliki seperangkat parameter yang tersedia yang telah disebutkan di atas.

Bagaimana cara mengatur postback (Panduan Antarmuka)

Klik “Tambah” untuk memulai proses pengaturan postback dan isi kolom yang diperlukan berdasarkan preferensi Anda.

Nama postback – masukkan nama yang jelas dan unik untuk setiap postback Anda untuk menghindari kebingungan. (misalnya, "FTD_YT_BR")
Event – pilih dari menu gulir bawah (Pendaftaran, Deposit pertama, dll.)
URL postback – tempel URL dari pelacak Anda (periksa contoh di atas)
Parameter – klik pada preset biru di bawah kolom “URL Postback” ("ID Klik", "Jumlah deposit") untuk menambahkan parameter secara otomatis
Metode – GET (secara default)
Mata uang – pilih $ atau ¢ untuk jumlah

7. Filter segmentasi

Pengaturan ini memungkinkan Anda memutuskan kapan postback harus dikirim — bergantung pada kampanye atau subakun mana yang terkait dengannya. Anda dapat mengisi salah satu atau kedua kolom ini.

Mengapa menggunakan filter segmentasi?

Filter segmentasi membantu Anda mengelola trafik dengan lebih tepat:

Optimalkan sumber trafik yang berbeda secara independen – Jika Anda menggunakan lebih dari satu alat pemantauan kinerja, Anda dapat mengirim peristiwa dasar ke satu filter dan peristiwa dengan parameter tambahan ke filter segmentasi yang lain.
Jalankan pengujian A/B – Segmentasi membantu Anda melihat sumber mana yang menghasilkan lebih banyak konversi dan bagaimana kinerja kampanye, materi iklan, atau halaman arahan yang berbeda.
Uji atau migrasikan alat dengan aman – Anda dapat mulai mengirim postback ke alat pemantauan kinerja baru secara paralel dengan yang lama dan membandingkan angkanya sebelum beralih sepenuhnya.

Bagaimana sistem memutuskan kapan harus mengirim postback:

Kampanye atau subakun tidak ditentukan
Postback dikirim untuk peristiwa pemicu yang dipilih terlepas dari kampanye atau subakun.
Hanya kampanye yang ditentukan
Postback dikirim untuk peristiwa pemicu hanya jika tautan pelacakan trader menyertakan kampanye khusus ini.
Hanya subakun yang ditentukan
Postback dikirim hanya Jika tautan pelacakan trader menyertakan subakun khusus ini, apa pun kampanye yang menjadi bagian dari subakun itu.
Kampanye dan subakun ditentukan
Postback dikirim hanya ketika kedua nilai dalam tautan trader cocok dengan kampanye dan subakun yang Anda masukkan.

(Catatan aktivasi: setelah postback diaktifkan, postback dikirim dalam waktu 15 detik setiap kali peristiwa dan kondisi yang dipilih terpenuhi.)

8. Aktifkan jika perlu dan klik "Tambahkan"

Status Postback

Postback melalui beberapa status selama siklus hidupnya. Berikut adalah arti masing-masing dan apa yang memicu perubahan status:

Memeriksa (~15 detik) – kami memeriksa postback Anda untuk masalah saat pertama kali dibuat, diedit, atau disalin
- Jika postback benar → itu menjadi Aktif.
- Jika ada kesalahan → postback beralih ke status Tidak Aktif dengan pesan kesalahan yang ditampilkan di antarmuka.
- Postback tidak dapat diedit atau ditangguhkan – hanya dapat dihapus
Aktif – postback berfungsi dengan baik dan mengumpulkan data.
- Jika diedit → sementara kembali ke status Memeriksa.
- Jika menerima 10 kesalahan HTTP 3xx/4xx berturut-turut → secara otomatis dinonaktifkan, menunjukkan kesalahan di antarmuka, dan mengirim pemberitahuan email.
Tidak Aktif – postback dinonaktifkan karena kegagalan validasi, deaktivasi manual, atau ambang kesalahan tercapai. Harus diperbaiki dan divalidasi ulang untuk menjadi Aktif lagi.

Perilaku kunci:

Setelah 10 upaya validasi gagal, aktivasi memerlukan bantuan manajer
Postback Aktif memantau diri sendiri dan melindungi terhadap kegagalan pengiriman yang persisten

Log Postback

Di sini Anda dapat menemukan semua postback yang dibuat dalam 30 hari terakhir. Ini membantu Anda mengidentifikasi masalah pengaturan dan memahami apa yang perlu diperbaiki, misalnya.

Daftar kesalahan yang mungkin:

Ketika postback gagal, periksa bagian Log untuk kode status.

Kesalahan 3xx – Kesalahan pengalihan

Server mengatakan: "Pergi ke alamat lain ini sebagai gantinya."

Hasil: Postback Anda dikirim ke tempat lain.

Penyebab utama:

- URL postback secara otomatis mengalihkan (HTTP→HTTPS, www/non-www, tautan pelacakan)

- Server atau pelacak meneruskan permintaan ke alamat lain

- Server Anda secara diam-diam mengubah URL di sepanjang jalan

Bagaimana cara memperbaikinya?

1. Salin URL postback Anda

2. Tempelkan ke bilah alamat browser dan tekan Enter

3. Tunggu hingga memuat (atau berhenti mengalihkan)

4. Salin apa yang Anda lihat di bilah alamat sekarang — ini adalah URL postback Anda

Kesalahan 4xx – Kesalahan klien

Server mengatakan: "Terjadi kesalahan dengan permintaan Anda."

Hasil: Biasanya ini adalah masalah pengaturan.