যখন আপনি একটি AdGroupCriterion.listing_group
অথবা একটি AssetGroupListingGroupFilter
এর প্রেক্ষাপটে তালিকাভুক্ত গ্রুপ ফিল্টারগুলির সাথে কাজ করেন, তখন আপনার ইন্টিগ্রেশন ডিজাইন করার সময় নিম্নলিখিত বিবেচ্য বিষয়গুলি বিবেচনা করুন।
ব্যাচ বিভাজন
যদি কোনও ব্যাচ জবের মধ্যে এমন কোনও অপারেশন থাকে যাতে বিজ্ঞাপন গ্রুপের মানদণ্ড বা অ্যাসেট গ্রুপের তালিকাভুক্তি গ্রুপ ফিল্টার থাকে, তাহলে Google Ads API সার্ভার যখন ব্যাচ জবের অপারেশনগুলি গ্রহণ করে তখন সেগুলিকে একাধিক সাব-ব্যাচে বিভক্ত করা হয়। মনে রাখবেন যে ব্যাচ জবের স্ট্যান্ডার্ড অপারেশনগুলির বিপরীতে, তালিকাভুক্তি গ্রুপ ফিল্টার অপারেশনগুলি ধারণকারী প্রতিটি সাব-ব্যাচকে পারমাণবিকভাবে বিবেচনা করা হয়।
তালিকাভুক্ত গ্রুপ ফিল্টার ধারণকারী ব্যাচের কাজগুলিকে কীভাবে সাব-ব্যাচে বিভক্ত করা হয় তা নিম্নলিখিত বিষয়গুলির দ্বারা নির্ধারিত হয়:
- তালিকাভুক্ত গ্রুপ ফিল্টারের ধরণ
- তালিকাভুক্ত গ্রুপ ফিল্টারটি যে
AdGroupCriterion
বাAssetGroup
লক্ষ্য করছে - কার্যক্রমের ক্রম
ক্রিয়াকলাপগুলিকে কীভাবে গোষ্ঠীভুক্ত করা হয়েছে তা বিবেচনা করুন:
- একই
AssetGroup
লক্ষ্য করে সমস্ত ধারাবাহিকAssetGroupListingGroupFilterOperation
ক্রিয়াকলাপগুলিকে একটি পারমাণবিক সাব-ব্যাচে একত্রিত করা হয় (কোনও আংশিক ব্যর্থতার আচরণ নেই)। - একই
AdGroup
লক্ষ্য করে একটিlisting_group
ধারণকারী সমস্ত ধারাবাহিকAdGroupCriterionOperation
ক্রিয়াকলাপগুলিকে একটি পারমাণবিক সাব-ব্যাচে একত্রিত করা হয় (কোনও আংশিক ব্যর্থতার আচরণ নেই)। - অন্যান্য সমস্ত ধারাবাহিক ক্রিয়াকলাপগুলিকে অ-পারমাণবিক উপ-ব্যাচে (আংশিক ব্যর্থতার আচরণ) একত্রিত করা হয়।
নিচের চিত্রটি এই ধারণাটি তুলে ধরে। প্রতিটি ধূসর বাক্স Google Ads API ব্যবহার করে জমা দেওয়া একটি ব্যাচ জবকে প্রতিনিধিত্ব করে। ধূসর বাক্সের মধ্যে, পৃথক ক্রিয়াকলাপগুলিকে রঙ অনুসারে গোষ্ঠীভুক্ত করা হয় যাতে Google Ads API সার্ভার যে সাব-ব্যাচ তৈরি করে তা উপস্থাপন করা হয়। প্রতিটি ধূসর বাক্সের ক্রিয়াকলাপের ক্রম ব্যাচ জবে যে ক্রম অনুসারে ক্রিয়াকলাপগুলি যোগ করা হত তার সাথে মিলে যায়।
সীমাবদ্ধতা
ব্যাচ জবের প্রেক্ষাপটে তালিকাভুক্ত গ্রুপ ফিল্টারগুলির সাথে কাজ করার সময়, নিম্নলিখিত সীমাবদ্ধতাগুলি প্রযোজ্য:
-
AssetGroupListingGroupFilterOperation
অপারেশনের একটি একক ব্যাচ, যেখানে একটিlisting_group
থাকে এবং একইAdGroup
লক্ষ্য করে, দৈর্ঘ্যে 20,000 অপারেশনের বেশি হতে পারে না। তবে, 10,000 অপারেশনের বেশি না করার পরামর্শ দেওয়া হচ্ছে। - একই
AssetGroup
লক্ষ্য করেAssetGroupListingGroupFilterOperation
অপারেশনের একটি একক ব্যাচ 10,000 অপারেশনের বেশি হতে পারে না। - এই শর্তগুলির যেকোনো একটি লঙ্ঘন করলে পুরো ব্যাচের কাজ ব্যর্থ হবে।
সমস্যা সমাধান
একটি ব্যাচ জবে লিস্টিং গ্রুপ ফিল্টার অপারেশনগুলি একটি লেনদেন হিসাবে প্রক্রিয়া করা হয়, যার ফলে এমন পরিস্থিতি তৈরি হতে পারে যেখানে অল্প সংখ্যক ভুল অপারেশনের কারণে অনেক অপারেশন ব্যর্থ হয়। অধিকন্তু, BatchJob
অপারেশনগুলি যেভাবে প্রক্রিয়া করা হয় তার কারণে, ব্যর্থতার মূল কারণ ডাউনস্ট্রিম ব্যর্থতার আগে বা পরে একটি সূচকে উপস্থিত হতে পারে।
উদাহরণস্বরূপ, ListBatchJobResults
থেকে একটি প্রতিক্রিয়া প্রক্রিয়া করার সময়, আপনি দেখতে পাবেন যে একটি স্ট্যাটাস বার্তা সহ বেশ কয়েকটি অপারেশন ব্যর্থ হয়েছে, Ad group is invalid due to the listing groups it contains
। এই বার্তাটি সাধারণত নির্দেশ করে যে এই সূচকের অপারেশনটি একটি ভিন্ন সূচকে ব্যর্থ অপারেশনের কারণে বাতিল করা হয়েছে। সমস্যার মূল কারণ সনাক্ত করার জন্য, আমরা অতিরিক্ত ত্রুটির তথ্যের সন্ধানে BatchJobResult
এর সমস্ত স্ট্যাটাস বার্তাগুলি পুনরাবৃত্তি করার পরামর্শ দিচ্ছি - Ad group is invalid
ত্রুটি বার্তা।