ত্রুটি এবং সতর্কতা

এই পৃষ্ঠাটি Display & Video 360 API ব্যবহার করার সময় বিভিন্ন ধরনের ত্রুটি এবং সতর্কতা নিয়ে আলোচনা করে যা আপনি সম্মুখীন হতে পারেন।

API ত্রুটি

এপিআই-তে করা অনুরোধগুলি যেগুলি সম্পূর্ণ করা যায় না একটি ত্রুটি বার্তা ফেরত দেয়৷ অনুরোধগুলি ফেরত দেওয়া ত্রুটিগুলি ব্যবহারকারী কোটার সাথে গণনা করা হয় এবং অতিরিক্ত কোটার জন্য অনুরোধগুলি পর্যালোচনা করার সময় বিবেচনা করা হবে৷ ভবিষ্যতে ত্রুটি এড়াতে ত্রুটি প্রতিক্রিয়া প্রক্রিয়া করা এবং পরিচালনা করা উচিত।

একটি ত্রুটি প্রতিক্রিয়া নিম্নলিখিত বিন্যাস নেয় এবং একটি HTTP প্রতিক্রিয়া কোড, একটি ত্রুটি বার্তা, এবং একটি Google RPC কোড স্থিতি অন্তর্ভুক্ত করে:

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

নীচে সাধারণ API ত্রুটিগুলির একটি তালিকা এবং সেগুলি ফেরত দেওয়া হলে নেওয়ার জন্য প্রস্তাবিত ব্যবস্থা রয়েছে:

SDF ত্রুটি

Display & Video 360 API স্ট্রাকচার্ড ডেটা ফাইল (SDFs) তৈরি এবং ডাউনলোড করার জন্য একটি অ্যাসিঙ্ক্রোনাস পদ্ধতি ব্যবহার করে। এই কারণে, SDF জেনারেশনের সময় নিক্ষিপ্ত ত্রুটিগুলি সমাপ্ত SDF ডাউনলোড টাস্কে ফেরত দেওয়া হয়৷ একটি SDF ডাউনলোড টাস্ক error করে শেষ করা হয়েছে বলে চিহ্নিত করা হয়েছে, কিন্তু response ক্ষেত্রে মিডিয়া রিসোর্সের নামের পরিবর্তে একটি জনবহুল ত্রুটি ক্ষেত্র রয়েছে, যেমনটি এই ছেঁটে দেওয়া উদাহরণে দেখা গেছে:

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

SDF তৈরি করার চেষ্টা করার সময় আপনি যদি একটি অ্যাকশনযোগ্য ত্রুটির বার্তা পান, তাহলে আপনাকে সেই অনুযায়ী অনুসরণ করা উচিত। যদি ত্রুটি বার্তাটি স্পষ্টভাবে কার্যকর না হয় তবে আমরা নিম্নলিখিত পদক্ষেপগুলির সুপারিশ করি:

• আপনার ব্যবহারকারীর অভিভাবক অংশীদার বা বিজ্ঞাপনদাতার সংস্থানগুলির জন্য যথাযথ অনুমতি রয়েছে তা যাচাই করুন৷
• নিশ্চিত করুন যে ফিল্টারে প্রদত্ত আইডিগুলি সঠিক, উদ্দেশ্যপ্রণোদিত সংস্থান প্রকারের সাথে সঙ্গতিপূর্ণ এবং প্রদত্ত রুট আইডির প্রেক্ষাপটের মধ্যে রয়েছে৷
• নিশ্চিত করুন যে আপনি ব্যবহারকারী প্রতি বিশটি সমবর্তী SDF ডাউনলোড কাজের সীমা অতিক্রম করছেন না।

আপনি যদি এখনও ত্রুটির সম্মুখীন হন, আপনার সমস্যা রিপোর্ট করতে সহায়তার সাথে যোগাযোগ করুন ।

নন-ব্লকিং সতর্কতা

