Các lỗi phổ biến trong Google Ads và cách xử lý hiệu quả

AdGroupCriterionError

Lỗi: INVALID_KEYWORD_TEXT

• Tóm tắt: Văn bản từ khoá chứa các ký tự không hợp lệ. Tham khảo mục Thêm từ khoá để biết chi tiết.
• Nguyên nhân thường gặp: Văn bản từ khoá bao gồm các ký tự đặc biệt hoặc không được hỗ trợ.
• Cách xử lý: Không có.
• Mẹo phòng tránh: Xác thực văn bản từ khoá trong ứng dụng của bạn trước khi gửi yêu cầu tới API.

AdGroupError

Lỗi: DUPLICATE_ADGROUP_NAME

• Tóm tắt: Tên nhóm quảng cáo bị trùng lặp với một nhóm quảng cáo hiện có.
• Nguyên nhân thường gặp: Đặt tên nhóm quảng cáo mới giống với tên nhóm quảng cáo đang hoạt động hoặc tạm dừng.
• Cách xử lý: Ghi lại lỗi, hiển thị thông báo cho người dùng và gợi ý một tên nhóm quảng cáo duy nhất. Bạn cũng có thể liệt kê danh sách các tên hiện đang được sử dụng.
• Mẹo phòng tránh: Tránh đặt tên trùng lặp bằng cách kiểm tra danh sách tên nhóm quảng cáo trước khi tạo mới.

AssetError

Lỗi: DUPLICATE_ASSET

• Tóm tắt: Có hai thao tác tạo trùng lặp trong cùng một yêu cầu, chứa cùng dữ liệu nhị phân.
• Nguyên nhân thường gặp: Gửi yêu cầu thay đổi với các thao tác tạo trùng lặp dữ liệu.
• Cách xử lý: Tách thao tác tạo thành phần ra một yêu cầu riêng biệt, sau đó liên kết với thành phần đó trong yêu cầu kế tiếp. Ngoài ra, có thể sử dụng mã nhận dạng tạm thời trong cùng một yêu cầu.
• Mẹo phòng tránh: Tránh gửi các thao tác trùng lặp trong cùng một yêu cầu.

AuthenticationError

Lỗi: CLIENT_CUSTOMER_ID_INVALID

• Tóm tắt: Mã khách hàng không đúng định dạng số.
• Nguyên nhân thường gặp: Sử dụng định dạng mã khách hàng không chính xác (ví dụ: 123-456-7890 thay vì 1234567890).
• Cách xử lý: Không có.
• Mẹo phòng tránh: Đảm bảo mã khách hàng đúng định dạng khi gửi yêu cầu. Tham khảo bài viết Bắt đầu để biết thêm chi tiết.

Lỗi: CLIENT_CUSTOMER_ID_IS_REQUIRED

• Tóm tắt: Mã khách hàng không được chỉ định trong tiêu đề HTTP.
• Nguyên nhân thường gặp: Thiếu mã khách hàng trong tiêu đề HTTP của yêu cầu.
• Cách xử lý: Không có.
• Mẹo phòng tránh: Mã khách hàng là bắt buộc cho tất cả các yêu cầu API. Hãy sử dụng thư viện ứng dụng của Google để đảm bảo tự động xử lý mã khách hàng.

Lỗi: CUSTOMER_NOT_FOUND

• Tóm tắt: Không tìm thấy tài khoản có mã khách hàng được cung cấp.
• Nguyên nhân thường gặp: Yêu cầu truy cập tài khoản ngay sau khi tạo, trước khi nó được thiết lập trong hệ thống.
• Cách xử lý: Đợi 5 phút đầu tiên, sau đó thử lại sau mỗi 30 giây.
• Mẹo phòng tránh: Đợi một khoảng thời gian trước khi gửi yêu cầu sau khi tạo tài khoản mới.

Lỗi: GOOGLE_ACCOUNT_COOKIE_INVALID

