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