Customer

Клиент.

JSON-представление
{
  "resourceName": string,
  "callReportingSetting": {
    object (CallReportingSetting)
  },
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "remarketingSetting": {
    object (RemarketingSetting)
  },
  "payPerConversionEligibilityFailureReasons": [
    enum (CustomerPayPerConversionEligibilityFailureReason)
  ],
  "optimizationScoreWeight": number,
  "status": enum (CustomerStatus),
  "customerAgreementSetting": {
    object (CustomerAgreementSetting)
  },
  "localServicesSettings": {
    object (LocalServicesSettings)
  },
  "videoBrandSafetySuitability": enum (BrandSafetySuitability),
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "hasPartnersBadge": boolean,
  "manager": boolean,
  "testAccount": boolean,
  "optimizationScore": number,
  "locationAssetAutoMigrationDone": boolean,
  "imageAssetAutoMigrationDone": boolean,
  "locationAssetAutoMigrationDoneDateTime": string,
  "imageAssetAutoMigrationDoneDateTime": string
}
Поля
resourceName

string

Неизменный. Имя ресурса клиента. Имена ресурсов клиента имеют вид:

customers/{customerId}

callReportingSetting

object ( CallReportingSetting )

Настройка отчетов о звонках для клиента. Изменяем только в операции update .

conversionTrackingSetting

object ( ConversionTrackingSetting )

Только вывод. Настройка отслеживания конверсий для клиента.

remarketingSetting

object ( RemarketingSetting )

Только вывод. Настройка ремаркетинга для клиента.

payPerConversionEligibilityFailureReasons[]

enum ( CustomerPayPerConversionEligibilityFailureReason )

Только вывод. Причины, по которым клиент не имеет права использовать PaymentMode.CONVERSIONS. Если список пуст, клиент имеет право. Это поле доступно только для чтения.

optimizationScoreWeight

number

Только вывод. Вес клиента в рейтинге оптимизации.

Вес показателя оптимизации можно использовать для сравнения/агрегирования показателей оптимизации нескольких клиентов, не являющихся менеджерами. Совокупный показатель оптимизации менеджера рассчитывается как сумма по всем его клиентам Customer.optimization_score * Customer.optimization_score_weight . Это поле равно 0 для всех клиентов-менеджеров и для неоцененных клиентов, не являющихся менеджерами.

Это поле доступно только для чтения.

status

enum ( CustomerStatus )

Только вывод. Статус клиента.

customerAgreementSetting

object ( CustomerAgreementSetting )

Только вывод. Настройка клиентского соглашения для клиента.

localServicesSettings

object ( LocalServicesSettings )

Только вывод. Настройки для клиента Местных услуг.

videoBrandSafetySuitability

enum ( BrandSafetySuitability )

Только вывод. Настройка безопасности бренда на уровне аккаунта. Позволяет выбрать тип инвентаря для показа рекламы на контенте, который подходит вашему бренду. См. https://support.google.com/google-ads/answer/7515513 .

id

string ( int64 format)

Только вывод. Идентификатор клиента.

descriptiveName

string

Необязательное, неуникальное описательное имя клиента.

currencyCode

string

Неизменный. Валюта, в которой работает счет. Поддерживается подмножество кодов валют стандарта ISO 4217.

timeZone

string

Неизменный. Идентификатор местного часового пояса клиента.

trackingUrlTemplate

string

Шаблон URL-адреса для создания URL-адреса отслеживания на основе параметров. Изменяем только в операции update .

finalUrlSuffix

string

Шаблон URL-адреса для добавления параметров к конечному URL-адресу. Изменяем только в операции update .

autoTaggingEnabled

boolean

Включена ли автоматическая пометка для клиента.

hasPartnersBadge

boolean

Только вывод. Наличие у Клиента значка Партнерской программы. Если Заказчик не связан с Партнерской программой, это будет ложно. Дополнительную информацию см. на странице https://support.google.com/partners/answer/3125774 .