• Tóm tắt: Mã truy cập trong tiêu đề không hợp lệ hoặc đã hết hạn.
• Nguyên nhân thường gặp: Sử dụng mã truy cập không còn hiệu lực.
• Cách xử lý: Yêu cầu một mã truy cập mới. Nếu sử dụng thư viện ứng dụng của Google, tham khảo tài liệu để làm mới mã truy cập.
• Mẹo phòng tránh: Lưu trữ và sử dụng lại mã truy cập cho đến khi hết hạn.

Lỗi: NOT_ADS_USER

• Tóm tắt: Tài khoản Google được sử dụng không liên kết với bất kỳ tài khoản Google Ads nào.
• Nguyên nhân thường gặp: Sử dụng tài khoản Google chưa kích hoạt Google Ads.
• Cách xử lý: Đăng nhập bằng tài khoản Google Ads hợp lệ hoặc mời tài khoản Google tham gia một tài khoản Google Ads hiện có. Vào Tools and Settings > Access and security để thêm quyền truy cập.
• Mẹo phòng tránh: Không có.

Lỗi: OAUTH_TOKEN_INVALID

• Tóm tắt: Mã thông báo OAuth trong tiêu đề không hợp lệ.
• Nguyên nhân thường gặp: Mã truy cập không đúng hoặc nhầm lẫn với mã làm mới hoặc mã uỷ quyền.
• Cách xử lý: Đảm bảo mã truy cập đúng và liên kết với tài khoản. Với tài khoản người quản lý, sử dụng mã làm mới để truy cập tất cả tài khoản khách hàng.
• Mẹo phòng tránh: Đọc tài liệu về mã truy cập, mã làm mới và quy trình OAuth2 để tránh nhầm lẫn.

AuthorizationError

Lỗi: CUSTOMER_NOT_ENABLED

• Tóm tắt: Không thể truy cập tài khoản khách hàng do tài khoản chưa được bật.
• Nguyên nhân thường gặp: Tài khoản khách hàng chưa hoàn tất quy trình đăng ký hoặc đã bị vô hiệu hoá.
• Cách xử lý: Đăng nhập vào giao diện người dùng Google Ads và hoàn tất quy trình đăng ký tài khoản. Nếu tài khoản đã bị hủy kích hoạt, hãy tham khảo bài viết Kích hoạt lại tài khoản Google Ads đã hủy.
• Mẹo phòng tránh: Kiểm tra trạng thái tài khoản để xác định xem tài khoản có bị vô hiệu hoá hay không.

Lỗi: DEVELOPER_TOKEN_NOT_APPROVED

• Tóm tắt: Mã nhà phát triển chỉ được phép sử dụng với tài khoản thử nghiệm, nhưng lại cố gắng truy cập tài khoản không phải thử nghiệm.
• Nguyên nhân thường gặp: Dùng mã nhà phát triển thử nghiệm để truy cập tài khoản không phải thử nghiệm.
• Cách xử lý: Nếu cần truy cập tài khoản không thử nghiệm, hãy đăng ký nâng cấp mã nhà phát triển lên Quyền truy cập tiêu chuẩn hoặc Quyền truy cập cơ bản.
• Mẹo phòng tránh: Đảm bảo sử dụng đúng loại mã nhà phát triển cho từng loại tài khoản.

Lỗi: DEVELOPER_TOKEN_PROHIBITED

• Tóm tắt: Mã nhà phát triển không được phép sử dụng với dự án trong yêu cầu.
• Nguyên nhân thường gặp: Dự án trên Google API Console bị liên kết sai mã nhà phát triển từ tài khoản người quản lý. Sau khi gửi yêu cầu API Google Ads, mã nhà phát triển sẽ được gắn vĩnh viễn với dự án đó.
• Cách xử lý: Tạo một dự án mới trên Google API Console nếu cần sử dụng mã nhà phát triển từ tài khoản người quản lý khác.
• Mẹo phòng tránh: Khi thay đổi mã nhà phát triển, hãy thiết lập một dự án Google API Console mới để tránh lỗi.

