Onboarding ScaleF
  • Tài liệu onboarding ScaleF
  • Quy trình hợp tác
  • 8 bước xây dựng chương trình giới thiệu
  • Các giai đoạn chương trình giới thiệu
  • Giới thiệu chung về tích hợp
    • Khởi tạo chiến dịch
    • Tích hợp website
    • Tích hợp hệ thống quản lý
    • Thiết lập trả thưởng
  • Xây dựng chính sách trả thưởng
  • Truyền thông chương trình
  • Thiết lập mục tiêu và báo cáo
  • Câu hỏi thường gặp
  • Sự khác biệt giữa Referral và Affiliate?
  • Tối ưu chiến dịch affiliate
Powered by GitBook
On this page
  • 1. Mục đích tích hợp
  • 2. Một số hệ thống quản lý lead đăng ký, quản lý đơn hàng phổ biến
  • 2.1. Quản lý đơn đăng ký với Hubspot
  • 3. Tích hợp gửi và nhận đơn qua API
  • 3.1. Thiết lập việc tự động đẩy các đơn hàng
  • 3.2. Tự động cập nhật trạng thái đơn hàng từ CRM khác về qua API

Was this helpful?

  1. Giới thiệu chung về tích hợp

Tích hợp hệ thống quản lý

PreviousTích hợp websiteNextThiết lập trả thưởng

Last updated 4 years ago

Was this helpful?

1. Mục đích tích hợp

Tích hợp hệ thống quản lý lead đăng ký, hệ thống quản lý đơn hàng giúp cho cộng tác viên ngay lập tức nhận được thông tin thay đổi trạng thái lead/trạng thái đơn, từ đó điều tiết hoạt động quảng cáo của họ hiệu quả

2. Một số hệ thống quản lý lead đăng ký, quản lý đơn hàng phổ biến

2.1. Quản lý đơn đăng ký với Hubspot

Hubspot là 1 trong những CRM phổ biến toàn thế giới, tìm hiểu thêm về Hubspot tại Hubspot.com. Một trong những ưu thế của Hubspot là bạn có thể tạo các tài khoản free để sử dụng mà vẫn đáp ứng được những nhu cầu cơ bản của doanh nghiệp.

ScaleF giúp bạn dễ dàng tích hợp 1 chiến dịch đẩy trực tiếp thông tin người mua hàng ghi nhận được vào CRM Hubspot, chỉ với 1 thao tác đơn giản là điền API key vào thông tin thiết lập khi tạo/chỉnh sửa 1 chiến dịch.

Lấy API key của Hubspot?

Nếu đã có 1 account trên Hubspot, bạn chỉ cần vào phần Setting >> Integrate >> API key

Copy key này vào dán vào phần Campaign >> Setting >> CRM >> Hubspot

Tạo tài khoản Hubspot Free

Nếu chưa có tài khoản Hubspot, bạn có thể tự tạo 1 tài khoản Free để bắt đầu.

Vào Hubspot.com và click vào Get Hubspot Free,

Ảnh 1

Ảnh 2

Ảnh 3

Tạo 1 account mới cho campaign đó rồi tiến hành cài đặt (1 tài khoản có thể tạo nhiều account, mỗi chiến dịch sẽ tạo 1 account tương đương 1 API key)

Ảnh 4

Ảnh 5

Để kiểm tra các thông tin đơn hàng về Hubspot thì vào Menu contact > Contact rồi xem các đơn có trùng khớp thông tin với các đơn đổ về report ở campaign hay không.

Ảnh 6

2.2. Quản lý đơn đăng ký với Pushsale

(updating)

3. Tích hợp gửi và nhận đơn qua API

Nếu đã có một hệ thống quản lý lead/đơn hàng riêng, bạn có thể thực hiện tích hợp qua API hoặc postback.

Luồng đi của data

3.1. Thiết lập việc tự động đẩy các đơn hàng

  • Ở Phần CRM chọn tab Custom API (1)

  • URL đích, url nhận dữ liệu gửi về từ Accesstrade khi có phát sinh đơn hàng (2)

  • Phương thức nhận dữ liệu từ Accesstrade (3)

  • Các giá trị muốn nhận khi phát sinh đơn hàng. (4)

  • input key là các param name key sẽ nhận được.

  • input value là các giá trị tương ứng với input key

  • Các giá trị hiện tại đang support: {conversion_id}, {click_id}, {name}, {phone}, {order_id}, {note}.

Video hướng dẫn

*NOTE:

Bạn cần cung cấp một đầu API postback để nhận data từ ScaleF

3.2. Tự động cập nhật trạng thái đơn hàng từ CRM khác về qua API

URL: https://{{domain}}/sync/api/v1/update-conversion-status

Domain chính xác sẽ được gửi lại trong quá trình tích hợp

Method: POST

Header:

  • Content-Type: application/json

  • X-At-User: {adv_loginname}

  • X-At-User-Type: advertiser

  • X-At-User-Access-Token: {token}

Post data example:

{

"conversion_id": "5d5e65d171a0e157e525173a",

"status": "approved",

"reason": "Khach da nhan hang"

}

Note: “status” chỉ support 4 giá trị [ rejected, pre_approved, approved, hold ]

Trong đó:

  • Conversion_id: được truyền qua trong param {conversion_id} trước đó qua API postback lead sang CRM của advertiser

  • Rejected: đơn hàng hủy, khách hàng không đồng ý nhận hàng, không liên hệ được... Sau khi hủy sẽ không chuyển sang được các trạng thái khác

  • Pre_approved: đơn hàng tạm duyệt, khách hàng đồng ý nhận hàng theo điều kiện chấp nhận của campaign. Tuy nhiên đơn hàng có thể bị đổi/ trả hoặc đơn phát hiện publisher vi phạm sẽ có thể bị hủy.

Từ “pre_approved” có thể chuyển sang các trạng thái “rejected” và “approved”

  • Approved: đơn hàng chắc chắn được duyệt và confirm thanh toán cho publisher

  • Hold: đơn hàng pending

Response:

{

"status": "success",

"data": {

"conversion_id": "5d5e65d171a0e157e525173a",

"order_id": "No.0009",

"conversion_parts": [

{

"sku": "SKU002",

"name": "Z MODERN PRO",

"url": "http://tiki.vn/1122",

"quantity": 1,

"currency": "VND",

"commission": {

"amount": 200000,

"currency": "VND"

},

"status": "approved",

"reason": "Khach khong nhan hang",

"id": "1",

"price": 3990000,

"discount": 300000,

"sale_amount": 3690000,

"calculate_by": "FIXED",

"calculate_by_id": null,

"category_name": "MODERNALPHABET",

"category_id": "MODERNALPHABET"

}

]

},

"message": "Success",

"code": 0

}

Error code:

Error code

Message

0

Success

1

Bad request

2

Access token is invalid

3

Click ID is invalid or not existed

4

Conversion ID must required

5

Campaign code is invalid

6

Conversion is not existed

7

Conversion already existed

8

Conversion part must required

9

Conversion part id is invalid or not existed

10

Status is invalid, must in: [create_new, reject, pre_approve, approved, hold]

11

Reason must required with statuses: reject, pre_approve, hold

12

Campaign id is invalid

13

Conversion ID must required

14

Conversion part currency is invalid

15

Conversion already approved or reject

20

Total sale amount is invalid

21

Total discount is invalid

22

Total commission is invalid

23

Total sale amount of conversion part is invalid

99

Unknown error

https://www.youtube.com/watch?v=kRLrGzPyNm0