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

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

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

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

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

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

म्यूटेट ऑपरेशन की सूची तैयार करना

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

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

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

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

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

AssetGroupListingGroupFilterOperation के लिए सबसे सही तरीके

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

जॉब में बदलाव करने से जुड़ी कार्रवाइयां जोड़ना

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

बैच जॉब चलाना

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

जॉब का स्टेटस वापस पाना

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

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