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

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

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

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 गड़बड़ी दिखती है.

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

The 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 पर अपडेट करें.