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

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

बेहतरीन परफ़ॉर्मेंस में मदद करने वाले कैंपेन बनाएं

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

बेहतरीन परफ़ॉर्मेंस में मदद करने वाले स्टैंडर्ड कैंपेन

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

• कैंपेन का बजट
• कैंपेन
• एसेट ग्रुप
• ऐसेट ग्रुप की ऐसेट
• एसेट

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

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

• AssetGroup और AssetGroupAsset रिसॉर्स बनाने से पहले, CampaignBudget, Campaign, और Asset रिसॉर्स को अलग-अलग अनुरोधों के तौर पर बनाएं.
• बदलाव करने के एक ही अनुरोध में इन सभी संसाधनों को शामिल करें.

CampaignBudget, Campaign, और Asset संसाधन, पिछले अनुरोधों में अलग-अलग बनाए जा सकते हैं. हालांकि, बेहतरीन परफ़ॉर्मेंस में मदद करने वाला कैंपेन तब तक दिखाया नहीं जा सकेगा, जब तक 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 संसाधनों को शामिल करना होगा. इसका मतलब यह भी है कि आपके सभी AssetGroupAsset रिसॉर्स, दिए गए field_type के लिए सही स्पेसिफ़िकेशन के मुताबिक होने चाहिए, ताकि पूरे अनुरोध को अस्वीकार होने से रोका जा सके.

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

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

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

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

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

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

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

एसेट ग्रुप अपडेट करें

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

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