একটি লাইন আইটেম পরিবেশন প্রভাবিত করতে পারে এমন একটি সমস্যা নির্দেশ করতে লাইন আইটেমগুলিতে নন-ব্লকিং সতর্কতা বরাদ্দ করা হয়। অনুরূপ সতর্কবার্তা একটি বিজ্ঞপ্তি ব্যানারের মাধ্যমে UI-তে যোগাযোগ করা হয়। এই সতর্কতাগুলি নিষ্ক্রিয় এবং একটি লাইন আইটেমের warningMessages ক্ষেত্রে তালিকাভুক্ত করা হয়েছে৷

প্যাসিভ হলেও, এই সতর্কতাগুলি সৃষ্টিকারী সমস্যাগুলি একটি লাইন আইটেমের পরিবেশনকে সম্পূর্ণরূপে প্রতিরোধ করার বিন্দুতে প্রভাবিত করতে পারে।

প্রতিরোধ

অনেক সমস্যা যা অ-ব্লকিং সতর্কতা সৃষ্টি করে তা নিম্নলিখিতগুলি সহ লাইন আইটেম সেটিংসের সঠিক কনফিগারেশনের মাধ্যমে এড়ানো যেতে পারে:

• ফ্লাইট : যদি একটি লাইন আইটেমের ফ্লাইট অবৈধ হয়, অথবা যদি প্যারেন্ট ইনসার্টেশন অর্ডারের ফ্লাইট মেয়াদ শেষ হয়ে যায়, লাইন আইটেমটি একটি সতর্কতা তৈরি করবে এবং পরিবেশন করবে না৷ পরবর্তী সমস্যাটি এড়াতে, নিশ্চিত করুন যে একটি লাইন আইটেমের ফ্লাইট তার মূল সন্নিবেশ আদেশের ফ্লাইটের পরে শেষ না হয়৷
• বরাদ্দকৃত সৃজনশীল : যদি একটি লাইন আইটেমের জন্য কোন বৈধ সৃজনশীল বরাদ্দ না থাকে, তবে লাইন আইটেমটি একটি সতর্কতা তৈরি করবে এবং পরিবেশন করবে না।
• টার্গেটিং : যদি একটি লাইন আইটেমের টার্গেটিং সঠিকভাবে বরাদ্দ না করা হয়, তাহলে লাইন আইটেমটি একটি সতর্কতা তৈরি করতে পারে এবং পরিবেশন সম্পূর্ণভাবে প্রভাবিত বা প্রতিরোধ হতে পারে।

আপনি যদি একটি বিদ্যমান লাইন আইটেম থেকে কনফিগারেশনের প্রতিলিপি করে থাকেন, তাহলে নিশ্চিত করুন যে বিদ্যমান লাইন আইটেমটি কোনো অপ্রত্যাশিত সতর্কতা তৈরি করছে না।

মনিটরিং

একটি লাইন আইটেম ফ্লাইটে থাকাকালীন যে সমস্যাগুলি অ-ব্লকিং সতর্কতার কারণ হতে পারে। আপনার লাইন আইটেমগুলি সঠিকভাবে পরিবেশন করছে তা নিশ্চিত করার জন্য, নতুন-উত্পন্ন সতর্কতার জন্য আপনার সক্রিয় লাইন আইটেমগুলি নিরীক্ষণ করুন৷ advertisers.lineItems.list ফাংশন ব্যবহার করে লাইন আইটেমগুলি বাল্কে পুনরুদ্ধার করা যেতে পারে। যদি একটি লাইন আইটেম একটি অপ্রত্যাশিত সতর্কতা তৈরি করে, তাহলে পরিবেশনের প্রভাব কমাতে আপনার অবিলম্বে সমস্যাটির সমাধান করা উচিত।

কোনো লাইন আইটেমের সেটিংস বা টার্গেটিং পরিবর্তন না করলেও সমস্যা দেখা দিতে পারে। উদাহরণগুলির মধ্যে রয়েছে অভিভাবক সন্নিবেশের আদেশের বিরতি বা মেয়াদ শেষ হওয়া এবং ব্যবহারকারীর তালিকার অবচয় বা অন্যান্য টার্গেটিং।