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

اسکریپت‌های گوگل ادز از افزونه‌های تبلیغاتی زیر پشتیبانی می‌کنند:

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

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

اسکریپت‌های گوگل ادز به شما امکان دسترسی به افزونه‌های تبلیغاتی پشتیبانی‌شده در حساب کاربری‌تان را می‌دهند. برای مثال، قطعه کد زیر به لینک‌های سایت دسترسی می‌دهد:

const sitelinkIterator = AdsApp.extensions().sitelinks().get();
for (const sitelink of sitelinkIterator) {
  // Do something with each sitelink
}

شما می‌توانید سایر افزونه‌های تبلیغاتی پشتیبانی‌شده را نیز به طور مشابه با استفاده از تکرارکننده‌های مربوطه بازیابی کنید.

خلقت

اسکریپت‌های گوگل ادز به شما امکان می‌دهند با استفاده از سازندگان، افزونه‌های تبلیغاتی پشتیبانی‌شده ایجاد کنید. برای مثال، قطعه کد زیر از یک سازنده شماره تلفن برای ایجاد شماره تلفن در حساب شما استفاده می‌کند:

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("6502530000")
  .withCallOnly(false)
  .build()
  .getResult();

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

// Add a phone number to a campaign.
campaign.addPhoneNumber(newPhoneNumber);

// Add a phone number to an ad group.
adGroup.addPhoneNumber(newPhoneNumber);

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

آمار بگیرید

اسکریپت‌های گوگل ادز به شما امکان می‌دهند به آمار افزونه‌های تبلیغاتی پشتیبانی‌شده در سطح حساب، کمپین یا گروه تبلیغاتی دسترسی داشته باشید.

برای مثال، برای دریافت آمار لینک‌های سایت:

// Account-level stats
// Get a sitelink in the account.
const sitelinkIterator = AdsApp.extensions().sitelinks().get();
const sitelink = sitelinkIterator.next();
const sitelinkStats = sitelink.getStatsFor("LAST_30_DAYS");
console.log(sitelinkStats.getClicks());

// Campaign-level stats.
// Get a sitelink in a campaign.
const campaignSitelinkIterator = campaign.extensions().sitelinks().get();
const campaignSitelink = campaignSitelinkIterator.next();
const campaignSitelinkStats = campaignSitelink.getStatsFor("LAST_30_DAYS");
console.log(campaignSitelinkStats.getClicks());

// Ad-group-level stats.
// Get a sitelink in an ad group.
const adGroupSitelinkIterator = adGroup.extensions().sitelinks().get();
const adGroupSitelink = adGroupSitelinkIterator.next();
const adGroupSitelinkStats = adGroupSitelink.getStatsFor("LAST_30_DAYS");
console.log(adGroupSitelinkStats.getClicks());

به آمار سایر افزونه‌های تبلیغاتی پشتیبانی‌شده نیز می‌توان به روشی مشابه دسترسی پیدا کرد.

اصلاح افزونه‌های تبلیغاتی

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

// Get a sitelink in the account.
const sitelinkIterator = AdsApp.extensions().sitelinks().get();
const sitelink = sitelinkIterator.next();
console.log(sitelink.getLinkText()); // "original text"

// Get a sitelink from a campaign. Assume it's the same one as before.
const campaignSitelinkIterator = campaign.extensions().sitelinks().get();
const campaignSitelink = campaignSitelinkIterator.next();
console.log(campaignSitelink.getLinkText()); // "original text"

// Get a sitelink from an ad group. Assume it's the same one as before.
const adGroupSitelinkIterator = adGroup.extensions().sitelinks().get();
const adGroupSitelink = adGroupSitelinkIterator.next();
console.log(adGroupSitelink.getLinkText()); // "original text"

// Change the sitelink's link text. This change will affect all the campaigns
// and ad groups to which the sitelink belongs.
campaignSitelink.setLinkText("new link text");

// Same text!
console.log(campaignSitelink.getLinkText()); // "new link text"
console.log(adGroupSitelink.getLinkText()); // "new link text"
console.log(sitelink.getLinkText()); // "new link text"

توجه: اگر یک Sitelink تغییر دهید، بر تبلیغاتی که در تمام کمپین‌ها و گروه‌های تبلیغاتی که sitelink به آنها مرتبط است، نمایش داده می‌شوند، تأثیر می‌گذارد. این قانون چه sitelink را مستقیماً از حساب کاربری، چه از CampaignSitelink یک کمپین مرتبط یا از AdGroupSitelink یک گروه تبلیغاتی مرتبط بازیابی کرده باشید، اعمال می‌شود. مثال کد قبلی این رفتار را نشان می‌دهد.

