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 có vấn đề mà bạn không thể giải quyết sau khi đọc các tài nguyên trên trang web này, hãy liên hệ với bộ phận hỗ trợ và chuẩn bị sẵn các thông tin sau:

  • Mã đại lý và mã nhà quảng cáo Search Ads 360 mà bạn đang cố gắng truy cập

  • Mã số dự án trên Google API Console

  • Tên người dùng của Tài khoản Google mà bạn đang sử dụng để truy cập API.
    Đây là tài khoản đã được cấp quyền truy cập vào Search Ads 360, cũng là tài khoản mà bạn dùng để thiết lập lệnh ủy quyền.

  • Đoạn mã yêu cầu của bạn

  • Phản hồi JSON
    Nếu phản hồi là một lỗi, hãy nhớ bao gồm thông báo lỗi, chứ không chỉ mã lỗi số.

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. Đảm bảo bạn đã hoàn thành các bước sau:

  1. Chuyển đến Google API Console.

  2. Chọn dự án của bạn. Nếu bạn chưa tạo dự án, hãy xem phần Tạo dự án cho ứng dụng của bạn.

  3. Trong thanh bên ở phía bên trái, hãy mở rộng mục API và xác thực. Tiếp theo, hãy nhấp vào API. Trong danh sách API, hãy đảm bảo trạng thái là BẬT cho API Search Ads 360.

Invalid grant

Lỗi này xảy ra khi mã làm mới của bạn không hợp lệ. Bạn có thể lấy mã 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 xin phép 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à mật khẩu ứng dụng, cũng như khi bạn nhận được mã làm mới.

Lỗi khi tải lượt chuyển đổi lên

Bảng sau đây liệt kê các lỗi mà bạn có thể gặp phải khi tải lượt chuyển đổi lên. Lưu ý rằng 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 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 các lượt chuyển đổi lên lại sau khi bạn thực hiện những việc sau:

  • Đã xác minh rằng mã lượt nhấp được tạo 4 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 phân bổ lượt chuyển đổi cho những lượt truy cập cụ thể, hãy đợi ít nhất 30 phút sau lượt truy cập trước khi tải lượt chuyển đổi lên. Search Ads 360 có thể không nhận ra mã lượt nhấp của lượt truy cập nếu bạn tải lên sớm hơn 30 phút sau khi người dùng truy cập. Trong một số ít trường hợp, bạn có thể phải đợi tới 4 giờ để Search Ads 360 có thể nhận ra mã lượt nhấp.

  • Xác nhận rằng lượt nhấp đó đến từ một nguồn hợp lệ như được chỉ báo bằng thông số gclsrc.

  • 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 là không chính xác hoặc chưa có sẵn. 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 chữ hoa chữ thường.
  • Đảm bảo bạn không thêm ký tự Unicode hoặc dấu cách đôi không in được 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 rằng hoạt động Floodlight tồn tại cho nhà quảng cáo bạn đã chỉ định trong cột advertiserId. (Có thể bạn đã chỉ định nhà quảng cáo không chính xác.)
  • 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 biến Floodlight tuỳ chỉnh mà bạn chỉ định đã được thiết lập dưới dạng phương diện (không phải là chỉ số) cho nhà quảng cáo 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

Đảm bảo biến Floodlight tuỳ chỉnh mà bạn chỉ định đã được thiết lập dưới dạng chỉ số (không phải thứ nguyên) cho nhà quảng cáo 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}

Một người nào đó đã tải một lượt chuyển đổi lên trong cùng phạm vi và mã chuyển đổi nhà quảng cáo được chỉ định trong cột conversionId.

"Mã chuyển đổi nhà quảng cáo" là mã do bạn tạo. Search Ads 360 yêu cầu mã nhận dạng này phải là duy nhất trong một phạm vi nhất định. Mã chuyển đổi trên Search Ads 360 do Search Ads 360 tạo ra và được đảm bảo là không trùng lặp.

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 nhà quảng cáo không tồn tại. Đả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 đ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 khách và mật khẩu ứng dụng khách, đồng thời khi lấy mã làm mới, hãy nhớ sử dụng Tài khoản Google đã được cấp quyền truy cập cho 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 nhà quảng cáo.

Mã chuyển đổi của nhà quảng cáo là mã nhận dạng mà bạn tạo và chỉ định trong cột conversionId. Search Ads 360 yêu cầu mã này là duy nhấ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ã nhận dạng 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.

Báo cáo mã phản hồi và thông báo lỗi

Nếu bạn yêu cầu báo cáo và phản hồi là một thông báo lỗi, hãy xem bài viết Mã phản hồi trong API Search Ads 360Phản hồi lỗi chuẩn để biết thêm thông tin về lỗi.

Dữ liệu trong giao diện người dùng Search Ads 360 không khớp với báo cáo do API trả về

Dữ liệu trong giao diện người dùng Search Ads 360 phải khớp với dữ liệu mà API trả về theo mặc định. Nếu bạn đặt includeRemovedEntities thành true trong một yêu cầu báo cáo, hãy nhớ chọn hộp đánh dấu Show removed (Hiển thị các mục đã xoá) trong giao diện người dùng.

Trừ khi 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: 2023-02-27 UTC.