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ề:

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.