广告附加信息

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 above.
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 above.
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"

同样的情况也适用于其他受支持的广告附加信息。

访问广告组级别的广告附加信息

利用 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 will
// not 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);

如果将所有移动应用从广告系列中移除,该广告系列将不再包含附加移动应用信息。要从广告系列中移除所有移动应用,您需要检索该广告系列的移动应用列表,然后一次移除一个应用。删除其他受支持的广告附加信息也采用相同流程。