Shopping-Kampagnen

Mit Google Ads-Scripts können Sie Ihre Shopping-Kampagnen verwalten. Mit Scripts können Sie vorhandene Shopping-Kampagnen bearbeiten, Produktgruppenhierarchien erstellen und verwalten sowie Shopping-Berichte erstellen. Sie können jedoch keine Shopping-Kampagnen erstellen, Shopping-Attribute auf Kampagnenebene festlegen (z. B. Kampagnenpriorität, Inventarfilter usw.) oder Merchant Center-Konten verknüpfen.

Shopping-Kampagnen und ‑Anzeigengruppen abrufen

Shopping-Kampagnen sind über die shoppingCampaigns-Sammlung eines AdsApp-Objekts verfügbar. Sie können sie wie gewohnt über Skripts abrufen:

const campaignName = "My first shopping campaign";

const campaignIterator = AdsApp.shoppingCampaigns()
    .withCondition(`campaign.name = "${campaignName}"`)
    .get();

for (const campaign of campaignIterator) {
  ...
}

Nachdem Sie eine Kampagne abgerufen haben, können Sie ihre Anzeigengruppen auf ähnliche Weise abrufen. Das ist nur dann sinnvoll, wenn Sie sowohl auf die Kampagne als auch auf die zugehörigen Anzeigengruppen reagieren müssen.

const adGroupIterator = campaign.adGroups()
    .withCondition(`ad_group.name = "${adGroupName}"`)
    .get();

for (const adGroup of adGroupIterator) {
    ...
}

Wenn Sie nur auf bestimmte Anzeigengruppen reagieren möchten, können Sie mit der Methode AdsApp.shoppingAdGroups() Anzeigengruppen abrufen, ohne zuerst die Kampagne abzurufen:

const adGroupIterator = AdsApp.shoppingAdGroups()
    .withCondition(`campaign.name = "${campaignName}"`)
    .withCondition(`ad_group.name = "${adGroupName}"`)
    .get();

for (const adGroup of adGroupIterator) {
    ...
}

Produktanzeigen

Mit Google Ads-Scripts können Sie Ihre Produktanzeigen mit der Methode ads() der ShoppingAdGroup abrufen. Sie können neue Produktanzeigen mit der Methode newAdBuilder() von ShoppingAdGroup erstellen.

Produktgruppenhierarchie durchlaufen

Sie können mit der Methode rootProductGroup des ShoppingAdGroup auf den Stamm der Produktgruppenhierarchie zugreifen. Mit der Methode children können Sie dann die untergeordneten Produktgruppen durchlaufen und die Hierarchie der Produktgruppen durchsuchen. Jeder Knoten ist ein ProductGroup-Objekt. Mit der Methode getDimension können Sie den tatsächlichen Typ der Produktgruppe ermitteln. Sie können sie auch in einen spezifischeren Typ umwandeln (z. B. ProductBrand), indem Sie die entsprechende Umwandlungsmethode verwenden (z. B. asBrand). Das folgende Code-Snippet zeigt, wie die Hierarchie der Produktgruppe rekursiv durchlaufen wird.

walkTree(shoppingAdGroup.rootProductGroup(), 1);

function walkTree(root, level) {
  // Logger.log(root.getDimension());
  let description = "";
  switch (root.getDimension()) {
    case "ROOT":
      description = "Root";
      break;

    case "CATEGORY":
      description = root.asCategory().getName();
      break;

    case "BRAND":
      description = root.asBrand().getName();
      break;

    // Handle more types here.
    ...
  }

  if (root.isOtherCase()) {
    description = "Other";
  }

  const padding = new Array(level + 1).join('-');
  console.log("%s, %s, %s, %s, %s, %s",
             padding,
             description,
             root.getDimension(),
             root.getMaxCpc(),
             root.isOtherCase(),
             root.getId().toFixed());
  const children = root.children().get();
  for (const child of children) {
    walkTree(child, level + 1);
  }
}

Bestimmte Produktgruppe auswählen

Mit der Methode productGroups einer AdsApp-, ShoppingCampaign- oder ShoppingAdGroup-Instanz können Sie bestimmte Produktgruppen in einer Produktgruppenhierarchie auswählen. Dieser Ansatz ist einfacher, als die gesamte Produktgruppenhierarchie zu durchlaufen, wenn Sie bestimmte Produktgruppen für die Gebotsverwaltung auswählen. Im folgenden Codebeispiel wird gezeigt, wie alle Produktgruppen mit mehr als fünf Klicks und einer Klickrate von über 0.01 im letzten Monat ausgewählt und ihr Gebot um 0.01 erhöht wird.