manager

boolean

Только вывод. Является ли клиент менеджером.

testAccount

boolean

Только вывод. Является ли клиент тестовым аккаунтом.

optimizationScore

number

Только вывод. Показатель оптимизации клиента.

Показатель оптимизации – это оценка эффективности кампаний клиента. Он варьируется от 0% (0,0) до 100% (1,0). Это поле имеет нулевое значение для всех клиентов-менеджеров и для неоцененных клиентов, не являющихся менеджерами.

См. раздел «О показателе оптимизации» на странице https://support.google.com/google-ads/answer/9061546 .

Это поле доступно только для чтения.

locationAssetAutoMigrationDone

boolean

Только вывод. Значение true, если местоположение на основе фида было перенесено на местоположение на основе объекта.

imageAssetAutoMigrationDone

boolean

Только вывод. Значение true, если изображение на основе фида было перенесено на изображение на основе объекта.

locationAssetAutoMigrationDoneDateTime

string

Только вывод. Временная метка миграции из местоположения на основе фида в местоположение базы активов в формате гггг-ММ-дд ЧЧ:мм:сс.

imageAssetAutoMigrationDoneDateTime

string

Только вывод. Временная метка перехода от изображения на основе фида к базовому изображению объекта в формате гггг-ММ-дд ЧЧ:мм:сс.

Настройка CallReportingSetting

Настройка отчетов о звонках для клиента. Изменяем только в операции update .

JSON-представление
{
  "callReportingEnabled": boolean,
  "callConversionReportingEnabled": boolean,
  "callConversionAction": string
}
Поля
callReportingEnabled

boolean

Включите отчеты о событиях телефонных звонков, перенаправив их через систему Google.

callConversionReportingEnabled

boolean

Включить ли отчеты о конверсиях по звонкам.

callConversionAction

string

Действие-конверсия по звонку на уровне клиента, которому можно приписать конверсию по звонку. Если этот параметр не установлен, используется действие-конверсия по умолчанию. Действует только в том случае, если для параметра callConversionReportingEnabled установлено значение true.

Настройка отслеживания конверсий

Коллекция настроек для всего клиента, связанных с отслеживанием конверсий Google Рекламы.

JSON-представление
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
Поля
acceptedCustomerDataTerms

boolean

Только вывод. Принял ли клиент условия использования данных клиента. Если используется отслеживание конверсий между аккаунтами, это значение наследуется от менеджера. Это поле доступно только для чтения. Дополнительную информацию см. на странице https://support.google.com/adspolicy/answer/7475709 .

conversionTrackingStatus

enum ( ConversionTrackingStatus )

Только вывод. Статус отслеживания конверсий. Он указывает, использует ли клиент отслеживание конверсий и кто является владельцем отслеживания конверсий этого клиента. Если этот клиент использует отслеживание конверсий между аккаунтами, возвращаемое значение будет отличаться в зависимости от login-customer-id в запрос.

enhancedConversionsForLeadsEnabled

boolean

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

googleAdsConversionCustomer

string

Только вывод. Имя ресурса клиента, где создаются и управляются конверсии. Это поле доступно только для чтения.

conversionTrackingId

string ( int64 format)

Только вывод. Идентификатор отслеживания конверсий, используемый для этого аккаунта. Этот идентификатор не указывает, использует ли клиент отслеживание конверсий (conversionTrackingStatus использует). Это поле доступно только для чтения.

crossAccountConversionTrackingId

string ( int64 format)

Только вывод. Идентификатор отслеживания конверсий менеджера клиента. Этот параметр задается, когда клиент включает отслеживание конверсий между аккаунтами, и переопределяет конверсиюTrackingId. Этим полем можно управлять только через интерфейс Google Рекламы. Это поле доступно только для чтения.

Настройка ремаркетинга

Настройка ремаркетинга для клиента.

JSON-представление
{
  "googleGlobalSiteTag": string
}
Поля
googleGlobalSiteTag

