विज्ञापन एक्सटेंशन स्क्रिप्ट माइग्रेट करना

अहम जानकारी: Google Ads स्क्रिप्ट के लेगसी वर्शन की मदद से, फ़ीड पर आधारित मौजूदा एक्सटेंशन का इस्तेमाल जारी रखा जा सकता है. हालांकि, फ़ीड-आधारित एक्सटेंशन जल्द ही उपलब्ध नहीं होंगे. साथ ही, एसेट-आधारित एक्सटेंशन, Google Ads स्क्रिप्ट के नए वर्शन में सिर्फ़ उपलब्ध होंगे. हमारा सुझाव है कि आप अपनी लेगसी Google Ads स्क्रिप्ट को जल्द से जल्द, Google Ads स्क्रिप्ट के नए वर्शन पर माइग्रेट करें.

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

खास जानकारी

ध्यान दें: अगर आपके पास ऐसी कोई स्क्रिप्ट नहीं है जो विज्ञापन एक्सटेंशन को ऐक्सेस या अपडेट करती है, तो आपको कुछ करने की ज़रूरत नहीं है. इसके बजाय, विज्ञापन एक्सटेंशन की गाइड देखें.

फ़ीड पर आधारित मौजूदा एक्सटेंशन को बंद कर दिया गया है. अब एसेट पर आधारित एक्सटेंशन का इस्तेमाल किया जाएगा. Google Ads के यूज़र इंटरफ़ेस (यूआई) में फ़ीड-आधारित एक्सटेंशन को "लेगसी" एक्सटेंशन कहा जाता है, जबकि एसेट-आधारित एक्सटेंशन को Google Ads यूज़र इंटरफ़ेस (यूआई) में "अपग्रेड किए गए" एक्सटेंशन कहा जाता है.

फ़ीड-आधारित एक्सटेंशन को 28 मार्च, 2022 से, नए एसेट-आधारित एक्सटेंशन में माइग्रेट कर दिया जाएगा. माइग्रेट होने के बाद, फ़ीड-आधारित एक्सटेंशन दिखने बंद हो जाएंगे. इस गाइड में, माइग्रेशन के बारे में बताया गया है. भले ही, आपके Google Ads खाते में फ़ीड-आधारित और एसेट-आधारित, दोनों तरह के विज्ञापन एक्सटेंशन हों या सिर्फ़ फ़ीड-आधारित विज्ञापन एक्सटेंशन हों.

स्थानांतरण विवरण

एसेट पर आधारित विज्ञापन एक्सटेंशन को ऐक्सेस या अपडेट करने के लिए, आपको Google Ads स्क्रिप्ट के नए वर्शन का इस्तेमाल करना होगा. Google Ads स्क्रिप्ट के नए वर्शन के बारे में जानकारी पाने के लिए, शुरू करने के लिए गाइड देखें.

विज्ञापन एक्सटेंशन फ़ेच किए जा रहे हैं

विज्ञापन एक्सटेंशन सिलेक्टर का मौजूदा सेट (उदाहरण के लिए, SitelinkSelector), फ़ीड-आधारित विज्ञापन एक्सटेंशन या ऐसेट-आधारित विज्ञापन एक्सटेंशन, दोनों में से किसी एक को फ़ेच कर सकता है. डिफ़ॉल्ट रूप से, ये सिलेक्टर दिखाएगा कि फ़िलहाल जो भी विज्ञापन एक्सटेंशन दिखाया जा रहा है वह दिखेगा. नीचे दी गई टेबल में उस विज्ञापन एक्सटेंशन के टाइप के बारे में खास जानकारी दी गई है जो फ़िलहाल दिखाया जा रहा है (और इसलिए डिफ़ॉल्ट रूप से दिखाया जाएगा):

