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

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

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

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

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

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

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

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

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

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

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

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

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

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

• ऐसेट ग्रुप के सिग्नल
• कैंपेन के कन्वर्ज़न लक्ष्य
• कैंपेन की शर्तें

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

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

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

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

• कस्टम ऐसेट के बिना या सिर्फ़ HTML5 MEDIA_BUNDLE ऐसेट वाले ऐसेट ग्रुप
• ऐसे ऐसेट ग्रुप जिनमें सभी ज़रूरी ऐसेट मौजूद हों (सुझाया गया)

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

• CampaignBudget
• Campaign (ShoppingSetting की जानकारी के साथ)
• AssetGroup
• AssetGroupListingGroupFilter

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

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

परफ़ॉर्मेंस मैक्स रीटेल कैंपेन को मान्य बनाने और उसे दिखाने के लिए ज़रूरी शर्तें

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

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

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

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

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

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

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

ऐसा अनुरोध जो पूरा नहीं हो सकता, क्योंकि इससे कैंपेन या संसाधन अमान्य स्थिति में चला जाएगा. उदाहरण के लिए, अगर आपने ज़रूरी ऐसेट शामिल किए बिना, नॉन-रीटेल कैंपेन (Local Services के परफ़ॉर्मेंस मैक्स कैंपेन के अलावा) के लिए 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 गड़बड़ी का मैसेज दिखाता है. हालांकि, परफ़ॉर्मेंस मैक्स रीटेल कैंपेन में, Google Merchant Center से अपने-आप जनरेट होने वाली ऐसेट का इस्तेमाल AssetGroup फिर से किया जा सकता है. इसके लिए, आपको एक ही अनुरोध में सभी कस्टम AssetGroupAsset लिंक हटाने होंगे.

परफ़ॉर्मेंस मैक्स रीटेल कैंपेन में मौजूद ऐसेट ग्रुप के लिए, कस्टम ऐसेट MEDIA_BUNDLE को लिंक करने के बाद के अनुरोधों में यह पक्का करना ज़रूरी है कि AssetGroup पर कम से कम एक final_urls सेट हो. साथ ही, एक ही अनुरोध में कम से कम ज़रूरी ऐसेट उपलब्ध कराई जाएं. इनमें कैंपेन-लेवल की ब्रैंड ऐसेट भी शामिल हैं. ऐसा तब होता है, जब ब्रैंड से जुड़े दिशा-निर्देश चालू हों. ये ऐसेट ग्रुप, बिना किसी कस्टम ऐसेट के बनाए जाते हैं. YOUTUBE_VIDEO जैसी वैकल्पिक विज्ञापन की ऐसेट को अलग से लिंक न करें या अलग-अलग अनुरोधों में विज्ञापन की ऐसेट को धीरे-धीरे न जोड़ें. सिर्फ़ वैकल्पिक कस्टम ऐसेट को लिंक करने से, ऐसेट ग्रुप काम नहीं करता. इससे Google Ads के यूज़र इंटरफ़ेस (यूआई) में बदलाव नहीं किए जा सकते. ज़्यादा जानकारी के लिए, परफ़ॉर्मेंस मैक्स रीटेल कैंपेन में ऐसेट ग्रुप को ऐसेट से लिंक करना लेख पढ़ें.