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

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

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

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

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

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

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

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

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

जब परफ़ॉर्मेंस मैक्स कैंपेन Campaign के लिए ब्रैंड से जुड़े दिशा-निर्देश चालू किए जाते हैं, तो आपको CampaignAsset रिसॉर्स का इस्तेमाल करके, कैंपेन से ब्रैंड Asset रिसॉर्स लिंक करने होंगे. brand_guidelines_enabled डिफ़ॉल्ट रूप से, true पर सेट होता है. हालांकि, ऐसा तब नहीं होता, जब इसे false पर सेट किया जाए या यात्रा के लक्ष्यों वाला कैंपेन बनाया जाए. Local Services के परफ़ॉर्मेंस मैक्स कैंपेन में, ब्रैंड से जुड़े दिशा-निर्देशों का इस्तेमाल नहीं किया जा सकता. साथ ही, ब्रैंड के CampaignAsset संसाधनों को शामिल नहीं किया जा सकता. कैंपेन बनाते समय, brand_guidelines_enabled को false पर सेट करें. Merchant Center फ़ीड वाले रीटेल परफ़ॉर्मेंस मैक्स कैंपेन, एक ही ऐटॉमिक सब-बैच में ब्रैंड CampaignAsset के संसाधनों को सिर्फ़ तब हटा सकते हैं, जब कस्टम AssetGroupAsset संसाधनों (एचटीएमएल5 MEDIA_BUNDLE ऐसेट के अलावा) के बिना ऐसेटलेस कैंपेन बनाया जाए या जब brand_guidelines_enabled को false पर सेट किया गया हो.

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

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

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

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

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

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

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

बैच जॉब चलाना

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

जॉब की स्थिति पोल करना और नतीजे पाना

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

बैच जॉब पूरा होने पर, जॉब में मौजूद हर कार्रवाई की स्थिति और जवाब पाने के लिए, ListBatchJobResults तरीके को कॉल करें. उदाहरण के लिए, बैच जॉब के सभी नतीजे देखें.