انتقال اسکریپت های پسوند آگهی، انتقال اسکریپت های پسوند آگهی

مهم: می‌توانید از طریق تجربه قدیمی Google Ads Scripts به کار با برنامه‌های افزودنی مبتنی بر فید فعلی خود ادامه دهید. با این حال، برنامه‌های افزودنی مبتنی بر فید به زودی از دسترس خارج می‌شوند و افزونه‌های مبتنی بر دارایی فقط در تجربه جدید Google Ads Scripts در دسترس هستند. توصیه می‌کنیم اسکریپت‌های قدیمی Google Ads خود را در اسرع وقت به تجربه جدید Google Ads Scripts منتقل کنید.

این سند فرآیند انتقال اسکریپت هایی را که به پسوندهای تبلیغاتی دسترسی یا مدیریت می کنند، توضیح می دهد. از 28 مارس 2022، مشتریانی که اسکریپت‌هایی دارند که افزونه‌های تبلیغاتی را به‌روزرسانی می‌کنند، برنامه‌های افزودنی مبتنی بر فید خود را به برنامه‌های افزودنی مبتنی بر دارایی جدید منتقل خواهند کرد. از 13 مه 2022، مشتریانی که دارای اسکریپت‌هایی هستند که افزونه‌های تبلیغاتی را واکشی می‌کنند (و هیچ اسکریپتی در حال به‌روزرسانی افزونه‌های تبلیغاتی نیستند) برنامه‌های افزودنی مبتنی بر فید خود را به برنامه‌های افزودنی مبتنی بر دارایی جدید منتقل خواهند کرد.

نمای کلی

توجه: اگر هیچ اسکریپتی ندارید که به پسوندهای تبلیغاتی دسترسی داشته باشد یا آن را به روز کند، کار لازم نیست و در عوض می توانید به راهنمای افزونه های تبلیغات مراجعه کنید.

پارادایم افزونه های مبتنی بر خوراک موجود به نفع برنامه های افزودنی مبتنی بر دارایی منسوخ شده است. افزونه‌های مبتنی بر فید در رابط کاربری Google Ads به عنوان افزونه‌های «قدیمی» شناخته می‌شوند، در حالی که برنامه‌های افزودنی مبتنی بر دارایی به عنوان افزونه‌های «ارتقای‌شده» در رابط کاربری Google Ads نامیده می‌شوند.

از 28 مارس 2022، برنامه‌های افزودنی مبتنی بر فید به برنامه‌های افزودنی جدید مبتنی بر دارایی منتقل می‌شوند - پس از انتقال، برنامه‌های افزودنی مبتنی بر فید دیگر ارائه نمی‌شوند. این راهنما انتقال را مشخص می‌کند که آیا شما افزونه‌های تبلیغات مبتنی بر فید و دارایی را در حساب Google Ads خود دارید یا فقط افزونه‌های تبلیغات مبتنی بر فید را در حساب خود دارید.

جزئیات مهاجرت

برای شروع دسترسی یا به‌روزرسانی افزونه‌های تبلیغات مبتنی بر دارایی، باید از تجربه جدید Google Ads Scripts استفاده کنید. برای کسب اطلاعات در مورد تجربه جدید Google Ads Scripts، راهنمای شروع به کار را ببینید.

واکشی پسوندهای تبلیغاتی