function main() {
  const productGroups = AdsApp.productGroups()
      .withCondition("metrics.clicks > 5")
      .withCondition("metrics.ctr > 0.01")
      .forDateRange("LAST_MONTH")
      .get();
  for (const productGroup of productGroups) {
    productGroup.setMaxCpc(productGroup.getMaxCpc() + 0.01);
  }
}

Produktgruppenhierarchie aktualisieren

Mit der Methode newChild können Sie einer vorhandenen Produktgruppe eine untergeordnete Produktgruppe hinzufügen. Dadurch erhalten Sie ein ProductGroupBuilderSpace-Objekt, mit dem Sie eine geeignete Produktgruppe erstellen können. Mit dem folgenden Code-Snippet wird unter dem Stamm eine Unterteilung für die Marke „cardcow“ hinzugefügt und dann weiter in neue und generalüberholte Produkte unterteilt.

const root = shoppingAdGroup.rootProductGroup();

// Add a brand product group for a "cardcow" under root.
const brandProductGroup = root.newChild()
    .brandBuilder()
    .withName("cardcow")
    .withBid(1.2)
    .build()
    .getResult();

// Add new conditions for New and Refurbished cardcow brand items.
const newItems = brandProductGroup.newChild()
    .conditionBuilder()
    .withCondition("New")
    .withBid(1.5)
    .build()
    .getResult();

// Refurbished items will use the bid from "cardcow" product group.
const refurbishedItems = brandProductGroup.newChild()
    .conditionBuilder()
    .withCondition("Refurbished")
    .build()
    .getResult();

Ebenso können Sie eine Unterteilung mit der Methode remove von ProductGroup entfernen. Dadurch wird auch die gesamte Produktgruppenhierarchie unter der zu entfernenden Produktgruppe gelöscht.

Skripts sorgen dafür, dass die Hierarchie der Produktgruppen nach dem Erstellen jeder Produktgruppe in einem konsistenten Zustand ist. Sie müssen die Produktgruppe, die „Alles andere“ entspricht, also nicht erstellen oder löschen, wenn Sie die Struktur der Hierarchie der Produktgruppen aktualisieren.

Produktgruppe "Alles andere"

Shopping-Produktgruppenhierarchien enthalten auf jeder Ebene eine Produktgruppe „Alles andere“ („Sonstiges“), um Produkte zu verarbeiten, die nicht dem benutzerdefinierten Zustand entsprechen, den Sie in der Produktgruppenhierarchie erstellt haben. Mit der Methode isOtherCase können Sie zwischen einer normalen Produktgruppe, die Sie hinzugefügt haben, und der Produktgruppe „Andere“ unterscheiden.

Im folgenden Code-Snippet wird die Produktgruppe „Other“ (Sonstiges) in der Hierarchie der Stammproduktgruppen abgerufen und das zugehörige Gebot ausgegeben.

const root = shoppingAdGroup.rootProductGroup();

const childProductGroups = root.children().get();
let everythingElseProductGroupFound = false;

for (const childProductGroup of childProductGroups) {
  if (childProductGroup.isOtherCase()) {
    console.log("'Everything else' product group found. Type of the " +
               "product group is %s and bid is %s.",
               childProductGroup.getDimension(),
               childProductGroup.getMaxCpc());
    everythingElseProductGroupFound = true;
    break;
  }
}
if (!everythingElseProductGroupFound) {
  console.log("No 'Everything else' product group found under root " +
             "product group.");
}

Wenn Sie eine Produktgruppe auf Blattebene unterteilen, wird durch Scripts automatisch eine Produktgruppe „Other“ (Sonstiges) erstellt, damit die Hierarchie der Produktgruppen gültig bleibt. Die Produktgruppe „Sonstiges“ übernimmt das Gebot der übergeordneten Produktgruppe.

Neue Shopping-Anzeigengruppe erstellen

Mit Google Ads-Scripts können Sie eine neue Shopping-Anzeigengruppe mit der Methode newAdGroupBuilderShoppingCampaign erstellen. Nachdem Sie die ShoppingAdGroup erstellt haben, können Sie mit der Methode createRootProductGroup eine neue Produktgruppenhierarchie erstellen.

Berichte

Google Ads-Scripts unterstützen product_group_view- und shopping_performance_view-Berichte, mit denen Sie die Leistung Ihrer Shopping-Kampagnen im Blick behalten können. Weitere Informationen zum Melden von Inhalten findest du in unserem Leitfaden zu Berichten.