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 es wird erklärt, wie sie zusammenhängen.

Ü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 Ihnen bei der Arbeit mit der Google Ads API begegnen.

Verwaltungskonto

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

• Früherer Name:Früher wurde diese Funktion als „Kundencenter“ (My Client Center, MCC) bezeichnet. Dieser Begriff wird möglicherweise noch in älterer Dokumentation oder in Diskussionen verwendet.
• Zweck:Verwenden Sie ein Verwaltungskonto, wenn Sie mehrere Konten über eine einzelne Hierarchie verknüpfen und verwalten möchten.
• API-Darstellung:Wird durch eine Customer-Ressource identifiziert, wobei customer.manager true ist.

Konto zur Anzeigenauslieferung für Werbetreibende

Ein Werbetreibendenkonto (oder Konto zur Anzeigenauslieferung) ist ein individuelles 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 false ist.

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 (verwaltet von einem Verwaltungskonto), nicht unbedingt auf einen „Kunden“ im geschäftlichen Sinne.
• API-Darstellung:Mit der Abfrage CustomerClient können Sie Konten in der Hierarchie eines Verwaltungskontos untersuchen. Mit CustomerClientLink lassen sich Verknüpfungen zwischen Verwaltungs- und Kundenkonten verwalten.

Kunde

Im API-Kontext ist ein Customer 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 Bereitstellungskonto) hängt von der jeweiligen Ressource ab.

Testkonto

Testkonten sind spezielle Werbetreibendenkonten, die unter einem dedizierten Testverwaltungskonto speziell zum Testen von API-Integrationen organisiert sind. Sowohl im Testverwaltungskonto als auch in den zugehörigen Testwerbetreibendenkonten 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 anfallen. Über sie 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 Testmanagerkontos von einem Testwerbekonto).

Beispiel für 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 ihrer Elternkonten.
• Die Konten B und D sind Werbetreibendenkonten (für die Anzeigenauslieferung).
• Konto C ist sowohl ein Kundenkonto (für A) als auch ein Verwaltungskonto (für D).