مجموعه انتخابگرهای افزونه تبلیغات موجود (به عنوان مثال، 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 درخواست کنید، اگر افزونه‌های تبلیغات مبتنی بر فید شما اخیراً منتقل شده باشند، می‌توانید افزونه‌های تبلیغاتی کمتری نسبت به حالت عادی ببینید.

همچنین هنگام ایجاد گزارش عملکرد برای برنامه های افزودنی تبلیغاتی خود باید این را در نظر داشته باشید. گزارش‌های شما ممکن است تغییرات یا افت قابل توجهی را هنگام انتقال افزونه‌های تبلیغات مبتنی بر فید مشاهده کنند.

روش های منسوخ شده

به عنوان بخشی از مهاجرت، چندین فیلد دیگر پشتیبانی نمی شود. برای مثال، تاریخ شروع و تاریخ پایان از برنامه‌های افزودنی Snippet منسوخ شده‌اند. تماس های getStartDate() null خواهند شد. علاوه بر این، یک پیام هشدار ثبت خواهد شد. برای درک اینکه کدام متدها منسوخ شده اند، جدول زیر را ببینید:

کلاس	روش های منسوخ شده
فراخوانی	بدون روش منسوخ شده
اپلیکیشن موبایل	getSchedules
شماره تلفن	getEndDate getStartDate
قیمت	getEndDate getSchedules getStartDate
لینک سایت	بدون روش منسوخ شده
قطعه	getEndDate getSchedules getStartDate

به روز رسانی پسوندهای تبلیغاتی

به عنوان بخشی از مهاجرت، چندین فیلد دیگر پشتیبانی نمی شود. برای مثال، تاریخ شروع و تاریخ پایان از برنامه‌های افزودنی Snippet منسوخ شده‌اند. تماس با setStartDate هیچ تاثیری بر برنامه افزودنی تبلیغات نخواهد داشت. علاوه بر این، یک پیام هشدار ثبت خواهد شد. برای درک اینکه کدام متدها منسوخ شده اند، جدول زیر را ببینید:

کلاس	روش های منسوخ شده
فراخوانی	بدون روش منسوخ شده
اپلیکیشن موبایل	setSchedules
شماره تلفن	clearEndDate clearStartDate setEndDate setStartDate
قیمت	clearEndDate clearStartDate setEndDate setSchedules setStartDate
لینک سایت	بدون روش منسوخ شده
قطعه	clearEndDate clearStartDate setEndDate setSchedules setStartDate

ایجاد پسوندهای تبلیغاتی

مجموعه‌ای از سازندگان برنامه‌های افزودنی آگهی (به عنوان مثال، SitelinkBuilder می‌تواند افزونه‌های تبلیغاتی مبتنی بر فید یا افزونه‌های آگهی مبتنی بر دارایی ایجاد کند. به‌طور پیش‌فرض، این سازندگان هر نوع افزونه‌ای را ایجاد می‌کنند که در حال حاضر ارائه می‌شود. جدول زیر خلاصه می‌شود. نوع پسوند تبلیغاتی که در حال حاضر ارائه می شود (و بنابراین به طور پیش فرض ایجاد می شود):

نوع پسوند تبلیغات در حساب کاربری
فقط پسوندهای تبلیغاتی مبتنی بر فید	افزونه های تبلیغاتی مبتنی بر فید به طور پیش فرض ایجاد می شوند
فقط پسوندهای تبلیغاتی مبتنی بر دارایی	افزونه های تبلیغاتی مبتنی بر دارایی به طور پیش فرض ایجاد می شوند
افزونه های تبلیغاتی مبتنی بر فید و دارایی	افزونه های تبلیغاتی مبتنی بر دارایی به طور پیش فرض ایجاد می شوند

پس از اینکه یک مشتری برنامه های افزودنی خود را انتقال داد، همه سازندگان برنامه های افزودنی تبلیغات به طور پیش فرض افزونه های تبلیغاتی مبتنی بر دارایی ایجاد می کنند. ایجاد برنامه‌های افزودنی تبلیغات مبتنی بر فید دیگر پشتیبانی نخواهد شد زیرا افزونه‌های تبلیغات مبتنی بر فید دیگر ارائه نمی‌شوند.

اگر می خواهید به جای تکیه بر رفتار پیش فرض، یک افزونه مبتنی بر فید ایجاد کنید، می توانید این کار را با فراخوانی build(true) به جای build() انجام دهید، برای مثال:

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();

اگر می‌خواهید یک برنامه افزودنی مبتنی بر دارایی ایجاد کنید و حساب شما در حال حاضر فقط دارای برنامه‌های افزودنی مبتنی بر فید است، می‌توانید تا ۲۸ مارس صبر کنید یا با 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();

فیلدهای پشتیبانی نشده

به عنوان بخشی از انتقال پسوند آگهی، فیلدهای خاصی منسوخ شده اند. برای مثال، تاریخ شروع و تاریخ پایان از برنامه‌های افزودنی Snippet منسوخ شده‌اند. تماس‌های مربوط به withEndDate یا withStartDate هیچ تأثیری بر برنامه افزودنی نخواهد داشت - در عوض یک پیام هشدار ثبت می‌شود. برای درک اینکه کدام متدها برای هر کلاس منسوخ شده اند، جدول زیر را ببینید:

کلاس	روش های منسوخ شده
CalloutBuilder	withMobilePreferred
MobileAppBuilder	withMobilePreferred withSchedules
Phone NumberBuilder	withEndDate withMobilePreferred withStartDate
پرایس بیلدر	withEndDate withMobilePreferred withSchedules withStartDate
SitelinkBuilder	withMobilePreferred
SnippetBuilder	withEndDate withMobilePreferred withSchedules withStartDate