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 zueinander in Beziehung stehen.

Übersicht

In der Google Ads API werden verschiedene Begriffe zur Beschreibung von Konten verwendet, was manchmal zu Verwirrung führen kann. Es ist wichtig, diese Unterschiede zu kennen, um Konten zu verwalten und API-Antworten zu interpretieren.

Kontotypen

Die folgenden Definitionen erläutern die verschiedenen Kontotypen, die bei der Arbeit mit der Google Ads API verwendet werden.

Verwaltungskonto

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

• Früherer Name:Früher wurde es als „MCC“ (Kundencenter) bezeichnet. Möglicherweise sehen Sie diesen Begriff noch in älterer Dokumentation oder in 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 , bei der customer.manager auf true gesetzt ist.

Werbetreibendenkonto (Auslieferungskonto)

Ein Werbekonto (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 , bei der customer.manager auf false gesetzt ist.

Kundenkonto

Ein Kundenkonto ist ein beliebiges 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 (verwaltet von einem Verwaltungskonto) und nicht unbedingt auf einen „Kunden“ im geschäftlichen Sinne.
• API-Darstellung: Mit CustomerClient können Sie Konten in der Hierarchie eines Verwaltungskontos prüfen und mit CustomerClientLink Links zwischen Verwaltungs- und Kundenkonten verwalten.

Kunde

Im API-Kontext ist ein Kunde die Ressource, die ein beliebiges Google Ads-Konto darstellt, 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 (Verwaltungs- oder Auslieferungskonto) hängt von der jeweiligen Ressource ab.

Testkonto

Testkonten sind spezielle Werbetreibendenkonten, die unter einem dedizierten Testverwaltungskonto organisiert sind und speziell für das Testen von API-Integrationen verwendet werden. Für das Testverwaltungskonto und die zugehörigen Testwerbetreibendenkonten ist das customer.test_account Feld auf true gesetzt. Testkonten können nicht unter einem Produktionsverwaltungskonto erstellt werden.

• Zweck:Mit Testkonten können Sie API-Aufrufe testen, ohne Anzeigen zu schalten oder Kosten zu verursachen. Es werden keine Anzeigen ausgeliefert.
• API-Darstellung: Wird durch eine Customer-Ressource identifiziert, bei der customer.test_account auf true gesetzt ist. Mit customer.manager wird zwischen einem Testverwaltungskonto und einem Testwerbetreibendenkonto unterschieden.

Beispiel für eine Hierarchie

Eine typische Hierarchie sieht so aus:

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

In diesem Fall gilt Folgendes:

• Konto A ist ein Verwaltungskonto.
• Die Konten B, C und D sind Kundenkonten im Verhältnis zu ihren übergeordneten Konten.
• Die Konten B und D sind Werbetreibendenkonten (Auslieferungskonten).
• Konto C ist sowohl ein Kundenkonto (für A) als auch ein Verwaltungskonto (für D).