Customer

Un cliente.

Representación 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)
  },
  "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
}
Campos
resourceName

string

Inmutable. El nombre del recurso del cliente. Los nombres de los recursos del cliente tienen la siguiente forma:

customers/{customerId}
callReportingSetting

object (CallReportingSetting)

Configuración de informes de llamadas de un cliente. Solo es mutable en una operación update.
conversionTrackingSetting

object (ConversionTrackingSetting)

Solo salida. Configuración del seguimiento de conversiones de un cliente.
remarketingSetting

object (RemarketingSetting)

Solo salida. Configuración de remarketing para un cliente.
payPerConversionEligibilityFailureReasons[]

enum (CustomerPayPerConversionEligibilityFailureReason)

Solo salida. Son los motivos por los que el cliente no es apto para usar PaymentMode.CURRENCY. Si la lista está vacía, significa que el cliente es apto. Este campo es de solo lectura.
optimizationScoreWeight

number

Solo salida. Ponderación del nivel de optimización del cliente.

La ponderación del nivel de optimización se puede usar para comparar o agregar niveles de optimización de varios clientes que no sean administradores. El nivel de optimización agregado de un administrador se calcula como la suma de todos sus clientes de Customer.optimization_score * Customer.optimization_score_weight. Este campo corresponde a 0 para todos los clientes de nivel administrador y para los clientes sin calificación que no son administradores.

Este campo es de solo lectura.
status

enum (CustomerStatus)

Solo salida. El estado del cliente.
customerAgreementSetting

object (CustomerAgreementSetting)

Solo salida. Configuración de acuerdos con el cliente para un cliente.
localServicesSettings

object (LocalServicesSettings)

Solo salida. Configuración del cliente de Servicios Locales.
id

string (int64 format)

Solo salida. El ID del cliente.
descriptiveName

string

Nombre descriptivo no único y opcional del cliente.
currencyCode

string

Inmutable. La moneda en la que opera la cuenta. Se admite un subconjunto de códigos de moneda del estándar ISO 4217.
timeZone

string

Inmutable. El ID de la zona horaria local del cliente.
trackingUrlTemplate

string

La plantilla de URL para crear una URL de seguimiento a partir de parámetros. Solo es mutable en una operación update.
finalUrlSuffix

string

La plantilla de URL para agregar parámetros a la URL final. Solo es mutable en una operación update.
autoTaggingEnabled

boolean

Indica si el etiquetado automático está habilitado para el cliente.
hasPartnersBadge

boolean

Solo salida. Si el Cliente tiene una insignia del Programa de Partners Si el Cliente no está asociado con el Programa de Partners, esto será falso. Para obtener más información, consulte https://support.google.com/partners/answer/3125774.
manager

boolean

Solo salida. Si el cliente es un administrador
testAccount

boolean

Solo salida. Si el cliente es una cuenta de prueba
optimizationScore

number

Solo salida. Es el nivel de optimización del cliente.

El nivel de optimización es una estimación de la efectividad de la configuración de las campañas de un cliente para lograr el rendimiento esperado. Su rango va del 0% (0.0) al 100% (1.0). Este campo es nulo para todos los clientes de administrador y para los clientes sin calificación que no son administradores.

Consulte el artículo "Acerca del nivel de optimización" en https://support.google.com/google-ads/answer/9061546.

Este campo es de solo lectura.
locationAssetAutoMigrationDone

boolean

Solo salida. Verdadero si la ubicación basada en el feed se migró a la basada en recursos.
imageAssetAutoMigrationDone

boolean

Solo salida. Verdadero si la imagen basada en el feed se migró a una basada en elementos.
locationAssetAutoMigrationDoneDateTime

string

Solo salida. Marca de tiempo de la migración de la ubicación basada en el feed a la ubicación base del activo en formato aaaa-MM-dd HH:mm:ss.
imageAssetAutoMigrationDoneDateTime

string

