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

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

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

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