Типы аккаунтов в Google Ads API

В этом документе разъясняются различные термины, используемые для описания аккаунтов в Google Ads API, и то, как они связаны друг с другом.

Обзор

В API Google Ads используется несколько терминов для описания аккаунтов, что иногда может вызывать путаницу. Понимание этих различий важно для управления аккаунтами и интерпретации ответов API.

Типы учетных записей

Приведенные ниже определения разъясняют различные типы учетных записей, с которыми вы столкнетесь при работе с API Google Ads.

Учетная запись менеджера

Управляющий аккаунт — это основной аккаунт, используемый для управления несколькими аккаунтами Google Ads.

  • Прежнее название: Ранее это называлось "MCC" (My Client Center). Вы можете встретить этот термин в устаревшей документации или обсуждениях.
  • Назначение: Для получения токена разработчика и доступа к API обычно требуется учетная запись менеджера. Она позволяет связывать и управлять другими учетными записями.

Обслуживание счета

Рекламный аккаунт (или аккаунт рекламодателя) — это отдельный аккаунт Google Ads, в котором запускаются рекламные кампании.

  • Назначение: Здесь создаются и показываются рекламные кампании, группы объявлений и сами объявления.

Клиентский аккаунт

Клиентский аккаунт — это любой аккаунт (будь то аккаунт обслуживающего клиента или другой аккаунт управляющего), который связан с вышестоящим аккаунтом управляющего и управляется им в иерархии.

  • Контекст: Термин «клиент» относится к отношениям в иерархии (управляемым менеджером), а не обязательно к «клиенту» в деловом смысле.

Клиент

В контексте API, «Клиент» — это ресурс, представляющий любой аккаунт Google Ads, будь то аккаунт менеджера или аккаунт для показа рекламы.

  • Представление: Все учетные записи представлены ресурсом Customer , идентифицируемым по customer_id .
  • Роль: Характер учетной записи (менеджер или обслуживающий сотрудник) зависит от конкретного сотрудника.

Тестовый аккаунт

Тестовые учетные записи — это специальные учетные записи, созданные в рамках учетной записи менеджера специально для тестирования интеграции API.

  • Назначение: Они позволяют тестировать вызовы API без показа реальной рекламы и без дополнительных затрат. Реальная реклама не показывается.

Пример иерархии

Типичная иерархия выглядит следующим образом:

  • Учетная запись менеджера A (верхний уровень)
    • Клиентский счет B (счет для обслуживания)
    • Учетная запись клиента C (другая учетная запись менеджера)
      • Клиентский счет D (обслуживающий счет)

В этом примере:

  • Счет А — это счет управляющего.
  • Счета B, C и D являются клиентскими счетами относительно своих родительских счетов.
  • Счета B и D являются обслуживаемыми счетами.
  • Счет C является одновременно и клиентским счетом (для A), и счетом управляющего (для D).