Kundenkonto vorbereiten

In diesem Schritt geben Sie ein Google Ads-Konto an, für das API-Aufrufe ausgeführt werden sollen. Das Konto kann entweder ein Produktionskonto (Livekonto) oder ein Testkonto sein. Jede Methode hat Vor- und Nachteile.

Produktionskonten
Testkonten
Vorteile
  • Es ist einfacher, Code zu schreiben und zu testen, der für bestimmte Kontoinhalte funktioniert.
  • Es ist einfacher, Code zu schreiben und zu testen, der Daten für Liveberichte verarbeitet.
  • In Testkonten werden keine Anzeigen ausgeliefert. Programmierfehler wirken sich daher nicht auf Ihre aktiven Kampagnen aus.
  • Funktioniert mit Entwicklertokens mit der Zugriffsebene „Testzugriff“.
Nachteile
  • Ein Programmierfehler in der Entwicklungsphase kann sich auf die Anzeigenbereitstellung in aktiven Kampagnen auswirken und zu Problemen wie einer schlechten Kampagnenleistung, einer falschen Anzeigenbereitstellung oder finanziellen Verlusten führen.
  • Das Entwickler-Token muss mindestens die Zugriffsebene „Grundlegender Zugriff“ haben, um API-Aufrufe ausführen zu können.
  • Sie müssen Kampagnen in Testkonten neu erstellen, um Code zu testen, der für bestimmte Kontoinhalte funktioniert.
  • Da in Testkonten keine Anzeigen ausgeliefert werden, werden Funktionen im Zusammenhang mit der Livebereitstellung, z. B. Statistikberichte, Fehler bei Richtlinienverstößen oder die Verarbeitung von Offline-Conversion-Importen, nicht unterstützt. Das erschwert das Testen dieser Funktionen.

Wir empfehlen, während der Entwicklung Ihrer Anwendung nach Möglichkeit ein Testkonto zu verwenden. Eine Anleitung dazu finden Sie unter Testkonten und ‑kampagnen erstellen.

Alternativ können Sie ein Produktionskonto mit einem niedrigen Kontobudget einrichten, z. B. 1 € pro Tag, das ausschließlich zum Testen von Funktionen verwendet wird, die von einem Testkonto nicht unterstützt werden.

Auswahl des Funktions-Sets

Bei der Auswahl eines Kontos für API-Aufrufe sollten Sie auch die Liste der Funktionen berücksichtigen, die Sie mit der API verwenden möchten. Auch wenn Sie ein Produktionskonto verwenden, gibt es einige kontospezifische Funktionen, z. B.:

  • Für Abrechnungsfunktionen benötigen Sie ein Konto mit monatlicher Rechnungsstellung.
  • Einige neue Funktionen im Konto sind möglicherweise durch Zulassungslisten eingeschränkt.

Bevor Sie das Konto für API-Aufrufe fertigstellen, sollten Sie in der Dokumentation der jeweiligen Funktion nachsehen, ob es zusätzliche Einschränkungen gibt.

Anmeldekundennummer und Kundennummer ermitteln

Wenn Sie einen API-Aufruf für einen Google Ads-Kunden ausführen möchten, müssen Sie Ihrem Dienstkonto entweder direkt oder über ein verknüpftes Verwaltungskonto Zugriff und die entsprechenden Berechtigungen für das Kundenkonto gewähren. Dazu benötigen Sie Administratorzugriff auf das Kundenkonto.

Melden Sie sich als Administrator in Ihrem Google Ads-Konto an. In einigen Fällen haben Sie möglicherweise die Wahl zwischen mehreren Kundenkonten. Über das ausgewählte Konto wird die Kunden-ID für die Anmeldung festgelegt. Dieser Header ist für einige API-Aufrufe erforderlich.

Nachdem Sie den Google Ads-Kunden ausgewählt haben, für den API-Aufrufe gesendet werden sollen, notieren Sie sich die folgenden Details:

  • Die zehnstellige Kundennummer des Kundenkontos, für das Sie API-Aufrufe planen. Dieser Kunde wird manchmal auch als „Betriebskunde“ bezeichnet.

  • Die 10-stellige Kundennummer des Kundenkontos, in dem Sie angemeldet sind. Wenn Sie beim Kunden angemeldet sind, ist die Kundennummer für die Anmeldung mit der Kundennummer identisch. Wenn Sie sich in einem Verwaltungskonto des Kunden angemeldet haben, ist die Kundennummer der Anmeldung die Kundennummer des Verwaltungskontos.

Zugriff auf das Dienstkonto gewähren

  1. Melden Sie sich als Administrator in Ihrem Google Ads-Konto an und klicken Sie auf Verwaltung > Zugriff und Sicherheit.

  2. Klicken Sie auf dem Tab Nutzer auf die Schaltfläche +.

  3. Geben Sie die E-Mail-Adresse des Dienstkontos in das Eingabefeld E-Mail ein. Wählen Sie die gewünschte Kontozugriffsebene aus und klicken Sie auf die Schaltfläche Konto hinzufügen. Die Zugriffsebene „E-Mail“ wird für Dienstkonten nicht unterstützt.

  4. Dem Dienstkonto wird Zugriff gewährt.

Standardmäßig können Sie einem Dienstkonto keinen Administratorzugriff gewähren. Wenn für Ihre API-Aufrufe Administratorzugriff erforderlich ist, können Sie den Zugriff so aktualisieren:

  1. Klicken Sie in der Spalte Zugriffsebene auf den Drop-down-Pfeil neben der Zugriffsebene des Dienstkontos.

  2. Wählen Sie in der Drop-down-Liste Verwaltung aus.