| |
|||||
Lektion 9c: Das AdWords-API |
|||||||
Ziel: Informieren Sie sich über das API und ermitteln Sie, ob es sich für Sie eignet. Einige grundlegende Funktionen und Vorteile der Verwendung werden erläutert. An diesem Modul sollten jedoch nur Entwickler oder AdWords-Kunden mit einer soliden Kenntnis über AdWords teilnehmen.
API steht für "Application Programming Interface" (Anwendungsprogrammierungsschnittstelle). Google bietet den AdWords-API-Service Entwicklern zur Erstellung von Programmen an, die zur direkten Interaktion mit dem AdWords-Server dienen. Die entwickelten Anwendungen ermöglichen AdWords-Kunden und Drittanbietern eine effektivere Verwaltung ihrer umfangreichen AdWords-Konten und -Kampagnen. Seit dem 1. November 2006 wird Entwicklern eine Gebühr in Höhe von 0,25 Euro bzw. des entsprechenden Betrags in der lokalen Währung pro 1000 verbrauchte Quoteneinheiten berechnet. Einige Kunden haben möglicherweise Anspruch auf kostenlose Quoteneinheiten. Für den programmgesteuerten Zugriff auf AdWords-Konten erstellen Entwickler Webservice-Clients, die eine Verbindung zu mindestens einem der standardisierten AdWords-API-Webservices herstellen. Entwickler benötigen sowohl ein genehmigtes Entwickler-Token als auch ein Token zur Anwendung, um auf das API zugreifen zu können.
Für das AdWords-API werden SOAP und WSDL verwendet. Diese bieten Unterstützung für immer mehr Sprachen, einschließlich Java, .NET, Perl, PHP und XML. Codebeispiele zu jeder dieser Sprachen stehen auf der AdWords-API-Startseite zur Verfügung.
Das AdWords-API ist für Entwickler bestimmt, die große, technisch versierte AdWords-Kunden und Drittanbieter vertreten, die wiederum die Berichterstellung und Kampagnenverwaltung automatisieren möchten. Dazu gehören Suchmaschinenvermarkter, Agenturen sowie andere Online-Marketing-Unternehmen, die mehrere Kundenkonten und/oder umfangreiche Kampagnen verwalten. Das AdWords-API erfordert technisches Knowhow und Programmierkenntnisse. Daher erzielen Kunden, die über Programmierkenntnisse verfügen oder Entwickler beschäftigen, die besten Ergebnisse. Nur AdWords-Kunden bzw. Entwickler, die einen AdWords-Kunden mit einem "Mein Kundencenter"-Konto vertreten, können auf das AdWords-API zugreifen.
Das AdWords-API ist äußerst flexibel und bietet viele Funktionen. Es ermöglicht Ihnen, neue und kreative Möglichkeiten für die Verwendung von AdWords zu finden. Die Möglichkeiten des AdWords-API hängen von Ihren Programmierkenntnissen und Werbeanforderungen ab. Im Folgenden werden einige Möglichkeiten angeführt: Des Weiteren ist das API eine hervorragende Alternative für das letztlich unzulässige Screenscraping. | |||||||
Ziel: Informieren Sie sich über die Anmeldung für das AdWords-API und holen Sie sich ein Entwickler-Token sowie ein Token zur Anwendung, um auf das AdWords-API zugreifen zu können.
Sie benötigen zur Anmeldung für das AdWords-API ein "Mein Kundencenter"-Konto. Falls Sie über kein derartiges Konto verfügen, wird es im Rahmen der Anmeldung eingerichtet. Sie registrieren sich für das API und geben dabei Informationen zu Ihrem Unternehmen, Ihren Anwendungen und Kunden an. Sie werden des Weiteren gebeten, die allgemeinen Geschäftsbedingungen für das AdWords-API zu akzeptieren und Zahlungsinformationen bereitzustellen. Nach der Registrierung wird Ihr neues AdWords-API-Center in Ihrem "Mein Kundencenter"-Konto aufgerufen. Hier können Sie Statusmeldungen zur Token-Genehmigung, Informationen zu Ihrem Entwickler-Token und Token zur Anwendung sowie Statistiken zur API-Nutzung anzeigen. Nach der Überprüfung Ihrer Registrierungsinformationen informieren wir Sie über Ihren Genehmigungsstatus für ein Entwickler-Token und Token zur Anwendung. Beide Tokens sind für den Zugriff auf das AdWords-API erforderlich.
Sie benötigen für den Zugriff auf das AdWords-API zwei Tokens: ein Entwickler-Token sowie ein Token zur Anwendung. Das Entwickler-Token dient zur Identifizierung eines genehmigten Entwicklers für das API. Das Token zur Anwendung dient zur Identifizierung einer genehmigten Anwendung für die API-Nutzung. Jedes Token entspricht einer eindeutigen Zeichenfolge aus Buchstaben, Ziffern und Symbolen. Diese muss in die Kopfzeile all Ihrer API-Anforderungen für die Kommunikation mit dem AdWords-Server eingefügt werden. Sämtliche Tokens müssen von den AdWords-API-Teams genehmigt werden. Nach der Genehmigung Ihrer Tokens werden diese auf der Seite "AdWords-API-Center" in Ihrem "Mein Kundencenter"-Konto angeführt. Lassen Sie bei Ihren Tokens mindestens dieselbe Vorsicht walten wie bei Ihrem Konto-Login und dem zugehörigen Passwort. Falls Sie weitere Tokens zur Anwendung benötigen, da Sie mit mehreren Anwendungen auf das API zugreifen möchten, können Sie zusätzliche Tokens beantragen. Klicken Sie dazu im Bereich für Tokens zur Anwendung in Ihrem AdWords-API-Center auf den Link "Hinzufügen". Jedem Entwickler wird jedoch nur ein Entwickler-Token zugewiesen. Mit Ihrem genehmigten Entwickler-Token und Token zur Anwendung können Sie nun Programme erstellen. Informationen zur Erstellung von Programmen gemäß den API-Standards erhalten Sie in der Dokumentation mit Beispielcode sowie im Entwicklerhandbuch. Diese stehen auf der Google AdWords-API-Startseite zur Verfügung. Mit dem AdWords-API werden Zugriffe über unser gebührenpflichtiges System für API-Einheiten verwaltet. Entwicklern wird eine Gebühr in Höhe von 0,25 Euro bzw. des entsprechenden Betrags in der lokalen Währung pro 1000 verbrauchte API-Einheiten berechnet. Einige AdWords-Kunden, die lediglich für die Verwaltung ihrer eigenen Konten auf das API zugreifen, haben möglicherweise Anspruch auf kostenlose API-Einheiten. API-Vorgänge erfordern unterschiedliche Mengen von API-Einheiten. Dies hängt von der Komplexität jedes Vorgangs ab. Beachten Sie, dass ein Vorgang als einzelne Aktion in einem AdWords-Konto betrachtet wird. Beispiel: Sie erkundigen sich über den Status einer Anzeigengruppe. Dies wird als ein Vorgang betrachtet. Der Vorgang erfordert in diesem Fall eine API-Einheit. Die Anforderung des Status von 1000 Anzeigengruppen würde folglich 1000 API-Einheiten erfordern. Die für den Entwickler anfallenden Kosten liegen demnach bei 0,25 Euro bzw. dem entsprechenden Betrag in der lokalen Währung. Weitere Informationen erhalten Sie in der Gebührenliste für AdWords-API-Vorgänge. Entwicklern wird eine Gebühr in Höhe von 0,25 Euro bzw. dem entsprechenden Betrag in der lokalen Währung pro 1000 verbrauchte API-Einheiten für ihre AdWords-API-Nutzung berechnet. Das AdWords-API-System weist verschiedenen Vorgängen verschiedene API-Einheiten zu. Bei einigen Vorgängen wird nur eine API-Einheit verbraucht. Im Gegensatz dazu werden bei anderen Vorgängen mehrere Einheiten verbraucht. Weitere Informationen zu den jeweiligen Kosten pro Vorgang stehen auf der Gebührenliste zur Verfügung. Lesen Sie zudem die häufig gestellten Fragen zur Kreditkartenabrechnung für das API, um Informationen zu den API-Abrechnungszeiträumen zu erhalten. Kunden, die API-Anwendungen ausschließlich zur Bewerbung ihrer eigenen Unternehmen entwickeln, haben möglicherweise Anspruch auf eine beschränkte Anzahl von kostenlosen API-Einheiten. API-Entwickler werden benachrichtigt, sofern sie nach Prüfung ihrer Registrierungsdaten Anspruch auf kostenlose API-Einheiten haben. | |||||||
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:
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. | |||||||
Ziel: Zusätzlich zu den in Kapitel 3 behandelten Datenservices bietet das AdWords-API den AccountService, InfoService, TrafficEstimatorService und ReportService. Diese ermöglichen einen programmgesteuerten Zugriff auf allgemeine AdWords-Informationen und -Funktionen. Informieren Sie sich über diese Services sowie über zusätzliche Hilferessourcen.
Der AccountService umfasst Vorgänge zum Einrichten und Ändern von AdWords-Konten. Sie haben mit dem AccountService folgende Möglichkeiten: Beim Abruf von Zahlungs- und Währungsinformationen werden keine Kreditkartennummern angezeigt. Sie benötigen eine ausdrückliche Genehmigung von Google, um Änderungen an Kreditkarteninformationen vorzunehmen und neue AdWords-Konten einzurichten.
Mithilfe des InfoService erhalten Sie grundlegende Informationen zu Ihrer API-Nutzung, einschließlich Kosten für Methoden und Vorgänge sowie der Anzahl von Einheiten.
Der TrafficEstimatorService umfasst Vorgänge, mit denen Sie Zugriffszahlen für verschiedene Komponenten Ihres AdWords-Kontos schätzen können. Mithilfe dieses Service lassen sich Zugriffszahlen für Keywords, Kampagnen und Anzeigengruppen schätzen.
Mithilfe des ReportService können Sie einen Bericht zur Leistung Ihrer AdWords-Kampagnen anfordern. Derzeit werden benutzerdefinierte Berichte sowie Berichte für Keywords, Anzeigen und URLs unterstützt. Der ReportService dient zum Erstellen und Speichern von Berichten im XML-Format und gibt die URL der Berichte zurück. Der jeweilige Bericht steht im Berichtcenter der AdWords-Benutzeroberfläche zur Verfügung. Zudem ist der Bericht programmgesteuert durch Herunterladen der angegebenen URL verfügbar.
Auf der AdWords-API-Startseite stehen hilfreiche Dokumentationen für die ersten Schritte zur Verfügung. Diese Seite wird regelmäßig aktualisiert. So sind Sie stets über neue Webservices, Funktionen und mehr informiert. Folgende Ressourcen sind auf dieser Seite verfügbar: | |||||||