string

Только вывод. Тег Google.

КлиентPayPerConversionEligibilityFailureReason

Перечисление, описывающее возможные причины, по которым клиент не имеет права использовать PaymentMode.CONVERSIONS.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
NOT_ENOUGH_CONVERSIONS У клиента недостаточно конверсий.
CONVERSION_LAG_TOO_HIGH Задержка конверсии клиента слишком велика.
HAS_CAMPAIGN_WITH_SHARED_BUDGET Клиент использует общие бюджеты.
HAS_UPLOAD_CLICKS_CONVERSION У клиента есть конверсии с ConversionActionType.UPLOAD_CLICKS.
AVERAGE_DAILY_SPEND_TOO_HIGH Средние ежедневные расходы клиента слишком высоки.
ANALYSIS_NOT_COMPLETE Право клиента на участие еще не рассчитано серверной частью Google Рекламы. Зайдите в ближайшее время.
OTHER Клиент не имеет права по другим причинам.

Настройка соглашения с клиентом

Настройка клиентского соглашения для клиента.

JSON-представление
{
  "acceptedLeadFormTerms": boolean
}
Поля
acceptedLeadFormTerms

boolean

Только вывод. Принял ли клиент условия использования формы для потенциальных клиентов.

Настройки локальных служб

Настройки для клиента местных услуг.

JSON-представление
{
  "granularLicenseStatuses": [
    {
      object (GranularLicenseStatus)
    }
  ],
  "granularInsuranceStatuses": [
    {
      object (GranularInsuranceStatus)
    }
  ]
}
Поля
granularLicenseStatuses[]

object ( GranularLicenseStatus )

Только вывод. Доступный только для чтения список статусов лицензий на географическом уровне.

granularInsuranceStatuses[]

object ( GranularInsuranceStatus )

Только вывод. Список страховых статусов на географическом уровне, доступный только для чтения.

Статус гранулярной лицензии

Статус лицензии на географическом + вертикальном уровне.

JSON-представление
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
Поля
geoCriterionId

string ( int64 format)

Только вывод. Идентификатор критерия геотаргета, связанный со статусом. Может быть на географическом уровне страны или штата/провинции, в зависимости от требований и местоположения. Дополнительную информацию см. на странице https://developers.google.com/google-ads/api/data/geotargets .

categoryId

string

Только вывод. Категория услуги, связанная со статусом. Например, xcat:service_area_business_plumber. Более подробную информацию см.: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids .

verificationStatus

enum ( LocalServicesVerificationStatus )

Только вывод. Детальный статус лицензии, по регионам и по вертикали.

Статус локалсервицесверификатион

Перечисление, описывающее статус определенной категории проверки Рекламы местных услуг.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Неизвестный статус проверки.
NEEDS_REVIEW Проверка началась, но не завершилась.
FAILED Проверка не удалась.
PASSED Верификация прошла.
NOT_APPLICABLE Проверка не применима.
NO_SUBMISSION Требуется проверка, но ожидается отправка.
PARTIAL_SUBMISSION Не все необходимые подтверждения были отправлены.
PENDING_ESCALATION Для подтверждения требуется проверка специалистом по рекламе местных услуг.

Гранулированный статус страхования

Статус страхования на гео+вертикальном уровне.

JSON-представление
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
Поля
geoCriterionId

string ( int64 format)

Только вывод. Идентификатор критерия геотаргета, связанный со статусом. Может быть на географическом уровне страны или штата/провинции, в зависимости от требований и местоположения. Дополнительную информацию см. на странице https://developers.google.com/google-ads/api/data/geotargets .

categoryId

string

Только вывод. Категория услуги, связанная со статусом. Например, xcat:service_area_business_plumber. Более подробную информацию см.: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids .

verificationStatus

enum ( LocalServicesVerificationStatus )

Только вывод. Подробный статус страхования, по географическому признаку + по вертикали.