अगर आपको 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 गड़बड़ी के मैसेज के इंडेक्स से पहले और बाद के मैसेज भी शामिल हैं. इससे आपको गड़बड़ी के बारे में ज़्यादा जानकारी मिल सकती है.