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

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

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

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 इकाइयां बनाई जा सकती हैं.

ज़्यादा विकल्पों वाला परफ़ॉर्मेंस मैक्स कैंपेन

खुदरा कारोबार के लिए परफ़ॉर्मेंस मैक्स कैंपेन

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

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

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

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

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

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