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

इस दस्तावेज़ में, उन स्क्रिप्ट को माइग्रेट करने की प्रोसेस के बारे में बताया गया है जो स्क्रिप्ट को ऐक्सेस या मैनेज करती हैं विज्ञापन एक्सटेंशन. वे ग्राहक जिन्होंने 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 मिलेगी. चेतावनी वाला एक मैसेज लॉग किया गया. कौन-कौनसे तरीके अब काम नहीं करते, यह जानने के लिए यहां दी गई टेबल देखें:

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

माइग्रेशन के दौरान, कई फ़ील्ड अब काम नहीं करते. उदाहरण के लिए, स्निपेट एक्सटेंशन से शुरू होने की तारीख और खत्म होने की तारीख रोक दी गई है. इन पर कॉल विज्ञापन एक्सटेंशन पर 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 पर किए गए कॉल का असर, एक्सटेंशन—इसके बजाय एक चेतावनी संदेश लॉग किया जाएगा. नीचे दी गई जानकारी देखें टेबल में देखें कि हर क्लास के लिए कौनसे तरीके काम नहीं करते: