Hiển thị và Video 360 API phiên bản 2 đã ngừng hoạt động. Sử dụng Display & Video 360 API phiên bản 3. Để biết hướng dẫn di chuyển từ phiên bản 2 sang phiên bản 3, hãy xem hướng dẫn di chuyển của chúng tôi.

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 màn hình & API Video 360.

Lỗi API

Nếu không thể hoàn tất các yêu cầu được gửi đến API, thì hệ thống sẽ trả về một thông báo lỗi. Số yêu cầu trả về lỗi sẽ được tính vào hạn mức của người dùng và sẽ được xem xét khi xem xét yêu cầu bổ sung hạn mức. Phản hồi lỗi cần được xử lý và xử lý để tránh lỗi trong tương lai.

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

Lỗi SDF

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

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

Nếu bạn nhận được thông báo lỗi có thể xử lý khi cố gắng tạo SDF, bạn phải tuân theo. Nếu thông báo lỗi không thể xử lý rõ ràng, chúng tôi đề xuất các hành động sau:

Xác minh rằng người dùng của bạn có các quyền thích hợp đối với cha mẹ đối tác hoặc 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ự định và nằm trong ngữ cảnh của đã cấp mã gốc.
Đảm bảo rằng bạn không vượt quá giới hạn 20 lượt tải xuống SDF đồng thời nhiệm vụ của 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ủa bạn.

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

Cảnh báo không chặn được chỉ định cho các mục hàng để cho biết có thể ảnh hưởng đến việc phân phối của mục hàng. Thông báo về các cảnh báo tương tự 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ù bị độ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 đó.

Phòng ngừa

Có thể tránh được nhiều vấn đề gây ra cảnh báo không chặn thông qua những cách cấu hình của 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 một và sẽ không phân phát. Để tránh vấn đề sau, hãy đảm bảo rằng một dòng thời gian hiển thị của mục không kết thúc muộn hơn thời gian hiển thị của chèn mục gốc đơn đặt hàng.
Mẫu quảng cáo được chỉ định: Nếu không có mẫu quảng cáo hợp lệ gán 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 chỉ định đúng cách, mục hàng có thể tạo cảnh báo và 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ự tính nào.

Giám sát

Các vấn đề khiến cảnh báo không chặn có thể phát sinh khi mục hàng đang ở chuyến bay. Để đảm bảo rằng các mục hàng của bạn đang phân phối chính xác, hãy giám sát các mục hàng đang hoạt động của mình cho các cảnh báo mới được tạo. Có thể truy xuất mục hàng hàng loạt bằng cách sử dụ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, thì bạn nên giải quyết vấn đề này ngay lập tức để giảm tác động đến việc phân phát.

Các 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 đơn đặt hàng quảng cáo gốc và 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.