Error dan Peringatan

Halaman ini membahas berbagai jenis error dan peringatan yang mungkin Anda temukan saat menggunakan antarmuka Video 360 API.

Error API

Permintaan yang dibuat ke API yang tidak dapat diselesaikan menampilkan pesan error. Permintaan yang menampilkan error akan mengurangi kuota pengguna dan akan dipertimbangkan saat meninjau permintaan kuota tambahan. Respons error harus diproses dan ditangani untuk menghindari kesalahan pada masa mendatang.

Respons {i>error<i} mengambil format berikut dan menyertakan kode respons HTTP, pesan error, dan status kode Google RPC:

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

Di bawah ini adalah daftar error API umum beserta tindakan yang disarankan untuk dilakukan jika dikembalikan:

Error SDF

Layar Display & Video 360 API menggunakan metode asinkron untuk membuat dan mendownload file data terstruktur (SDF). Untuk ini alasan, error yang ditampilkan selama pembuatan SDF ditampilkan di SDF yang sudah selesai download tugas. Tugas download SDF yang selesai di error adalah ditandai sebagai selesai, tetapi memiliki kolom error yang terisi, bukan nama resource media di kolom response, seperti yang terlihat dalam contoh terpotong ini:

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

Jika Anda menerima pesan {i>error<i} yang dapat ditindaklanjuti ketika mencoba membuat SDF, Anda harus mengikutinya. Jika pesan error tidak dapat ditindaklanjuti dengan jelas, kami sarankan tindakan berikut:

• Verifikasi bahwa pengguna Anda memiliki izin yang sesuai untuk orang tua referensi partner atau pengiklan.
• Pastikan ID yang diberikan dalam filter sudah akurat, sesuai dengan jenis resource yang dimaksudkan, dan berada dalam konteks ID root yang diberikan.
• Pastikan bahwa Anda tidak melebihi batas dua puluh download SDF serentak tugas per pengguna.

Jika Anda masih mengalami error, hubungi dukungan untuk melaporkan menyelesaikan masalah Anda.

Peringatan Tidak Pemblokiran

Peringatan non-pemblokiran ditetapkan ke item baris untuk menunjukkan yang dapat memengaruhi penayangan item baris. Peringatan serupa disampaikan di UI melalui banner notifikasi. Peringatan ini bersifat pasif dan yang tercantum di kolom warningMessages item baris.

Meskipun pasif, masalah yang menyebabkan peringatan ini dapat berdampak pada penayangan hingga sepenuhnya mencegah item baris tersebut.

Pencegahan

Banyak masalah yang menyebabkan peringatan yang tidak memblokir dapat dihindari dengan melakukan konfigurasi setelan item baris, yang meliputi:

• Penerbangan: Jika penerbangan item baris tidak valid, atau jika periode pesanan pemasangan iklan induk telah kedaluwarsa, item baris akan membuat peringatan dan tidak akan ditayangkan. Untuk menghindari masalah yang terakhir, pastikan baris penayangan item tidak berakhir lebih lambat dari periode tayang item induknya pesanan.
• Materi iklan yang ditetapkan: Jika tidak ada materi iklan yang valid ditetapkan ke item baris, item baris tersebut akan menampilkan peringatan dan tidak yang diperlukan.
• Penargetan: Jika penargetan item baris tidak ditetapkan dengan benar, item baris dapat memberikan peringatan dan penayangan mungkin terpengaruh atau dicegah sepenuhnya.

Jika Anda mereplikasi konfigurasi dari item baris yang sudah ada, pastikan item baris yang ada tidak menghasilkan peringatan tak terduga.

Pemantauan

Masalah yang menyebabkan peringatan yang tidak memblokir dapat muncul saat item baris berada penerbangan. Untuk memastikan item baris ditayangkan dengan benar, pantau item baris aktif untuk peringatan yang baru dibuat. Item baris dapat diambil secara massal menggunakan fungsi advertisers.lineItems.list. Jika item baris menghasilkan peringatan yang tidak terduga, Anda harus mengatasi masalah tersebut segera untuk mengurangi dampaknya terhadap penayangan.

Masalah dapat muncul meskipun setelan atau penargetan item baris tidak berubah. Contohnya mencakup jeda atau berakhirnya perjanjian pemasangan iklan induk dan penghentian daftar pengguna atau penargetan lainnya.