स्मार्ट कैंपेन को परफ़ॉर्मेंस मैक्स कैंपेन में बदलना

v25 और इसके बाद के वर्शन में, स्मार्ट कैंपेन को परफ़ॉर्मेंस मैक्स कैंपेन में बदलने के लिए, SmartCampaignSettingService.GeneratePMaxDraftCampaign तरीके का इस्तेमाल किया जा सकता है. यह तरीका, v24 और इससे पहले के वर्शन में उपलब्ध नहीं है.

कन्वर्ज़न कैसे काम करता है

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

जनरेट किए गए परफ़ॉर्मेंस मैक्स ड्राफ़्ट कैंपेन को, स्टेटस की इन वैल्यू के साथ शुरू किया जाता है:

• status को PAUSED पर सेट किया गया है.
• विज्ञापन दिखाने की ज़रूरी शर्तों के बारे में primary_status में बताया गया है.
• contains_eu_political_advertising को डिफ़ॉल्ट रूप से DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING पर सेट किया जाता है. हालांकि, ऐसा तब होता है, जब स्मार्ट कैंपेन में पहले से कोई वैल्यू तय न की गई हो. अगर आपके कैंपेन में ईयू में दिखाए जाने वाले राजनैतिक विज्ञापन मौजूद हैं, तो इस फ़ील्ड की पुष्टि करें और इसे अपडेट करें.

इससे आपको जनरेट किए गए परफ़ॉर्मेंस मैक्स कैंपेन, बजट, ऐसेट ग्रुप, और ऐसेट की जांच करने, उनमें बदलाव करने, और उन्हें बेहतर बनाने का विकल्प मिलता है. ऐसा कैंपेन को विज्ञापन दिखाने के लिए चालू करने से पहले किया जा सकता है.

ड्राफ़्ट ऐसेट

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

1. ऐसेट से जुड़ी ज़रूरी शर्तों की गाइड देखें.
2. इमेज ऐसेट अपलोड करने के उदाहरण का पालन करके, नई इमेज अपलोड करें.
3. नई ऐसेट को ड्राफ़्ट कैंपेन के ऐसेट ग्रुप से लिंक करें. इसके बाद, प्लेसहोल्डर की इमेज के लिए मौजूद AssetGroupAsset लिंक हटाएं. ऐसा एक ही ऐटॉमिक म्यूटेट रिक्वेस्ट में या नई ऐसेट को लिंक करने के बाद करें, ताकि ऐसेट से जुड़ी ज़रूरी शर्तें पूरी होती रहें. इसके लिए, ऐसेट ग्रुप को ऐसेट से लिंक करने की गाइड में दिया गया तरीका अपनाएं.

अनुरोध के पैरामीटर

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

GeneratePMaxDraftCampaignRequest मैसेज में ये फ़ील्ड इस्तेमाल किए जा सकते हैं:

• resource_name (ज़रूरी है): जिस स्मार्ट कैंपेन को बदलना है उसके लिए फिर से जनरेट किए जाने वाले SmartCampaignSetting के संसाधन का नाम. इसे इस फ़ॉर्मैट में डालें:

  customers/customer_id/smartCampaignSettings/campaign_id
  

• validate_only (ज़रूरी नहीं): अगर true है, तो अनुरोध की पुष्टि की जाती है, लेकिन उसे लागू नहीं किया जाता. जवाब के validated_info फ़ील्ड में, सिर्फ़ पुष्टि करने से जुड़ी गड़बड़ियां, चेतावनियां या कन्वर्ज़न से जुड़ी संभावित समस्याएं दिखती हैं. इसके लिए, ड्राफ़्ट इकाइयां बनाने की ज़रूरत नहीं होती.

