Kundenkonto vorbereiten

In diesem Schritt legen Sie ein Google Ads-Konto fest, für das API-Aufrufe erfolgen sollen. Das Konto kann entweder ein Produktionskonto (Live-Konto) 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.
  • Code, mit dem Live-Berichtsdaten verarbeitet werden, lässt sich leichter schreiben und testen.
  • In Testkonten werden keine Anzeigen ausgeliefert. Programmierfehler haben also keine Auswirkungen auf Ihre aktiven Kampagnen.
  • Funktioniert mit Entwicklertokens mit Testzugriffsebene.
Nachteile
  • Ein Programmierfehler in der Entwicklungsphase kann sich auf die Auslieferung aktiver Kampagnen auswirken und zu Problemen wie einer schlechten Kampagnenleistung, einer falschen Auslieferung oder finanziellen Verlusten führen.
  • Das Entwickler-Token muss mindestens die Zugriffsebene „Basic Access“ haben, um API-Aufrufe ausführen zu können.
  • Sie müssen Kampagnen in Testkonten rekonstruieren, um Code zu testen, der mit bestimmten Kontoinhalten funktioniert.
  • Da in Testkonten keine Anzeigen ausgeliefert werden, werden Funktionen im Zusammenhang mit der Live-Bereitstellung wie Berichtsstatistiken, Fehler bei Richtlinienverstößen oder die Verarbeitung von Offline-Conversion-Importen nicht unterstützt. Das Testen dieser Funktionen ist daher schwierig.

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 (z. B. 1 €/Tag) einrichten, um Funktionen zu testen, die von einem Testkonto nicht unterstützt werden.

Auswahl des Funktionssets

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 festlegen, sollten Sie in der Dokumentation der jeweiligen Funktion nachsehen, ob es zusätzliche Einschränkungen gibt.

Anmelde-Kundennummer und Kundennummer ermitteln

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

Melden Sie sich zuerst als Administrator in Ihrem Google Ads-Konto an. In einigen Fällen haben Sie möglicherweise mehr als ein Kundenkonto zur Auswahl. Mit dem von Ihnen ausgewählten Konto wird die Anmelde-Kundennummer festgelegt, die für einige API-Aufrufe ein erforderlicher Header ist.

Nachdem Sie den Google Ads-Kunden identifiziert haben, für den API-Aufrufe erfolgen sollen, notieren Sie sich die folgenden Details:

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

  • Die 10-stellige Kundennummer des Kundenkontos, mit dem Sie angemeldet sind. Wenn Sie im Betriebskundenkonto angemeldet sind, ist die Anmeldekunden-ID dieselbe wie die Kunden-ID. Wenn Sie sich in einem Verwaltungskonto des Kunden angemeldet haben, ist die Anmelde-Kundennummer die Kundennummer des Verwaltungskontos.

Zugriff auf das Dienstkonto gewähren

  1. Rufen Sie in Ihrem Google Ads-Konto als Administrator Verwaltung > Zugriff und Sicherheit auf.

  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 E-Mail-Zugriffsebene 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 upgraden:

  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 Administrator aus.