Trang này được dịch bởi Cloud Translation API.

Lỗi và cảnh báo

Trang này thảo luận về các loại lỗi và cảnh báo mà bạn có thể gặp phải khi sử dụng Display & Video 360 API.

Lỗi API

Các yêu cầu được gửi tới API không thể hoàn tất sẽ trả về một thông báo lỗi. Các yêu cầu trả về lỗi sẽ được tính vào hạn mức người dùng và sẽ được cân nhắc khi xem xét các yêu cầu để bổ sung hạn mức. Cần xử lý và xử lý các phản hồi lỗi để tránh các lỗi trong tương lai.

Phản hồi lỗi có định dạng sau và bao gồm mã phản hồi HTTP, thông báo lỗi và trạng thái mã RPC của Google:

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

Dưới đây là danh sách các lỗi API thường gặp cùng với hành động nên thực hiện nếu các lỗi đó được trả về:

Mã	RPC	Việc nên làm
`400`	`INVALID_ARGUMENT`	Đã xảy ra vấn đề với yêu cầu của bạn. Xem lại trường thông báo trong phản hồi lỗi và sửa đổi yêu cầu của bạn cho phù hợp.
`401`	`UNAUTHENTICATED`	Không xác thực được yêu cầu của bạn một cách chính xác. Xác minh rằng bạn đưa thông tin xác thực OAuth hợp lệ vào yêu cầu của mình. Để biết thêm thông tin về vấn đề này, vui lòng tham khảo Hướng dẫn bắt đầu sử dụng của chúng tôi.
`403`	`PERMISSION_DENIED`	Bạn không có quyền cần thiết để hoàn tất yêu cầu của mình. Xác minh rằng tài khoản người dùng của bạn có các quyền phù hợp đối với đối tác hoặc nhà quảng cáo có liên quan.
`404`	`NOT_FOUND`	Không tìm thấy tài nguyên bạn đang cố truy xuất. Xác minh rằng mã nhận dạng bạn đang sử dụng là chính xác và cho loại tài nguyên đang được truy xuất.
`409`	`ABORTED`	Tài nguyên mà bạn đang cố gắng sửa đổi đang được sửa đổi ở nơi khác. Chờ vài giây rồi thử lại yêu cầu.
`429`	`RESOURCE_EXHAUSTED`	Bạn đã vượt quá giới hạn tốc độ hoặc hạn mức yêu cầu hằng ngày. Kiểm tra mức sử dụng API của bạn bằng Google API Console và sửa đổi quy trình công việc để hoạt động trong giới hạn hạn mức hiện có. Để biết thêm thông tin, vui lòng xem trang của chúng tôi về cách Tối ưu hoá hạn mức. Nếu không thể hoàn thành các hoạt động trong phạm vi hạn mức hằng ngày nhất định, bạn có thể yêu cầu thêm hạn mức.
`500`	`INTERNAL`	API đã gặp lỗi nội bộ. Chờ vài giây rồi thử lại yêu cầu. Nếu vẫn xảy ra lỗi, hãy liên hệ với nhóm hỗ trợ.
`504`	`DEADLINE_EXCEEDED`	API mất quá nhiều thời gian để hoàn tất yêu cầu. Chờ vài giây rồi thử yêu cầu lại. Nếu lỗi vẫn tiếp diễn, hãy liên hệ với nhóm hỗ trợ.

Lỗi SDF

API Display & Video 360 sử dụng phương thức không đồng bộ để tạo và tải các tệp dữ liệu có cấu trúc (SDF) xuống. Vì lý do này, các lỗi được tạo trong quá trình tạo SDF sẽ được trả về trong tác vụ tải SDF đã hoàn tất xuống. Tác vụ tải xuống SDF hoàn tất trong error được đánh dấu là đã hoàn tất, nhưng có trường lỗi được điền sẵn thay vì tên tài nguyên nội dung đa phương tiện trong trường response, như trong ví dụ bị cắt bớt này:

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

