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

Imutável. O nome do recurso do cliente. Os nomes dos recursos do cliente têm o seguinte 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 para o cliente não estar qualificado para usar PaymentMode.conversions. Se a lista estiver vazia, o cliente está 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 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 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 dos Serviços Locais.
videoBrandSafetySuitability

enum (BrandSafetySuitability)

Apenas saída. Configuração de brand safety no nível da conta. Permite selecionar um tipo de inventário para mostrar os anúncios em conteúdo adequado à sua marca. Consulte https://support.google.com/google-ads/answer/7515513.
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á falso. 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. Ela varia de 0% (0,0) a 100% (1,0). Este campo é nulo para todos os clientes administradores e para clientes sem pontuação.

Consulte "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 no feed tiver sido migrado para o local com base em recursos.
imageAssetAutoMigrationDone

boolean

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

string

Apenas saída. Carimbo de data/hora da migração do local baseado 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 baseada 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 os relatórios de eventos de chamadas telefônicas redirecionando-as pelo sistema do Google.
callConversionReportingEnabled

boolean

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

string

Ação de conversão de chamada no nível do cliente à qual atribuir uma conversão. Se ela não for definida, uma ação de conversão padrão será usada. Somente em vigor quando callConversionReportingEnabled está definido como verdadeiro.

ConversionTrackingSetting

Um conjunto de configurações gerais 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 desse recurso. Se esse cliente estiver usando o acompanhamento de conversões de várias contas, o valor retornado vai ser diferente com base no login-customer-id da solicitação.
enhancedConversionsForLeadsEnabled

boolean

Apenas saída. Indica 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 onde 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 usa 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.

RemarketingSetting

Configuração de remarketing para um cliente.

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

string

Apenas saída. Tag do Google

CustomerPayPerConversionEligibilityFailureReason

Enumeração que descreve os possíveis motivos pelos quais um cliente não está qualificado para usar PaymentMode.conversions.

Enums
UNSPECIFIED Não especificado.
UNKNOWN Usado apenas para valor de retorno. Representa um 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 médio diário 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 o Termos de Serviço do formulário de lead.

LocalServicesSettings

Configurações para clientes dos 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 de nível vertical por área 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 de segmentação geográfica associado ao status. Pode estar no nível geográfico do país ou do estado/província, dependendo dos requisitos e da localização. 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 + indústria.

LocalServicesVerificationStatus

Enumeração que descreve o status de uma categoria de verificação específica 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 foi concluída.
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 pelo especialista em operações de anúncios dos Serviços Locais.

GranularInsuranceStatus

Status do seguro no nível geográfico + setor.

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

string (int64 format)

Apenas saída. ID do critério de segmentação geográfica associado ao status. Pode estar no nível geográfico do país ou do estado/província, dependendo dos requisitos e da localização. 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.