Hệ thống Permate hỗ trợ 3 loại upload conversion chính, phục vụ cho mục đích Tạo mới (có hoặc không có click_uuid) hoặc Cập nhật conversion hiện có:
1.Loại 1: Tạo conversion sử dụng Click_uuid #
Tính năng này được sử dụng để xử lý các phiên chưa có chuyển đổi (xử lý các click ID chưa có conversion).
| Trường thông tin | Yêu cầu | Ví dụ | Lưu ý |
| Bắt buộc | File tải lên chỉ chứa click_uuid. | 4e68ed08-d97f-4637-8. | |
| Cấu hình thêm (Tùy chọn) | event_id, status (chỉ chấp nhận: approve, pending, reject), payout, sale_value, ip, product_id, date_time (định dạng YYYY-MM-DD HH:MM:SS). | date_time: 2020-01-31 23:59:59. | Nếu file upload có chứa các thông tin này, hệ thống sẽ update các giá trị theo nội dung được upload. |
Logic và Lưu ý Đặc biệt (Loại 1):
- Trạng thái mặc định:
o Nếu người dùng bật Manual Approve trong Offer Setting, trạng thái conversion mới tạo sẽ là ‘pending’.
o Nếu người dùng để cài đặt mặc định, trạng thái chuyển đổi sẽ là ‘approve’.
- Không có event_id: Trường hợp File Upload chỉ chứa click_uuid mà không có event_id, conversion mới được tạo sẽ ghi nhận cho Event Default của Offer.
- Cập nhật click_uuid đã tồn tại: Nếu Click_uuid được tải lên đã được ghi nhận là một conversion trước đó, trạng thái của conversion đó sẽ luôn luôn được thay đổi thành ‘approve’, bất kể trạng thái hiện tại là gì.
- Header trống: Trường hợp Header file có khai báo nhưng để trống giá trị (ví dụ: Payout, Sale Value), hệ thống sẽ thực hiện tạo mới Conversion dựa trên các thông tin của Click tương ứng.
- Lỗi: Nếu khai báo click_id và offer_id trên header nhưng không search ra kết quả, hệ thống báo lỗi “Unable to determine offer”.
2.Loại 2: Tạo conversion không dử dụng Click_uuid #
Tính năng này cho phép người dùng thêm chuyển đổi cho một Publisher nào đó mà không thể xác định được click_uuid.
| Trường thông tin | Yêu cầu | Ví dụ |
| Bắt buộc | partner_id (ID của publisher trên Permate), offer_id (ID của Offer trên Permate), payout, sale_value. | partner_id: 10001, offer_id: 101, payout: 9.5, sale_value: 11.5. |
| Lưu ý Bắt buộc | Trường Payout và sale_value có thể để trống, tuy nhiên thông tin ở header là bắt buộc. | |
| Cấu hình thêm (Tùy chọn) | status (approve, pending, reject), event_id, date_time, product_id. | status: approve, date_time: 2020-01-31 23:59:59. |
Logic và Lưu ý Đặc biệt (Loại 2):
- Trạng thái mặc định: Các chuyển đổi được thêm mới sẽ mặc định có trạng thái là ‘approve’ nếu không được cài đặt status trong file.
- Bỏ qua Manual Approve: Quá trình tạo conversion này bỏ qua cài đặt Manual Approve trong Offer Setting.
- Event Default: Nếu file upload không có thông tin event_id, hệ thống thực hiện tạo mới Conversion cho Event Default của Offer.
- Logic Budget: Không áp dụng Logic Budget cho Offer và Partner trong trường hợp tạo mới Conversion bằng File Upload.
3.Loại 3: Cập nhật conversion hiện có #
Tính năng này cho phép người dùng thay đổi các giá trị có sẵn trên một conversion đã được ghi lại trong phiên trước đó, bao gồm: Status, Payout, Sale value, IP ghi nhận chuyển đổi, và Product.
| Trường thông tin | Yêu cầu | Ví dụ |
| Bắt buộc | conversion_id (ID của Conversion trên hệ thống). | 17599183297097876. |
| Bắt buộc Thêm | Cần có thêm ít nhất một trong các trường sau: click_uuid, status (approve, pending, reject), payout, sale_value, ip, product_id. | status: approve, payout: 30. |
| Cấu hình thêm (Tùy chọn) | offer_id, event_id. |
Logic và Lưu ý Đặc biệt (Loại 3):
- Yêu cầu dữ liệu offer_id và event_id: Nếu đã khai báo offer_id và event_id ở header, người dùng phải điền dữ liệu và không được để trống. Nếu để trống, hệ thống sẽ báo lỗi “không xác định event id”.
4. Trường hợp đặc biệt : #
Nếu người dùng tải lên một click_uuid chưa được ghi nhận là conversion, hệ thống sẽ tự record một conversion mới
(trạng thái sẽ theo cài đặt Manual Approve trong Offer Setting).
Các Lưu Ý và Logic Chung Khác
- Logic Duplicate Conversion: Khi tạo mới Conversion, hệ thống luôn thực hiện tạo mới Conversion và bỏ qua Setting “Duplicate Conversion” của Event.
- Working Mode (Stopped/Blocked): Nếu Working Mode của Partner với Offer là “Stopped” hoặc “Blocked”, thì Conversion được tạo sẽ có trạng thái là “Organic”.
- Ảnh hưởng Ngân sách (Budget):
o Nếu tổng conversion được upload lên lớn hơn Public Budget, hệ thống sẽ thông báo cho Brand.