खाते में मौजूद विज्ञापन एक्सटेंशन का टाइप
सिर्फ़ फ़ीड-आधारित विज्ञापन एक्सटेंशन	फ़ीड-आधारित विज्ञापन एक्सटेंशन, डिफ़ॉल्ट रूप से दिखाए जाएंगे
सिर्फ़ ऐसेट पर आधारित विज्ञापन एक्सटेंशन	ऐसेट पर आधारित विज्ञापन एक्सटेंशन, डिफ़ॉल्ट रूप से दिखाए जाएंगे
फ़ीड और ऐसेट, दोनों तरह के विज्ञापन एक्सटेंशन	ऐसेट पर आधारित विज्ञापन एक्सटेंशन, डिफ़ॉल्ट रूप से दिखाए जाएंगे

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

// This will return feed-based sitelink extensions before and after
// March 28, 2022.
const sitelinks = AdsApp.extensions().sitelinks().withOnlyLegacy().get();

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

आईडी के हिसाब से विज्ञापन एक्सटेंशन फ़िल्टर करना

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

// If these IDs belong to feed-based sitelink extensions, this code will return
// an empty iterator on or after March 28, 2022 (once the extensions have been
// migrated).
const ids = [123, 456, 789];
const sitelinks = AdsApp.extensions().sitelinks().withIds(ids).get();

इसे ठीक करने के लिए, आपको किसी अन्य एट्रिब्यूट के हिसाब से फ़िल्टर करना चाहिए या एसेट पर आधारित विज्ञापन एक्सटेंशन के आईडी का इस्तेमाल करने के लिए, अपने कोड को अपडेट करना चाहिए.

आंकड़ों के हिसाब से विज्ञापन एक्सटेंशन फ़िल्टर करना

फ़ीड-आधारित विज्ञापन एक्सटेंशन को माइग्रेट करने पर, संबंधित ऐसेट-आधारित विज्ञापन एक्सटेंशन के आंकड़े रीसेट हो जाएंगे. आंकड़ों के हिसाब से विज्ञापन एक्सटेंशन फ़िल्टर करते समय, आपको इस बात का ध्यान रखना चाहिए. उदाहरण के लिए, अगर आपने LAST_MONTH में Clicks > 100 के साथ साइटलिंक एक्सटेंशन का अनुरोध किया है, तो हो सकता है कि आपको सामान्य से कम विज्ञापन एक्सटेंशन दिखें. ऐसा तब होता है, जब फ़ीड पर आधारित विज्ञापन एक्सटेंशन हाल ही में माइग्रेट किए गए हों.

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

अब काम न करने वाले तरीके

माइग्रेशन के तहत, कई फ़ील्ड अब काम नहीं करते. उदाहरण के लिए, स्निपेट एक्सटेंशन से शुरू होने की तारीख और खत्म होने की तारीख की सुविधा हटा दी गई है. getStartDate() पर किए गए कॉल के लिए, null का मैसेज दिखेगा. इसके अलावा, चेतावनी वाला मैसेज भी रिकॉर्ड किया जाएगा. कौनसे तरीके काम नहीं करते, यह जानने के लिए नीचे दी गई टेबल देखें:

कक्षा	अब काम न करने वाले तरीके
कॉलआउट	ऐसे कोई भी तरीके नहीं हैं जो अब काम नहीं करते
MobileApp	getSchedules
फ़ोन नंबर	getEndDate getStartDate
कीमत	getEndDate getSchedules getStartDate
साइटलिंक	ऐसे कोई भी तरीके नहीं हैं जो अब काम नहीं करते
स्निपेट	getEndDate getSchedules getStartDate

विज्ञापन एक्सटेंशन अपडेट करना

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

कक्षा	अब काम न करने वाले तरीके
कॉलआउट	ऐसे कोई भी तरीके नहीं हैं जो अब काम नहीं करते
MobileApp	setSchedules
फ़ोन नंबर	clearEndDate clearStartDatesetEndDate setStartDate
कीमत	clearEndDate clearStartDatesetEndDate setSchedules setStartDate
साइटलिंक	ऐसे कोई भी तरीके नहीं हैं जो अब काम नहीं करते
स्निपेट	clearEndDate clearStartDatesetEndDate setSchedules setStartDate

