Tính năng báo cáo trong Nền tảng Google Maps cung cấp một tập hợp các báo cáo trực quan được xác định trước về mức sử dụng API, hạn mức và thông tin thanh toán cơ bản trong Google Cloud Console. Hãy sử dụng các báo cáo này để xác định số lệnh gọi API bạn đã thực hiện, tiến đến hạn mức sử dụng API và theo dõi mức sử dụng thanh toán theo thời gian.
Các loại báo cáo bao gồm:
- Báo cáo sử dụng: Báo cáo số lượng yêu cầu mà dự án của bạn đưa ra cho API Nền tảng Google Maps bằng cách sử dụng thông tin xác thực được liên kết với dự án của bạn.
- Báo cáo hạn mức: Báo cáo mức sử dụng hạn mức dưới dạng biểu đồ có thể được nhóm theo yêu cầu mỗi phút. Hạn mức hiện tại cho các API đã chọn hiển thị trong bảng bên dưới biểu đồ hạn mức sử dụng.
- Báo cáo thanh toán: Báo cáo chi phí theo thời gian dưới dạng biểu đồ dạng đường xếp chồng. Xem mức sử dụng hạn mức của tháng hiện tại, bao gồm mọi khoản tín dụng dành riêng cho mức sử dụng đã áp dụng, cũng như tổng chi phí dự đoán cho toàn bộ tháng hiện tại.
- Báo cáo về mức độ tương tác: Cung cấp thông tin chi tiết cho doanh nghiệp về cách người dùng tương tác với ứng dụng bản đồ của bạn.
Để xem danh sách đầy đủ các trạng thái phản hồi và mã phản hồi giúp xác định việc một yêu cầu có xuất hiện trong các báo cáo Mức sử dụng, Hạn mức và/hoặc Thanh toán hay không, hãy xem bài viết Trạng thái và báo cáo phản hồi.
Xem các báo cáo về mức sử dụng, hạn mức và thanh toán của Nền tảng Google Maps bằng Bảng điều khiển Cloud.
Báo cáo về việc sử dụng
Mức sử dụng dựa trên số lượng yêu cầu mà dự án của bạn gửi đến API Nền tảng Google Maps bằng cách sử dụng thông tin đăng nhập được liên kết với dự án của bạn. Yêu cầu bao gồm các yêu cầu thành công, yêu cầu dẫn đến lỗi máy chủ và yêu cầu dẫn đến lỗi ứng dụng. Thông tin xác thực bao gồm khoá API và mã ứng dụng khách (đối với các dự án Gói cao cấp và Gói đặc biệt đã di chuyển). Để biết thông tin chi tiết, hãy xem phần Tổng quan về gói cao cấp và thông tin về cách sử dụng mã ứng dụng khách.
Chỉ số về việc sử dụng được trình bày trong bảng (Yêu cầu, Lỗi và Độ trễ) và biểu đồ (Lưu lượng truy cập, Lỗi và Độ trễ). Để theo dõi:
Tất cả API: Bạn có thể lọc và nhóm các chỉ số sử dụng cho tất cả các API theo những cách sau:
- Lọc theo khoảng thời gian và API.
- Xem lưu lượng truy cập, lỗi và độ trễ được nhóm theo mã phản hồi, API và thông tin xác thực.
Một API cụ thể: Bạn có thể lọc và nhóm các chỉ số sử dụng cho một API cụ thể theo những cách sau:
- Lọc theo khoảng thời gian, phiên bản API, thông tin xác thực và phương thức.
- Xem lưu lượng truy cập, lỗi và độ trễ được nhóm theo mã phản hồi, phương thức và phiên bản API, cũng như thông tin đăng nhập.
Trang tổng quan về API và dịch vụ
Trang tổng quan API và dịch vụ cung cấp thông tin tổng quan về chỉ số sử dụng cho tất cả các API bật cho dự án của bạn: API Nền tảng Google Maps cũng như các API và dịch vụ khác.
Trang tổng quan có 3 biểu đồ và một bảng. Bạn có thể lọc mức sử dụng hiển thị trong các biểu đồ và bảng bằng cách chọn khoảng thời gian từ 1 giờ đến 30 ngày qua.
Biểu đồ Lưu lượng truy cập cho thấy mức sử dụng số truy vấn mỗi giây (QPS) trên mỗi API.
Biểu đồ Lỗi cho thấy tỷ lệ phần trăm số yêu cầu dẫn đến lỗi trên mỗi API.
Biểu đồ Độ trễ cho biết độ trễ trung bình của các yêu cầu trên mỗi API.
Bên dưới biểu đồ có một bảng liệt kê các API và dịch vụ đã bật. Số yêu cầu là số lượng yêu cầu (trong khoảng thời gian đã chọn). Số lỗi là số lượng yêu cầu dẫn đến lỗi. Độ trễ (độ trễ trung bình và phân vị) là độ trễ của các yêu cầu này.
Để truy cập vào trang Trang tổng quan API và dịch vụ:
- Mở trang Bộ chọn dự án trong Cloud Console:
- Chọn dự án của bạn. Trang tổng quan về API và dịch vụ sẽ xuất hiện.
Nếu trang không xuất hiện, hãy chọn nút trình đơn
rồi chọn API và dịch vụ.
Để biết thêm thông tin, hãy xem phần Theo dõi mức sử dụng API.
Trang tổng quan về Google Maps
Trang Tổng quan của Google Maps có một bảng liệt kê các API đã bật và các yêu cầu sử dụng trong 30 ngày qua. Các yêu cầu mà API thực hiện cũng sẽ hiện dưới dạng biểu đồ. Biểu đồ thanh toán cho thấy hoá đơn hiện tại và tổng mức sử dụng trong 3 tháng qua.
Để truy cập vào Trang tổng quan về Nền tảng Google Maps:
- Mở trang Nền tảng Google Maps trong Cloud Console:
- Trên trình đơn bên trái, hãy chọn Tổng quan.
Trang API của Nền tảng Google Maps
Trang API của Google Maps có hai bảng. Bảng API đã bật cho thấy số lượng yêu cầu, số lượng lỗi và độ trễ trung bình của mỗi API đã bật trong 30 ngày qua. Bảng API bổ sung liệt kê các API chưa được bật.
Để truy cập trang API Nền tảng Google Maps:
- Mở trang Nền tảng Google Maps trong Cloud Console:
- Trong trình đơn bên trái, hãy chọn API.
Trang Chỉ số của Google Maps
Trang Chỉ số của Google Maps cho thấy 3 biểu đồ: Lưu lượng truy cập, Lỗi và Độ trễ trung bình. Dữ liệu sử dụng trong biểu đồ có thể được nhóm theo lớp Mã phản hồi, API, phương thức API, Thông tin xác thực, Nền tảng và Miền.
Bên dưới các biểu đồ, trang Chỉ số có một bảng API cho thấy các yêu cầu, lỗi và độ trễ của những API bạn đã chọn.
Khi sử dụng trình đơn thả xuống API ở trên cùng và các tuỳ chọn nhóm và lọc trong ngăn bên phải, bạn có thể nhóm và lọc các chỉ số sử dụng đã hiển thị bằng cách chọn một số API, Thông tin xác thực, lớp Mã phản hồi, Loại nền tảng và/hoặc Miền. Bạn cũng có thể chọn khoảng thời gian (từ một giờ đến 30 ngày qua) và độ chi tiết (mỗi giây hoặc ngày) cho các chỉ số sử dụng được hiển thị.
Các hình ảnh sau đây minh hoạ bộ lọc Nền tảng và Miền cho một API duy nhất khi bạn chọn nhóm theo Nền tảng và Miền trong danh sách thả xuống Grouped by (Nhóm theo):
Để truy cập vào trang Chỉ số API Nền tảng Google Maps:
- Mở trang Nền tảng Google Maps trong Cloud Console:
- Trên trình đơn bên trái, hãy chọn Chỉ số.
Báo cáo về thông tin xác thực
Bạn có thể lọc và nhóm các chỉ số theo thông tin xác thực đã dùng để tải API.
| Định dạng thông tin xác thực | Ý nghĩa |
|---|---|
| Tên khoá Ví dụ: "Khoá ứng dụng dành cho thiết bị di động" |
Khoá API đã được dùng để tải API bằng ?key=...: Bạn có thể tìm thấy tên khoá trên Bảng điều khiển của Nền tảng Maps trong phần Khoá và thông tin xác thực. |
| Số dự án Ví dụ: "project_number:123456", trong đó 123456 là số dự án. |
Nếu bạn thấy thông tin xác thực này, thì có hai trường hợp sau đây:
|
Biểu đồ mã phản hồi
Biểu đồ Lưu lượng truy cập theo mã phản hồi và Lỗi theo mã phản hồi phân tách mức sử dụng theo lớp mã phản hồi HTTP. Bảng này cho thấy mối liên kết giữa trạng thái phản hồi của API Nền tảng Google Maps và lớp mã phản hồi HTTP:
| Trạng thái của API Maps | Lớp mã phản hồi HTTP – Báo cáo sử dụng (2xx, 3xx, 4xx, 5xx) |
Ghi chú |
|---|---|---|
| OK | 2xx | Phản hồi thành công. Đây là yêu cầu có thể lập hoá đơn và sẽ sử dụng hạn mức. |
| OK | 3xx | Phản hồi thành công. Đây là yêu cầu có thể lập hoá đơn và sẽ sử dụng hạn mức. Ví dụ: các yêu cầu thành công về Địa điểm sẽ trả về lệnh chuyển hướng 302 đến hình ảnh được tham chiếu. |
| DATA_NOT_AVAILABLE | 4xx(1) | Phản hồi thành công cho biết rằng không có dữ liệu nào cho vị trí đầu vào. Đây là yêu cầu có thể lập hoá đơn và sẽ sử dụng hạn mức. |
| ZERO_RESULTS | 4xx(1) | Phản hồi thành công không trả về kết quả nào. Đây là yêu cầu có thể lập hoá đơn và sẽ sử dụng hạn mức. |
| NOT_FOUND | 4xx(1) | Đối với API Đường đi, thông báo này cho biết rằng không thể mã hoá địa lý ít nhất một trong các vị trí được chỉ định trong điểm gốc, điểm đến hoặc điểm tham chiếu của yêu cầu. Đối với API Địa điểm, thông báo này cho biết rằng không tìm thấy vị trí được tham chiếu (place_id) trong cơ sở dữ liệu Địa điểm. Đây là yêu cầu có thể lập hoá đơn và sẽ sử dụng hạn mức. |
| INVALID_REQUEST (giá trị thông số không hợp lệ), MAX_WAYPOINTS_EXCEEDED, MAX_ROUTE_LENGTH_EXCEEDED và các giá trị khác. |
4xx | Lỗi do giá trị thông số không hợp lệ. Hãy kiểm tra phản hồi của API để biết thêm thông tin chi tiết. Đây là yêu cầu có thể lập hoá đơn và sẽ sử dụng hạn mức. |
| REQUEST_DENIED | 4xx | Lỗi ứng dụng do lỗi xác thực, lỗi truy cập và các nguyên nhân khác. Hãy kiểm tra phản hồi của API để biết thêm thông tin chi tiết. |
| OVER_TOTAL_LIMIT, OVER_QUERY_LIMIT, Resources_EXHAUSTED, rateLimitExceptions Đã vượt quá giới hạn, DailyLimit Luồng |
4xx | Lỗi ứng dụng do có quá nhiều yêu cầu trong khoảng thời gian cho phép. Hãy thử lại yêu cầu vào lúc khác. Hãy kiểm tra phản hồi của API để biết thêm thông tin chi tiết. |
| INVALID_REQUEST (thông số không hợp lệ hoặc bị thiếu, yêu cầu phân tích cú pháp hoặc lỗi xác thực) | 4xx | Lỗi ứng dụng khách do yêu cầu không hợp lệ. Hãy kiểm tra phản hồi của API để biết thêm thông tin chi tiết. |
| NOT_FOUND (404) | 4xx | Đối với
API vị trí địa lý,
thông báo này cho biết rằng thông tin đầu vào không đủ để tạo
thông tin ước tính vị trí. Đối với Roads API (API Đường), thông báo này cho biết không thể điều chỉnh dữ liệu đầu vào theo cách hợp lý. Đây là yêu cầu có thể lập hoá đơn và sẽ sử dụng hạn mức. |
| UNKNOWN_ERROR | 5xx | Lỗi máy chủ cho biết không thể xử lý yêu cầu: lỗi nội bộ, quá tải dịch vụ, không có sẵn, hết giờ, v.v. |
1
Để cải thiện tính nhất quán của báo cáo mã lỗi, API Nền tảng Google Maps
sẽ di chuyển:
1) từ lớp mã phản hồi HTTP 2xx sang 4xx cho
các trạng thái của API Maps: DATA_NOT_AVAILABLE, NOT_FOUND,
ZERO_RESULTS - trạng thái,
2) từ lớp mã phản hồi HTTP 2xx sang 4xx cho
các trạng thái của API Maps: REQUEST_DENIED, OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT, dailyLimitExceeded,
lớp mã phản hồi HTTP/Maps/5, {13/Maps API} từ phản hồi sang trạng thái HTTP , {13/Maps} từ 2xxrateLimitExceededuserRateLimitExceeded5xxUNKNOWN_ERROR
Bạn có thể thấy cả hai mã phản hồi trong giai đoạn chuyển đổi. Mã phản hồi được trả về trong phản hồi của API Maps không thay đổi.
Xác nhận rằng sự gia tăng về 4xx và/hoặc 5xx trong Chỉ số của nền tảng Google Maps có liên quan đến quá trình di chuyển này bằng cách kiểm tra xem mã phản hồi chính xác nào tăng trong Metrics Explorer (tìm hiểu thêm về cách sử dụng Google Cloud Monitoring cho Nền tảng Google Maps).
|
||
Để biết thêm thông tin về mã trạng thái và thông báo lỗi, hãy xem tài liệu phản hồi cho API mà bạn quan tâm (ví dụ: Phản hồi mã hoá địa lý hoặc Phản hồi chỉ đường).
Thông số giải pháp của Nền tảng Google Maps
Nền tảng Google Maps cung cấp nhiều loại mã mẫu để giúp bạn thiết lập và chạy chiến dịch một cách nhanh chóng. Ví dụ: bạn có thể sử dụng Trình tạo nhanh trong Cloud Console, làm theo hướng dẫn triển khai về các giải pháp trong ngành và học từ lớp học lập trình.
Để hiểu cách sử dụng và cách cải thiện các giải pháp, Google đưa tham số truy vấn solution_channel vào các lệnh gọi API để thu thập thông tin về việc sử dụng mã mẫu:
- Theo mặc định, tham số truy vấn
solution_channelđược đưa vào mã mẫu giải pháp. - Tham số truy vấn này sẽ trả về số liệu phân tích về quá trình áp dụng giải pháp cho Google nhằm cải thiện chất lượng giải pháp trong các vòng lặp sau này.
- Bạn có thể chọn không sử dụng bằng cách xoá tham số truy vấn
solution_channelvà giá trị của tham số đó khỏi mã mẫu. - Bạn không cần phải giữ lại thông số này. Việc xoá tham số truy vấn sẽ không ảnh hưởng đến hiệu suất.
- Tham số truy vấn chỉ được dùng cho báo cáo mức sử dụng mã mẫu.
- Tham số truy vấn này tách biệt với mọi dữ liệu phân tích và báo cáo dành riêng cho API. Điều đó có nghĩa là việc xoá tham số khỏi mã mẫu của giải pháp sẽ không tắt tính năng báo cáo API JavaScript của Maps nội bộ.
Báo cáo hạn mức
Hạn mức đặt ra giới hạn về số lượng yêu cầu mà dự án của bạn có thể thực hiện tới các API Nền tảng Google Maps. Có thể giới hạn yêu cầu theo ba cách: mỗi ngày, mỗi phút và theo người dùng mỗi phút. Chỉ những yêu cầu thành công và gây ra lỗi máy chủ mới được tính vào hạn mức. Các yêu cầu không được xác thực không được tính vào hạn mức.
Mức sử dụng hạn mức được hiển thị trong biểu đồ trên trang Hạn mức trong Cloud Console và có thể được nhóm theo các yêu cầu mỗi phút. Hạn mức hiện tại cho các API đã chọn hiển thị trong bảng bên dưới biểu đồ hạn mức sử dụng.
Để biết hạn mức mỗi phút cho bất kỳ sản phẩm API GMP nào, hãy sử dụng công cụ tính này.
Trang Hạn mức trên Google Maps
Trang Hạn mức của Google Maps cho thấy hạn mức và mức sử dụng hạn mức cho API cụ thể mà bạn đã chọn.
Biểu đồ hạn mức sử dụng trên Google Cloud Console cho thấy tổng lưu lượng truy cập của các khoá API và mã ứng dụng khách. Lưu lượng truy cập bằng mã ứng dụng khách cũng có trong biểu đồ Chỉ số trên Cloud Console.
Trang chỉ hiển thị các yêu cầu có tiêu thụ hạn mức: yêu cầu thành công (OK, ZERO_RESULTS, DATA_NOT_AVAILABLE) và các yêu cầu gây ra lỗi máy chủ (NOT_FOUND, INVALID_REQUEST/INVALID_VALUE (giá trị thông số không hợp lệ), UNKNOWN_ERROR).
Các yêu cầu gây ra lỗi ứng dụng — lỗi xác thực, uỷ quyền và lỗi đối số không hợp lệ (REQUEST_DENIED, OVER_QUERY_LIMIT, INVALID_REQUEST (tham số không hợp lệ, lỗi phân tích cú pháp yêu cầu)) — không chiếm hạn mức và không được hiển thị.
Đơn vị hạn mức là yêu cầu cho hầu hết các API Nền tảng Google Maps (Maps Static API, API tĩnh Chế độ xem đường phố, API mã hóa địa lý, API chỉ đường, API địa điểm, API múi giờ, API vị trí địa lý và API độ cao) nhưng có một số ngoại lệ:
- Đối với API ma trận khoảng cách, đơn vị hạn mức là một phần tử là cặp điểm gốc – điểm đến.
- Đối với API JavaScript của Maps, đơn vị hạn mức là một lượt tải bản đồ.
- Đối với SDK bản đồ dành cho Android và SDK bản đồ dành cho iOS, đơn vị hạn mức là một yêu cầu về Chế độ xem đường phố hoặc tải Ảnh toàn cảnh. Bạn có thể sử dụng miễn phí lượt tải bản đồ và không sử dụng hạn mức.
Để truy cập vào trang Hạn mức của Nền tảng Google Maps:
- Mở trang Nền tảng Google Maps trong Cloud Console:
- Trên trình đơn bên trái, hãy chọn Hạn mức.
- Chọn một API trong danh sách API thả xuống.
Đơn vị hạn ngạch
Bảng này hiển thị đơn vị hạn mức cho API Nền tảng Google Maps.
| API Nền tảng Google Maps | Đơn vị hạn mức |
|---|---|
| Maps | |
| SDK Bản đồ dành cho Android | 1 ảnh toàn cảnh |
| SDK Bản đồ dành cho iOS | 1 ảnh toàn cảnh |
| API Thẻ thông tin bản đồ | 1 yêu cầu |
| API Chế độ xem từ trên không của Maps | 1 yêu cầu |
| Maps Static API | 1 yêu cầu |
| API JavaScript cho Maps | 1 lượt tải bản đồ |
| Street View Static API | 1 yêu cầu |
| Maps Embed API | 1 lượt tải bản đồ |
| Tuyến đường | |
| API tuyến đường (Tính toán tuyến đường) | 1 yêu cầu |
| API tuyến đường (Ma trận tính toán) | 1 phần tử (cặp nguồn gốc – đích đến) |
| Directions API | 1 yêu cầu |
| Distance Matrix API | 1 phần tử (cặp nguồn gốc – đích đến) |
| Roads API | 1 yêu cầu |
| Địa điểm | |
| Places API | 1 yêu cầu |
| Address Validation API | 1 yêu cầu |
| Geocoding API | 1 yêu cầu |
| Geolocation API | 1 yêu cầu |
| Time Zone API | 1 yêu cầu |
| Môi trường | |
| API Chất lượng không khí (CurrentConditions và HeatmapTile) | 1 yêu cầu |
| API Chất lượng không khí (Lịch sử) | 1 trang |
| Pollen API | 1 yêu cầu |
| Solar API | 1 yêu cầu |
Báo cáo thanh toán
Xem báo cáo thanh toán
Các báo cáo thanh toán liên quan đến việc sử dụng các sản phẩm trên Nền tảng Google Maps hiện có trong Google Cloud Console. Để biết thêm thông tin, hãy xem phần Thanh toán.
Cách xem báo cáo thanh toán:
- Mở trang Bộ chọn dự án trong Cloud Console:
- Chọn dự án.
- Chọn nút trình đơn
rồi chọn Thanh toán.
- Nếu bạn có nhiều tài khoản thanh toán, hãy chọn Chuyển đến tài khoản thanh toán được liên kết để mở trang Tổng quan cho tài khoản thanh toán được liên kết.
- Trong trình đơn bên trái, hãy chọn Báo cáo để mở trang Báo cáo thanh toán cho tài khoản thanh toán được liên kết.
Cách đọc biểu đồ trong báo cáo thanh toán
Báo cáo thanh toán trình bày chi phí theo thời gian dưới dạng biểu đồ dạng đường xếp chồng. Chế độ xem mặc định hiển thị chi phí hằng ngày theo mức sử dụng cụ thể của tháng hiện tại được nhóm theo dự án (đối với tất cả sản phẩm), bao gồm mọi khoản tín dụng theo mức sử dụng cụ thể đã áp dụng, cũng như tổng chi phí dự đoán cho toàn bộ tháng hiện tại. Mỗi dòng trong biểu đồ (và hàng trong bảng tóm tắt) tương ứng với dự án, được xếp hạng lớn nhất đến nhỏ nhất theo chi phí. Tìm hiểu thêm về cách diễn giải biểu đồ báo cáo thanh toán.
Mẹo: Phân tích mức sử dụng và chi phí cho mỗi SKU
Để hiểu chính xác hơn thông tin chi tiết về mô hình định giá trả tiền theo mức dùng và mức độ tác động của mô hình này đối với việc triển khai, hãy xem mức sử dụng và chi phí theo SKU.
Để thay đổi chế độ xem báo cáo để hiển thị mục hàng theo SKU:
- Trong bảng điều khiển ở bên phải biểu đồ, hãy mở rộng bộ lọc Nhóm theo.
- Chọn SKU.
Các bộ lọc báo cáo thanh toán khác có sẵn bao gồm Phạm vi thời gian, Dự án, Sản phẩm, SKU và Vị trí, cho phép bạn lọc theo nơi gửi yêu cầu API.
Để phân loại nguồn sử dụng ngoài sản phẩm, hãy nhóm các báo cáo thanh toán theo một trong các giá trị được liệt kê. Ba khoá liên quan đến API Nền tảng Google Maps là goog-maps-api-key-suffix (bốn ký tự cuối cùng của khoá API), goog-maps-platform-type (nền tảng: Android, iOS, JavaScript hoặc dịch vụ web) và goog-maps-channel (giá trị kênh số được đặt từ truy vấn API). Thông tin thêm về cách lọc và nhóm.
Bạn có thể thay đổi chế độ xem biểu đồ để loại trừ các khoản tín dụng theo mức sử dụng cụ thể bằng cách bỏ chọn hộp đánh dấu Bao gồm các khoản tín dụng vào chi phí trong bảng điều khiển bên phải.
Theo dõi và hạn chế sử dụng
Để lập kế hoạch ngân sách và kiểm soát chi phí, bạn có thể làm những việc sau:
- Đặt cảnh báo về ngân sách để theo dõi mức tăng mức chi tiêu của bạn so với một số tiền cụ thể. Việc đặt ngân sách không giới hạn mức sử dụng API mà chỉ thông báo cho bạn khi số tiền chi tiêu đạt đến gần mức đã chỉ định.
Giới hạn mức sử dụng API hằng ngày để quản lý chi phí sử dụng các API có tính phí. Bằng cách đặt giới hạn về số yêu cầu mỗi ngày, bạn có thể giới hạn chi tiêu của mình. Sử dụng một phương trình đơn giản để xác định hạn mức ngân sách hằng ngày tuỳ thuộc vào số tiền bạn muốn chi tiêu. Ví dụ: (Mức chi tiêu hằng tháng /giá mỗi SKU)/30 = số yêu cầu giới hạn mỗi ngày (đối với một API).
Theo dõi mức sử dụng trên mỗi kênh
Để theo dõi mức sử dụng qua các kênh số, bạn phải thêm thông số "channel" (kênh) vào các yêu cầu API. Các giá trị kênh duy nhất được chấp nhận là các số từ 0-999. Dưới đây là một số ví dụ:
- API dịch vụ web mã hóa địa lý
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1 - API JavaScript của Maps
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap" async defer></script>
Theo dõi hoạt động sử dụng kênh ngay trên Báo cáo thanh toán. Các kênh sẽ phản ánh trong mục Nhãn là kênh goog-maps-channel chính.
Lọc báo cáo thanh toán theo SKU và kênh
- Sử dụng bộ lọc Nhóm theo SKU.
- Chọn con nháy Nhãn.
- Chọn trình đơn thả xuống Key (Khoá) rồi chọn goog-maps-channel (kênh của goog-maps).
- Chọn trình đơn thả xuống Giá trị rồi chọn các kênh số mà bạn muốn lọc.
Nhóm theo khoá Nhãn goog-maps-channel để xem chi phí do mỗi kênh tạo ra.
Sau khi bạn triển khai dữ liệu sử dụng kênh trong các yêu cầu của mình, có thể phải mất một khoảng thời gian ngắn (tối đa 24 giờ) trước khi dữ liệu đó được phản ánh trong báo cáo thanh toán.
Xuất dữ liệu thanh toán bằng BigQuery
Bạn cũng có thể xuất dữ liệu thanh toán sang BigQuery.
BigQuery Export cho phép bạn tự động xuất dữ liệu chi tiết về việc thanh toán qua đám mây (chẳng hạn như dữ liệu về mức sử dụng và chi phí ước tính) trong suốt cả ngày sang một tập dữ liệu BigQuery mà bạn chỉ định. Sau đó, bạn có thể truy cập vào dữ liệu thanh toán từ BigQuery để phân tích chi tiết. Điều này giúp bạn hiểu rõ hơn nguồn gốc sử dụng Nền tảng Google Maps.
Nếu muốn bắt đầu với tính năng xuất BigQuery và truy vấn dữ liệu, bạn có thể thử truy vấn mẫu bên dưới. Trước khi chạy truy vấn này, bạn phải:
- Bật tính năng thanh toán và tính năng xuất dữ liệu thanh toán của BigQuery trên tài khoản.
- Định dạng bảng là PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID, trong đó:
- PROJECT_ID là mã dự án thực tế của bạn (ví dụ: "my-project-123456").
- DATASET_NAME là tên của tập dữ liệu mà bạn đã tạo (ví dụ: "SampleDataSet").
- BILLING_ACCOUNT_ID là mã tham chiếu đến ID tài khoản thanh toán của bạn,
có tiền tố là "gcp_billing_exportv1" và thay đổi dấu gạch ngang (-) thành dấu gạch dưới (_).
Ví dụ: Mã tài khoản thanh toán 123456-7890AB-CDEF01 sẽ trở thành
gcp_billing_export_v1_123456_789AB_CDEF01.
#standardSQL
SELECT Date(usage_start_time, "America/Los_Angeles") AS billing_day,
invoice.month AS invoice_month,
service.description AS service,
sku.description AS sku,
(
SELECT l.value
FROM Unnest(labels) AS l
WHERE l.KEY = 'goog-maps-channel' ) AS goog_maps_channel,
Round(Sum(usage.amount), 2) AS usage_amount,
usage.unit AS usage_unit,
Round(Sum(cost), 2) AS cost,
cost_type,
currency
FROM PROJECT_ID.DATASET_NAME.gcp_billing_export_v1_BILLING_ACCOUNT_ID
WHERE invoice.month = '202002' -- Change the invoice month with the same format as the example.
GROUP BY billing_day,
invoice_month,
service,
sku,
goog_maps_channel,
usage_unit,
cost_type,
currency
ORDER BY billing_day,
service,
sku
Thông tin có liên quan
Thanh toán qua đám mây:
- Tạo, sửa đổi hoặc đóng tài khoản thanh toán Cloud
- Sửa đổi chế độ cài đặt thanh toán của dự án
- Xem báo cáo thanh toán và xu hướng chi phí
- Thiết lập ngân sách và cảnh báo về ngân sách
- Giới hạn mức sử dụng API
Trạng thái phản hồi và báo cáo
Bảng dưới đây cho thấy sự liên kết giữa trạng thái của API Maps, mã phản hồi HTTP được trả về trong phản hồi của API Maps và lớp mã phản hồi HTTP trong Báo cáo sử dụng, đồng thời cho biết liệu yêu cầu tương ứng có xuất hiện trong báo cáo Mức sử dụng, Hạn mức và Thanh toán hay không.
Báo cáo về việc sử dụng trong mục Chỉ số của Nền tảng Google Maps
cung cấp thông tin chi tiết về HTTP response code class. Nếu bạn cần độ chi tiết cao hơn, hãy xem mục Mã trạng thái phản hồi có trong bài viết Theo dõi mức sử dụng Nền tảng Google Maps.
| Mã phản hồi có trong phản hồi của API Maps | Có trong Báo cáo sử dụng | Đã báo cáo cho | |||
|---|---|---|---|---|---|
| Trạng thái của API Maps | Mã phản hồi HTTP | Lớp mã phản hồi HTTP | Cách sử dụng | Hạn mức | Thanh toán |
| OK | 200, 204, 302 |
2xx, 3xx |
Có | Có | Có |
| DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS |
200, 404 |
4xx1 | Có | Có | Có |
| INVALID_REQUEST (giá trị thông số không hợp lệ), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED, , v.v. |
200, 400 |
4xx | Có | Có | Có |
| INVALID_REQUEST (thông số không hợp lệ/bị thiếu, lỗi phân tích cú pháp yêu cầu) | 200, 400 |
4xx | Có | Không | Không |
| REQUEST_DENIED | 200, 400, 403 |
4xx1 | Có | Không | Không |
| OVER_TOTAL_LIMIT, OVER_QUERY_LIMIT, Resources_EXHAUSTED, DailyLimitExceptions, rateLimitLimited, userRateLimited |
200, 403, 429 |
4xx1 | Có | Không | Không |
| UNKNOWN_ERROR | 200, 500, 503 |
5xx1 | Có | Có | Không |
1
Để cải thiện tính nhất quán của báo cáo mã lỗi, API Nền tảng Google Maps
sẽ di chuyển:
1) từ lớp mã phản hồi HTTP 2xx sang 4xx cho
các trạng thái của API Maps: DATA_NOT_AVAILABLE, NOT_FOUND,
ZERO_RESULTS - trạng thái,
2) từ lớp mã phản hồi HTTP 2xx sang 4xx cho
các trạng thái của API Maps: REQUEST_DENIED, OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT, dailyLimitExceeded,
lớp mã phản hồi HTTP/Maps/5, {13/Maps API} từ phản hồi sang trạng thái HTTP , {13/Maps} từ 2xxrateLimitExceededuserRateLimitExceeded5xxUNKNOWN_ERROR
Bạn có thể thấy cả hai mã phản hồi trong giai đoạn chuyển đổi. Mã phản hồi được trả về trong phản hồi của API Maps không thay đổi.
Xác nhận rằng sự gia tăng về 4xx và/hoặc 5xx trong Chỉ số của nền tảng Google Maps có liên quan đến quá trình di chuyển này bằng cách kiểm tra xem mã phản hồi chính xác nào tăng trong Metrics Explorer (tìm hiểu thêm về cách sử dụng Google Cloud Monitoring cho Nền tảng Google Maps).
|
|||||
Báo cáo tham gia
Thông tin chi tiết về doanh nghiệp
Nền tảng Google Maps cung cấp cho bạn thông tin chi tiết về cách người dùng tương tác với bản đồ của bạn. Thông tin chi tiết này bao gồm các chỉ số tương tác chính như số lượt xem trên bản đồ hoặc lượt tương tác với địa điểm yêu thích. Bạn có thể phân tích những thông tin chi tiết này để khám phá các vị trí phổ biến cho hoạt động quảng cáo và tiếp thị hoặc để tối ưu hoá trải nghiệm người dùng.
Các chức năng báo cáo thông tin chi tiết về hoạt động kinh doanh bao gồm:
- Xem thông tin tổng quan nhanh về thông tin chi tiết về hoạt động kinh doanh để nhanh chóng nắm bắt các xu hướng chính trong thông tin chi tiết về hoạt động kinh doanh
- Xem chi tiết để phân tích một chỉ số cụ thể trong bảng điều khiển để tìm hiểu kỹ hơn về các chỉ số
- Xuất các chỉ số sang CSV để bạn có thể phân tích dữ liệu thông tin chi tiết về doanh nghiệp trong công cụ phân tích doanh nghiệp mà bạn yêu thích
Các chỉ số tương tác hiện có bao gồm:
- Chế độ xem bản đồ: Theo dõi chế độ xem trên bản đồ khi xoay, thu phóng hoặc nghiêng. Số lượt xem bản đồ được tính theo mã bưu chính hằng tuần (từ Chủ Nhật đến thứ Bảy theo giờ Thái Bình Dương). Dữ liệu mới được cung cấp hằng tuần vào thứ Tư đầu tiên sau khoảng thời gian quan sát.
Người dùng có thể xem thông tin chi tiết về doanh nghiệp trên trang Chỉ số trong Cloud Console. Dự án phải bật API JavaScript của Maps.
Bạn có thể phân tích các chỉ số tương tác ngay trong bảng điều khiển bằng chức năng Lọc và Nhóm theo để phân tích chi tiết hơn về các chỉ số. Ví dụ: bạn có thể chọn lọc theo một khu vực cụ thể để tìm hiểu cách xu hướng của chế độ xem bản đồ chỉ đối với mã bưu chính ở khu vực đó. Mặt khác, bạn có thể muốn nhóm theo một khu vực cụ thể để tổng hợp các lượt tương tác trong khu vực đó.
Người dùng có thể xuất toàn bộ tập dữ liệu hoặc chế độ xem đã lọc sang CSV để phân tích thêm trong công cụ phân tích doanh nghiệp mà bạn yêu thích. Bạn có thể tải xuống tối đa 90 ngày cùng một lúc và những tệp tải xuống lớn hơn 60 nghìn ô sẽ bị cắt bớt. Quá trình xuất dữ liệu lượt xem bản đồ sang CSV có thể mất vài phút, tuỳ thuộc vào phạm vi thời gian đã chọn.
Chỉ số thông tin chi tiết về doanh nghiệp được ẩn danh, do đó chỉ phản ánh xu hướng tổng thể về mức độ tương tác với bản đồ của bạn. Số lượng thấp có thể được làm tròn thành 0 và số lượng đóng góp từ các điểm ngoại lai có thể được giảm xuống.
Bạn có thể kiểm soát quyền truy cập vào thông tin chi tiết về doanh nghiệp đối với dự án trên Google Cloud trong Bảng điều khiển Google Cloud bằng cách sử dụng quyền Maps Analytics. Chủ sở hữu dự án được cấp quyền này theo mặc định và có thể cấp quyền truy cập cho người dùng khác khi cần.
Bạn không nên sử dụng thông tin chi tiết về doanh nghiệp để ước tính chi phí sử dụng. Vui lòng tham khảo báo cáo về việc sử dụng để biết thêm thông tin về việc sử dụng.
Bộ định vị loại Plus
Đối với người dùng Locator Plus, trang tổng quan về số liệu phân tích sẽ giúp bạn phân tích và tạo thông tin chi tiết từ dữ liệu của mình, cung cấp thông tin rõ ràng về mức độ người mua sắm đang tương tác với công cụ định vị cửa hàng của bạn. Bạn có thể đo lường hiệu suất hằng tuần, bao gồm cả số lượt xem, số lượt tương tác với Thông tin chi tiết về địa điểm và Tìm kiếm cũng như tỷ lệ tương tác tổng thể. Ngoài ra, trang tổng quan này cung cấp các điểm chuẩn quan trọng để so sánh phương thức triển khai của bạn so với các nhà bán lẻ khác.
- Chuyển đến Locator Plus trong Google Cloud Console.
- Hãy chuyển đến phần Báo cáo về mức độ tương tác trong Google Cloud Console để xem trang tổng quan về số liệu phân tích.
Báo cáo đo điểm chuẩn cho phép bạn so sánh dữ liệu của mình với dữ liệu tổng hợp trong ngành từ các công ty khác có chia sẻ dữ liệu của họ. Thông tin so sánh này cung cấp bối cảnh có giá trị, giúp bạn đặt ra mục tiêu có ý nghĩa, hiểu rõ hơn về các xu hướng trong ngành và tìm hiểu hiệu quả hoạt động của mình so với các đối thủ cạnh tranh.
Để xem dữ liệu đo điểm chuẩn, dữ liệu tương tác của bạn sẽ được đưa vào điểm chuẩn của Google một cách ẩn danh. Để chọn không hiển thị cả chế độ xem lẫn dữ liệu tương tác một cách ẩn danh trong báo cáo đo điểm chuẩn, hãy gửi thẻ hỗ trợ. Thông thường, phiếu yêu cầu hỗ trợ sẽ được giải quyết trong vòng 3 ngày.