এই গাইডে কিছু পেশাদার পদ্ধতি উল্লেখ করা হয়েছে যা আপনার অ্যাপের দক্ষতা ও পারফর্ম্যান্স অপ্টিমাইজ করার জন্য প্রয়োগ করতে পারবেন।
আপনার অ্যাপ বজায় রাখা
আপনার অ্যাপ যাতে নির্বিঘ্নে চলে তা নিশ্চিত করতে, নিম্নলিখিত কাজগুলি করুন:
আপনার 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 অ্যাক্সেস লেভেলের জন্য পর্যালোচনা করা হয়।