افزونه‌های آگهی

جاوااسکریپت Google Ads از افزونه‌های آگهی زیر پشتیبانی می‌کند:

• برنامه‌های تلفن همراه
• شماره تلفن
• نوشته‌های راهنما
• قیمت‌ها
• گزیده‌ها
• سایت‌پیوندها

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

جاوااسکریپت Google Ads به شما امکان می‌دهد به افزونه‌های آگهی پشتیبانی‌شده در حسابتان دسترسی داشته باشید. برای مثال، تکه‌کد زیر به سایت‌پیوندها دسترسی پیدا می‌کند:

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

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

ساختن

جاوااسکریپت Google Ads به شما امکان می‌دهد بااستفاده از سازنده‌ها افزونه‌های آگهی پشتیبانی‌شده ایجاد کنید. برای مثال، تکه‌کد زیر از سازنده شماره تلفن برای ایجاد شماره تلفن در حسابتان استفاده می‌کند:

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

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

دریافت آمار

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

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

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

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

اصلاح افزونه‌های آگهی

افزونه‌های آگهی پشتیبانی‌شده موجود را می‌توان با جاوااسکریپت Google Ads اصلاح کرد. برای مثال، تکه‌کد زیر سایت‌پیوند موجود را اصلاح می‌کند:

// 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 را اصلاح کنید، بر آگهی‌هایی که در همه پویش‌ها و گروه‌های آگهی مرتبط با سایت‌پیوند ارائه می‌شوند تأثیر خواهد گذاشت. این قانون صرف‌نظر از اینکه پیوند سایت را مستقیماً از حساب، از CampaignSitelink پویش مرتبط، یا از AdGroupSitelink گروه آگهی مرتبط بازیابی کرده باشید اعمال می‌شود. نمونه کد قبلی این رفتار را نشان می‌دهد.

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

دسترسی به افزونه‌های آگهی سطح گروه آگهی

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

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

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

دسترسی به اطلاعات تکمیلی سطح حساب

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

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

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

برداشتن افزونه‌های آگهی پویش، گروه آگهی، و حساب

افزونه‌های آگهی پشتیبانی‌شده را می‌توان در سطح حساب از پویش‌ها و گروه‌های آگهی برداشت. جاوااسکریپت Google Ads از برداشتن افزونه‌های آگهی از حساب به‌طور هم‌زمان پشتیبانی نمی‌کند.

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

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