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

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

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

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 में ऐसेट जोड़ने के बाद के अनुरोध सिर्फ़ तब स्वीकार किए जा सकते हैं, जब अनुरोध ऐसेट से जुड़ी सभी ज़रूरी शर्तों के मुताबिक हो. दूसरे शब्दों में, इन ऐसेट ग्रुप में ऐसेट को एक साथ नहीं जोड़ा जा सकता.