बैच जॉब में लिस्टिंग ग्रुप फ़िल्टर

AdGroupCriterion.listing_group या AssetGroupListingGroupFilter के संदर्भ में, लिस्टिंग ग्रुप फ़िल्टर के साथ काम करते समय, इंटिग्रेशन डिज़ाइन करते समय इन बातों का ध्यान रखें.

बैच को हिस्सों में बांटना

अगर किसी बैच जॉब में ऐसे ऑपरेशन शामिल हैं जिनमें विज्ञापन ग्रुप के लिए शर्तें या एसेट ग्रुप की लिस्टिंग ग्रुप फ़िल्टर शामिल हैं, तो Google Ads API सर्वर पर मिलने के बाद, बैच जॉब में शामिल ऑपरेशन को कई सब-बैच में बांटा जाता है. ध्यान दें कि बैच जॉब में शामिल स्टैंडर्ड ऑपरेशन के उलट, लिस्टिंग ग्रुप फ़िल्टर वाले ऑपरेशन वाले हर सब-बैच को एक यूनिट के तौर पर माना जाता है.

लिस्टिंग ग्रुप फ़िल्टर वाले बैच जॉब को सब-बैच में बांटने का तरीका, इन फ़ैक्टर पर निर्भर करता है:

1. लिस्टिंग ग्रुप फ़िल्टर का टाइप
2. वह AdGroupCriterion या AssetGroup जिसे लिस्टिंग ग्रुप फ़िल्टर टारगेट कर रहा है
3. ऑपरेशन का क्रम

देखें कि ऑपरेशन को कैसे ग्रुप किया जाता है:

• एक ही AssetGroup को टारगेट करने वाले सभी लगातार AssetGroupListingGroupFilterOperation ऑपरेशन को एक एटॉमिक सब-बैच में ग्रुप किया जाता है. इसमें, कुछ ऑपरेशन के फ़ेल होने पर भी बाकी ऑपरेशन पूरे होते हैं.
• एक ही AdGroup को टारगेट करने वाले listing_group वाले सभी लगातार AdGroupCriterionOperation को एक एटॉमिक सब-बैच में ग्रुप किया जाता है. इसमें, कुछ ऑपरेशन के फ़ेल होने पर भी बाकी ऑपरेशन पूरे होते हैं.
• अन्य सभी लगातार ऑपरेशन को नॉन-एटॉमिक सब-बैच में ग्रुप किया जाता है. इसमें, कुछ ऑपरेशन के फ़ेल होने पर बाकी ऑपरेशन भी फ़ेल हो जाते हैं.

यहां दिए गए डायग्राम में, इस सिद्धांत के बारे में बताया गया है. ग्रे रंग के हर बॉक्स का मतलब है कि Google Ads API का इस्तेमाल करके, बैच जॉब सबमिट की गई है. ग्रे रंग के बॉक्स में, अलग-अलग ऑपरेशन को रंग के हिसाब से ग्रुप किया गया है. इससे पता चलता है कि Google Ads API सर्वर, सब-बैच कैसे बनाता है. ग्रे रंग के हर बॉक्स में ऑपरेशन का क्रम, उस क्रम से मेल खाता है जिसमें ऑपरेशन को बैच जॉब में जोड़ा गया होगा.

सीमाएं

बैच जॉब के संदर्भ में, लिस्टिंग ग्रुप फ़िल्टर के साथ काम करते समय, ये सीमाएं लागू होती हैं:

• listing_group वाले AdGroupCriterionOperation के एक बैच में, एक ही 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 गड़बड़ी के मैसेज के इंडेक्स से पहले और बाद के मैसेज शामिल हैं.