Khắc phục sự cố

Nếu bạn gặp vấn đề khi sử dụng Search Ads 360 API, hãy xem qua phần khắc phục sự cố này.

Nếu bạn gặp vấ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 những thông tin sau:

  • Mã nhận dạng công ty quảng cáo và Mã nhận dạng nhà quảng cáo trên 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, 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à một lỗi, hãy nhớ đưa vào 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:

Nhắn tin 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 Search Ads 360 API cho tài khoản của mình. Đả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 ở phía bên trái, hãy mở rộng APIs & auth (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 của Search Ads 360 API 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ã 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 được đề 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 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 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 khách và khoá bí mật của ứng dụng khách, 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 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 Nhắn tin Mô tả
0x00000101

Click ID '{ID}' is not found

Mã lượt nhấp mà bạn chỉ định trong yêu cầu insert hoặc update không hợp lệ. Tải lại lượt chuyển đổi lên sau khi bạn đã làm những việc sau:

  • Đã xác minh rằng mã lượt nhấp được tạo 6 giờ trước khi lượt chuyển đổi được tả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 các lượt truy cập cụ thể, hãy đợi ít nhất 6 giờ 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 6 giờ 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 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 là từ một nguồn hợp lệ như được chỉ định bằng tham số gclsrc.

  • Đã xác minh rằng mã lượt nhấp của bạn được tạo trong vòng 90 ngày qua.

0x00000106 Either a click ID or keyword ID is required

Lượt chuyển đổi không chỉ định nguồn phân bổ. Chỉ định cột clickId hoặc các cột customerId, campaignId, adGroupId và criterionId để xác định từ khoá.

0x0000010C Either of Floodlight activity ID or Floodlight activity name is required

Chỉ định segmentationType: "FLOODLIGHT" và hoạt động Floodlight trong cột segmentationName hoặc segmentationId.

Khi bạn chỉnh sửa một lượt chuyển đổi mà Search Ads 360 đã ghi lại thông qua thẻ Floodlight, bạn phải có hoạt động Floodlight để xác định lượt chuyển đổi đó.

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 kiểu chữ.
  • Đảm bảo rằng bạn không thêm bất kỳ ký tự Unicode không in được hoặc dấu cách kép nào vào tên hoạt động Floodlight.
  • Đảm bảo bạn đã chỉ định tên của một hoạt động Floodlight, chứ không phải một cột Floodlight.
  • Kiểm tra để đảm bảo hoạt động Floodlight tồn tại cho nhà quảng cáo có mã lượt nhấp hoặc từ khoá trong yêu cầu của bạn.
  • 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 làm phương diện (không phải 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 làm chỉ số (không phải phương diệ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.

0x00000119 A conversion ID or advertiser conversion ID is required to modify an existing conversion

Yêu cầu update của bạn không chỉ định cột conversionId. Bạn phải có conversionId để xác định lượt chuyển đổi mà bạn muốn chỉnh sửa. Xem phần Ngừng sử dụng dsConversionId.

0x0000011A The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}

Ai đó đã 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ã nhận dạng 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 cho một phạm vi nhất định. Mã chuyển đổi Search Ads 360 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 kiểm tra các vấn đề thường gặp sau đây:

  • Đảm bảo bạn đã chỉ định đúng mã nhận dạng trong cột conversionId. Đối với lượt chuyển đổi được tải lên thông qua API, đây là conversionId mà bạn đã chỉ định khi chèn lượt chuyển đổi. Đối với lượt chuyển đổi được ghi lại thông qua thẻ Floodlight, đây là mã đơn đặt hàng Floodlight.
  • Đảm bảo conversionTimestamp là dấu thời gian của lượt chuyển đổi hiện có, tính bằng mili giây theo giờ UTC. Dấu thời gian được chuyển đổi từ múi giờ địa phương hoặc được chỉ định bằng giây thay vì mili giây không khớp với lượt chuyển đổi hiện có.
  • Đối với những lượt chuyển đổi được ghi nhận thông qua thẻ Floodlight, hãy đảm bảo rằng bạn đã chỉ định hoạt động Floodlight của lượt chuyển đổi trong cột segmentationName hoặc segmentationId và lượt chuyển đổi đó đã xảy ra trong vòng 28 ngày qua.
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 mà mã lượt nhấp hoặc từ khoá trong yêu cầu thuộc về.

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 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 vào nhà quảng cáo đó.

0x0000011F Advertiser conversion ID is already specified in this request

Có ít nhất hai 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ã mà bạn tạo và chỉ định trong cột conversionId. 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.

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 lượt chuyển đổi mà bạn đã chỉ định.

0x00000124 Conversion timestamp is before click timestamp

conversionTimestamp sớm hơn thời gian nhấp mà bạn đã chỉ định trong cột clickId. Đảm bảo dấu thời gian được chỉ định theo mili giây Epoch UTC, không phải theo giây hoặc theo múi giờ địa phương.

0x00000125 Conversion age is older than the max supported age

Yêu cầu update của bạn đã cố gắng chỉnh sửa một lượt chuyển đổi quá cũ nên không thể chỉnh sửa. Bạn chỉ có thể chỉnh sửa những lượt chuyển đổi mà Search Ads 360 ghi nhận thông qua thẻ Floodlight trong vòng 28 ngày kể từ conversionTimestamp.

0x00000126 Service internal error

Hãy thử lại yêu cầu của bạn sau một thời gian. Đây có thể là lỗi tạm thời. Vui lòng liên hệ với nhóm hỗ trợ SA360 nếu lỗi này vẫn tiếp diễn.

0x00000129 Invalid customer ID: {ID}

Search Ads 360 không tìm thấy mã khách hàng mà bạn đã chỉ định trong cột customerId. Chỉ định mã khách hàng Search Ads 360 mới của tài khoản khách hàng có chứa từ khoá, ví dụ: 123-456-7890.

0x0000012C Cannot find this keyword ID in Search Ads 360.

Search Ads 360 không tìm thấy từ khoá được xác định bằng các cột customerId, campaignId, adGroupId và criterionId. Đảm bảo rằng cả 4 mã nhận dạng đều là mã nhận dạng Search Ads 360 mới và từ khoá thuộc về nhóm quảng cáo, chiến dịch và tài khoản khách hàng mà bạn đã chỉ định.

0x0000012E Please provide the full set of new Search Ads 360 IDs: {missing ID}

Một lượt chuyển đổi được phân bổ cho một từ khoá cần chỉ định customerId, campaignId, adGroupId và criterionId. Thông báo này nêu tên mã nhận dạng bị thiếu. Xem bài viết Chỉ phân bổ lượt chuyển đổi cho một từ khoá.

0x0000012F Editing a click ID older than 60 days is not supported.

Yêu cầu update của bạn đã chỉ định một clickId được tạo cách đây hơn 60 ngày. Bạn chỉ có thể chỉnh sửa lượt chuyển đổi trong vòng 60 ngày kể từ ngày xảy ra lượt nhấp.

0x0000013C Conversion editing using integer DS conversion ID is deprecated. Please use conversion ID instead.

Yêu cầu update của bạn đã chỉ định cột dsConversionId không còn được dùng nữa hoặc đã chuyển mã chuyển đổi Search Ads 360 trong cột conversionId. Thay vào đó, hãy xác định lượt chuyển đổi bằng mã chuyển đổi của nhà quảng cáo. Xem phần Ngừng sử dụng dsConversionId.

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

Nếu bạn yêu cầu một báo cáo và phản hồi là thông báo lỗi, hãy xem phần Mã phản hồi trong Search Ads 360 API và Phả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ề

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 mục đã xoá trong giao diện người dùng.