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 vấn đề 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 các thông tin sau:

  • Mã công ty quảng cáo 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 Bảng điều khiển API của Google

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

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

  • Phản hồi JSON
    Nếu phản hồi là lỗi, hãy nhớ thêm thông báo lỗi chứ không chỉ mã lỗi dạng 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. Hãy đảm bảo bạn đã làm những việ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 ở 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ã 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 uỷ quyền đề xuất.

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 trên màn hình Consent 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 khi 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ượt chuyển đổi lên lại sau khi bạn hoàn tất 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 phân bổ lượt chuyển đổi cho một số lượt truy cập cụ thể, hãy đợi ít nhất 30 phút sau khi lượt truy cập đó xảy ra 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 30 phút sau lượt truy cập. Trong một số ít trường hợp, bạn có thể phải đợi tối đa 4 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ệ vì được biểu thị bằng tham 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 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, do đó, hãy đảm bảo yêu cầu của bạn khớp chính xác với cách viết hoa.
  • Đả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ủa 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 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 là do Search Ads 360 tạo và được đả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ã.

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 Bảng điều khiển API của Google để truy xuất mã ứng dụng khách và mật khẩu ứng dụng khách, cũng như khi bạn nhận được 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 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 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ã 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à kết quả phản hồi là một thông báo lỗi, hãy xem phần Mã phản hồi trong API Search Ads 360Phản hồi lỗi tiêu 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ề

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