Customer

Um cliente.

Representação 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

Imutável. O nome do recurso do cliente. Os nomes dos recursos do cliente têm o formato:

customers/{customerId}
callReportingSetting

object (CallReportingSetting)

Configuração do Relatório de chamadas para um cliente. mutável apenas em uma operação update;
conversionTrackingSetting

object (ConversionTrackingSetting)

Apenas saída. Configuração do acompanhamento de conversões de um cliente.
remarketingSetting

object (RemarketingSetting)

Apenas saída. Configuração de remarketing para um cliente.
payPerConversionEligibilityFailureReasons[]

enum (CustomerPayPerConversionEligibilityFailureReason)

Apenas saída. Motivos por que o cliente não está qualificado para usar PaymentMode.conversions. Se a lista estiver vazia, o cliente estará qualificado. Este campo é somente leitura.
optimizationScoreWeight

number

Apenas saída. Peso da pontuação de otimização do cliente.

O peso da pontuação de otimização pode ser usado para comparar/agregar as pontuações de vários clientes que não são administradores. A pontuação de otimização agregada de um administrador é calculada como a soma de todos os clientes de Customer.optimization_score * Customer.optimization_score_weight. Esse campo é 0 para todos os clientes administradores e para clientes que não são administradores sem pontuação.

Este campo é somente leitura.
status

enum (CustomerStatus)

Apenas saída. O status do cliente.
customerAgreementSetting

object (CustomerAgreementSetting)

Apenas saída. Configuração do Contrato do Cliente para um cliente.
localServicesSettings

object (LocalServicesSettings)

Apenas saída. Configurações para clientes de Serviços Locais.
id

string (int64 format)

Apenas saída. O ID do cliente.
descriptiveName

string

Nome descritivo opcional e não exclusivo do cliente.
currencyCode

string

Imutável. A moeda em que a conta opera. É compatível com um subconjunto dos códigos de moeda do padrão ISO 4217.
timeZone

string

Imutável. O ID de fuso horário local do cliente.
trackingUrlTemplate

string

O modelo de URL para criar um URL de rastreamento sem parâmetros. mutável apenas em uma operação update;
finalUrlSuffix

string

O modelo de URL para anexar parâmetros ao URL final. mutável apenas em uma operação update;
autoTaggingEnabled

boolean

Indica se a codificação automática está ativada para o cliente.
hasPartnersBadge

boolean

Apenas saída. Se o cliente tem um selo do programa Google Partners. Se o Cliente não estiver associado ao Programa Google Partners, o valor será "false". Para mais informações, consulte https://support.google.com/partners/answer/3125774.
manager

boolean

Apenas saída. Se o cliente é um gerente.
testAccount

boolean

Apenas saída. Se o cliente é uma conta de teste.
optimizationScore

number

Apenas saída. Pontuação de otimização do cliente.

A pontuação de otimização é uma estimativa da performance das campanhas de um cliente. Ele varia de 0% (0,0) a 100% (1,0). Este campo é nulo para todos os clientes administradores e para clientes sem pontuação.

Consulte o artigo "Sobre a pontuação de otimização" em https://support.google.com/google-ads/answer/9061546.

Este campo é somente leitura.
locationAssetAutoMigrationDone

boolean

Apenas saída. Verdadeiro se o local com base em feed tiver sido migrado para o local com base em recursos.
imageAssetAutoMigrationDone

boolean

Apenas saída. Verdadeiro se a imagem com base em feed tiver sido migrada para uma imagem com base em recursos.
locationAssetAutoMigrationDoneDateTime

string

Apenas saída. Carimbo de data/hora da migração do local com base no feed para o local base do recurso no formato aaaa-MM-dd HH:mm:ss.
imageAssetAutoMigrationDoneDateTime

string

Apenas saída. Carimbo de data/hora da migração da imagem com base no feed para a imagem base do recurso no formato aaaa-MM-dd HH:mm:ss.

CallReportingSetting

Configuração do Relatório de chamadas para um cliente. mutável apenas em uma operação update;

Representação JSON 
{
  "callReportingEnabled": boolean,
  "callConversionReportingEnabled": boolean,
  "callConversionAction": string
}
Campos
callReportingEnabled

boolean

Ativar relatórios de eventos de ligações telefônicas redirecionando-os pelo sistema do Google.
callConversionReportingEnabled

boolean

Define se os relatórios de conversões de chamada serão ativados.
callConversionAction

string

Ação de conversão de chamada no nível do cliente que será atribuída a essa conversão. Se ela não for definida, uma ação de conversão padrão será usada. Em vigor somente quando callConversionReportingEnabled está definido como "true".

ConversionTrackingSetting

Um conjunto de configurações do cliente relacionadas ao acompanhamento de conversões do Google Ads.

Representação JSON 
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
Campos
acceptedCustomerDataTerms

boolean

Apenas saída. Se o cliente aceitou os termos de dados do cliente. Se você usa o acompanhamento de conversões de várias contas, esse valor é herdado do administrador. Este campo é somente leitura. Para mais informações, consulte https://support.google.com/adspolicy/answer/7475709.
conversionTrackingStatus

enum (ConversionTrackingStatus)

Apenas saída. Status do acompanhamento de conversões. Ela indica se o cliente está usando o acompanhamento de conversões e quem é o proprietário do acompanhamento de conversões do cliente. Se esse cliente estiver usando o acompanhamento de conversões de várias contas, o valor retornado será diferente com base no login-customer-id da solicitação.
enhancedConversionsForLeadsEnabled

boolean