Solo salida. Marca de tiempo de la migración de la imagen basada en el feed a la imagen base del elemento en formato aaaa-MM-dd HH:mm:ss.

CallReportingSetting

Configuración de informes de llamadas de un cliente. Solo es mutable en una operación update.

Representación JSON 
{
  "callReportingEnabled": boolean,
  "callConversionReportingEnabled": boolean,
  "callConversionAction": string
}
Campos
callReportingEnabled

boolean

Para habilitar la generación de informes de eventos de llamadas telefónicas, redirecciónalos a través del sistema de Google.
callConversionReportingEnabled

boolean

Indica si se deben habilitar los informes de conversiones de llamadas.
callConversionAction

string

Es la acción de conversión de llamada a nivel del cliente a la que se atribuye una conversión de llamada. Si no se establece, se utilizará una acción de conversión predeterminada. Solo es válida cuando se establece callConversionReportingEnabled como verdadera.

ConversionTrackingSetting

Es una colección de parámetros de configuración que se aplican a todo el cliente y que se relacionan con el seguimiento de conversiones de Google Ads.

Representación JSON 
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
Campos
acceptedCustomerDataTerms

boolean

Solo salida. Si el cliente aceptó las condiciones sobre los datos del cliente Si utiliza el seguimiento de conversiones de múltiples cuentas, este valor se hereda del administrador. Este campo es de solo lectura. Para obtener más información, consulte https://support.google.com/adspolicy/answer/7475709.
conversionTrackingStatus

enum (ConversionTrackingStatus)

Solo salida. Estado del seguimiento de conversiones Indica si el cliente utiliza el seguimiento de conversiones y quién es el propietario correspondiente de este cliente. Si este cliente utiliza el seguimiento de conversiones de múltiples cuentas, el valor que se muestre diferirá según el login-customer-id de la solicitud.
enhancedConversionsForLeadsEnabled

boolean

Solo salida. Si el cliente habilitó las conversiones avanzadas de clientes potenciales Si utiliza el seguimiento de conversiones de múltiples cuentas, este valor se hereda del administrador. Este campo es de solo lectura.
googleAdsConversionCustomer

string

Solo salida. El nombre del recurso del cliente en el que se crean y administran las conversiones. Este campo es de solo lectura.
conversionTrackingId

string (int64 format)

Solo salida. Es el ID de seguimiento de conversiones utilizado para esta cuenta. Este ID no indica si el cliente utiliza el seguimiento de conversiones (conversionTrackingStatus sí). Este campo es de solo lectura.
crossAccountConversionTrackingId

string (int64 format)

Solo salida. El ID de seguimiento de conversiones del administrador del cliente. Se establece cuando el cliente habilita el seguimiento de conversiones de múltiples cuentas y anula conversionTrackingId. Este campo solo se puede administrar a través de la IU de Google Ads. Este campo es de solo lectura.

ConversionTrackingStatus

Estado del seguimiento de conversiones del cliente

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor de retorno. Representa un valor desconocido en esta versión.
NOT_CONVERSION_TRACKED El cliente no utiliza ningún seguimiento de conversiones.
CONVERSION_TRACKING_MANAGED_BY_SELF Este cliente crea y administra las acciones de conversión.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER El administrador especificado en la login-customer-id de la solicitud crea y administra las acciones de conversión.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER Un administrador diferente del cliente o administrador especificado en la login-customer-id de la solicitud crea y administra las acciones de conversión.

RemarketingSetting

Configuración de remarketing para un cliente.

Representación JSON 
{
  "googleGlobalSiteTag": string
}
Campos
googleGlobalSiteTag

string

Solo salida. La etiqueta de Google

CustomerPayPerConversionEligibilityFailureReason

