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

Bạn nên sử dụng các phiên hoạt động có tính năng Tự động hoàn thành (Mới). Phiên hoạt động giúp đơn giản hoá việc đặt 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).

Việc đặt giá theo phiên bắt đầu từ yêu cầu Tự động hoàn thành (Mới) đầu tiên bao gồm mã thông báo phiên, tiếp tục thông qua mỗi yêu cầu Tự động hoàn thành (Mới) tiếp theo, sau đó được 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), 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 lập hoá đơn như thể không có mã thông báo phiên.

Các phiên chưa hoàn tất, nghĩa là các phiên không bị chấm dứt bởi 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ẽ chỉ bị tính phí cho các yêu cầu tự động hoàn thành sử dụng SKU: Yêu cầu tự động hoàn thành.

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

  • Tính năng 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 hoàn thành quy trình thanh toán và giao hàng

Tính nă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à Chi tiết về địa điểm (Mới) để lấy thông tin vị trí của một địa điểm. Ví dụ: bạn chọn một đề xuất trong tính năng tự động hoàn thành, sau đó sử dụng Thông tin chi tiết về địa điểm (Mới) để lấy vĩ độ và kinh độ của địa điể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ạng vĩ độ và kinh độ
  • Plus Code
  • Loại
  • Khung nhìn

Phiên này được kết thúc bằng một yêu cầu duy nhất đến Chi tiết địa điểm (Mới) yêu cầu bất kỳ trường nào được xác định bởi SKU: Chi tiết địa điểm (Chỉ thông tin vị trí).

Sau đó, bạn sẽ được lập hoá đơn 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 cho việc khám phá địa điểm, bạn không chỉ muốn nhận thêm 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

Trong trường hợp này, phiên của bạn bị chấm dứt bằng một yêu cầu đế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 lập hoá đơn như sau:

Tự động hoàn thành quy trình thanh toán và giao hàng

API Xác thực địa chỉ là một dịch vụ chấp nhận một địa chỉ. Nó xác định các thành phần địa chỉ và xác thực các thành phần đó. Dịch vụ này cũng chuẩn hoá địa chỉ để gửi thư, đồng thời tìm vĩ độ và kinh độ nổi tiếng nhất của địa chỉ đó.

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

Ví dụ về giá

Bảng sau đây trình bày các ví dụ về giá cho 3 trường hợp chính của phiên hoạt động. 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 đã thanh toán Giá mỗi 1.000 yêu cầu
Dữ liệu vị trí
  • 5 yêu cầu Tự động hoàn thành (Mới) có hoá đơn 2,83 USD (giới hạn là 12 yêu cầu cho phiên này)
  • 1 yêu cầu Chi tiết địa điểm (Mới) được tính phí $5
Khám phá địa điểm
  • 5 yêu cầu Tự động hoàn thành (Mới) được lập hoá đơn 0 USD
  • 1 yêu cầu Chi tiết địa điểm (Mới) được lập hóa đơn $25
Thanh toán và giao hàng
  • 5 yêu cầu Tự động hoàn thành (Mới)
  • 1 yêu cầu xác thực địa chỉ
  • 5 yêu cầu Tự động hoàn thành (Mới) được lập hoá đơn 0 USD
  • 1 yêu cầu xác thực địa chỉ được ưu tiên thanh toán ở mức 25 USD

Ví dụ về giá không có phiên hoạt động

Nếu không sử dụng phiên hoạt động, bạn sẽ bị tính phí cho mỗi yêu cầu tự động hoàn thành (Mới) bằng cách sử dụng SKU: Yêu cầu tự động hoàn thành với giá 2,83 USD trên 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ỏ qua

Nếu một phiên bị bỏ qua, nghĩa là không bị chấm dứt bởi lệnh gọi đến 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 về mô hình đặt giá theo mỗi yêu cầu và sẽ được tính phí là 2,83 USD cho mỗi 1.000 yêu cầu theo xác định của SKU: Yêu cầu tự động hoàn thành.