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

string

Inmutable. El nombre del recurso del cliente. Los nombres de los recursos para los clientes tienen el siguiente formato:

customers/{customerId}

callReportingSetting

object (CallReportingSetting)

Parámetro de configuración de informes de llamadas de un cliente. Solo 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 de un cliente.

payPerConversionEligibilityFailureReasons[]

enum (CustomerPayPerConversionEligibilityFailureReason)

Solo salida. Motivos por los que el cliente no es apto para usar PaymentMode.conversions. 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 utilizar para comparar o agregar niveles de optimización entre varios clientes que no son 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 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. Parámetro de configuración de acuerdos con clientes para un cliente.

localServicesSettings

object (LocalServicesSettings)

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

videoBrandSafetySuitability

enum (BrandSafetySuitability)

Solo salida. configuración de seguridad de la marca a nivel de la cuenta. Permite seleccionar un tipo de inventario para mostrar tus anuncios en el contenido adecuado para tu marca. Consulta https://support.google.com/google-ads/answer/7515513.

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 mutable en una operación update.

finalUrlSuffix

string

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

autoTaggingEnabled

boolean

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, consulta 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. Nivel de optimización del cliente.

El nivel de optimización es una estimación de qué tan bien están configuradas las campañas de un cliente para lograr el rendimiento esperado. Puede variar de 0% (0.0) a 100% (1.0). Este campo es nulo para todos los clientes de administrador y para los clientes sin calificación que no son administradores.

Consulta "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 una ubicación 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 recurso 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 recurso en formato aaaa-MM-dd HH:mm:ss.

CallReportingSetting

Parámetro de configuración de informes de llamadas de un cliente. Solo mutable en una operación update.

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

boolean

Habilitar la generación de informes de los eventos de llamadas telefónicas redireccionándolos 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 la estableces, se utilizará una acción de conversión predeterminada. Solo es válida cuando callConversionReportingEnabled se establece como verdadera.

ConversionTrackingSetting

Es una colección de parámetros de configuración para todo el cliente relacionados 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, consulta 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 del seguimiento de conversiones 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 del 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. Esto 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.

RemarketingSetting

Configuración de remarketing de un cliente.

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

string

Solo salida. La etiqueta de Google.

CustomerPayPerConversionEligibilityFailureReason

Es una enumeración que describe los posibles motivos por los que un cliente no es apto para usar PaymentMode.CONVERSION.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor que se muestra. 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_CLI.
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

Parámetro de configuración de acuerdos con clientes 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 las licencias a nivel de la vertical geográfica.

granularInsuranceStatuses[]

object (GranularInsuranceStatus)

Solo salida. Una lista de solo lectura de los estados de seguro a nivel de la vertical geográfica.

GranularLicenseStatus

Estado de la licencia 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 la licencia detallado por ubicación geográfica y vertical

LocalServicesVerificationStatus

Es una enumeración que describe el estado de una categoría particular 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 No se pudo realizar la 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 obligatoria.
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 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 detallado del seguro por ubicación geográfica y vertical.