Apenas saída. Se o cliente ativou as conversões otimizadas para leads. Se você usa o acompanhamento de conversões de várias contas, esse valor é herdado do administrador. Este campo é somente leitura.
googleAdsConversionCustomer

string

Apenas saída. O nome do recurso do cliente em que as conversões são criadas e gerenciadas. Este campo é somente leitura.
conversionTrackingId

string (int64 format)

Apenas saída. O ID de acompanhamento de conversões usado para esta conta. Esse ID não indica se o cliente usa o acompanhamento de conversões (o conversionTrackingStatus usa). Este campo é somente leitura.
crossAccountConversionTrackingId

string (int64 format)

Apenas saída. O ID de acompanhamento de conversões do gerente do cliente. Ele é definido quando o cliente ativa o acompanhamento de conversões de várias contas e substitui o conversionTrackingId. Esse campo só pode ser gerenciado na interface do Google Ads. Este campo é somente leitura.

ConversionTrackingStatus

Status do acompanhamento de conversões do cliente.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
NOT_CONVERSION_TRACKED O cliente não usa acompanhamento de conversões.
CONVERSION_TRACKING_MANAGED_BY_SELF As ações de conversão são criadas e gerenciadas por esse cliente.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER As ações de conversão são criadas e gerenciadas pelo administrador especificado no login-customer-id da solicitação.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER As ações de conversão são criadas e gerenciadas por um administrador diferente do cliente ou administrador especificado no login-customer-id da solicitação.

RemarketingSetting

Configuração de remarketing para um cliente.

Representação JSON 
{
  "googleGlobalSiteTag": string
}
Campos
googleGlobalSiteTag

string

Apenas saída. A tag do Google.

CustomerPayPerConversionEligibilityFailureReason

Enumeração que descreve os possíveis motivos de um cliente não estar qualificado para usar PaymentMode.conversions.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa o valor desconhecido nesta versão.
NOT_ENOUGH_CONVERSIONS O cliente não tem conversões suficientes.
CONVERSION_LAG_TOO_HIGH O tempo de conversão do cliente é muito alto.
HAS_CAMPAIGN_WITH_SHARED_BUDGET O cliente usa orçamentos compartilhados.
HAS_UPLOAD_CLICKS_CONVERSION O cliente tem conversões com ConversionActionType.UPLOAD_ particular.
AVERAGE_DAILY_SPEND_TOO_HIGH O gasto diário médio do cliente é muito alto.
ANALYSIS_NOT_COMPLETE A qualificação do cliente ainda não foi calculada pelo back-end do Google Ads. Verifique novamente mais tarde.
OTHER O cliente não está qualificado por outros motivos.

CustomerAgreementSetting

Configuração do Contrato do Cliente para um cliente.

Representação JSON 
{
  "acceptedLeadFormTerms": boolean
}
Campos
acceptedLeadFormTerms

boolean

Apenas saída. Se o cliente aceitou os Termos de Serviço do formulário de lead.

LocalServicesSettings

Configurações para clientes de Serviços Locais.

Representação JSON 
{
  "granularLicenseStatuses": [
    {
      object (GranularLicenseStatus)
    }
  ],
  "granularInsuranceStatuses": [
    {
      object (GranularInsuranceStatus)
    }
  ]
}
Campos
granularLicenseStatuses[]

object (GranularLicenseStatus)

Apenas saída. Uma lista somente leitura de status de licença no nível da indústria geográfica.
granularInsuranceStatuses[]

object (GranularInsuranceStatus)

Apenas saída. Uma lista somente leitura de status de seguro no nível da indústria geográfica.

GranularLicenseStatus

Status da licença no nível geográfico e vertical.

Representação JSON 
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
Campos
geoCriterionId

string (int64 format)

Apenas saída. ID do critério da segmentação geográfica associado ao status. Pode ser no nível geográfico do país ou do estado/província, dependendo dos requisitos e do local. Consulte https://developers.google.com/google-ads/api/data/geotargets para mais informações.
categoryId

string

Apenas saída. Categoria de serviço associada ao status. Por exemplo, xcat:service_area_business_encanador. Para mais detalhes, consulte: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids.
verificationStatus

enum (LocalServicesVerificationStatus)

Apenas saída. Status de licença granular, por localização geográfica e indústria.

LocalServicesVerificationStatus

Enumeração que descreve o status de uma categoria específica de verificação dos anúncios dos Serviços Locais.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Status de verificação desconhecido.
NEEDS_REVIEW A verificação foi iniciada, mas não terminou.
FAILED Falha na verificação.
PASSED A verificação foi aprovada.
NOT_APPLICABLE A verificação não é aplicável.
NO_SUBMISSION A verificação é obrigatória, mas o envio está pendente.
PARTIAL_SUBMISSION Nem todas as verificações necessárias foram enviadas.
PENDING_ESCALATION A verificação precisa ser analisada por um especialista de operações de anúncios dos Serviços Locais.

GranularInsuranceStatus

Status do seguro em nível geográfico e vertical.

Representação JSON 
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
Campos
geoCriterionId

string (int64 format)

Apenas saída. ID do critério da segmentação geográfica associado ao status. Pode ser no nível geográfico do país ou do estado/província, dependendo dos requisitos e do local. Consulte https://developers.google.com/google-ads/api/data/geotargets para mais informações.
categoryId

string

Apenas saída. Categoria de serviço associada ao status. Por exemplo, xcat:service_area_business_encanador. Para mais detalhes, consulte: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids.
verificationStatus

enum (LocalServicesVerificationStatus)

Apenas saída. Status de seguro granular, por localização geográfica + indústria.