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