همین مفاهیم برای سایر افزونه‌های تبلیغاتی پشتیبانی‌شده نیز صدق می‌کند.

به افزونه‌های تبلیغاتی در سطح گروه‌های تبلیغاتی دسترسی پیدا کنید

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

// This will return phone numbers that have been explicitly added to this
// ad group.
const adGroupPhoneNumberIterator = adGroup.extensions().phoneNumbers().get();

به سایر افزونه‌های تبلیغاتی پشتیبانی‌شده می‌توان در سطح گروه تبلیغاتی به روشی مشابه دسترسی پیدا کرد.

دسترسی به افزونه‌های تبلیغاتی در سطح حساب کاربری

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

// This will return callouts that have been explicitly added to your account.
const accountCalloutIterator =
    AdsApp.currentAccount().extensions().callouts().get();

به اپلیکیشن‌های موبایل و نقد و بررسی‌های سطح حساب کاربری نیز می‌توان به روشی مشابه دسترسی پیدا کرد.

افزودن افزونه‌های تبلیغاتی در سطح حساب کاربری مشابه افزودن افزونه‌های تبلیغاتی در سطح کمپین یا گروه تبلیغاتی است. مثال زیر نحوه افزودن افزونه فراخوانی در سطح حساب کاربری را نشان می‌دهد:

// Create a new callout in the account. Without adding the new callout as an ad
// group, campaign or account extension, it won't actually serve.
const calloutBuilder = AdsApp.extensions().newCalloutBuilder();
const newCallout = calloutBuilder.withText("Sample Text").build().getResult();

// Add the new callout as an account-level extension. This enables it to serve
// for all campaigns in the account.
AdsApp.currentAccount().addCallout(newCallout);

اپلیکیشن‌های موبایل و نقد و بررسی‌های سطح حساب کاربری را می‌توان به روشی مشابه اضافه کرد.

افزونه‌های تبلیغاتی کمپین، گروه تبلیغاتی و حساب کاربری را حذف کنید

افزونه‌های تبلیغاتی پشتیبانی‌شده را می‌توان از کمپین‌ها و گروه‌های تبلیغاتی در سطح حساب کاربری حذف کرد. اسکریپت‌های گوگل ادز از حذف یکباره افزونه‌های تبلیغاتی از یک حساب پشتیبانی نمی‌کنند.

// Get a mobile app from a campaign.
const campaignMobileAppIterator = campaign.extensions().mobileApps().get();
const campaignMobileApp = campaignMobileAppIterator.next();

// Remove the mobile app.
campaign.removeMobileApp(campaignMobileApp);

// The mobile app still exists in the account and will be returned in the
// following iterator.
const mobileAppIterator = AdsApp.extensions().mobileApps().get();

به طور مشابه، برای حذف یک برنامه تلفن همراه در سطح گروه تبلیغاتی یا حساب کاربری:

// Get a mobile app from an ad group.
const adGroupMobileAppIterator = adGroup.extensions().mobileApps().get();
const adGroupMobileApp = adGroupMobileAppIterator.next();

// Remove the mobile app.
adGroup.removeMobileApp(adGroupMobileApp);

// Get an account-level mobile app.
const accountMobileAppIterator =
    AdsApp.currentAccount().extensions().mobileApps().get();
const accountMobileApp = accountMobileAppIterator.next();

// Remove the mobile app.
// Note that this removes the mobile app from the account level, so it won't
// serve as an account-level extension, but it will still exist in the
// account. It can still be added to an AdGroup or Campaign, or again as an
// account-level extension in the future.
AdsApp.currentAccount().removeMobileApp(accountMobileApp);

اگر همه برنامه‌های تلفن همراه از یک کمپین حذف شوند، آن کمپین دیگر افزونه برنامه تلفن همراه نخواهد داشت. برای حذف همه برنامه‌های تلفن همراه از کمپین خود، باید لیست برنامه‌های تلفن همراه آن کمپین را بازیابی کرده و آنها را یکی یکی حذف کنید. این روش برای سایر افزونه‌های تبلیغاتی پشتیبانی شده نیز یکسان است.