विज्ञापन एक्सटेंशन बनाना

विज्ञापन एक्सटेंशन बिल्डर का मौजूदा सेट (उदाहरण के लिए, SitelinkBuilder), फ़ीड-आधारित विज्ञापन एक्सटेंशन या ऐसेट-आधारित विज्ञापन एक्सटेंशन बना सकता है. डिफ़ॉल्ट रूप से, ये बिल्डर उसी तरह का विज्ञापन एक्सटेंशन बनाएंगे जो फ़िलहाल दिखाया जा रहा है. यहां दी गई टेबल में, विज्ञापन एक्सटेंशन के उस टाइप के बारे में खास जानकारी दी गई है जो फ़िलहाल दिखाया जा रहा है. साथ ही, यह भी बताया गया है कि यह डिफ़ॉल्ट रूप से कैसे बनेगा:

खाते में विज्ञापन एक्सटेंशन के टाइप
सिर्फ़ फ़ीड-आधारित विज्ञापन एक्सटेंशन	फ़ीड-आधारित विज्ञापन एक्सटेंशन, डिफ़ॉल्ट रूप से बन जाएंगे
सिर्फ़ ऐसेट पर आधारित विज्ञापन एक्सटेंशन	एसेट पर आधारित विज्ञापन एक्सटेंशन डिफ़ॉल्ट रूप से बनाए जाएंगे
फ़ीड और ऐसेट, दोनों तरह के विज्ञापन एक्सटेंशन	ऐसेट-आधारित विज्ञापन एक्सटेंशन डिफ़ॉल्ट रूप से बन जाएंगे

किसी ग्राहक के एक्सटेंशन माइग्रेट हो जाने के बाद, सभी विज्ञापन एक्सटेंशन बिल्डर डिफ़ॉल्ट रूप से ऐसेट पर आधारित विज्ञापन एक्सटेंशन बनाएंगे. फ़ीड-आधारित विज्ञापन एक्सटेंशन अब नहीं बनाए जा सकेंगे, क्योंकि फ़ीड-आधारित विज्ञापन एक्सटेंशन अब नहीं दिखाए जाएंगे.

अगर आपको डिफ़ॉल्ट व्यवहार के बजाय, फ़ीड पर आधारित एक्सटेंशन बनाना है, तो build() के बजाय build(true) को कॉल करें. उदाहरण के लिए:

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(true) means this will create a legacy phone number extension.
  .build(true)
  .getResult();

अगर आपको ऐसेट-आधारित एक्सटेंशन बनाना है और फ़िलहाल आपके खाते में सिर्फ़ फ़ीड-आधारित एक्सटेंशन हैं, तो 28 मार्च तक इंतज़ार करें या build(false) को कॉल करें.

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(false) means this will create an asset-based phone number extension
  // even if the account currently only has feed-based extensions.
  .build(false)
  .getResult();

काम न करने वाले फ़ील्ड

विज्ञापन एक्सटेंशन को माइग्रेट करने की प्रोसेस के तहत, कुछ फ़ील्ड बंद कर दिए गए हैं. उदाहरण के लिए, स्निपेट एक्सटेंशन से शुरू होने की तारीख और खत्म होने की तारीख की सुविधा हटा दी गई है. withEndDate या withStartDate पर किए गए कॉल से एक्सटेंशन पर कोई असर नहीं पड़ेगा. इसके बजाय, चेतावनी वाला मैसेज लॉग किया जाएगा. हर क्लास के लिए कौनसे तरीके काम नहीं करते, इसे समझने के लिए यहां दी गई टेबल देखें:

कक्षा	ऐसे तरीके जो अब काम नहीं करते
CalloutBuilder	withMobilePreferred
MobileAppBuilder	withMobilePreferred withSchedules
PhoneNumberBuilder	withEndDate withMobilePreferred withStartDate
PriceBuilder	withEndDate withMobilePreferred withSchedules withStartDate
SitelinkBuilder	withMobilePreferred
SnippetBuilder	withEndDate withMobilePreferred withSchedules withStartDate