• gbp_enabled (इस्तेमाल नहीं किया जा सकता): ज़रूरी नहीं. परफ़ॉर्मेंस मैक्स कैंपेन से लिंक की गई Google Business Profile (GBP) की लोकेशन को कन्वर्ज़न के तौर पर ट्रैक करना है या नहीं. इस फ़ील्ड को सेट न करें या false पर सेट करें. इसे true पर सेट करने की सुविधा उपलब्ध नहीं है. ऐसा करने पर, SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED गड़बड़ी का मैसेज दिखता है.

• image_enabled (इस्तेमाल नहीं किया जा सकता): ज़रूरी नहीं. परफ़ॉर्मेंस मैक्स कैंपेन के लिए ज़रूरी इमेज जनरेट करनी हैं या नहीं. जैसे, हॉरिज़ॉन्टल, स्क्वेयर, और लोगो इमेज टाइप. इस फ़ील्ड को सेट न करें या false पर सेट करें. इसे true पर सेट नहीं किया जा सकता. ऐसा करने पर, SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED गड़बड़ी का मैसेज दिखता है.

जवाब की जानकारी

GeneratePMaxDraftCampaignResponse मैसेज, जनरेट किए गए परफ़ॉर्मेंस मैक्स ड्राफ़्ट कैंपेन और उससे जुड़ी इकाइयों के संसाधन के नाम दिखाता है:

• pmax_campaign: जनरेट किए गए ड्राफ़्ट परफ़ॉर्मेंस मैक्स कैंपेन का Campaign रिसॉर्स नेम.
• campaign_budget: जनरेट किए गए परफ़ॉर्मेंस मैक्स कैंपेन से लिंक किए गए CampaignBudget रिसॉर्स का नाम.
• asset_group: जनरेट किए गए परफ़ॉर्मेंस मैक्स कैंपेन से लिंक किए गए AssetGroup संसाधन का नाम.
• assets: जनरेट किए गए परफ़ॉर्मेंस मैक्स कैंपेन से लिंक किए गए Asset रिसॉर्स के नामों की सूची.
• validated_info: कन्वर्ज़न की जांच से मिली पुष्टि की जानकारी या कन्वर्ज़न से जुड़ी संभावित समस्याएं. ये दोनों तब पॉप्युलेट होती हैं, जब validate_only को true पर सेट किया जाता है. साथ ही, जनरेट किए गए इकाई के रिसॉर्स नेम के साथ, जब validate_only, false होता है.

सुझाया गया वर्कफ़्लो

स्मार्ट कैंपेन को बदलने के लिए, इस वर्कफ़्लो का इस्तेमाल करें:

1. ड्राफ़्ट कैंपेन जनरेट करना: सिर्फ़ ज़रूरी resource_name सेट के साथ SmartCampaignSettingService.GeneratePMaxDraftCampaign को कॉल करें. gbp_enabled और image_enabled को अनसेट रहने दें या false पर सेट करें. वापस किए गए pmax_campaign, campaign_budget, asset_group, और assets रिसॉर्स के नाम सेव करें.
2. कैंपेन की समीक्षा करना और उसे पसंद के मुताबिक बनाना: परफ़ॉर्मेंस मैक्स कैंपेन का ड्राफ़्ट, status = PAUSED और creation_status = INCOMPLETE की मदद से बनाया जाता है. इसलिए, इसके बजट, ऐसेट ग्रुप, और ऐसेट की जांच करें और उन्हें कॉन्फ़िगर करें.
3. कैंपेन को चालू करें और ओरिजनल कैंपेन को रोकें: जब आप विज्ञापन दिखाने के लिए तैयार हों, तब परफ़ॉर्मेंस मैक्स कैंपेन के status को ENABLED पर अपडेट करें. इसके बाद, ओरिजनल स्मार्ट कैंपेन के status को PAUSED पर अपडेट करें, ताकि डुप्लीकेट विज्ञापन न दिखें.

ध्यान दें: आने वाले समय में, gbp_enabled और image_enabled को चालू करने के बाद, GBP की लोकेशन और इमेज ऐसेट को भी अपने-आप माइग्रेट किया जा सकेगा.