स्ट्रक्चर के अनुरोध

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

परफ़ॉर्मेंस मैक्स कैंपेन बनाना

Google Ads API में, परफ़ॉर्मेंस मैक्स कैंपेन की इकाइयां, कई यूनीक रिसॉर्स के कॉम्बिनेशन के तौर पर दिखती हैं.

स्टैंडर्ड परफ़ॉर्मेंस मैक्स कैंपेन

स्टैंडर्ड परफ़ॉर्मेंस मैक्स कैंपेन के विज्ञापन दिखाने के लिए, कम से कम ये रिसॉर्स ज़रूरी हैं.

• कैंपेन का बजट
• कैंपेन
• कैंपेन की ऐसेट (सिर्फ़ उन कैंपेन के लिए जिनमें ब्रैंड के दिशा-निर्देशों की सुविधा चालू है)
• ऐसेट ग्रुप
• ऐसेट ग्रुप की ऐसेट
• ऐसेट

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

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

परफ़ॉर्मेंस मैक्स कैंपेन बनाने वाले अनुरोधों को स्ट्रक्चर करने के अलग-अलग विकल्प होते हैं. कार्रवाइयों को ग्रुप में कैसे बांटा जाए और अनुरोधों को कैसे स्ट्रक्चर किया जाए, यह काफ़ी हद तक आपके लक्ष्यों और इन्फ़्रास्ट्रक्चर पर निर्भर करता है.

• AssetGroup और AssetGroupAsset रिसॉर्स बनाने से पहले, CampaignBudget, Campaign, Asset, और CampaignAsset रिसॉर्स को अलग-अलग अनुरोधों में बनाएं. (ब्रैंड के दिशा-निर्देशों की सुविधा वाले कैंपेन के लिए, Campaign और ज़रूरी CampaignAsset रिसॉर्स को एक ही अनुरोध में शामिल करना होगा)
• इन सभी रिसॉर्स को, बदलाव करने के एक ही अनुरोध में शामिल करें.

हालांकि, CampaignBudget, Campaign, Asset और CampaignAsset रिसॉर्स को अलग-अलग अनुरोधों में बनाया जा सकता है. हालांकि, परफ़ॉर्मेंस मैक्स कैंपेन के विज्ञापन तब तक नहीं दिखाए जा सकते, जब तक AssetGroup और AssetGroupAsset रिसॉर्स नहीं बनाए जाते.

परफ़ॉर्मेंस मैक्स कैंपेन के विज्ञापन दिखाने के लिए ज़रूरी शर्तें

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

• ऐसेट ग्रुप के सिग्नल
• कैंपेन के कन्वर्ज़न लक्ष्य
• कैंपेन के लिए टारगेटिंग के मानदंड

AssetGroup और AssetGroupAsset रिसॉर्स बनाने के लिए किए गए अनुरोध में, AssetGroupSignal रिसॉर्स बनाने के लिए कार्रवाइयां शामिल की जा सकती हैं. इसके अलावा, AssetGroup बनाने के बाद, AssetGroupSignal इकाइयां बनाने के लिए अलग से अनुरोध किया जा सकता है.

अतिरिक्त विकल्पों के साथ परफ़ॉर्मेंस मैक्स कैंपेन

रीटेल के लिए परफ़ॉर्मेंस मैक्स कैंपेन

रीटेल कैंपेन यूनीक होते हैं, क्योंकि इनमें ऐसेट ग्रुप बनाने के दो अलग-अलग तरीके होते हैं. इनसे विज्ञापन दिखाने के लिए मान्य कैंपेन बनता है:

• बिना किसी ऐसेट वाले ऐसेट ग्रुप
• ऐसेट ग्रुप जिनमें सभी ज़रूरी ऐसेट शामिल हों (सुझाया जाता है)

