Anzeigenerweiterungen

In Google Ads-Scripts werden die folgenden Anzeigenerweiterungen unterstützt:

• Mobile Apps
• Telefonnummern
• Erweiterungen mit Zusatzinformationen
• Preise
• Snippets
• Sitelinks

Weitere Informationen zu Anzeigenerweiterungen finden Sie in der Hilfe.

Mit Google Ads-Scripts können Sie auf unterstützte Anzeigenerweiterungen in Ihrem Konto zugreifen. Beispielsweise wird mit dem folgenden Code-Snippet auf Sitelinks zugegriffen:

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

Andere unterstützte Anzeigenerweiterungen werden in ähnlicher Weise mithilfe ihres jeweiligen Iterators abgerufen.

Erstellung

Mit Google Ads-Scripts können Sie unterstützte Anzeigenerweiterungen erstellen. Im folgenden Code-Snippet wird beispielsweise ein Telefonnummern-Builder verwendet, um eine Telefonnummer in Ihrem Konto zu erstellen:

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

Wenn build() aufgerufen wird, wird die Telefonnummer im Konto erstellt, wird aber noch nicht in Anzeigen angezeigt. Dazu muss sie zunächst einer Kampagne oder Anzeigengruppe hinzugefügt werden.

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

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

Andere unterstützte Anzeigenerweiterungen können auf die gleiche Weise mithilfe der jeweiligen Tools erstellt und mit Kampagnen oder Anzeigengruppen verknüpft werden.

Statistiken abrufen

Mit Google Ads-Scripts können Sie auf Statistiken für unterstützte Anzeigenerweiterungen auf Konto-, Kampagnen- oder Anzeigengruppenebene zugreifen.

Gehen Sie beispielsweise wie folgt vor, um Statistiken zu Sitelinks abzurufen:

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

Auf Statistiken zu anderen unterstützten Anzeigenerweiterungen kann auf ähnliche Weise zugegriffen werden.

Anzeigenerweiterungen ändern

Vorhandene unterstützte Anzeigenerweiterungen können mithilfe von Google Ads-Skripts geändert werden. Beispielsweise wird mit dem folgenden Code-Snippet ein vorhandener Sitelink geändert:

// 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"

Hinweis :Wenn Sie einen Sitelink ändern, wirkt sich das auf die Anzeigenauslieferung in allen Kampagnen und Anzeigengruppen aus, mit denen der Sitelink verknüpft ist. Diese Regel gilt unabhängig davon, ob Sie den Sitelink direkt aus dem Konto, aus einer CampaignSitelink einer verknüpften Kampagne oder aus einer AdGroupSitelink einer verknüpften Anzeigengruppe abgerufen haben. Das obige Codebeispiel veranschaulicht dieses Verhalten.

Dieselben Prinzipien gelten für andere unterstützte Anzeigenerweiterungen.

Auf Anzeigenerweiterungen auf Anzeigengruppenebene zugreifen

Mit Google Ads-Scripts können Sie auf Anzeigenerweiterungen auf Anzeigengruppenebene zugreifen. Der folgende Methodenaufruf gibt Telefonnummern zurück, die einer Anzeigengruppe explizit hinzugefügt wurden. Wenn der Kampagne, zu der die Anzeigengruppe gehört, Telefonnummern hinzugefügt wurden, werden diese vom folgenden Methodenaufruf nicht zurückgegeben, auch wenn sie in Anzeigen erscheinen können, die aus dieser Anzeigengruppe ausgeliefert werden.

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

Auf andere unterstützte Anzeigenerweiterungen kann auf ähnliche Weise auf Anzeigengruppenebene zugegriffen werden.

Anzeigenerweiterungen auf Kontoebene

Mit Google Ads-Scripts können Sie auf Anzeigenerweiterungen auf Kontoebene zugreifen. Zusatzinformationen, mobile Apps und Rezensionen können als Anzeigenerweiterungen auf Kontoebene hinzugefügt werden. Sitelinks und Telefonnummern auf Kontoebene sind jedoch nicht verfügbar. Der folgende Methodenaufruf gibt Zusatzinformationen zurück, die Ihrem Konto ausdrücklich hinzugefügt wurden.

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

Auf mobile Apps und Rezensionen kann auf ähnliche Weise zugegriffen werden.

Anzeigenerweiterungen auf Kontoebene können ähnlich wie auf Kampagnen- oder Anzeigengruppenebene hinzugefügt werden. Im folgenden Beispiel wird gezeigt, wie Sie eine Anzeigenerweiterung mit Zusatzinformationen auf Kontoebene hinzufügen:

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

Mobile Apps und Bewertungen auf Kontoebene können auf ähnliche Weise hinzugefügt werden.

Anzeigenerweiterungen auf Kampagnen-, Anzeigengruppen- und Kontoebene entfernen

Unterstützte Anzeigenerweiterungen können aus Kampagnen und Anzeigengruppen auf Kontoebene entfernt werden. Google Ads-Skripts unterstützen nicht das gleichzeitige Entfernen aller Anzeigenerweiterungen aus einem Konto.

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

Mit dem folgenden Beispielcode entfernen Sie eine mobile App auf Konto- oder Anzeigengruppenebene:

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

Wenn alle Apps aus einer Kampagne entfernt werden, hat die Kampagne keine App-Erweiterung mehr. Wenn Sie alle Apps aus Ihrer Kampagne entfernen möchten, müssen Sie die Liste der Apps für diese Kampagne abrufen und die Apps einzeln entfernen. Dasselbe Verfahren gilt für andere unterstützte Anzeigenerweiterungen.