বিজ্ঞাপন এক্সটেনশন স্ক্রিপ্ট স্থানান্তর, বিজ্ঞাপন এক্সটেনশন স্ক্রিপ্ট স্থানান্তর

এই দস্তাবেজটি স্ক্রিপ্টগুলির জন্য মাইগ্রেশন প্রক্রিয়া বর্ণনা করে যা বিজ্ঞাপন এক্সটেনশনগুলি অ্যাক্সেস করে বা পরিচালনা করে৷ 28 মার্চ, 2022 থেকে, বিজ্ঞাপন এক্সটেনশন আপডেট করার স্ক্রিপ্ট সহ গ্রাহকরা তাদের ফিড-ভিত্তিক এক্সটেনশনগুলি নতুন সম্পদ-ভিত্তিক এক্সটেনশনগুলিতে স্থানান্তরিত হবে। 13 মে, 2022 থেকে শুরু করে, স্ক্রিপ্ট সহ গ্রাহকরা বিজ্ঞাপন এক্সটেনশন আনছেন (এবং কোনও স্ক্রিপ্ট বিজ্ঞাপন এক্সটেনশন আপডেট করবেন না) তাদের ফিড-ভিত্তিক এক্সটেনশনগুলি নতুন সম্পদ-ভিত্তিক এক্সটেনশনগুলিতে স্থানান্তরিত হবে।

ওভারভিউ

বিদ্যমান ফিড-ভিত্তিক এক্সটেনশনের দৃষ্টান্তটি সম্পদ-ভিত্তিক এক্সটেনশনের পক্ষে অবহেলিত। Google Ads UI-তে ফিড-ভিত্তিক এক্সটেনশনগুলিকে "লেগেসি" এক্সটেনশন হিসাবে উল্লেখ করা হয় যখন সম্পদ-ভিত্তিক এক্সটেনশনগুলিকে Google Ads UI-তে "আপগ্রেড করা" এক্সটেনশন হিসাবে উল্লেখ করা হয়।

28 মার্চ, 2022 থেকে, ফিড-ভিত্তিক এক্সটেনশনগুলি নতুন সম্পদ-ভিত্তিক এক্সটেনশনগুলিতে স্থানান্তরিত হবে - একবার স্থানান্তরিত হলে, ফিড-ভিত্তিক এক্সটেনশনগুলি পরিবেশন করা বন্ধ করে দেবে। আপনার Google বিজ্ঞাপন অ্যাকাউন্টে ফিড-ভিত্তিক এবং সম্পদ-ভিত্তিক বিজ্ঞাপন এক্সটেনশন আছে বা আপনার অ্যাকাউন্টে শুধুমাত্র ফিড-ভিত্তিক বিজ্ঞাপন এক্সটেনশন আছে কিনা এই নির্দেশিকাটি মাইগ্রেশনের রূপরেখা দেবে।

মাইগ্রেশন বিশদ

সম্পদ-ভিত্তিক বিজ্ঞাপন এক্সটেনশনগুলি অ্যাক্সেস বা আপডেট করা শুরু করার জন্য, আপনাকে অবশ্যই নতুন Google বিজ্ঞাপন স্ক্রিপ্ট অভিজ্ঞতা ব্যবহার করতে হবে। নতুন Google বিজ্ঞাপন স্ক্রিপ্ট অভিজ্ঞতা সম্পর্কে তথ্যের জন্য, শুরু করার নির্দেশিকা দেখুন।

বিজ্ঞাপন এক্সটেনশন আনা হচ্ছে

