Tính năng tự động hoàn thành (Mới) và giá theo phiên

Chọn nền tảng: Android iOS JavaScript Dịch vụ web

Bạn nên sử dụng các phiên có tính năng Tự động hoàn thành (Mới). Phiên giúp đơn giản hoá việc định giá và cung cấp mô hình định giá nhất quán để sử dụng với tính năng Tự động hoàn thành (Mới).

Tính năng định giá theo phiên bắt đầu bằng yêu cầu Tự động hoàn thành (Mới) đầu tiên, trong đó có mã thông báo phiên, tiếp tục qua từng yêu cầu Tự động hoàn thành (Mới) tiếp theo, sau đó kết thúc bằng một yêu cầu đến Thông tin chi tiết về địa điểm (Mới) hoặc Xác thực địa chỉ sử dụng mã thông báo phiên.

Sau khi phiên kết thúc, mọi lệnh gọi đến tính năng Tự động hoàn thành (Mới), Thông tin chi tiết về địa điểm (Mới) hoặc Xác thực địa chỉ sử dụng mã thông báo phiên đã hết hạn sẽ được tính phí như thể không có mã thông báo phiên.

Các phiên chưa hoàn tất, tức là các phiên không bị chấm dứt bằng yêu cầu Thông tin chi tiết về địa điểm (Mới) hoặc Xác thực địa chỉ, chỉ được tính phí cho các yêu cầu tự động hoàn tất bằng SKU: Yêu cầu tự động hoàn tất.

Ba trường hợp đặt giá phổ biến nhất là:

  • Tự động hoàn thành cho dữ liệu vị trí
  • Tính năng tự động hoàn thành để khám phá địa điểm
  • Tự động điền thông tin thanh toán và giao hàng

Tự động hoàn thành cho dữ liệu vị trí

Trong trường hợp này, bạn muốn sử dụng tính năng Tự động hoàn thành và Thông tin chi tiết về địa điểm (Mới) để lấy thông tin vị trí về một địa điểm. Ví dụ: bạn chọn một đề xuất từ tính năng tự động hoàn thành, sau đó sử dụng thẻ Thông tin chi tiết về địa điểm (Mới) để lấy toạ độ vĩ độ và kinh độ của địa điểm đó nhằm hiển thị địa điểm đó trên bản đồ.

Thông tin vị trí có thể bao gồm:

  • Địa chỉ
  • Vị trí dưới dạng toạ độ vĩ độ và kinh độ
  • Plus Code
  • Loại
  • Khung nhìn

Phiên này được chấm dứt bằng một yêu cầu duy nhất đến Thông tin chi tiết về địa điểm (Mới) yêu cầu mọi trường do SKU: Thông tin chi tiết về địa điểm (Chỉ vị trí) xác định.

Sau đó, bạn sẽ được tính phí như sau:

Tính năng tự động hoàn thành để khám phá địa điểm

Trong trường hợp Tự động hoàn thành để khám phá địa điểm, bạn muốn nhận được nhiều thông tin hơn là dữ liệu vị trí về một địa điểm. Ví dụ: bạn có thể yêu cầu bất kỳ nội dung nào sau đây:

  • Tuỳ chọn hỗ trợ tiếp cận
  • Giờ mở cửa hiện tại
  • Lựa chọn đỗ xe
  • Bài đánh giá
  • Điểm xếp hạng

Đối với trường hợp này, phiên của bạn sẽ bị chấm dứt bằng một yêu cầu đến phần Thông tin chi tiết về địa điểm (Mới) yêu cầu bất kỳ trường nào có trong SKU Thông tin chi tiết về địa điểm (Mới) Cơ bản, Nâng cao hoặc Ưu tiên.

Sau đó, bạn sẽ được tính phí như sau:

Tự động điền thông tin thanh toán và giao hàng

Address Validation API là một dịch vụ chấp nhận địa chỉ. Phương thức này xác định các thành phần địa chỉ và xác thực các thành phần đó. Hàm này cũng chuẩn hoá địa chỉ để gửi thư và tìm toạ độ vĩ độ và kinh độ tốt nhất đã biết cho địa chỉ đó.

Trong trường hợp Tự động hoàn thành để thanh toán và giao hàng, bạn sẽ chấm dứt phiên bằng một yêu cầu gửi đến Address Validation API (API Xác thực địa chỉ) để xác thực địa chỉ đã chọn. Sau đó, bạn sẽ được tính phí như sau:

  • Tất cả yêu cầu Tự động hoàn thành (Mới) đều được tính phí theo SKU: Mức sử dụng phiên Tự động hoàn thành, tức là không tính phí cho các yêu cầu đó.
  • Một yêu cầu SKU: Address Validation Preferred (Mã SKU: Ưu tiên xác minh địa chỉ):
    • Tính phí 25 USD cho mỗi 1.000 yêu cầu,tối đa 100.000 yêu cầu
    • Tính phí 20 USD cho mỗi 1.000 yêu cầu,tối đa 500.000 yêu cầu

Ví dụ về việc đặt giá

Bảng sau đây cho thấy các ví dụ về giá cho 3 tình huống phiên chính. Bảng này cũng liệt kê các SKU xuất hiện trong bảng sao kê thanh toán của bạn cho từng trường hợp.

Trường hợp Ví dụ về yêu cầu SKU đã tính phí Giá mỗi 1.000 yêu cầu
Dữ liệu vị trí
  • 5 yêu cầu đối với tính năng Tự động hoàn thành (Mới) được tính phí 2,83 USD (giới hạn ở 12 yêu cầu cho phiên)
  • 1 yêu cầu về Thông tin chi tiết về địa điểm (Mới) được tính phí 5 USD
Khám phá địa điểm
  • 5 yêu cầu đối với tính năng Tự động hoàn thành (Mới) được tính phí 0 USD
  • 1 yêu cầu về Thông tin chi tiết về địa điểm (Mới) được tính phí 25 USD
Thanh toán và giao hàng
  • 5 yêu cầu đối với tính năng Tự động hoàn thành (Mới)
  • 1 yêu cầu Xác thực địa chỉ
  • 5 yêu cầu đối với tính năng Tự động hoàn thành (Mới) được tính phí 0 USD
  • 1 yêu cầu Xác thực địa chỉ ưu tiên được tính phí 25 USD

Ví dụ về việc đặt giá không tính theo phiên

Nếu không sử dụng phiên, bạn sẽ được tính phí theo yêu cầu cho tính năng Tự động điền (Mới) bằng SKU: Yêu cầu tự động điền với mức phí 2,83 USD cho mỗi 1.000 yêu cầu.

Giá dự phòng cho các phiên chưa hoàn tất hoặc bị bỏ dở

Nếu một phiên bị bỏ ngang, nghĩa là không bị chấm dứt bằng lệnh gọi đến tính năng Thông tin chi tiết về địa điểm (Mới) hoặc Xác thực địa chỉ, thì các yêu cầu Tự động hoàn thành (Mới) sẽ quay lại mô hình định giá theo yêu cầu và được tính phí 2,83 USD cho mỗi 1.000 yêu cầu theo định nghĩa của SKU: Yêu cầu tự động hoàn thành.