এই গাইডে কিছু পেশাদার পদ্ধতি সম্পর্কে আলোচনা করা হয়েছে যা আপনার অ্যাপের দক্ষতা ও পারফর্ম্যান্স অপ্টিমাইজ করার জন্য প্রয়োগ করতে পারবেন।
আপনার অ্যাপ বজায় রাখা
আপনার অ্যাপ যাতে নির্বিঘ্নে চলে তা নিশ্চিত করতে, নিম্নলিখিত কাজগুলি করুন:
আপনার Google Cloud প্রোজেক্টের মালিক ও এডিটরদের তালিকা আপ-টু-ডেট আছে কিনা তা নিশ্চিত করুন। কোনও জরুরি পরিস্থিতি বা API-এর নিয়ম ও শর্তাবলী মেনে চলার ব্যাপারে কোনও বিষয় থাকলে, আমরা এইসব ব্যবহারকারীর সাথে যোগাযোগ করব। API-এর নিয়ম ও শর্তাবলী মেনে চলার ব্যাপারে আপনার সাথে যোগাযোগ করতে না পারলে, আপনার API অ্যাক্সেস কমিয়ে দেওয়া বা তুলে নেওয়া হতে পারে।
প্রোডাক্টে পরিবর্তন, রক্ষণাবেক্ষণের জন্য ডাউনটাইম এবং বন্ধ হয়ে যাওয়ার তারিখের মতো সমস্যা সম্পর্কে জানতে, আমাদের API ব্লগ এবং প্রোডাক্ট ব্লগ সাবস্ক্রাইব করুন।
আপনার অ্যাপকে Google Ads API-এর নিয়ম ও শর্তাবলী (T&C) মেনে চলতে দিন। প্রয়োজন হলে, API অ্যাক্সেস সহ আপনার Google Cloud প্রোজেক্টের মালিক ও এডিটরদের সাথে API সংক্রান্ত নীতি মেনে চলা টিম যোগাযোগ করবে। নিয়ম ও শর্তাবলী সম্পর্কে আপনার কোনও প্রশ্ন বা উদ্বেগ থাকলে, আপনার API অ্যাক্সেস অ্যাপ্লিকেশন পর্যালোচনা করার সময় কমপ্লায়েন্স টিম আপনাকে যে ইমেল পাঠিয়েছে, সেটির উত্তর দিয়ে তাদের সাথে যোগাযোগ করতে পারেন।
অপটিমাইজেশান
আপনি ব্যাচ অপারেশন রান করে এবং উপযুক্ত হলে, স্পার্স অবজেক্ট পাঠিয়ে আপনার অ্যাপ অপ্টিমাইজ করতে পারবেন।
ব্যাচ অপারেশন
API-তে অনুরোধ করার জন্য বেশ কিছু নির্দিষ্ট খরচ হয়, যেমন রাউন্ড-ট্রিপ নেটওয়ার্ক লেটেন্সি, সিরিয়ালাইজেশন ও ডিসিরিয়ালাইজেশন প্রসেসিং এবং ব্যাকএন্ড সিস্টেমে কল করা। এইসব নির্দিষ্ট খরচের প্রভাব কমাতে এবং সামগ্রিক পারফর্ম্যান্স বাড়াতে, API-তে বেশিরভাগ মিউটেট পদ্ধতি এমনভাবে ডিজাইন করা হয়েছে যাতে সেগুলি অপারেশনের অ্যারে গ্রহণ করতে পারে। প্রতিটি অনুরোধে একাধিক অপারেশন ব্যাচ করে, আপনি অনুরোধের সংখ্যা এবং সংশ্লিষ্ট নির্দিষ্ট খরচ কমাতে পারেন। সম্ভব হলে, শুধুমাত্র একটি অপারেশন সহ অনুরোধ করা এড়িয়ে চলুন।
যেমন, ধরুন আপনি একাধিক বিজ্ঞাপন গ্রুপ জুড়ে একটি ক্যাম্পেনে ৫০,০০০ কীওয়ার্ড যোগ করছেন। প্রতিটি কীওয়ার্ডের জন্য ১টি করে ৫০,০০০টি অনুরোধ করার পরিবর্তে, ৫০০টি কীওয়ার্ডের জন্য ১০০টি অনুরোধ করুন অথবা ৫,০০০টি কীওয়ার্ডের জন্য ১০টি অনুরোধ করুন। একটি অনুরোধে অনুমোদিত অপারেশনের সংখ্যার উপর সীমা রয়েছে, তাই আপনাকে সর্বোত্তম পারফর্ম্যান্স অর্জন করতে আপনার ব্যাচের সাইজ অ্যাডজাস্ট করতে হতে পারে।
স্পার্স অবজেক্ট পাঠান
API-তে অবজেক্ট পাঠানো হলে, ফিল্ড অবশ্যই ডিসিরিয়ালাইজ, যাচাই ও ডেটাবেসে স্টোর করতে হবে। আপনি যখন শুধুমাত্র কয়েকটি ফিল্ড আপডেট করতে চান তখন সম্পূর্ণ অবজেক্ট পাস করলে অতিরিক্ত প্রসেসিং সময় লাগতে পারে এবং পারফর্ম্যান্স কমে যেতে পারে। এই সমস্যা
সমাধান করতে, Google Ads API স্পার্স আপডেট করার সুবিধা দেয়, যার ফলে আপনি কোনও অবজেক্টের
শুধুমাত্র সেইসব ফিল্ড পূরণ করতে পারবেন যেগুলি পরিবর্তন করতে হবে বা যেগুলি পূরণ করা প্রয়োজন।
স্পার্স আপডেট প্রসেস করতে কম সময় লাগে এবং এতে সমস্যা হওয়ার সম্ভাবনা কম থাকে। যেসব ফিল্ড
update_mask-এ (FieldMask নামেও পরিচিত) নেই, সেগুলি অপরিবর্তিত থাকে।
যেমন, কীওয়ার্ড-লেভেল বিড আপডেট করে এমন অ্যাপ স্পার্স আপডেট ব্যবহার করে উপকৃত হতে পারে, কারণ শুধু বিজ্ঞাপন গ্রুপ আইডি, ক্রাইটেরিয়ন আইডি এবং বিড ফিল্ড পূরণ করতে হবে।
সমস্যা ম্যানেজ করা ও সমাধান করা
ডেভেলপমেন্টের সময়, আপনি সমস্যার সম্মুখীন হতে পারেন। এই বিভাগে আপনার অ্যাপে সমস্যা ম্যানেজমেন্ট তৈরি করার জন্য বিবেচনা এবং কৌশল বর্ণনা করা হয়েছে। এই বিভাগ ছাড়াও, সমস্যা ম্যানেজ করার বিষয়ে আরও তথ্যের জন্য সমস্যার সমাধানকরণ গাইড দেখুন।
অনুরোধের সোর্স আলাদা করা
কিছু অ্যাপ মূলত ইন্টারেক্টিভ, যা UI-তে ব্যবহারকারীর শুরু করা অ্যাকশনের উত্তরে সরাসরি API কল ইস্যু করে। অন্যান্যরা মূলত অফলাইনে কাজ করে, পর্যায়ক্রমিক ব্যাকএন্ড প্রক্রিয়ার অংশ হিসেবে API কল ইস্যু করে। অনেক অ্যাপ এই দুটিকে একত্রিত করে। সমস্যা ম্যানেজমেন্টের কথা ভাবার সময়, এই বিভিন্ন ধরনের অনুরোধের মধ্যে পার্থক্য করাটা উপযোগী হতে পারে।
ব্যবহারকারীর শুরু করা অনুরোধের ক্ষেত্রে, আপনার প্রাথমিক লক্ষ্য হওয়া উচিত ব্যবহারকারীকে ভালো অভিজ্ঞতা প্রদান করা। যে নির্দিষ্ট সমস্যাটি ঘটেছে সেটি ব্যবহার করে UI-তে ব্যবহারকারীকে যতটা সম্ভব প্রসঙ্গ প্রদান করুন। সমস্যার সমাধান করার জন্য তারা কী কী পদক্ষেপ নিতে পারেন তা স্পষ্টভাবে উল্লেখ করুন (নিম্নলিখিত সাজেশনগুলি দেখুন)।
ব্যাকএন্ডে শুরু করা অনুরোধের জন্য, আপনার অ্যাপে বিভিন্ন ধরনের সমস্যার সম্মুখীন হতে পারে, সেগুলি সমাধান করার জন্য হ্যান্ডলার প্রয়োগ করুন। বিরল বা আগে কখনও দেখা যায়নি এমন সমস্যার সমাধান করতে সবসময় ডিফল্ট হ্যান্ডলার অন্তর্ভুক্ত করুন। ডিফল্ট হ্যান্ডলারের জন্য একটি ভাল পদ্ধতি হল, ব্যর্থ অপারেশন এবং ত্রুটি একটি সারিতে যোগ করা যাতে একজন হিউম্যান অপারেটর পর্যালোচনা করতে এবং একটি উপযুক্ত সমাধান নির্ধারণ করতে পারেন।
সমস্যার ধরন আলাদা করা
Google Ads API-তে বিভিন্ন ধরনের সমস্যার মধ্যে পার্থক্য জানাটা খুবই গুরুত্বপূর্ণ, বিশেষ করে যখন আপনি সমস্যা সমাধানের জন্য শক্তিশালী সিস্টেম তৈরি করছেন। কিছু সাধারণ সমস্যার ধরন নিচে দেওয়া হল:
- যাচাইকরণ সংক্রান্ত সমস্যা
- যেসব সমস্যার ক্ষেত্রে আবার চেষ্টা করা যেতে পারে
- যাচাইকরণ সংক্রান্ত সমস্যা
- সিঙ্ক করা সম্পর্কিত সমস্যা
আরও বিবরণের জন্য সমস্যার ধরন এবং সাধারণ সমস্যা দেখুন।
ব্যাকএন্ড সিঙ্ক করুন
আপনার অ্যাপের ব্যবহারকারীদের Google Ads অ্যাকাউন্টে ম্যানুয়াল অ্যাক্সেস থাকলে, তারা এমন পরিবর্তন করতে পারে যা আপনার অ্যাপ জানে না, যার ফলে আপনার অ্যাপের লোকাল ডেটাবেস সিঙ্কের বাইরে চলে যায়। আমাদের সমস্যার ধরন সংক্রান্ত নির্দেশিকায় যেমন উল্লেখ করা হয়েছে, সিঙ্ক-সম্পর্কিত সমস্যা হলে আপনি
সেটির সমাধান করতে পারেন, তবে আপনি আগে থেকেই
সেগুলি প্রতিরোধ করার চেষ্টা করতে পারেন। একটি প্রোঅ্যাক্টিভ স্ট্র্যাটেজি হল, আপনার অ্যাকাউন্টে Google Ads অবজেক্টের সাথে আপনার লোকাল ডেটাবেস
রিকনসাইল করার জন্য একটি পিরিয়ডিক সিঙ্ক জব চালানো। অ্যাকাউন্টের
বড় হায়ারার্কির ক্ষেত্রে, দৈনিক কোটা শেষ হয়ে যাওয়া আটকাতে, প্রতি রাতে প্রতিটি অ্যাকাউন্ট থেকে
সব অবজেক্ট পুল করা এড়িয়ে চলুন; এর পরিবর্তে,
ChangeStatus কোয়েরি করুন অথবা সম্প্রতি পরিবর্তন করা এন্টিটি ফিল্টার করুন যাতে
পরিবর্তনগুলি ইনক্রিমেন্টালভাবে সিঙ্ক করা যায়।
লগ সংক্রান্ত সমস্যা
ডিবাগিং ও মনিটরিংয়ের সুবিধা দিতে সব সমস্যার লগ রাখতে হবে। কমপক্ষে, অনুরোধ আইডি, যে অপারেশনের কারণে সমস্যা হয়েছে এবং সমস্যাটি লগ করুন। লগ করার জন্য অন্যান্য তথ্যের মধ্যে রয়েছে কাস্টমার আইডি, API পরিষেবা, রাউন্ড-ট্রিপ অনুরোধের লেটেন্সি, পুনরায় চেষ্টা করার সংখ্যা এবং স্যানিটাইজ করা কাঁচা অনুরোধ এবং প্রতিক্রিয়া (OAuth টোকেন এবং যেকোনও PII-এর মতো সংবেদনশীল ক্রেডেনশিয়াল রিড্যাক্ট করা নিশ্চিত করা)।
ট্রেন্ড মনিটর করা
API-তে হওয়া সমস্যার ট্রেন্ড মনিটর করতে ভুলবেন না যাতে আপনার অ্যাপে হওয়া সমস্যা শনাক্ত করে সমাধান করতে পারেন। আপনার নিজের সমাধান তৈরি করার কথা বিবেচনা করুন অথবা উপলভ্য অনেক বাণিজ্যিক টুলের মধ্যে একটি ব্যবহার করুন যা ইন্টারেক্টিভ ড্যাশবোর্ড তৈরি করতে এবং অটোমেটিক সতর্কতা পাঠাতে আপনার লগ ব্যবহার করতে পারে।
ডেভেলপমেন্ট
ডেভেলপমেন্টের সময় টেস্ট অ্যাকাউন্ট ব্যবহার করুন।
টেস্ট অ্যাকাউন্ট ব্যবহার করা
টেস্ট অ্যাকাউন্ট হল Google Ads অ্যাকাউন্ট যা আসলে বিজ্ঞাপন পরিবেশন করে না। Google Ads API-এর সাথে পরীক্ষা করতে এবং আপনার অ্যাপের কানেক্টিভিটি, ক্যাম্পেন ম্যানেজমেন্ট লজিক বা অন্যান্য প্রসেসিং প্রত্যাশা অনুযায়ী কাজ করছে কিনা তা পরীক্ষা করতে আপনি একটি টেস্ট অ্যাকাউন্ট ব্যবহার করতে পারেন। আপনার Google Cloud প্রোজেক্টের জন্য শুধুমাত্র টেস্ট অ্যাকাউন্টে ব্যবহার করার জন্য টেস্ট অ্যাক্সেস প্রয়োজন, তাই আপনি অবিলম্বে Google Ads API-এর মাধ্যমে ডেভেলপ করা শুরু করতে পারেন, যদিও Google আপনার অ্যাপ্লিকেশনটি উচ্চতর API অ্যাক্সেস লেভেলের জন্য পর্যালোচনা করছে।