বিজ্ঞাপন এক্সটেনশন নির্বাচকদের বিদ্যমান সেট (উদাহরণস্বরূপ, SitelinkSelector ফিড-ভিত্তিক বিজ্ঞাপন এক্সটেনশন বা সম্পদ-ভিত্তিক বিজ্ঞাপন এক্সটেনশন আনতে সক্ষম। ডিফল্টরূপে, এই নির্বাচকরা বর্তমানে যে ধরনের বিজ্ঞাপন এক্সটেনশন পরিবেশন করছে তা ফিরিয়ে দেবে। নিম্নলিখিত সারণীটি সংক্ষিপ্ত করে বিজ্ঞাপন এক্সটেনশনের ধরন যা বর্তমানে পরিবেশন করছে (এবং এইভাবে ডিফল্টরূপে ফেরত দেওয়া হবে):

অ্যাকাউন্টে বিজ্ঞাপন এক্সটেনশনের ধরন
শুধুমাত্র ফিড-ভিত্তিক বিজ্ঞাপন এক্সটেনশন ফিড-ভিত্তিক বিজ্ঞাপন এক্সটেনশনগুলি ডিফল্টরূপে ফেরত দেওয়া হবে
শুধুমাত্র সম্পদ-ভিত্তিক বিজ্ঞাপন এক্সটেনশন সম্পদ-ভিত্তিক বিজ্ঞাপন এক্সটেনশনগুলি ডিফল্টরূপে ফেরত দেওয়া হবে
উভয় ফিড-ভিত্তিক এবং সম্পদ-ভিত্তিক বিজ্ঞাপন এক্সটেনশন সম্পদ-ভিত্তিক বিজ্ঞাপন এক্সটেনশনগুলি ডিফল্টরূপে ফেরত দেওয়া হবে

সমস্ত ফিড-ভিত্তিক বিজ্ঞাপন এক্সটেনশন স্থানান্তরিত হওয়ার পরে, সমস্ত বিজ্ঞাপন এক্সটেনশন নির্বাচকরা ডিফল্টরূপে সম্পদ-ভিত্তিক বিজ্ঞাপন এক্সটেনশনগুলি ফিরিয়ে দেবে। withOnlyLegacy পদ্ধতির মাধ্যমে ফিড-ভিত্তিক বিজ্ঞাপন এক্সটেনশন আনা সম্ভব হবে। এটি ঐতিহাসিক মেট্রিক্স সংগ্রহের জন্য দরকারী।

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

বেশিরভাগ ক্ষেত্রে, ফিড-ভিত্তিক বিজ্ঞাপন এক্সটেনশানগুলি স্থানান্তরিত হওয়ার আগে বা পরে কোনও কোড পরিবর্তনের প্রয়োজন হবে না। যাইহোক, এমন কয়েকটি পরিস্থিতি রয়েছে যেখানে কোড পরিবর্তনের প্রয়োজন হতে পারে।

ID দ্বারা বিজ্ঞাপন এক্সটেনশন ফিল্টারিং

যখন একটি ফিড-ভিত্তিক বিজ্ঞাপন এক্সটেনশন স্থানান্তরিত হয়, তখন সংশ্লিষ্ট সম্পদ-ভিত্তিক বিজ্ঞাপন এক্সটেনশনের একটি ভিন্ন ID থাকবে। এর মানে হল যদি আপনার স্ক্রিপ্ট বর্তমানে ID দ্বারা বিজ্ঞাপন এক্সটেনশনগুলিকে ফিল্টার করে, তাহলে এটি সম্পদ-ভিত্তিক বিজ্ঞাপন এক্সটেনশনগুলি আনতে অক্ষম হবে৷

// 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 এ ফিরে আসবে। উপরন্তু, একটি সতর্কতা বার্তা লগ করা হবে. কোন পদ্ধতিগুলি অবমূল্যায়িত করা হয়েছে তা বোঝার জন্য নিম্নলিখিত টেবিলটি দেখুন:

ক্লাস অপ্রচলিত পদ্ধতি
কলআউট কোন অবচয় পদ্ধতি
মোবাইল অ্যাপ getSchedules
ফোন নম্বর getEndDate
getStartDate
দাম getEndDate
getSchedules
getStartDate
সাইটলিঙ্ক কোন অবচয় পদ্ধতি
স্নিপেট getEndDate
getSchedules
getStartDate

বিজ্ঞাপন এক্সটেনশন আপডেট করা হচ্ছে

মাইগ্রেশনের অংশ হিসেবে, বেশ কিছু ক্ষেত্র আর সমর্থিত নয়। উদাহরণস্বরূপ, স্নিপেট এক্সটেনশনগুলি থেকে শুরুর তারিখ এবং শেষের তারিখ অবমুক্ত করা হয়েছে৷ setStartDate করা কলগুলি বিজ্ঞাপন এক্সটেনশনের উপর কোন প্রভাব ফেলবে না। উপরন্তু, একটি সতর্কতা বার্তা লগ করা হবে. কোন পদ্ধতিগুলি অবমূল্যায়িত করা হয়েছে তা বোঝার জন্য নিম্নলিখিত টেবিলটি দেখুন:

ক্লাস অপ্রচলিত পদ্ধতি
কলআউট কোন অবচয় পদ্ধতি
মোবাইল অ্যাপ setSchedules
ফোন নম্বর clearEndDate
clearStartDate setEndDate
setStartDate
দাম clearEndDate
clearStartDate setEndDate
setSchedules
setStartDate
সাইটলিঙ্ক কোন অবচয় পদ্ধতি
স্নিপেট clearEndDate
clearStartDate setEndDate
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 এ করা কলগুলি এক্সটেনশনের উপর কোনো প্রভাব ফেলবে না—এর পরিবর্তে একটি সতর্কতা বার্তা লগ করা হবে। প্রতিটি ক্লাসের জন্য কোন পদ্ধতি অবহেলিত তা বোঝার জন্য নিম্নলিখিত টেবিলটি দেখুন:

ক্লাস অপ্রচলিত পদ্ধতি
কলআউট বিল্ডার withMobilePreferred
MobileAppBuilder withMobilePreferred
withSchedules
ফোন নম্বর নির্মাতা withEndDate
withMobilePreferred
withStartDate
প্রাইস বিল্ডার withEndDate
withMobilePreferred
withSchedules
withStartDate
সাইটলিঙ্ক বিল্ডার withMobilePreferred
স্নিপেট বিল্ডার withEndDate
withMobilePreferred
withSchedules
withStartDate