স্ট্রাকচার্ড ডেটা ফাইল (SDF) হলো বিশেষ ফরম্যাটের CSV ফাইল। এগুলোর মাধ্যমে Display & Video 360-এ একসাথে অনেক রিসোর্স পুনরুদ্ধার, তৈরি এবং সম্পাদনা করা যায়। SDF ফাইল ডাউনলোড, সম্পাদনা এবং তারপর পুনরায় আপলোড করার মাধ্যমে একসাথে অনেক রিসোর্স আপডেট করুন।
ডিসপ্লে অ্যান্ড ভিডিও ৩৬০ ইউআই (UI) এসডিএফ (SDF) ডাউনলোড এবং আপলোড সমর্থন করে। ডিসপ্লে অ্যান্ড ভিডিও ৩৬০ এপিআই (API) এসডিএফ (SDF) ডাউনলোড সমর্থন করে।
ফর্ম্যাট
একটি SDF দুটি মূল ফরম্যাটের মধ্যে একটি ব্যবহার করে, Standard এবং QA :
- আপনি স্ট্যান্ডার্ড ফরম্যাটের ফাইল ডাউনলোড ও আপলোড করতে পারেন। আপলোডের সময় নির্ভুলতা নিশ্চিত করার জন্য এই ফাইলগুলোর ডেটাতে সাংখ্যিক আইডি ব্যবহার করা হতে পারে। ডেটা ব্যাখ্যা করার জন্য রেফারেন্স তথ্যের প্রয়োজন হতে পারে।
- আপনি QA ফরম্যাটের ফাইল ডাউনলোড করতে পারেন। এই ফাইলগুলোতে স্ট্যান্ডার্ড ফরম্যাটের ফাইলের মতোই ডেটা থাকে, কিন্তু এতে আরও সহজে পাঠযোগ্য মান ব্যবহার করা হয়। উদাহরণস্বরূপ, কিছু কলামে ID-এর পরিবর্তে ডিসপ্লে নেম ব্যবহার করা হতে পারে। এই ফরম্যাটের জন্য নির্দিষ্ট কলামগুলোতে "Qa" সাফিক্সটি ব্যবহৃত হয়।
ফাইলের প্রকার
SDF সাতটি রিসোর্স টাইপ সমর্থন করে। প্রতিটি রিসোর্স টাইপের নিজস্ব ফাইল টাইপ এবং কলাম কাঠামো রয়েছে। সমর্থিত রিসোর্স টাইপগুলো হলো:
- প্রচারণা
- সন্নিবেশ ক্রম
- লাইন আইটেম
- বিজ্ঞাপন গোষ্ঠী
- বিজ্ঞাপন
- ইনভেন্টরি উৎস
- মিডিয়া পণ্য
শুধুমাত্র লাইন আইটেম এবং অ্যাড গ্রুপ ফাইল টাইপগুলো QA ফরম্যাট সমর্থন করে।
নিয়মিতভাবে নতুন SDF সংস্করণ প্রকাশ করা হয় এবং পূর্ববর্তী সংস্করণগুলো বাতিল করা হয় । নতুন সংস্করণগুলো ফাইল টাইপ কলামের কাঠামো হালনাগাদ করে। প্রয়োজনে, নতুন SDF সংস্করণটি প্রকাশের সময় একটি মাইগ্রেশন গাইড অন্তর্ভুক্ত করবে।
ডাউনলোড ত্রুটি
SDF ডাউনলোডের ফলে দুই ধরনের ত্রুটি দেখা দিতে পারে: ফাইল তৈরির ত্রুটি এবং বাদ পড়া রিসোর্স।
ফাইল তৈরির ত্রুটি
SDF জেনারেশন ত্রুটির কারণে বন্ধ হয়ে যেতে পারে। Display & Video 360 API ব্যবহার করার সময় যদি জেনারেশন ব্যর্থ হয়, তবে সমাপ্ত টাস্কটি তার error ফিল্ডে Status অবজেক্ট সেট করবে। Status অবজেক্টটিতে একটি বার্তা থাকবে, যেখানে ত্রুটির কারণ বিস্তারিতভাবে উল্লেখ করা থাকবে।
এই ত্রুটিগুলো সম্পর্কে আরও জানতে আমাদের 'ত্রুটি ও সতর্কীকরণ নির্দেশিকা' পৃষ্ঠাটি পড়ুন।
বাদ পড়া ত্রুটি
SDF সব ধরনের রিসোর্স সমর্থন করে না। যদি কোনো রিসোর্স একটি SDF-এ অন্তর্ভুক্ত করা না যায়, তাহলে ডাউনলোডের সাথে একটি "Skipped" ফাইল (উদাহরণ: SDF-LineItems-Skipped.csv ) অন্তর্ভুক্ত থাকবে। এই ফাইলটির একটি দুই-কলামের কাঠামো রয়েছে। প্রথম কলামটি বাদ দেওয়া রিসোর্সটিকে শনাক্ত করে। দ্বিতীয় কলামটি সেটিকে বাদ দেওয়ার কারণ ব্যাখ্যা করে।
ফাইল আপলোড
নতুন রিসোর্স তৈরি করতে বা বিদ্যমান রিসোর্স আপডেট করতে ডিসপ্লে ও ভিডিও ৩৬০ ইউআই ব্যবহার করে এসডিএফ ফাইল আপলোড করুন ।
SDF ব্যবহার করে রিসোর্স আপডেট বা তৈরি করার সময় ত্রুটি কমাতে এই ধাপগুলো অনুসরণ করুন:
- Display & Video 360 API বা UI ব্যবহার করে SDF ফাইলগুলো ডাউনলোড করুন।
- বিদ্যমান রিসোর্সগুলো আপডেট করতে বিদ্যমান ফাইল এন্ট্রিগুলো পরিবর্তন করুন।
- নতুন রিসোর্স তৈরি করতে ফাইল এন্ট্রি যোগ করুন।
- যেসব এন্ট্রি নতুন বা আপডেট করা হয়নি, সেগুলো মুছে ফেলুন। এতে ফাইলের আকার কমে এবং অনিচ্ছাকৃত আপডেটের সম্ভাবনা দূর হয়।
- Display & Video 360 UI-তে ফাইলটি আপলোড করুন।
একটি SDF আপলোড এবং প্রসেস করার পরে, একটি SDF-ResultFile.zip ফাইল ডাউনলোডের জন্য উপলব্ধ হয়। এই ZIP ফাইলটিতে দুটি সম্ভাব্য ফাইল থাকতে পারে:
-
SDF-{ResourceType}-Updated-ResultFile.csv, যেখানে সফলভাবে আপডেট বা তৈরি করা রিসোর্সগুলোর তালিকা থাকে। -
SDF-{ResourceType}-Failed-ResultFile.csv, যেখানে ব্যর্থ অপারেশন এবং প্রাসঙ্গিক ত্রুটির বার্তাগুলো তালিকাভুক্ত করা থাকে।
ZIP ফাইলটিতে একটি বা উভয় ফাইলই থাকতে পারে।