Anzeigentypen

In Google Ads werden zahlreiche Anzeigentypen unterstützt, etwa Text-, Bild- und mobile Anzeigen. In diesem Leitfaden wird beschrieben, wie Sie mithilfe von Google Ads-Skripts Anzeigen erstellen und abrufen sowie Berichte dazu generieren. Eine Übersicht der Anzeigentypen, die in Google Ads unterstützt werden, finden Sie im API-Leitfaden.

Erstellung

Skripts können Anzeigen mithilfe der newAd() -Methode aktiviert AdGroup Instanzen. Dadurch wird ein AdBuilderSpace die Builder für unterstützten Anzeigentypen.

Mit dem folgenden Snippet wird eine erweiterte Textanzeige erstellt:

let adOperation = adGroup.newAd().expandedTextAdBuilder()
    .withHeadlinePart1("First headline part")
    .withHeadlinePart2("Second headline part")
    .withDescription("Ad description")
    .withFinalUrl("http://www.example.com")
    .withPath1("path1") // optional
    .withPath2("path2") // optional
    .build();

Prüfung

Einige Informationen, die mit allen Anzeigentypen verknüpft sind, sind sofort über eine Ad verfügbar, z. B. die Anzeigen-ID und der Genehmigungsstatus. Außerdem können Anzeigen pausiert, aktiviert oder entfernt werden.

Wenn Sie auf spezifische Felder für den Anzeigentyp zugreifen möchten, z. B. auf die Beschreibung einer erweiterten Textanzeige, verwenden Sie die Methode asType(), um ein AdViewSpace zu erstellen. Dadurch erhalten Sie Zugriff auf eine erweiterte Version der Ad, die typspezifische Methoden bereitstellt.

Im folgenden Snippet wird die Beschreibung jeder erweiterten Textanzeige abgerufen:

const iterator = AdsApp.ads().withCondition("Type = EXPANDED_TEXT_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let expandedTextAd = ad.asType().expandedTextAd();
  let description = expandedTextAd.getDescription();
}

Mit der Bedingung Type = EXPANDED_TEXT_AD wird sichergestellt, dass jede Anzeige aus dem Iterator ist eine erweiterte Textanzeige. Wenn Sie versuchen, eine Anzeige mit dem falschen Typ aufzurufen, wird ein Fehler ausgegeben, der die Ausführung Ihres Scripts unterbricht. Daher sollten Sie sich typspezifische Felder nur ansehen, wenn der Typ einer Anzeige bekannt ist.

Mit dem folgenden Snippet wird ermittelt, ob eine Anzeige den richtigen Typ hat. mithilfe der Ad.isType() :

if (ad.isType().expandedTextAd()) {
  let expandedTextAd = ad.asType().expandedTextAd();
  let headlinePart1 = expandedTextAd.getHeadlinePart1();
  let headlinePart2 = expandedTextAd.getHeadlinePart2();
}

Berichte

Die ad_group_ad-Ansicht kann auch werden zusätzlich zu regulären Statistiken zur Abfrage typspezifischer Anzeigenfelder wie ad_group_ad.expanded_text_ad.headline_part1 Mit dem folgenden Snippet werden die Statistiken für alle erweiterten Textanzeigen abgerufen, bei denen der erste Anzeigentitel den Text "Discount Sales" enthält:

const results = AdsApp.search(
  "SELECT ad_group_ad.ad_group.id, " +
         "ad_group_ad.id, " +
         "ad_group_ad.expanded_text_ad.headline_part1, " +
         "ad_group_ad.expanded_text_ad.headline_part2, " +
         "metrics.clicks, " +
         "metrics.impressions, " +
         "metrics.cost" +
  "FROM ad_group_ad " +
  "WHERE ad_group_ad.expanded_text_ad.headline_part1 = 'Discount Sales' " +
    "AND segments.date DURING LAST_7_DAYS");

while (results.hasNext()) {
  let row = results.next();
  let headlinePart1 = row.adGroupAd.expandedTextAd.headlinePart1;
  let headlinePart2 = row.adGroupAd.expandedTextAd.headlinePart2;
  ...
}

Weitere Informationen zu Berichten in Scripts finden Sie im Leitfaden zu Berichten.