AdGroupCriterion.listing_group या AssetGroupListingGroupFilter के संदर्भ में, लिस्टिंग ग्रुप फ़िल्टर का इस्तेमाल करते समय, इंटिग्रेशन डिज़ाइन करते समय इन बातों का ध्यान रखें.
बैच स्प्लिट करना
AdGroupCriterionOperation
अगर किसी बैच जॉब में ऐसी कोई कार्रवाई है जिसमें विज्ञापन ग्रुप के मानदंड या ऐसेट ग्रुप की लिस्टिंग ग्रुप के फ़िल्टर शामिल हैं, तो Google Ads API सर्वर को मिलने पर, बैच जॉब में मौजूद कार्रवाइयों को कई सब-बैच में बांट दिया जाता है. ध्यान दें कि बैच जॉब में स्टैंडर्ड कार्रवाइयों के उलट, लिस्टिंग ग्रुप फ़िल्टर कार्रवाइयों वाले हर सब-बैच को एटॉमिक तरीके से प्रोसेस किया जाता है.
लिस्टिंग ग्रुप फ़िल्टर वाले बैच जॉब को सब-बैच में बांटने का तरीका इन बातों पर निर्भर करता है:
- लिस्टिंग ग्रुप फ़िल्टर का टाइप
AdGroupCriterionयाAssetGroupलिस्टिंग ग्रुप फ़िल्टर, टारगेट कर रहा है- कार्रवाइयों का क्रम
देखें कि ऑपरेशन को कैसे ग्रुप किया गया है:
- एक ही
AssetGroupको टारगेट करने वाली सभी लगातारAssetGroupListingGroupFilterOperationकार्रवाइयों को एक एटॉमिक सब-बैच में ग्रुप किया जाता है. इसमें कुछ कार्रवाइयों के फ़ेल होने की समस्या नहीं होती. - एक ही
AdGroupको टारगेट करने वाली सभी लगातारAdGroupCriterionOperationकार्रवाइयों को एक एटॉमिक सब-बैच में ग्रुप किया जाता है. इसमेंlisting_groupटारगेटिंग शामिल होती है. इसमें कुछ कार्रवाइयों के फ़ेल होने की समस्या नहीं होती. - इसके बाद की सभी कार्रवाइयों को, नॉन-ऐटॉमिक सब-बैच में एक साथ ग्रुप किया जाता है. इससे कुछ कार्रवाइयां पूरी नहीं हो पाती हैं.
इस डायग्राम में, इस कॉन्सेप्ट के बारे में बताया गया है. हर ग्रे बॉक्स, Google Ads API का इस्तेमाल करके सबमिट किए गए बैच जॉब को दिखाता है. ग्रे बॉक्स में, अलग-अलग कार्रवाइयों को रंग के हिसाब से ग्रुप किया जाता है. इससे उन सब-बैच के बारे में पता चलता है जिन्हें Google Ads API सर्वर बनाता है. हर ग्रे बॉक्स में मौजूद कार्रवाइयों का क्रम, उस क्रम से मेल खाता है जिसमें कार्रवाइयों को बैच जॉब में जोड़ा गया था.
सीमाएं
बैच जॉब के संदर्भ में लिस्टिंग ग्रुप फ़िल्टर का इस्तेमाल करते समय, ये सीमाएं लागू होती हैं:
AdGroupCriterionOperationकार्रवाइयों के एक बैच में,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 गड़बड़ी के मैसेज के इंडेक्स से पहले और बाद के होने चाहिए.