Kontotypen in der Google Ads API

In diesem Dokument werden die verschiedenen Begriffe erläutert, die zur Beschreibung von Konten in der Google Ads API verwendet werden, und wie sie miteinander zusammenhängen.

Übersicht

In der Google Ads API werden mehrere Begriffe verwendet, um Konten zu beschreiben. Das kann manchmal zu Verwirrung führen. Diese Unterschiede zu kennen, ist wichtig für die Verwaltung von Konten und die Interpretation von API-Antworten.

Kontotypen

In den folgenden Definitionen werden die verschiedenen Kontotypen erläutert, die Sie bei der Arbeit mit der Google Ads API verwenden können.

Verwaltungskonto

Ein Verwaltungskonto ist ein primäres Konto, mit dem mehrere Google Ads-Konten verwaltet werden.

• Früherer Name: Diese Konten wurden früher als „Kundencenter“ bezeichnet. Möglicherweise finden Sie diesen Begriff noch in älteren Dokumentationen oder Diskussionen.
• Zweck: Verwenden Sie ein Verwaltungskonto, wenn Sie mehrere Konten über eine einzige Hierarchie verknüpfen und verwalten möchten.
• API-Darstellung: Wird durch eine Customer-Ressource identifiziert, wobei customer.manager den Wert true hat.

Werbetreibendenkonto (zur Anzeigenauslieferung)

Ein Werbetreibendenkonto (oder Konto zur Anzeigenauslieferung) ist ein einzelnes Google Ads-Konto, in dem Werbekampagnen ausgeführt werden.

• Zweck: Hier werden Kampagnen, Anzeigengruppen, Asset-Gruppen und Anzeigen erstellt und ausgeliefert.
• API-Darstellung: Wird durch eine Customer-Ressource identifiziert, wobei customer.manager den Wert false hat.

Kundenkonto

Ein Kundenkonto ist ein Konto (entweder ein Werbetreibendenkonto oder ein anderes Verwaltungskonto), das mit einem übergeordneten Verwaltungskonto in der Hierarchie verknüpft ist und von diesem verwaltet wird.

• Kontext: Der Begriff „Kunde“ bezieht sich auf die Beziehung in der Hierarchie (von einem Verwaltungskonto verwaltet), nicht unbedingt auf einen „Kunden“ im geschäftlichen Sinne.
• API-Darstellung: Fragen Sie CustomerClient ab, um Konten in der Hierarchie eines Verwaltungskontos zu prüfen, und verwenden Sie CustomerClientLink, um Verknüpfungen zwischen Verwaltungs- und Kundenkonten zu verwalten.

Kunde

Im API-Kontext ist ein Kunde die Ressource, die für jedes Google Ads-Konto steht, unabhängig davon, ob es sich um ein Verwaltungskonto oder ein Werbetreibendenkonto handelt.

• Darstellung: Alle Konten werden durch eine Customer-Ressource dargestellt, die durch eine customer_id identifiziert wird.
• Rolle: Die Art des Kontos (Verwaltung oder Bereitstellung) hängt von der jeweiligen Ressource ab.

Testkonto

Testkonten sind spezielle Werbetreibendenkonten, die in einem dedizierten Testverwaltungskonto organisiert sind und speziell zum Testen von API-Integrationen verwendet werden. Sowohl für das Testverwaltungskonto als auch für die untergeordneten Testkonten von Werbetreibenden ist das Feld customer.test_account auf true festgelegt. Testkonten können nicht unter einem Produktionsverwaltungskonto erstellt werden.

• Zweck: Mit Testkonten können Sie API-Aufrufe testen, ohne dass Live-Anzeigen ausgeliefert werden oder Kosten entstehen. Es werden keine Live-Anzeigen ausgeliefert.
• API-Darstellung: Wird durch eine Customer-Ressource identifiziert, wobei customer.test_account true ist (mit customer.manager zur Unterscheidung eines Testverwaltungskontos von einem Testwerbetreibendenkonto).

Beispiel für eine Hierarchie

Eine typische Hierarchie sieht so aus:

• Verwaltungskonto A (oberste Ebene)
  • Kundenkonto B (Werbetreibendenkonto)
  • Kundenkonto C (ein weiteres Verwaltungskonto)
    • Kundenkonto D (Werbetreibendenkonto)

In diesem Fall gilt Folgendes:

• Konto A ist ein Verwaltungskonto.
• Die Konten B, C und D sind Kundenkonten, die den übergeordneten Konten zugeordnet sind.
• Die Konten B und D sind Werbetreibendenkonten (Konten zur Anzeigenauslieferung).
• Konto C ist sowohl ein Kundenkonto (für A) als auch ein Verwaltungskonto (für D).