বৃহস্পতিবার, ২৬ ফেব্রুয়ারি, ২০২৬
এই গুরুত্বপূর্ণ আপডেট Assistant-কে একটি শক্তিশালী কোড জেনারেশন টুল থেকে Google Ads ডেভেলপারদের জন্য একটি প্রোঅ্যাক্টিভ সমস্যা সমাধান এবং অটোমেশন পার্টনারে রূপান্তরিত করে। আমাদের v1.6.0 রিলিজের পর থেকে, আমরা আপনার মতামত শুনেছি এবং API ডেভেলপমেন্টের সবচেয়ে চ্যালেঞ্জিং অংশগুলিতে ফোকাস করেছি: ডায়াগনস্টিক, ধারাবাহিকতা এবং সেট-আপ।
v2.0-এ নতুন কী আছে?
১. সহজ ইনস্টলেশন ও রক্ষণাবেক্ষণ
মাল্টি-ল্যাঙ্গুয়েজ ডেভেলপমেন্ট এনভায়রনমেন্ট সেট-আপ করা কোনও কঠিন কাজ নয়।
- এক-কমান্ড সেট-আপ: pip, কম্পোজার ও বান্ডলার ডিপেন্ডেন্সি একবারে ম্যানেজ করতে
install.shবাinstall.ps1-এর সাথে নতুন--install-depsফ্ল্যাগ ব্যবহার করুন। - ইউনিফায়েড ডিরেক্টরি স্ট্রাকচার: আপনার জেনারেট করা সব কোড, CSV এক্সপোর্ট ও ডায়াগনস্টিক রিপোর্ট এখন প্রতিটি ধরনের আউটপুটের জন্য সাব-ডিরেক্টরি সহ একটি
saved/ডিরেক্টরির অধীনে সাজানো থাকে। - এক-কমান্ড আপডেট: API এবং ক্লায়েন্ট লাইব্রেরির নতুন ভার্সন রিলিজ হলে, লেটেস্ট ভার্সন ব্যবহার করার জন্য আপনাকে
update.shএক্সিকিউট করতে হবে। এছাড়াও, আপনার প্রসঙ্গে অতিরিক্ত ক্লায়েন্ট লাইব্রেরি যোগ করতেupdate.shব্যবহার করতে পারবেন।
২. এজেন্টিক কনভার্সন সংক্রান্ত সমস্যার সমাধান করা
অফলাইন কনভার্সন ট্র্যাকিং হল Google Ads API-এর অন্যতম শক্তিশালী—তবুও জটিল—ফিচার। কোনও কনভার্সন কেন অ্যাট্রিবিউট করা হয়নি তা ডিবাগ করা একটি সময়সাপেক্ষ ম্যানুয়াল প্রসেস হতে পারে।
v2.0-তে, আমরা একটি বিশেষ কনভার্সন সংক্রান্ত সমস্যার সমাধান ও ডায়াগনস্টিক স্যুট নিয়ে এসেছি।
- নতুন স্ক্রিপ্ট:
api_examples/collect_conversions_troubleshooting_data.py - নতুন কমান্ড:
/conversions_support_data
স্ক্রিপ্টটি কনভার্সন সংক্রান্ত সমস্যার সমাধানের জন্য স্ট্যান্ডার্ড রিপোর্ট এক্সিকিউট করে এবং আপনার সমস্যার সমাধান করার জন্য Assistant-কে প্রাসঙ্গিক তথ্য প্রদান করে।
Assistant আপনার কনভার্সন সংক্রান্ত সমস্যা বিশ্লেষণ করে তা সমাধান করার চেষ্টা করার পরে এই কমান্ডটি সবচেয়ে বেশি উপযোগী হয়। যদি তা না হয় এবং আপনাকে সহায়তা টিমের সাথে যোগাযোগ করতে হয়, তাহলে এই কমান্ড আপনার গ্রাহক সেটিংস, কনভার্সন অ্যাকশন বিশ্লেষণ করবে এবং আগে থেকে করা বিশ্লেষণের উপর ভিত্তি করে একটি স্ট্রাকচার্ড ডায়াগনস্টিক রিপোর্ট তৈরি করতে আপলোড করা সারসংক্ষেপ বিশ্লেষণ করবে। এমনকি এটি "খারাপ" অবস্থা এবং ব্যর্থতার উচ্চ হার অটোমেটিক শনাক্ত করে, যার ফলে আপনার লগ ডাইভিংয়ের সময় সাশ্রয় হয়। এটি ফলাফল একটি টেক্সট ফাইলে সেভ করে, যা আপনি কোনও সহায়তা অনুরোধের সাথে যোগ করতে পারেন।
৩. লেটেস্ট API (v23)-এর জন্য তৈরি করা হয়েছে
ভার্সন ২.০-এ Google Ads API v23 সম্পূর্ণভাবে কাজ করে। আমাদের সব ইন্টার্যাক্টিভ উদাহরণ আপডেট করা হয়েছে এবং Assistant-এর ইন্টার্নাল কনটেক্সট এখন লেটেস্ট রিসোর্স ও ফিল্ডের জন্য অপ্টিমাইজ করা হয়েছে, যাতে আপনার তৈরি করা কোড প্রোডাকশনের জন্য রেডি থাকে।
৪. সেশন হুকের মাধ্যমে নির্বিঘ্ন অটোমেশন
আপনার ওয়ার্কফ্লোকে সত্যিই বাধাহীন করতে আমরা SessionStart এবং SessionEnd হুক যোগ করেছি।
- অটোমেটিক কনফিগারেশন: সেশন শুরু হওয়ার সময় Assistant এখন অটোমেটিক আপনার
$HOMEডিরেক্টরিতে কনফিগারেশন ফাইল খুঁজে নিতে পারে। এটি আপনার প্রোজেক্ট ডিরেক্টরির সাব-ডিরেক্টরি config-এ কপি করে। API কোয়েরি করার জন্য Python হল Gemini-র পছন্দের ভাষা। তাই, আপনি অন্য কোনও ভাষা ব্যবহার করলে, এটি আপনার কনফিগারেশন ফাইল পড়ে এবং কোয়েরির জন্য কনফিগারেশনে একটি অস্থায়ী google-ads.yaml তৈরি করে, তবে আপনার পছন্দের ভাষার কোডে উত্তর দেওয়া চালিয়ে যায়। - অটোমেটিক-ক্লিনআপ: আপনি বেরিয়ে গেলে সাময়িক কনফিগারেশন নিরাপদে মুছে ফেলা হয়, যার ফলে আপনার ওয়ার্কস্পেস পরিষ্কার এবং আপনার ক্রেডেনশিয়াল সুরক্ষিত থাকে।
৫. আরও উন্নত GAQL যাচাইকরণ
জটিল GAQL কোয়েরি তৈরি করা এখন আগের চেয়ে অনেক সহজ। আমরা GEMINI.md এবং conversions/GEMINI.md আপডেট করেছি, যাতে লেটেস্ট API এজ কেসের জন্য কঠোর যাচাইকরণ নিয়ম অন্তর্ভুক্ত করা হয়েছে। এর মধ্যে তারিখের সেগমেন্ট এবং নির্দিষ্ট রেঞ্জের প্রয়োজনীয়তা আরও ভালোভাবে ম্যানেজ করার সুবিধা রয়েছে। Assistant এখন কোয়েরি এক্সিকিউট করার আগেই লজিক সংক্রান্ত ভুল ধরতে পারে।
৬. স্কিল
স্কিলকে একটি মিনি-প্লাগ-ইন বা "আচরণগত ব্লুপ্রিন্ট" হিসেবে ভাবুন। সাধারণ প্রসঙ্গ (যেমন আপনার GEMINI.md ফাইল) ব্যাকগ্রাউন্ড তথ্য প্রদান করলেও, AI-এর ব্রেনে কোনও স্কিল তখনই "লোড" করা হয় যখন এটিকে বিশেষভাবে কোনও জটিল, পদ্ধতিগত টাস্ক সম্পূর্ণ করতে হয়, যেমন এই এক্সটেনশনের বর্তমান ভার্সন পাওয়া। আপনি সরাসরি স্কিল এক্সিকিউট করেন না। Gemini সিদ্ধান্ত নেয় যে কখন এটির প্রয়োজন।
যদিও এটি এখনও একটি পরীক্ষামূলক ফিচার, সেশন শুরু এবং ক্লিনআপের জন্য আমাদের হুকের ব্যবহারকে আরও উন্নত করতে আমরা এই রিলিজে একটি অন্তর্ভুক্ত করেছি।
আপনি কেন আপগ্রেড করবেন?
v1.6.0 থেকে v2.0.0-এ আপগ্রেড করার অর্থ শুধু নতুন ফিচার পাওয়া নয়; এর অর্থ হল নির্ভরযোগ্যতা। অটোমেটেড ডায়াগনস্টিক টুলের সাথে API সংক্রান্ত গভীর জ্ঞান ইন্টিগ্রেট করার মাধ্যমে, v2.0 "ট্রায়াল ও এরর" লুপের সংখ্যা কমায়, যা প্রায়শই API ইন্টিগ্রেশনকে ধীর করে দেয়।
আপনি কনভার্সন আপলোড ডিবাগ করছেন বা জটিল রিপোর্টিং পাইপলাইন তৈরি করছেন, v2.0 আপনাকে আরও দ্রুত এবং আরও আত্মবিশ্বাসের সাথে কাজ করার টুল দেয়।
শুরু করা
প্রথম ইনস্টলেশন
git clone https://github.com/googleads/google-ads-api-developer-assistant.git- প্রোজেক্ট ডিরেক্টরিতে, এক্সটেনশন ও ক্লায়েন্ট লাইব্রেরি ইনস্টল করতে install.sh বা install.ps1 রান করুন।
আগের ভার্সন থেকে আপগ্রেড করা
saved_code/এবংsaved_csv/থেকে যেকোনও কাস্টম কোড কপি করে কোনও নিরাপদ লোকেশনে রাখুন।- আপনার প্রোজেক্ট ডিরেক্টরি এবং সব সাব-ডিরেক্টরি ও ফাইল মুছে দিয়ে Google Ads API Developer Assistant-এর স্থানীয় ক্লোন মুছে দিন।
git clone https://github.com/googleads/google-ads-api-developer-assistant.git- প্রোজেক্ট ডিরেক্টরিতে, এক্সটেনশন ও ক্লায়েন্ট লাইব্রেরি ইনস্টল করতে install.sh বা
install.ps1রান করুন।
লেবেল: google-ads-api, release