अगर ऐसेट ग्रुप से ऐसेट बाहर रखने का विकल्प चुना जाता है, तो Google, विज्ञापन बनाने के लिए, लिंक किए गए Merchant Center खाते में दी गई ऐसेट का इस्तेमाल अपने-आप करता है. हालांकि, हमारा सुझाव है कि सभी इन्वेंट्री तक पहुंचने के लिए, ऐसेट उपलब्ध कराएं. रीटेल के लिए परफ़ॉर्मेंस मैक्स कैंपेन के विज्ञापन दिखाने के लिए, कम से कम ये रिसॉर्स ज़रूरी हैं.

• CampaignBudget
• Campaign (जिसमें ShoppingSettings की वैल्यू डाली गई हो)
• AssetGroup
• AssetGroupListingGroupFilter

यह ध्यान रखना ज़रूरी है कि रीटेल कैंपेन में, Campaign.shopping_settings फ़ील्ड में वैल्यू डालनी ज़रूरी है. इसके अलावा, हर AssetGroup में शामिल final_urls, Campaign.shopping_settings में बताए गए Merchant Center खाता आईडी से जुड़े यूआरएल से मेल खाने चाहिए. आखिर में, हर AssetGroup में प्रॉडक्ट की मान्य लिस्टिंग ग्रुप ट्री होनी चाहिए. इसमें एक या उससे ज़्यादा AssetGroupListingGroupFilter रिसॉर्स शामिल होने चाहिए. कम से कम, आपको एक नोड ट्री बनाना होगा, ताकि आपके बताए गए Merchant Center फ़ीड में मौजूद सभी प्रॉडक्ट शामिल किए जा सकें.

इनमें से हर रिसॉर्स को अलग-अलग या एक ही अनुरोध में बनाया जा सकता है. हालांकि, जब तक इन सभी रिसॉर्स को सही तरीके से नहीं बनाया जाता, तब तक कैंपेन के विज्ञापन नहीं दिखाए जा सकते.

रीटेल परफ़ॉर्मेंस मैक्स कैंपेन के विज्ञापन दिखाने के लिए ज़रूरी शर्तें

रीटेल कैंपेन, स्टैंडर्ड परफ़ॉर्मेंस मैक्स कैंपेन के लिए उपलब्ध सभी विकल्पों का इस्तेमाल कर सकते हैं. इनमें ऐसेट ग्रुप के सिग्नल, कैंपेन के कन्वर्ज़न लक्ष्य, और कैंपेन के लिए टारगेटिंग के मानदंड बनाना शामिल है. अगर AssetGroup रिसॉर्स बनाते समय, AssetGroup में विज्ञापन की ऐसेट जोड़ने का विकल्प चुना जाता है, तो आपके AssetGroup को, ऐसेट से जुड़ी ज़रूरी शर्तों के मुताबिक होना चाहिए. दूसरे शब्दों में, आपके पास ऐसेट शामिल न करने या सभी ज़रूरी ऐसेट शामिल करने का विकल्प होता है.

अतिरिक्त विकल्पों के साथ रीटेल परफ़ॉर्मेंस मैक्स कैंपेन

अमान्य स्थिति बनाम अमान्य अनुरोध

Google Ads API में, परफ़ॉर्मेंस मैक्स कैंपेन के साथ काम करते समय, अमान्य स्थितियों और अमान्य अनुरोधों के बीच अंतर करना ज़रूरी है.

अमान्य स्थिति

कैंपेन को जिस तरह से कॉन्फ़िगर किया गया है उसकी वजह से, उसके विज्ञापन नहीं दिखाए जा सकते. उदाहरण के लिए, PERFORMANCE_MAX के advertising_channel_type के साथ, स्टैंडअलोन Campaign रिसॉर्स बनाया जा सकता है. कैंपेन बनाने का अनुरोध पूरा होने के बावजूद, उसके विज्ञापन तब तक नहीं दिखाए जा सकते, जब तक कैंपेन में कम से कम एक AssetGroup न जोड़ा जाए. अगर आपके अनुरोध पूरे हो जाते हैं, लेकिन आपके कैंपेन या ऐसेट ग्रुप के विज्ञापन नहीं दिखाए जा रहे हैं, तो इसकी वजह जानने के लिए, CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus, और AssetGroupPrimaryStatusReason का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, समस्याओं को हल करने वाली गाइड देखें.