Lỗi: USER_PERMISSION_DENIED

• Tóm tắt: Người dùng được uỷ quyền không có quyền truy cập tài khoản khách hàng hiện tại.
• Nguyên nhân thường gặp: Người dùng có quyền truy cập vào tài khoản người quản lý nhưng không chỉ định login-customer-id trong yêu cầu.
• Cách xử lý: Không có.
• Mẹo phòng tránh: Chỉ định login-customer-id là mã tài khoản người quản lý mà không bao gồm dấu gạch nối (-). Thư viện ứng dụng của Google đã hỗ trợ thực hiện việc này.

BiddingError

Lỗi: BID_TOO_MANY_FRACTIONAL_DIGITS

• Tóm tắt: Giá trị giá thầu không phải bội số chính xác của đơn vị tiền tệ tối thiểu của tài khoản. Ví dụ: 0,015 USD (tương ứng 15000 micro) không phải là giá thầu hợp lệ.
• Nguyên nhân thường gặp: Không có.
• Cách xử lý: Không có.
• Mẹo phòng tránh: Xác minh rằng giá thầu là bội số chính xác của đơn vị tiền tệ tối thiểu được cấu hình trong tài khoản.

Lỗi: BID_TOO_BIG

• Tóm tắt: Giá trị giá thầu vượt mức giới hạn, ngay cả khi nằm trong ngân sách chiến dịch.
• Nguyên nhân thường gặp: Không có.
• Cách xử lý: Không có.
• Mẹo phòng tránh: Đối với các tài khoản tham gia chương trình Google Ad Grants, đảm bảo giá thầu CPC không vượt mức tối đa được chương trình quy định.

CampaignBudgetError

Lỗi: MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC

• Tóm tắt: Ngân sách chiến dịch không đủ mức tối thiểu của đơn vị tiền tệ tài khoản.
• Nguyên nhân thường gặp: Không có.
• Cách xử lý: Không có.
• Mẹo phòng tránh: Xác minh rằng ngân sách được đặt lớn hơn hoặc bằng đơn vị tiền tệ tối thiểu của tài khoản.

Lỗi: NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT

• Tóm tắt: Ngân sách không phải bội số chính xác của đơn vị tối thiểu khi chuyển đổi từ micro sang đơn vị tiền tệ tài khoản.
• Nguyên nhân thường gặp: Không có.
• Cách xử lý: Không có.
• Mẹo phòng tránh: Đảm bảo rằng ngân sách chia hết cho đơn vị tiền tệ tối thiểu được cấu hình trong tài khoản.

CampaignError

Lỗi: DUPLICATE_CAMPAIGN_NAME

• Tóm tắt: Tên chiến dịch trùng lặp với chiến dịch hiện tại.
• Nguyên nhân thường gặp: Đặt tên chiến dịch mới giống với chiến dịch đang hoạt động hoặc tạm dừng.
• Cách xử lý: Ghi lại lỗi, hiển thị thông báo cho người dùng và gợi ý tên khác cho chiến dịch. Bạn cũng có thể hiển thị danh sách tên chiến dịch hiện có để tránh trùng lặp.
• Mẹo phòng tránh: Kiểm tra danh sách chiến dịch hiện có trước khi đặt tên mới.

CriterionError

Lỗi: KEYWORD_HAS_INVALID_CHARS

• Tóm tắt: Từ khóa chứa ký tự không hợp lệ trong quá trình thêm hoặc chỉnh sửa.
• Nguyên nhân thường gặp: Sử dụng ký tự đặc biệt như !, @, %, *.
• Cách xử lý: Không có.
• Mẹo phòng tránh: Kiểm tra từ khóa và loại bỏ các ký tự không hợp lệ trước khi gửi yêu cầu. Tham khảo mục Thêm từ khoá để biết thêm chi tiết.

