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

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

Обзор

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

Типы аккаунтов

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

Управляющий аккаунт

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

• Прежнее название. Ранее этот тип аккаунта назывался Центром клиентов. Вы можете встретить этот термин в устаревшей документации или обсуждениях.
• Назначение. Управляющий аккаунт позволяет связывать несколько аккаунтов и управлять ими в рамках единой иерархии.
• Представление API. Идентифицируется ресурсом Customer, где customer.manager – это true.

Аккаунт рекламодателя (для показа рекламы)

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

• Назначение. Здесь создаются и показываются кампании, группы объявлений, группы объектов и объявления.
• Представление API. Идентифицируется ресурсом Customer, где customer.manager – это false.

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

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

• Контекст. Термин "клиент" относится к иерархии аккаунтов (управляемый аккаунт), а не к клиенту в деловом смысле.
• Представление в API. Чтобы проверить аккаунты в иерархии управляющего аккаунта, используйте запрос CustomerClient, а чтобы управлять связями между управляющим и клиентскими аккаунтами, – CustomerClientLink.

Клиент

В контексте API клиент – это ресурс, представляющий любой аккаунт Google Рекламы, будь то управляющий аккаунт или аккаунт рекламодателя.

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

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

Тестовые аккаунты – это специальные аккаунты рекламодателей, организованные в отдельный тестовый управляющий аккаунт, предназначенный для тестирования интеграций API. В тестовом управляющем аккаунте и подчиненных ему тестовых аккаунтах рекламодателей для поля customer.test_account задано значение true. Тестовые аккаунты нельзя создавать в рабочем управляющем аккаунте.

• Назначение. Тестовые аккаунты позволяют тестировать вызовы API без показа реальных объявлений и дополнительных расходов. В них нет объявлений.
• Представление в API: ресурс Customer, где customer.test_account – это true (с customer.manager, позволяющим отличить тестовый управляющий аккаунт от тестового аккаунта рекламодателя).

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

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

• Управляющий аккаунт А (верхний уровень)
  • Клиентский аккаунт Б (аккаунт рекламодателя)
  • Клиентский аккаунт C (другой управляющий аккаунт)
    • Клиентский аккаунт D (аккаунт рекламодателя)

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

• Аккаунт А – управляющий аккаунт.
• Аккаунты Б, В и Г являются клиентскими аккаунтами по отношению к родительским.
• Аккаунты Б и Г – это аккаунты рекламодателей (показывающие рекламу).
• Аккаунт C является клиентским аккаунтом для аккаунта A и управляющим аккаунтом для аккаунта D.