Mit Google Ads-Scripts können Sie in Ihren Konten mit Ausrichtungseinstellungen auf Kampagnenebene arbeiten. Die folgenden Einstellungen werden unterstützt: Werbezeitplaner, Zielregionen und ausgeschlossene Standorte, Ausrichtungsziele in der Nähe und Plattformen. In diesem Leitfaden erfahren Sie, wie Sie mit Kampagnenzielen arbeiten.
Werbezeitplaner
Mit Werbezeitplanern können Sie festlegen, wann Ihre Anzeigen ausgeliefert werden sollen.
Abrufen
Sie können die Anzeigenzeitpläne einer Kampagne mit der Methode adSchedules
der Zielgruppen der Kampagne abrufen.
Im folgenden Code-Snippet wird gezeigt, wie Sie die Liste aller AdSchedule
-Kriterien für eine Kampagne abrufen:
const campaign = AdsApp.campaigns()
.withCondition("campaign.name = 'My campaign'")
.get()
.next();
const adSchedules = campaign.targeting().adSchedules().get();
for (const adSchedule of adSchedules) {
// Process your ad schedule.
...
}
Standardmäßig werden Anzeigen einer Kampagne jederzeit ausgeliefert. Wenn Sie also keinen benutzerdefinierten Werbezeitplaner für Ihre Kampagne festgelegt haben, erhalten Sie keine Werbezeitpläne.
Aktualisieren
Nachdem Sie eine Anzeigenplanung abgerufen haben, können Sie ihre Eigenschaften direkt ändern. So können Sie beispielsweise den Gebotszuschlag einer Anzeigenplanung so aktualisieren:
adSchedule.setBidModifier(1.1);
Erstellen
Sie können die Methode Campaign
mit der Methode addAdSchedule
kombinieren, um einen neuen Anzeigenzeitplan zu erstellen.
Mit dem folgenden Code-Snippet wird ein benutzerdefinierter Anzeigenzeitplan für die Kampagne erstellt, der jeden Samstag von 7:00 bis 11:00 Uhr (Zeitzone des Kontos) mit einem Gebotszuschlag von 1, 1 gilt.
campaign.addAdSchedule({
dayOfWeek: "SATURDAY",
startHour: 7,
startMinute: 0,
endHour: 11,
endMinute: 0,
bidModifier: 1.1
});
Weitere Informationen zu zulässigen Werten für die einzelnen Parameter sowie zu zusätzlichen Einschränkungen beim Erstellen von Anzeigenplänen finden Sie in unserer Dokumentation.
Entfernen
Sie können einen Werbezeitplaner mit der Methode remove
entfernen. Wenn Sie die benutzerdefinierte Anzeigenauslieferung einer Kampagne zurücksetzen möchten, können Sie alle benutzerdefinierten Anzeigenauslieferungspläne so löschen:
const adSchedules = campaign.adSchedules().get();
for (const adSchedule of adSchedules) {
adSchedule.remove();
}
Standorte
Mit Google Ads-Scripts können Sie Ihre Kampagne auch auf Standorte ausrichten oder ausschließen.
Abrufen
Sie können die Liste der gezielten Standorte mit der Methode targetedLocations
der Ziele der Kampagne abrufen.
Ausgeschlossene Standorte können mit der Methode excludedLocations
abgerufen werden. Im folgenden Code-Snippet werden alle Standorte ausgewählt, für die im letzten Monat mehr als 100 Impressionen erzielt wurden.
const locations = AdsApp.targeting()
.targetedLocations()
.withCondition("metrics.impressions > 100")
.forDateRange("LAST_MONTH")
.orderBy("metrics.clicks DESC")
.get();
for (const location of locations) {
// Process the campaign target here.
...
}
Wenn Sie Ihre Kampagne so eingerichtet haben, dass Anzeigen in allen Ländern und Regionen ausgeliefert werden, wird eine leere Liste der Standorte angezeigt.
Aktualisieren
Nachdem Sie einen Standort abgerufen haben, lassen sich seine Eigenschaften direkt ändern. So können Sie beispielsweise die Gebotsanpassung für einen Standort aktualisieren:
location.setBidModifier(1.1);
Erstellen
Sie können geografische Ziele für eine Kampagne mit der Methode addLocation
erstellen. Ebenso können Sie einen Standort mit der Methode excludeLocation
ausschließen. Im folgenden Code-Snippet ist eine Kampagne auf die USA mit einem Gebotszuschlag von 1, 15 ausgerichtet. New York City ist ausgeschlossen.
campaign.addLocation(2840, 1.15); // United States
campaign.excludeLocation(1023191); // New York city
In der Dokumentation zum geografischen Targeting mit der Google Ads API finden Sie eine Liste der IDs, die Sie beim Hinzufügen des Standort-Targetings verwenden können. Wenn Sie die Leistung Ihrer Standortziele erfassen möchten, können Sie in der Ressource location_view
„Bericht“ suchen.
Entfernen
Sie können ein Standortziel mit der Methode remove
entfernen.
Ausrichtungsziele in der Nähe
Mit Google Ads-Scripts können Sie eine Kampagne auf einen Umkreis um einen Standort ausrichten.
Abrufen
Sie können die Liste der Zielregionen mit der Methode targetedProximities
für die Zielgruppen der Kampagne abrufen.
Im folgenden Code-Snippet werden alle Zielregionen ausgewählt, für die im letzten Monat mehr als 100 Impressionen erzielt wurden.
const proximities = AdsApp.targeting()
.targetedProximities()
.withCondition("metrics.impressions > 100")
.forDateRange("LAST_MONTH")
.orderBy("metrics.clicks DESC")
.get();
for (const proximity of proximities) {
...
}
Erstellen
Sie können ein Standortziel für eine Kampagne mit der Methode addProximity
erstellen. Im folgenden Code-Snippet wird eine Kampagne auf einen Umkreis von 20 Kilometern um die Koordinaten (37.423021, -122.083739) ausgerichtet.
campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS");
Mit dieser Methode können Sie dasselbe Umgebungsziel auch mit einem Gebots-Modifier und einer Adresse erstellen:
campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS", {
bidModifier: 1.15,
address: {
streetAddress: "1600 Amphitheatre Parkway",
cityName: "Mountain View",
provinceName: "California",
provinceCode: "CA",
postalCode: "94043",
countryCode: "US"
}
});
Beachten Sie, dass nicht überprüft wird, ob die Adresse tatsächlich zum angegebenen Breiten- und Längengrad gehört. Die Adresse dient nur dazu, die Anzeige in der Campaign Manager-Benutzeroberfläche zu ändern.
Entfernen
Sie können ein Näherungsziel mit der Methode remove
entfernen.
Plattformen
Die Liste der Plattformen, auf die eine Kampagne ausgerichtet ist, können Sie mit der Methode platforms
der Zielgruppen der Kampagne abrufen.
Da Google Ads-Kampagnen auf alle Plattformen (Computer, Mobilgeräte und Tablets) ausgerichtet sind, können Sie kein Platform
-Kriterium hinzufügen oder entfernen. Am häufigsten wird dieses Targeting-Kriterium verwendet, um die Gebotsanpassung für Geräte Ihrer Kampagne festzulegen:
campaign.targeting()
.platforms()
.mobile()
.get()
.next().
setBidModifier(1.2);
Plattform-IDs sind für alle Kampagnen gleich und haben vordefinierte Werte, die im Anhang zu Google Ads API-Plattformen angegeben sind. Diese IDs können beim Parsen von Berichten nützlich sein. Wenn Sie Kriterien direkt auswählen, können Sie die Hilfsmethoden von PlatformSelector
verwenden.