v25 और इसके बाद के वर्शन में,
SmartCampaignSettingService.GeneratePMaxDraftCampaign
तरीके का इस्तेमाल करके, स्मार्ट कैंपेन को परफ़ॉर्मेंस मैक्स कैंपेन में बदला जा सकता है. यह तरीका, v24 और इससे पहले के वर्शन में उपलब्ध नहीं है.
कन्वर्ज़न कैसे काम करता है
SmartCampaignSettingService.GeneratePMaxDraftCampaign को कॉल करने पर,
एपीआई, अनुरोध में दिए गए स्मार्ट कैंपेन की सेटिंग के आधार पर, परफ़ॉर्मेंस मैक्स कैंपेन का ड्राफ़्ट, बजट, ऐसेट ग्रुप, और ऐसेट जनरेट करता है. जनरेट होने के बाद, विज्ञापन दिखाने के लिए कैंपेन को चालू करने से पहले, आपको नए संसाधनों की जांच करनी चाहिए, उनमें बदलाव करना चाहिए, और उन्हें बेहतर बनाना चाहिए.
जनरेट किए गए परफ़ॉर्मेंस मैक्स कैंपेन के ड्राफ़्ट को, इन स्टेटस वैल्यू के साथ शुरू किया जाता है:
statusकोPAUSEDपर सेट किया जाता है.- विज्ञापन दिखाने की ज़रूरी शर्तें पूरी होती हैं या नहीं, यह
primary_statusमें दिखता है. - डिफ़ॉल्ट रूप से,
contains_eu_political_advertisingकोDOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISINGपर सेट किया जाता है. हालांकि, अगर स्मार्ट कैंपेन में यह पहले से तय है, तो डिफ़ॉल्ट वैल्यू लागू नहीं होती. अगर आपके कैंपेन में ईयू में राजनैतिक विज्ञापन शामिल हैं, तो इस फ़ील्ड की पुष्टि करें और इसे अपडेट करें.
इससे, विज्ञापन दिखाने के लिए कैंपेन को चालू करने से पहले, जनरेट किए गए परफ़ॉर्मेंस मैक्स कैंपेन, बजट, ऐसेट ग्रुप, और ऐसेट की जांच की जा सकती है, उनमें बदलाव किया जा सकता है, और उन्हें बेहतर बनाया जा सकता है.
ड्राफ़्ट ऐसेट
नए कैंपेन के साथ, प्लेसहोल्डर इमेज का एक ग्रुप भी जनरेट होता है. नए कैंपेन को चालू करने से पहले, इन इमेज को बदलना ज़रूरी है. अगर अनुरोध में image_enabled फ़ील्ड काम करता है और इसे true पर सेट किया जाता है, तो एपीआई, प्लेसहोल्डर की इमेज के बजाय अपने-आप इमेज जनरेट करता है. जवाब के assets फ़ील्ड में, नई ऐसेट देखी जा सकती हैं. इन्हें बदलने के लिए, यह तरीका अपनाएं:
- ऐसेट से जुड़ी ज़रूरी शर्तें देखें.
- इमेज ऐसेट अपलोड करने के उदाहरण के मुताबिक, नई इमेज अपलोड करें.
-
ऐसेट ग्रुप को ऐसेट से लिंक करने के बारे में बने लेख में दिए गए तरीके के मुताबिक, नई ऐसेट को ड्राफ़्ट कैंपेन के ऐसेट ग्रुप से लिंक करें. इसके बाद, प्लेसहोल्डर की इमेज के लिए
AssetGroupAssetलिंक हटाएं. यह काम, एक ही एटॉमिक म्यूटेट अनुरोध में किया जा सकता है या नई ऐसेट को लिंक करने के बाद किया जा सकता है, ताकि ऐसेट से जुड़ी ज़रूरी शर्तें पूरी होती रहें.
अनुरोध के पैरामीटर
GeneratePMaxDraftCampaignRequest मैसेज में, ये फ़ील्ड स्वीकार किए जाते हैं:
resource_name(ज़रूरी है): उस स्मार्ट कैंपेन के लिए,SmartCampaignSettingका संसाधन नाम जिसे आपको बदलना है. इसे इस फ़ॉर्मैट में सेट करें:customers/customer_id/smartCampaignSettings/campaign_idvalidate_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गड़बड़ी दिखती है.
जवाब की जानकारी
The GeneratePMaxDraftCampaignResponse मैसेज
में, जनरेट किए गए परफ़ॉर्मेंस मैक्स कैंपेन के ड्राफ़्ट और
उससे जुड़ी इकाइयों के संसाधन नाम दिखते हैं:
pmax_campaign: जनरेट किए गए परफ़ॉर्मेंस मैक्स कैंपेन के ड्राफ़्ट काCampaignसंसाधन नाम.campaign_budget: जनरेट किए गए परफ़ॉर्मेंस मैक्स कैंपेन से लिंक किया गयाCampaignBudgetसंसाधन नाम.asset_group: जनरेट किए गए परफ़ॉर्मेंस मैक्स कैंपेन से लिंक किया गयाAssetGroupसंसाधन नाम.assets: जनरेट किए गए परफ़ॉर्मेंस मैक्स कैंपेन से लिंक किए गएAssetसंसाधन नामों की सूची.validated_info: पुष्टि करने की जानकारी या कन्वर्ज़न की जांच से मिली कन्वर्ज़न से जुड़ी संभावित समस्याएं. यह जानकारी,validate_onlyकोtrueपर सेट करने पर और जनरेट की गई इकाई के संसाधन नामों के साथ तब दिखती है, जबvalidate_onlyकोfalseपर सेट किया जाता है.
सुझाया गया वर्कफ़्लो
स्मार्ट कैंपेन को बदलने के लिए, यह वर्कफ़्लो इस्तेमाल करें:
- ड्राफ़्ट कैंपेन जनरेट करें: सिर्फ़ ज़रूरी
resource_nameको सेट करके,SmartCampaignSettingService.GeneratePMaxDraftCampaignको कॉल करें.gbp_enabledऔरimage_enabledको सेट न करें याfalseपर सेट करें. मिले हुएpmax_campaign,campaign_budget,asset_group, औरassetsसंसाधन नामों को सेव करें. - कैंपेन की समीक्षा करें और उसे पसंद के मुताबिक बनाएं: परफ़ॉर्मेंस मैक्स
कैंपेन का ड्राफ़्ट,
status = PAUSEDऔरcreation_status = INCOMPLETEके साथ बनाया जाता है. इसलिए, इसके बजट, ऐसेट ग्रुप, और ऐसेट की जांच करें और उन्हें कॉन्फ़िगर करें. - कैंपेन को चालू करें और ओरिजनल कैंपेन को रोकें: जब विज्ञापन दिखाने के लिए कैंपेन तैयार हो जाए, तो परफ़ॉर्मेंस मैक्स कैंपेन के
statusकोENABLEDपर अपडेट करें. इसके बाद, डुप्लीकेट विज्ञापन दिखाने से बचने के लिए, ओरिजनल स्मार्ट कैंपेन केstatusकोPAUSEDपर अपडेट करें.