परफ़ॉर्मेंस मैक्स कैंपेन के लिए बैच प्रोसेसिंग

बैच प्रोसेसिंग की मदद से, एक साथ कई कार्रवाइयां की जा सकती हैं. ये कार्रवाइयां एक-दूसरे पर निर्भर हो सकती हैं. इन्हें कई सेवाओं पर एक साथ भेजा जा सकता है. इसके लिए, कार्रवाइयों के पूरा होने का इंतज़ार करने की ज़रूरत नहीं होती. परफ़ॉर्मेंस मैक्स कैंपेन बनाने और उन्हें मैनेज करने के लिए, बैच प्रोसेसिंग का इस्तेमाल किया जा सकता है.

इस गाइड में, बैच प्रोसेसिंग का इस्तेमाल करते समय परफ़ॉर्मेंस मैक्स कैंपेन से जुड़ी जानकारी दी गई है. सामान्य बैच प्रोसेसिंग गाइड में, बैच प्रोसेसिंग के बारे में सामान्य जानकारी दी गई है. साथ ही, स्ट्रक्चर अनुरोधों की गाइड में, परफ़ॉर्मेंस मैक्स कैंपेन बनाने या मैनेज करने के लिए अनुरोधों को तैयार करने के बारे में ज़्यादा जानकारी दी गई है.

बैच प्रोसेसिंग का इस्तेमाल करके परफ़ॉर्मेंस मैक्स कैंपेन बनाने के लिए, यह तरीका अपनाएं:

नया बैच जॉब बनाना

BatchJob संसाधन बनाने के लिए, बैच प्रोसेसिंग के जॉब बनाने का सामान्य तरीका अपनाएं.

बदलाव करने से जुड़ी कार्रवाइयों की सूची तैयार करना

परफ़ॉर्मेंस मैक्स कैंपेन को कई मिलते-जुलते संसाधन बनाने के लिए कार्रवाइयों की ज़रूरत होती है. इनके बारे में स्ट्रक्चर के अनुरोधों से जुड़ी गाइड में बताया गया है. बैच जॉब में शामिल किए जाने वाले हर रिसॉर्स के लिए, MutateOperation बनाएं.

CampaignOperation और CampaignAssetOperation की ज़रूरी शर्तें

जब किसी कैंपेन के लिए ब्रैंड से जुड़े दिशा-निर्देश चालू किए जाते हैं (ब्रैंड से जुड़े दिशा-निर्देश देखें), तो आपको CampaignAsset संसाधनों का इस्तेमाल करके, ब्रैंड ऐसेट को कैंपेन से लिंक करना होगा. इसके अलावा, बैच जॉब में इन CampaignAsset संसाधनों को Campaign संसाधन बनाने के तुरंत बाद बनाया जाना चाहिए. अगर ब्रैंड से जुड़े दिशा-निर्देश चालू होने पर, Campaign रिसॉर्स के तुरंत बाद CampaignAsset रिसॉर्स नहीं बनाए जाते हैं (समस्या हल करने का तरीका देखें), तो अनुरोध पूरा नहीं होगा. साथ ही, CampaignError मैसेज दिखेगा, जिसमें बताया जाएगा कि ऐसेट मौजूद नहीं हैं. कार्रवाइयों की उसी सूची में बाद में CampaignAsset बनाने की कार्रवाइयां शामिल करने से, यह गड़बड़ी नहीं रुकेगी.

AssetGroupOperation और AssetGroupAssetOperation की ज़रूरी शर्तें

बैच जॉब में AssetGroup और AssetGroupAsset संसाधन बनाने वाली MutateOperation टाइप की कार्रवाइयों को क्रम से होना चाहिए. इनके बीच में कोई अन्य कार्रवाई नहीं होनी चाहिए. ऐसा इसलिए, क्योंकि प्रोसेस करते समय इन कार्रवाइयों को एक साथ ग्रुप किया जाता है. ऐसा न करने पर, अनुरोध में AssetGroupError दिखेगा, जिससे पता चलेगा कि कुछ ऐसेट मौजूद नहीं हैं. भले ही, ऐसेट से जुड़ी ज़रूरी शर्तों को पूरा करने के लिए ज़रूरी कार्रवाइयां, बाद में कार्रवाइयों की सूची में शामिल की गई हों.

AssetGroupListingGroupFilterOperation सबसे सही तरीके

AssetGroupListingGroupFilter के संदर्भ में लिस्टिंग ग्रुप फ़िल्टर का इस्तेमाल करते समय, हम एक ही AssetGroup को टारगेट करने वाले AssetGroupListingGroupFilterOperation कार्रवाइयों को बैच जॉब में लगातार जोड़ने का सुझाव देते हैं. इससे बैच स्प्लिटिंग के दौरान, कार्रवाइयों के सेट को एटॉमिक तरीके से प्रोसेस किया जा सकेगा. बैच को बांटने और लिस्टिंग ग्रुप पर असर डालने वाले अन्य फ़ैक्टर के बारे में ज़्यादा जानने के लिए, लिस्टिंग ग्रुप के बैच को प्रोसेस करने से जुड़ी गाइड देखें.

जॉब में म्यूटेट ऑपरेशन जोड़ना

दूसरे चरण से म्यूटेट ऑपरेशन को सूची में जोड़ें और AddBatchJobOperations को कॉल करें. इससे, पहले चरण में बनाए गए बैच जॉब में म्यूटेशन की सूची जुड़ जाएगी. बदलाव करने के ऑपरेशन की सूची जोड़ने के लिए, बैच प्रोसेसिंग की सामान्य गाइड में दिए गए ऑपरेशन जोड़ने का तरीका अपनाएं.

बैच जॉब चलाना

अपलोड किए गए जॉब को RunBatchJob को कॉल करके, चलने की अनुमति दें. उदाहरण के लिए, बैच प्रोसेसिंग की सामान्य गाइड में बैच जॉब चलाना चरण देखें.

जॉब की स्थिति वापस पाना

बैच जॉब, लंबे समय तक चलने वाली कार्रवाइयों के तौर पर शुरू होते हैं. इन्हें पूरा होने में समय लगता है. जॉब शुरू करने के बाद, लंबे समय तक चलने वाले ऑपरेशन के GetOperation तरीके का इस्तेमाल करके, जॉब के स्टेटस की जांच करें. ऐसा तब तक करें, जब तक जॉब पूरा न हो जाए.

सभी बैच जॉब पूरे होने के बाद, ListBatchJobResults को कॉल करें. इससे, सामान्य बैच प्रोसेसिंग गाइड में दिए गए बैच जॉब के सभी नतीजों की सूची बनाएं चरण के मुताबिक, उनके स्टेटस और जवाब प्रिंट किए जा सकेंगे.