Nếu nhận được một thông báo lỗi có thể xử lý được khi cố gắng tạo SDF, thì bạn nên làm theo thông báo đó. Nếu thông báo lỗi không thể xử lý rõ ràng, bạn nên thực hiện các hành động sau:

Xác minh rằng người dùng có quyền phù hợp đối với tài nguyên đối tác mẹ hoặc tài nguyên của nhà quảng cáo.
Xác nhận rằng các mã nhận dạng được cung cấp trong bộ lọc là chính xác, tương ứng với loại tài nguyên dự kiến và nằm trong ngữ cảnh của mã nhận dạng gốc nhất định.
Đảm bảo rằng bạn không vượt quá giới hạn 20 tác vụ tải xuống SDF đồng thời cho mỗi người dùng.

Nếu bạn vẫn gặp lỗi, hãy liên hệ với nhóm hỗ trợ để báo cáo vấn đề.

Cảnh báo không chặn

Cảnh báo không chặn được chỉ định cho mục hàng để cho biết vấn đề có thể ảnh hưởng đến việc phân phát mục hàng. Các cảnh báo tương tự sẽ được thông báo trong giao diện người dùng thông qua biểu ngữ thông báo. Những cảnh báo này mang tính thụ động và được liệt kê trong trường warningMessages của mục hàng.

Mặc dù thụ động, nhưng các vấn đề gây ra những cảnh báo này có thể ảnh hưởng đến việc phân phát mục hàng đến mức ngăn chặn hoàn toàn mục hàng đó.

Biện pháp phòng ngừa

Có thể tránh được nhiều vấn đề gây ra cảnh báo không chặn bằng cách định cấu hình đúng cách các chế độ cài đặt mục hàng, bao gồm:

Thời gian hiển thị: Nếu chuyến bay của mục hàng không hợp lệ hoặc nếu thời gian hiển thị của đơn đặt hàng quảng cáo gốc đã hết hạn, thì mục hàng sẽ tạo cảnh báo và không phân phát. Để tránh vấn đề thứ hai, hãy đảm bảo rằng thời gian hiển thị của mục hàng không kết thúc muộn hơn thời gian hiển thị của đơn đặt hàng chèn mẹ.
Mẫu quảng cáo được chỉ định: Nếu không có mẫu quảng cáo hợp lệ nào được chỉ định cho một mục hàng, thì mục hàng sẽ tạo một cảnh báo và sẽ không phân phát.
Nhắm mục tiêu: Nếu tiêu chí nhắm mục tiêu của mục hàng không được chỉ định đúng, thì mục hàng có thể tạo cảnh báo và việc phân phát có thể bị ảnh hưởng hoặc bị ngăn chặn hoàn toàn.

Nếu bạn đang sao chép cấu hình từ một mục hàng hiện có, hãy đảm bảo rằng mục hàng hiện tại không tạo ra bất kỳ cảnh báo ngoài dự kiến nào.

Giám sát

Các vấn đề gây ra cảnh báo không chặn có thể phát sinh khi một mục hàng đang diễn ra. Để đảm bảo mục hàng của bạn đang phân phát chính xác, hãy theo dõi các mục hàng đang hoạt động để phát hiện các cảnh báo mới. Bạn có thể truy xuất mục hàng hàng loạt bằng hàm advertisers.lineItems.list. Nếu một mục hàng đang tạo cảnh báo không mong muốn, bạn nên giải quyết vấn đề ngay lập tức để giảm tác động đến việc phân phát.

Vấn đề có thể phát sinh ngay cả khi chế độ cài đặt hoặc tiêu chí nhắm mục tiêu của mục hàng không thay đổi. Ví dụ: việc tạm dừng hoặc hết hạn đối với đơn đặt hàng quảng cáo gốc, và việc ngừng sử dụng danh sách người dùng hoặc tiêu chí nhắm mục tiêu khác.