अमान्य अनुरोध

ऐसा अनुरोध जो पूरा नहीं हो पाएगा, क्योंकि इससे कैंपेन या रिसॉर्स अमान्य स्थिति में चला जाएगा. उदाहरण के लिए, अगर रीटेल कैंपेन के अलावा किसी अन्य कैंपेन के लिए, ज़रूरी ऐसेट शामिल किए बिना AssetGroup बनाने की कोशिश की जाती है, तो Google Ads API गड़बड़ी का मैसेज दिखाता है. इसलिए, आपको AssetGroup और उसके AssetGroupAsset रिसॉर्स को एक ही अनुरोध में शामिल करना होगा. इसका मतलब यह भी है कि field_type के लिए, आपके सभी AssetGroupAsset रिसॉर्स को सही खास जानकारी के मुताबिक होना चाहिए, ताकि पूरा अनुरोध पूरा हो सके.

बदलाव करने के अनुरोधों के साथ कार्रवाइयों को ग्रुप में बांटना

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

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

कार्रवाइयों का क्रम

परफ़ॉर्मेंस मैक्स कैंपेन बनाने के लिए, बदलाव करने का बल्क अनुरोध इस्तेमाल करने पर भी, आपको अपने अनुरोधों और कार्रवाइयों को इस तरह से क्रम में लगाना होगा कि किसी रिसॉर्स को बनाने से पहले उसका रेफ़रंस न दिया जाए. बदलाव करने के बल्क अनुरोधों के मामले में, इसका मतलब है कि कार्रवाइयों को इस तरह से क्रम में लगाया जाए कि रेफ़रंस वाले रिसॉर्स, उनका रेफ़रंस देने वाले रिसॉर्स से पहले दिखाए जाएं.

अगर ऐसेट रिसॉर्स बनाने के लिए, बदलाव करने के उसी बल्क अनुरोध में ऐसेट रिसॉर्स बनाने का विकल्प चुना जाता है जो AssetGroup और उसके AssetGroupAsset रिसॉर्स बनाता है, तो सभी AssetOperations, सभी AssetGroupAssetOperations से पहले होनी चाहिए. जैसा कि डायग्राम में दिखाया गया है.

Google Ads का सर्वर, लगातार AssetGroupAssetOperations को एक साथ बैच करता है और यह आकलन करता है कि किसी AssetGroup में, ऐसेट से जुड़ी ज़रूरी शर्तें पूरी होती हैं या नहीं. यह आकलन, उस ग्रुप में की गई आखिरी कार्रवाई के बाद किया जाता है. अगर आपके अनुरोध में AssetOperations और AssetGroupAssetOperations बारी-बारी से शामिल हैं, तो एपीआई सर्वर, पहली AssetGroupAssetOperation के बाद, ऐसेट से जुड़ी ज़रूरी शर्तों का आकलन करेगा. साथ ही, अनुरोध में शामिल बाकी कार्रवाइयों को पूरा किए बिना, गड़बड़ी का मैसेज दिखाएगा. नतीजतन, अनुरोध में शामिल कोई भी ऐसेट, आपके Google Ads खाते में नहीं जोड़ी जाएगी. इसके अलावा, न तो AssetGroup बनाया जाएगा और न ही उससे जुड़े कोई AssetGroupAsset रिसॉर्स बनाए जाएंगे.

ऐसेट ग्रुप अपडेट करना

मान्य AssetGroup बनाने के बाद, ऐसे अनुरोध नहीं किए जा सकते जिनसे अमान्य स्थिति पैदा हो. इस स्थिति में, ऐसेट से जुड़ी ज़रूरी शर्तें पूरी नहीं होती हैं. ऐसे किसी भी अनुरोध से गड़बड़ी होती है. उदाहरण के लिए, अगर आप एक AssetGroup बनाते हैं जिसमें एक MARKETING_IMAGE (ज़रूरी शर्त) है, तो उस MARKETING_IMAGE से जुड़े AssetGroupAsset को हटाने के लिए किए गए किसी भी अनुरोध से गड़बड़ी होगी.

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