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 mit Scripts keine Shopping-Kampagnen erstellen, keine Shopping-Eigenschaften auf Kampagnenebene festlegen (z. B. Kampagnenpriorität, Inventarfilter usw.) und keine Merchant Center-Konten verknüpfen.
Shopping-Kampagnen und -Anzeigengruppen abrufen
Shopping-Kampagnen sind über die Sammlung shoppingCampaigns 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 die Kampagne als auch die zugehörigen Anzeigengruppen bearbeiten müssen.
const adGroupIterator = campaign.adGroups()
.withCondition(`ad_group.name = "${adGroupName}"`)
.get();
for (const adGroup of adGroupIterator) {
...
}
Wenn Sie nur bestimmte Anzeigengruppen bearbeiten möchten, können Sie die Methode AdsApp.shoppingAdGroups() verwenden, um Anzeigengruppen abzurufen, 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() von ShoppingAdGroup abrufen. Sie können neue Produktanzeigen mit der Methode newAdBuilder() von ShoppingAdGroup erstellen.
Produktgruppenhierarchie durchlaufen
Mit der Methode rootProductGroup von ShoppingAdGroup können Sie auf die Stammgruppe der Produktgruppenhierarchie zugreifen. Anschließend können Sie die Methode children verwenden, um die untergeordneten Produktgruppen zu durchlaufen und die Produktgruppenhierarchie zu durchqueren. 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 mit der entsprechenden Casting-Methode (z. B. asBrand) in einen spezifischeren Typ (z. B. ProductBrand) umwandeln. Das folgende Code-Snippet zeigt, wie Sie die Produktgruppenhierarchie rekursiv durchlaufen.
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
Sie können bestimmte Produktgruppen in einer Produktgruppenhierarchie mit der Methode productGroups einer AdsApp-, ShoppingCampaign- oder ShoppingAdGroup-Instanz auswählen. Dieser Ansatz ist einfacher, als die gesamte Produktgruppenhierarchie zu durchlaufen, wenn bestimmte Produktgruppen für die Gebotsverwaltung ausgewählt werden. Im folgenden Code-Snippet wird gezeigt, wie Sie alle Produktgruppen mit mehr als fünf Klicks und einer Klickrate von mehr als 0.01 im letzten Monat auswählen und ihr Gebot um 0.01 erhöhen.
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
Sie können einer vorhandenen Produktgruppe mit der Methode newChild eine untergeordnete Produktgruppe hinzufügen. Dadurch erhalten Sie ein ProductGroupBuilderSpace-Objekt, mit dem Sie eine entsprechende Produktgruppe erstellen können. Mit dem folgenden Code-Snippet wird eine Untergruppe für die Marke „cardcow“ unter dem Stamm hinzugefügt und dann weiter in neue und aufgearbeitete 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 entfernten Produktgruppe gelöscht.
Skripts sorgen dafür, dass die Produktgruppenhierarchie nach dem Erstellen jeder Produktgruppe in einem konsistenten Zustand ist. Sie müssen also die Produktgruppe „Alles andere“ nicht erstellen oder löschen, wenn Sie die Struktur der Produktgruppenhierarchie aktualisieren.
Produktgruppe "Alles andere"
Shopping-Produktgruppenhierarchien enthalten auf jeder Ebene die Produktgruppe „Alles andere“ („Sonstiges“), um Produkte zu verarbeiten, die nicht der benutzerdefinierten Bedingung entsprechen, die 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 „Sonstige“ unterscheiden.
Mit dem folgenden Code-Snippet wird die Produktgruppe „Sonstige“ unter der Stammproduktgruppenhierarchie 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 Blattproduktgruppe unterteilen, wird automatisch eine Produktgruppe „Sonstige“ erstellt, damit die Hierarchie der Produktgruppen gültig bleibt. Die Produktgruppe „Sonstige“ übernimmt das Gebot der übergeordneten Produktgruppe.
Neue Shopping-Anzeigengruppe erstellen
Mit Google Ads-Scripts können Sie eine neue Shopping-Anzeigengruppe mit der Methode newAdGroupBuilder von ShoppingCampaign erstellen. Nachdem Sie die ShoppingAdGroup erstellt haben, können Sie mit der Methode createRootProductGroup eine neue Produktgruppenhierarchie erstellen.
Berichte
Google Ads-Scripts unterstützen die Berichte product_group_view und shopping_performance_view, mit denen Sie die Leistung Ihrer Shopping-Kampagnen im Blick behalten können. Weitere Informationen zur Berichterstellung finden Sie im Leitfaden zu Berichten.