DistinctError

Lỗi: DUPLICATE_ELEMENT

• Tóm tắt: Yêu cầu API chứa các tham số trùng lặp không cần thiết.
• Nguyên nhân thường gặp: Gửi yêu cầu với các phần tử, toán tử hoặc tham số bị lặp lại.
• Cách xử lý: Không có.
• Mẹo phòng tránh: Xóa tất cả các phần tử trùng lặp trước khi gửi yêu cầu. Đảm bảo tuân thủ điều kiện ràng buộc DistinctElements trong cấu hình API.

InternalError

Lỗi: DEADLINE_EXCEEDED

• Tóm tắt: Yêu cầu không thể hoàn tất trong thời gian chờ và bị gián đoạn.
• Nguyên nhân thường gặp: Yêu cầu tìm kiếm tạo ra phản hồi quá lớn hoặc yêu cầu thay đổi quá phức tạp khiến hệ thống không xử lý kịp.
• Cách xử lý: Chờ khoảng 30 giây và thử lại yêu cầu. Nếu lỗi tiếp diễn, hãy chia nhỏ yêu cầu thành nhiều phần nhỏ hơn để xử lý nhanh hơn.
• Mẹo phòng tránh: Xem xét cách sử dụng phân đoạn để giảm kích thước phản hồi. Hiểu rõ các giới hạn của lớp truyền tải gRPC.

Lỗi: INTERNAL_ERROR

• Tóm tắt: Lỗi không mong muốn xảy ra trong quá trình xử lý yêu cầu.
• Nguyên nhân thường gặp: Sự cố không xác định từ API gây ra lỗi.
• Cách xử lý: Thử lại các yêu cầu không thành công, sử dụng lịch trình thời gian đợi lũy thừa cho mỗi lần thử lại.
• Mẹo phòng tránh: Không có.

Lỗi: TRANSIENT_ERROR

• Tóm tắt: Lỗi tạm thời xảy ra trong hệ thống nội bộ API.
• Nguyên nhân thường gặp: Sự cố tạm thời trong hệ thống API.
• Cách xử lý: Thử lại các yêu cầu không thành công, sử dụng lịch trình thời gian đợi lũy thừa cho mỗi lần thử lại.
• Mẹo phòng tránh: Không có.

InvalidGrantError

Lỗi: invalid_grant (malformed auth code)

• Tóm tắt: Mã uỷ quyền không đúng định dạng để trao đổi lấy mã thông báo OAuth.
• Nguyên nhân thường gặp: Người dùng cố gắng tạo mã làm mới trên một tổ hợp thông tin uỷ quyền và ứng dụng OAuth đã được sử dụng trước đó.
• Cách xử lý: Thu hồi mã làm mới hiện có trước khi tạo mã mới. Lưu ý rằng việc thu hồi sẽ khiến mã hiện tại không còn hiệu lực, bao gồm cả các mã truy cập được tạo từ mã làm mới đó.
• Mẹo phòng tránh: Lưu trữ mã làm mới ở nơi an toàn để tránh việc phải tạo lại mã.

MutateError

Lỗi: RESOURCE_NOT_FOUND

• Tóm tắt: Yêu cầu tham chiếu đến một tài nguyên không tồn tại hoặc không tìm thấy.
• Nguyên nhân thường gặp: Yêu cầu cố gắng thay đổi hoặc tham chiếu tài nguyên đã bị xóa, không tồn tại, hoặc tên tài nguyên không đúng định dạng.
• Cách xử lý: Sử dụng yêu cầu tìm kiếm để truy xuất tên tài nguyên hiện có trước khi thực hiện thay đổi. Tham khảo tài liệu thư viện ứng dụng để tạo tên tài nguyên hợp lệ.
• Mẹo phòng tránh: Không tạo tên tài nguyên thủ công. Sử dụng các phương thức trợ giúp từ thư viện ứng dụng của Google Ads API.

