API-Webservices - Google AdWords Learning Center

Ziel: Verschaffen Sie sich einen Überblick über die Webservices für AdWords-API-Daten. Diese Informationen sind zur Entwicklung von Programmen sehr hilfreich. Umfassendere Dokumente stehen jedoch auf der AdWords-API-Startseite von Google zur Verfügung.

Das AdWords-API bietet eine Reihe von Webservices, die einen programmgesteuerten Zugriff auf AdWords-Konten ermöglichen. Für den programmgesteuerten Zugriff auf AdWords-Konten werden Webservice-Clients erstellt, die eine Verbindung zu mindestens einem der AdWords-API-Webservices herstellen.

AdWords bietet die folgenden API-Webservices:

CampaignService
AdGroupService
KeywordService
CreativeService
CriterionService
KeywordToolService
AccountService
InfoService
TrafficEstimatorService
ReportService

Der CampaignService, AdGroupService, KeywordToolService, CriterionService und CreativeService werden zusammen als Datenservices bezeichnet. Sie umfassen Vorgänge, die die Verwaltung Ihrer AdWords-Kampagnen, Anzeigengruppen, Keywords, Ihres Anzeigentexts und der Ausrichtung ermöglichen. Dies erfolgt durch Anforderungen mithilfe von Datenobjekten bzw. einer Liste mit Datenobjekten. Daraufhin wird vom Service in der Regel ein Datenobjekt bzw. eine Liste mit Datenobjekten zurückgegeben. Bei der Erstellung eines Datenobjekts legen Sie Felder für das Objekt fest.

Batchvorgänge (Listen) sind effektiver als einzelne Vorgänge. Aus diesem Grund empfehlen wir, nach Möglichkeit stets Batchvorgänge zu verwenden. Der CreativeService verfügt beispielsweise über den Vorgang addCreative und addCreativeList. Der Vorgang addCreative dient zum Hinzufügen einer einzelnen Anzeige und addCreativeList zum Hinzufügen mehrerer Anzeigen.

Kampagnen, Anzeigengruppen, Keywords und Anzeigen verfügen über IDs, die von den AdWords-API-Webservices festgelegt werden. Keyword- und Anzeigen-IDs sind nur in der jeweiligen Anzeigengruppe eindeutig. Im Gegensatz dazu sind Kampagnen- und Anzeigengruppen-IDs global eindeutig.

Eine Kampagne wird mithilfe einer Kampagnendatenstruktur dargestellt. Diese Datenstruktur verfügt über Felder, die zur Beschreibung der Kampagne dienen - beispielsweise startDate, endDate, name, status, dailyBudget und mehr. Senden Sie zur Verwendung des CampaignService Anfragen, mit denen einzelne Kampagnendatenobjekte bzw. mehrere Datenobjekte eingereicht oder zurückgegeben werden.

Mithilfe des CampaignService können Sie Vorgänge auf Kampagnenebene erstellen, aktualisieren, auflisten, ausführen und auf Vorgänge zugreifen. Zu den Vorgängen gehören z. B. das Pausieren einer Kampagne oder das Hinzufügen neuer Anzeigengruppen zu einer Kampagne. Verwenden Sie zum Aktualisieren oder Ausführen von Vorgängen für eine Anzeigengruppe den AdGroupService.

Eine Anzeigengruppe wird durch eine Datenstruktur für Anzeigengruppen dargestellt. Diese Datenstruktur verfügt über Felder, die zur Beschreibung der Anzeigengruppe dienen - beispielsweise name, status und maxCPC. Außerdem weist die Datenstruktur eine ID auf, mit der die Anzeigengruppe eindeutig identifiziert wird.

Eine Anzeigengruppe besteht aus einer Keyword-Gruppe und mindestens einer Anzeige (einem Anzeigentext), die durch die Keywords in dieser Keyword-Gruppe geschaltet wird. Der AdGroupService umfasst alle Vorgänge, die die gesamte Anzeigengruppe betreffen. Dazu gehören das Erstellen und Aktualisieren von Anzeigengruppen, das Hinzufügen von Keywords und Anzeigen sowie das Abrufen von Informationen der Anzeigengruppen.

Der Kriterienservice liefert Ihnen Informationen über Ausrichtungskriterien. Sie können beispielsweise Keywords für eine keyword-bezogene Kampagne oder die Websites für eine placement-bezogene Kampagne anzeigen. Zudem lassen sich Ausrichtungskriterien für Keywords und Placements erstellen und ändern.

Jede Anzeigengruppe verfügt über mindestens ein Keyword, das zur Anzeigenschaltung dient. Mithilfe des Keyword-Tool-Services können Sie Keywords auf Basis eines anderen Keywords oder auf Basis von Wörtern einer bestimmten Webseite bzw. Website erstellen.