Enumeración que describe los posibles motivos por los que un cliente no es apto para usar PaymentMode.CURRENCY.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor de retorno. Representa un valor desconocido en esta versión.
NOT_ENOUGH_CONVERSIONS El cliente no tiene suficientes conversiones.
CONVERSION_LAG_TOO_HIGH El lapso de tiempo para conversión del cliente es demasiado alto.
HAS_CAMPAIGN_WITH_SHARED_BUDGET El cliente utiliza presupuestos compartidos.
HAS_UPLOAD_CLICKS_CONVERSION El cliente tiene conversiones con ConversionActionType.UPLOAD_ diferentes.
AVERAGE_DAILY_SPEND_TOO_HIGH La inversión diaria promedio del cliente es demasiado alta.
ANALYSIS_NOT_COMPLETE El backend de Google Ads aún no calculó la elegibilidad del cliente. Vuelve a consultarlo pronto.
OTHER El cliente no es apto por otros motivos.

CustomerAgreementSetting

Configuración de acuerdos con el cliente para un cliente.

Representación JSON 
{
  "acceptedLeadFormTerms": boolean
}
Campos
acceptedLeadFormTerms

boolean

Solo salida. Si el cliente aceptó las Condiciones del Servicio del formulario de clientes potenciales

LocalServicesSettings

Configuración del cliente de Servicios Locales.

Representación JSON 
{
  "granularLicenseStatuses": [
    {
      object (GranularLicenseStatus)
    }
  ],
  "granularInsuranceStatuses": [
    {
      object (GranularInsuranceStatus)
    }
  ]
}
Campos
granularLicenseStatuses[]

object (GranularLicenseStatus)

Solo salida. Una lista de solo lectura de los estados de la licencia a nivel de la geovertical
granularInsuranceStatuses[]

object (GranularInsuranceStatus)

Solo salida. Una lista de solo lectura de los estados de seguro a nivel de la geovertical.

GranularLicenseStatus

Estado de la licencia a nivel de la ubicación geográfica y vertical.

Representación JSON 
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
Campos
geoCriterionId

string (int64 format)

Solo salida. Es el ID del criterio de segmentación geográfica asociado con el estado. Puede ser a nivel geográfico del país, el estado o la provincia, según los requisitos y la ubicación. Consulta https://developers.google.com/google-ads/api/data/geotargets para obtener más información.
categoryId

string

Solo salida. Es la categoría del servicio asociada con el estado. Por ejemplo, xcat:plomero_empresa_de_servicios. Para obtener más información, consulte: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids.
verificationStatus

enum (LocalServicesVerificationStatus)

Solo salida. Estado de la licencia detallado, por ubicación geográfica y vertical.

LocalServicesVerificationStatus

Es una enumeración que describe el estado de una categoría específica de verificación de Anuncios de Servicios Locales.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Estado de verificación desconocido.
NEEDS_REVIEW La verificación comenzó, pero no ha finalizado.
FAILED Se produjo un error de verificación.
PASSED Se aprobó la verificación.
NOT_APPLICABLE La verificación no es aplicable.
NO_SUBMISSION La verificación es obligatoria, pero el envío está pendiente.
PARTIAL_SUBMISSION No se envió toda la verificación requerida.
PENDING_ESCALATION El especialista en operaciones de Anuncios de Servicios Locales debe revisar la verificación.

GranularInsuranceStatus

Estado del seguro a nivel de la ubicación geográfica y la vertical

Representación JSON 
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
Campos
geoCriterionId

string (int64 format)

Solo salida. Es el ID del criterio de segmentación geográfica asociado con el estado. Puede ser a nivel geográfico del país, el estado o la provincia, según los requisitos y la ubicación. Consulta https://developers.google.com/google-ads/api/data/geotargets para obtener más información.
categoryId

string

Solo salida. Es la categoría del servicio asociada con el estado. Por ejemplo, xcat:plomero_empresa_de_servicios. Para obtener más información, consulte: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids.
verificationStatus

enum (LocalServicesVerificationStatus)

Solo salida. Estado de seguro detallado, por ubicación geográfica y vertical.