DOCS

Hello events

/

Các sự kiện của Hello

Cách sử dụng các sự kiện của Hello.

Tìm hiểu cách Zonos Hello sử dụng các sự kiện và phương thức, và cách bạn có thể sử dụng chúng để nâng cao trang web thương mại điện tử của mình.

z-country-change 

Sự kiện này sẽ được kích hoạt mỗi khi quốc gia được thay đổi, bao gồm cả việc chọn quốc gia ban đầu. Thuộc tính detail của sự kiện sẽ là một đối tượng bao gồm codename.

Thuộc tínhMô tả
codeMã ISO hai ký tự của quốc gia mà sản phẩm xuất xứ từ đó
nameTên quốc gia

Hello integration script

1
2
3
4
{
  "code": "US",
  "name": "United States"
}

z-duty-tax-quote 

Sự kiện này sẽ kích hoạt sau khi nhận được phản hồi báo giá thuế và thuế. Thuộc tính sự kiện detail sẽ là một đối tượng với các thuộc tính sau:

Thuộc tínhMô tả
subtotalTổng phụ của các mặt hàng mà báo giá dựa trên
taxOrVatSố tiền thuế bán hàng ước lượng hoặc số tiền VAT được báo giá dựa trên tổng phụ
dutyTotalSố tiền thuế ước lượng được báo giá dựa trên tổng phụ
dutyTaxTotalGiá trị kết hợp của taxOrVatdutyTotal
foreign (cao cấp)Một đối tượng chứa các giá trị giống như trên, sau đó được chuyển đổi thành số tiền ngoại tệ

Hello kịch bản tích hợp

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "subtotal": 89.99,
  "taxOrVat": 18.0,
  "dutyTotal": 32.54,
  "dutyTaxTotal": 50.54,
  "foreign": {
    "currencyCode": "GBP",
    "subtotal": 89.99,
    "taxOrVat": 18.0,
    "dutyTotal": 32.54,
    "dutyTaxTotal": 50.54
  }
}

z-message-change 

Sự kiện này sẽ kích hoạt mỗi khi thông điệp hiển thị Hello được thay đổi. Thuộc tính sự kiện detail sẽ là một đối tượng bao gồm message.

Thuộc tínhMô tả
messageChuỗi Html của thông điệp hiện đang được hiển thị

Hello kịch bản tích hợp

1
2
3
{
  "message": "<div>Welcome ...</div>"
}

Phương pháp 

Dưới đây là các phương pháp tiện ích bạn có thể sử dụng để tích hợp với trang web của mình.

Phương phápTrả vềMô tả
zonos.isDomestic()BooleanTrue nếu quốc gia hiện tại là trong nước
zonos.country()StringLấy mã quốc gia hiện tại đã chọn.
zonos.country(code)StringThiết lập quốc gia thủ công và trả về nó. code nên là mã ISO hai ký tự.

zonos.config(object) là một phương pháp được sử dụng bởi Hello. Nó có thể được thiết lập để hoạt động với việc ước tính báo giá, chuyển đổi tiền tệ, hoặc hiển thị lại Hello màn hình screen và di chuyển vị trí cờ. Tùy thuộc vào những gì bạn muốn làm, đối tượng gửi đến config sẽ thay đổi:

Nhiệm vụĐiền vào cấu hình với đối tượng như…
Ước tính báo giá{detail: {items: [{id: "String", name: "String", price: Double / "String", quantity: Integer / "String", image: "String URL của hình ảnh / Tùy chọn", hsCode: "String / Tùy chọn", category: "String / Tùy chọn", country: "String (quốc gia xuất xứ) / Tùy chọn", SKU: "String / Tùy chọn"}], currencyCode: "String / tùy chọn mặc định là USD", includedTaxRate: Double / tùy chọn mặc định là 0}}
Chuyển đổi tiền tệ{detail: {currencySelectors: ["css selector 1", "css selector 2"], customConverter: "hàm tùy chỉnh để chuyển đổi các selector / Tùy chọn, tốt nhất là để mặc định", showDecimal: boolean / Tùy chọn}}
Hiển thị lại Hello màn hình screen và di chuyển vị trí cờ{detail: {location: "Các tùy chọn chuỗi là: left, right, top, bottom, floating & attached / Tùy chọn", showSplash: boolean / Tùy chọn}}

Trang này có hữu ích không?