Khắc phục sự cố
Nếu bạn gặp sự cố khi sử dụng API Search Ads 360, hãy xem phần khắc phục sự cố này.
Nếu bạn không thể giải quyết một vấn đề nào đó sau khi đọc các tài nguyên trên trang web này, hãy liên hệ với nhóm hỗ trợ và chuẩn bị sẵn những thông tin sau:
Lỗi ủy quyền
Dưới đây là một số lỗi uỷ quyền thường gặp:
| Thông điệp |
Mô tả |
Access Not Configured. Please use Google API Console to activate the API for your project.
|
Lỗi này xảy ra nếu bạn chưa bật API Search Ads 360 cho tài khoản của mình. Hãy đảm bảo bạn đã làm những việc sau:
Chuyển đến Google API Console.
Chọn dự án của bạn. Nếu bạn chưa tạo dự án, hãy xem bài viết Tạo dự án cho ứng dụng của bạn. Trong thanh bên ở bên trái, hãy mở rộng mục API và xác thực. Tiếp theo, nhấp vào API. Trong danh sách API, hãy đảm bảo trạng thái của API Search Ads 360 là BẬT.
|
Invalid grant
|
Lỗi này xảy ra khi mã thông báo làm mới của bạn không hợp lệ. Bạn có thể lấy mã thông báo làm mới bằng cách gọi tập lệnh tiện ích Search Ads 360 như sau:
sa360Api.py --login
Tìm hiểu thêm về quy trình đề xuất để uỷ quyền.
|
Invalid client
no application name
|
Lỗi này xảy ra nếu bạn chưa chỉ định tên sản phẩm khi thiết lập dự án trong Google API Console. Để khắc phục lỗi này, hãy
nhập tên sản phẩm của bạn trên màn hình Consent (Sự đồng ý) của Google API Console.
|
Các loại lỗi uỷ quyền khác |
Hãy nhớ sử dụng một Tài khoản Google đã được cấp quyền truy cập vào Search Ads 360 khi bạn đăng nhập vào Google API Console để truy xuất mã ứng dụng và khoá ứng dụng, cũng như khi bạn lấy mã làm mới.
|
Lỗi tải lượt chuyển đổi lên
Bảng sau đây liệt kê các lỗi bạn có thể gặp phải khi tải lượt chuyển đổi lên. Xin lưu ý rằng các mã lỗi thập lục phân là không thể thay đổi, vì vậy, bạn có thể sử dụng các mã này trong tập lệnh của riêng mình để xác định lỗi.
| Mã lỗi |
Thông điệp |
Mô tả |
0x00000101 |
Click ID '{ID}' is not found
|
Mã lượt nhấp mà bạn chỉ định trong yêu cầu
update không hợp lệ. Tải lại lượt chuyển đổi lên sau khi bạn thực hiện các bước sau:
Xác minh rằng mã lượt nhấp được tạo 6 giờ trước khi tải lượt chuyển đổi lên. Kích hoạt dịch vụ chuyển đổi API. Nếu bạn đang
xác định lượt chuyển đổi cho một số lượt truy cập cụ thể, hãy đợi ít nhất 6 giờ sau lượt truy cập đó rồi mới tải lượt chuyển đổi lên. Search Ads 360 có thể không nhận dạng được clickID của lượt truy cập nếu bạn tải lên sớm hơn 6 giờ sau khi có lượt truy cập. Trong một số ít trường hợp, bạn có thể phải đợi tối đa 24 giờ thì Search Ads 360 mới có thể nhận dạng được clickId. Xác nhận rằng lượt nhấp đến từ một nguồn hợp lệ như được tham số gclsrc cho biết. Xác nhận rằng bạn đã chỉ định đúng nhà quảng cáo trong cột
advertiserId. Xác minh mã lượt nhấp của bạn được tạo trong vòng 90 ngày qua.
|
0x0000010E |
Floodlight activity name '{name}' is not found |
Tên của hoạt động Floodlight được chỉ định trong cột
segmentationName
không chính xác hoặc chưa có. Nếu bạn thấy lỗi này, hãy kiểm tra các vấn đề thường gặp sau:
- Tên có phân biệt chữ hoa chữ thường, vì vậy, hãy đảm bảo yêu cầu của bạn khớp chính xác với tên.
- Đảm bảo bạn không thêm bất kỳ ký tự Unicode không in được hoặc khoảng trắng đôi nào vào tên hoạt động Floodlight.
- Đảm bảo bạn đã chỉ định tên của
hoạt động Floodlight, chứ không phải
cột Floodlight.
- Kiểm tra để đảm bảo hoạt động Floodlight tồn tại cho nhà quảng cáo mà bạn đã chỉ định trong cột
advertiserId. (Có thể bạn đã chỉ định sai nhà quảng cáo.)
- Sau khi bạn tạo hoặc chỉnh sửa một hoạt động Floodlight, hãy đợi vài giờ trước khi tải lượt chuyển đổi lên cho hoạt động đó.
|
0x00000115 |
Custom dimension '{name}' is not found |
Đảm bảo rằng biến Floodlight tuỳ chỉnh mà bạn chỉ định đã được thiết lập làm phương diện (không phải chỉ số) cho nhà quảng cáo được liên kết với clickId, criterionId hoặc productGroupId mà bạn đang phân bổ cho lượt chuyển đổi.
|
0x00000116 |
Custom metric '{name}' is not found |
Hãy đảm bảo rằng biến Floodlight tuỳ chỉnh mà bạn chỉ định đã được thiết lập làm chỉ số (không phải phương diện) cho nhà quảng cáo được liên kết với clickId, criterionId hoặc productGroupId mà bạn đang phân bổ cho lượt chuyển đổi.
|
0x0000011A |
The advertiser conversion ID is already specified for a conversion with Search Ads 360
conversion ID {ID} |
Có người đã tải một lượt chuyển đổi lên cho cùng một phạm vi và mã chuyển đổi của nhà quảng cáo được chỉ định trong cột
conversionId.
"Mã chuyển đổi của nhà quảng cáo" là mã do bạn tạo. Search Ads 360 yêu cầu mã này phải là duy nhất trong một phạm vi nhất định.
Mã chuyển đổi Search Ads 360 do Search Ads 360 tạo và đảm bảo là duy nhất.
|
0x0000011B |
Advertiser conversion ID '{ID}' is not found |
Yêu cầu
update của bạn đã cố gắng cập nhật một mã chuyển đổi của nhà quảng cáo không tồn tại. Hãy đảm bảo bạn đã chỉ định đúng mã nhận dạng. |
0x0000011D |
User does not have permission to view advertiser {advertiser ID} |
Tài khoản Google mà khách hàng của bạn đang sử dụng không có quyền xem nhà quảng cáo được chỉ định trong yêu cầu.
Khi bạn đăng nhập vào Google API Console để truy xuất mã ứng dụng và khoá ứng dụng, cũng như khi bạn nhận được mã thông báo làm mới, hãy nhớ sử dụng một Tài khoản Google đã được cấp quyền truy cập vào nhà quảng cáo mà bạn đã chỉ định.
|
0x0000011F |
Advertiser conversion ID is already specified in this request |
Hai hoặc nhiều lượt chuyển đổi trong yêu cầu chỉ định cùng một phạm vi và mã chuyển đổi của nhà quảng cáo.
Mã chuyển đổi của nhà quảng cáo là mã bạn tạo và chỉ định trong cột
conversionId. Search Ads 360 yêu cầu mã này phải có một giá trị riêng biệt trong một phạm vi nhất định.
|
0x0000011E |
The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION) |
Mã hoặc tên hoạt động Floodlight mà bạn cung cấp không khớp với loại chuyển đổi mà bạn chỉ định.
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2024-12-21 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2024-12-21 UTC."],[[["This page provides troubleshooting information for common issues encountered while using the Search Ads 360 API, including authorization and conversion upload errors."],["If the provided resources don't resolve your issue, contact support with specific information about your problem, including your Search Ads 360 and Google API Console credentials, code snippets, and JSON responses."],["The page lists common authorization errors such as `Access Not Configured`, `Invalid grant`, and `Invalid client`, with explanations and solutions."],["It also includes a table of conversion upload errors, detailing their hexadecimal error codes, descriptions, and troubleshooting steps."],["For report discrepancies, refer to the Response Codes and Standard Error Responses documentation and ensure the `includeRemovedEntities` setting in your request matches the \"Show removed\" checkbox selection in the Search Ads 360 UI."]]],["When troubleshooting the Search Ads 360 API, consult the provided resources. If issues persist, contact support, providing your Agency/Advertiser ID, Project Number, API access username, code snippet, and JSON response (including full error messages). Common authorization errors include `Access Not Configured`, `Invalid grant`, and `Invalid client`, often resolved by enabling the API, refreshing tokens, or naming your project. Conversion upload errors relate to invalid click IDs, Floodlight activity names, or custom dimensions/metrics. Ensure correct permissions and data consistency between UI and API.\n"]]
