Customer-аккаунты Google Ads

Customer-аккаунт — это стандартный рекламный аккаунт Google Ads, содержащий кампании, группы объявлений, ключевые слова и поисковые запросы.

Идентификация аккаунта

Customer ID

Каждый аккаунт идентифицируется уникальным Customer ID в формате XXX-XXX-XXXX (10 цифр).

Где найти:

1. Войдите в Google Ads
2. Нажмите на аватар/иконку аккаунта в правом верхнем углу
3. Customer ID отображается в выпадающем меню
4. Альтернативно: Инструменты → Настройки → Настройки аккаунта

Использование в API:

• В запросах Customer ID указывается без дефисов: XXXXXXXXXX
• Параметр customer_id обязателен для всех запросов к Google Ads API

Дескриптивный номер

Дополнительный идентификатор, который можно задать вручную:

• Произвольная строка для идентификации аккаунта (например, "Main Brand Account")
• Не используется в API, только в интерфейсе Google Ads

Поля аккаунта

Поле	Тип	Описание
customer.id	integer	Customer ID (без дефисов)
customer.descriptive_name	string	Название аккаунта
customer.currency_code	string	ISO-код валюты (USD, EUR, RUB)
customer.time_zone	string	Часовой пояс аккаунта
customer.manager	boolean	Является ли аккаунт Manager-аккаунтом
customer.test_account	boolean	Является ли тестовым аккаунтом
customer.call_reporting_setting.call_conversion_action	string	Настройка конверсий для звонков
customer.auto_tagging_enabled	boolean	Включён ли автотеггинг

Валютные поля и cost_micros

Ключевая особенность Google Ads API: все денежные значения возвращаются в микродолларах (микроединицах базовой валюты).

Конвертация

# Пример: 5 000 000 микродолларов = $5.00
cost_in_micros = 5_000_000
real_cost = cost_in_micros / 1_000_000
# real_cost = 5.0

Поля, использующие микроединицы:

• metrics.cost_micros
• metrics.average_cpc
• metrics.average_cpm
• metrics.cost_per_conversion
• metrics.conversion_value

LightLead автоматически конвертирует все микроединицы в реальную валюту при отображении данных.

Статус аккаунта

Статус	Описание
ENABLED	Аккаунт активен
SUSPENDED	Аккаунт приостановлен
CANCELLED	Аккаунт отменён
CLOSED	Аккаунт закрыт

LightLead может получать данные только из аккаунтов в статусе ENABLED.

Получение данных аккаунта

Основной запрос

SELECT
  customer.id,
  customer.descriptive_name,
  customer.currency_code,
  customer.time_zone,
  customer.auto_tagging_enabled
FROM customer

Список всех доступных аккаунтов

GET /customers:listAccessibleCustomers

Этот запрос возвращает все аккаунты, доступные текущему пользователю (как напрямую, так и через Manager-аккаунты).

Связанные страницы

• Manager и Customer аккаунты
• Сущности и поля
• Метрики
• Подключение Google Ads