NotEmptyError

Lỗi: EMPTY_LIST

• Tóm tắt: Danh sách bắt buộc trong yêu cầu đang trống.
• Nguyên nhân thường gặp: Truyền danh sách thao tác trống vào phương thức mutate.
• Cách xử lý: Không có.
• Mẹo phòng tránh: Đảm bảo danh sách thao tác không trống trước khi gửi yêu cầu.

QuotaError

Lỗi: RESOURCE_EXHAUSTED

• Tóm tắt: Yêu cầu vượt quá giới hạn tần suất của hệ thống.
• Nguyên nhân thường gặp: Không có.
• Cách xử lý: Không có.
• Mẹo phòng tránh: Thêm độ trễ ngắn giữa các yêu cầu hoặc kết hợp nhiều thao tác vào ít yêu cầu hơn để giảm tần suất gọi API.

RangeError

Lỗi: TOO_LOW

• Tóm tắt: Giá trị nhỏ hơn mức tối thiểu được phép.
• Nguyên nhân thường gặp: Không chỉ định mã nhận dạng, dẫn đến giá trị 0 được truyền vào yêu cầu.
• Cách xử lý: Không có.
• Mẹo phòng tránh: Luôn kiểm tra các giới hạn về phạm vi giá trị được quy định trong tài liệu tham khảo API trước khi gửi yêu cầu.

RequestError

Lỗi: INVALID_INPUT

• Tóm tắt: Yêu cầu không đúng định dạng.
• Nguyên nhân thường gặp: URL hoặc nội dung yêu cầu không tuân thủ định dạng được chỉ định.
• Cách xử lý: Không có.
• Mẹo phòng tránh: Xác minh định dạng yêu cầu trước khi gửi.

Lỗi: REQUIRED_FIELD_MISSING

• Tóm tắt: Thiếu trường bắt buộc trong yêu cầu.
• Nguyên nhân thường gặp: Không điền trường bắt buộc khi cố gắng thêm thực thể.
• Cách xử lý: Ghi lại lỗi và hiển thị thông báo cụ thể cho người dùng. Sử dụng thuộc tính fieldPath trong phản hồi lỗi để xác định trường bị thiếu.
• Mẹo phòng tránh: Tham khảo tài liệu API để biết danh sách các trường bắt buộc cho từng loại yêu cầu.

ResourceCountLimitExceededError

Lỗi: RESOURCE_LIMIT

• Tóm tắt: Yêu cầu tạo tài nguyên mới khiến tổng số tài nguyên vượt quá giới hạn hệ thống.
• Nguyên nhân thường gặp: Giới hạn số lượng tài nguyên hiện có trong một ngữ cảnh cụ thể.
• Cách xử lý: Xác định giới hạn gặp phải bằng cách kiểm tra phần Giới hạn hệ thống. Tái sử dụng tài nguyên hiện có hoặc xóa tài nguyên không cần thiết để tạo không gian cho tài nguyên mới.
• Mẹo phòng tránh: Sử dụng các công cụ tìm kiếm API để theo dõi số lượng tài nguyên và quản lý hiệu quả.

StringLengthError

Lỗi: TOO_LONG

• Tóm tắt: Chuỗi được gán cho trường cụ thể dài hơn giới hạn cho phép.
• Nguyên nhân thường gặp: Dòng tiêu đề hoặc nội dung mô tả trong quảng cáo chứa quá nhiều ký tự.
• Cách xử lý: Xác định giới hạn độ dài áp dụng, sửa đổi chuỗi cho phù hợp và gửi lại yêu cầu.
• Mẹo phòng tránh: Kiểm tra kỹ các giới hạn về độ dài chuỗi và tuân thủ quy định để tránh lỗi.