Customer

Un cliente.

Rappresentazione 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
}
Campi
resourceName

string

Immutabile. Il nome della risorsa del cliente. I nomi delle risorse cliente hanno il seguente formato:

customers/{customerId}
callReportingSetting

object (CallReportingSetting)

Impostazione del monitoraggio delle chiamate per un cliente. Modificabile solo in un'operazione update.
conversionTrackingSetting

object (ConversionTrackingSetting)

Solo output. Impostazione del monitoraggio delle conversioni per un cliente.
remarketingSetting

object (RemarketingSetting)

Solo output. Impostazione di remarketing per un cliente.
payPerConversionEligibilityFailureReasons[]

enum (CustomerPayPerConversionEligibilityFailureReason)

Solo output. Motivi per cui il cliente non è idoneo a utilizzare PaymentMode.CONVERSION. Se l'elenco è vuoto, il cliente è idoneo. Questo campo è di sola lettura.
optimizationScoreWeight

number

Solo output. Ponderazione del punteggio di ottimizzazione del cliente.

La ponderazione del punteggio di ottimizzazione può essere utilizzata per confrontare/aggregare i punteggi di ottimizzazione di più clienti diversi dall'account amministratore. Il punteggio di ottimizzazione aggregato di un gestore viene calcolato come la somma di tutti i suoi clienti di Customer.optimization_score * Customer.optimization_score_weight. Questo campo è 0 per tutti i clienti amministratore e per i clienti diversi dall'account amministratore senza punteggio.

Questo campo è di sola lettura.
status

enum (CustomerStatus)

Solo output. Lo stato del cliente.
customerAgreementSetting

object (CustomerAgreementSetting)

Solo output. Impostazione del Contratto con il cliente per un cliente.
localServicesSettings

object (LocalServicesSettings)

Solo output. Impostazioni per cliente di Servizi locali.
id

string (int64 format)

Solo output. L'ID del cliente.
descriptiveName

string

Nome descrittivo facoltativo e non univoco del cliente.
currencyCode

string

Immutabile. La valuta in cui opera l'account. È supportato un sottoinsieme dei codici valuta dello standard ISO 4217.
timeZone

string

Immutabile. L'ID del fuso orario locale del cliente.
trackingUrlTemplate

string

Il modello di URL per la creazione di un URL di monitoraggio basato sui parametri. Modificabile solo in un'operazione update.
finalUrlSuffix

string

Il modello di URL per aggiungere parametri all'URL finale. Modificabile solo in un'operazione update.
autoTaggingEnabled

boolean

Indica se il tagging automatico è attivato per il cliente.
hasPartnersBadge

boolean

Solo output. Se il Cliente dispone di un badge del programma Partners. Se il Cliente non è associato al programma Partners, si tratta di una dichiarazione falso. Per ulteriori informazioni, visita la pagina https://support.google.com/partners/answer/3125774.
manager

boolean

Solo output. Se il cliente è un gestore.
testAccount

boolean

Solo output. Se il cliente è un account di prova.
optimizationScore

number

Solo output. Punteggio di ottimizzazione del cliente.

Il punteggio di ottimizzazione è una stima del livello di efficacia delle campagne di un cliente in termini di rendimento. L'intervallo varia da 0% (0,0) a 100% (1,0). Questo campo è nullo per tutti i clienti amministratore e per i clienti diversi dall'account amministratore senza punteggio.

Consulta "Informazioni sul punteggio di ottimizzazione" alla pagina https://support.google.com/google-ads/answer/9061546.

Questo campo è di sola lettura.
locationAssetAutoMigrationDone

boolean

Solo output. True se è stata eseguita la migrazione della località basata sul feed alla località basata sugli asset.
imageAssetAutoMigrationDone

boolean

Solo output. True se è stata eseguita la migrazione dell'immagine basata su feed a un'immagine basata su asset.
locationAssetAutoMigrationDoneDateTime

string

Solo output. Timestamp della migrazione dalla località basata sul feed alla posizione della base degli asset nel formato aaaa-MM-gg HH:mm:ss.
imageAssetAutoMigrationDoneDateTime

string

Solo output. Timestamp della migrazione dall'immagine basata sul feed all'immagine base dell'asset in formato aaaa-MM-gg HH:mm:ss.

CallReportingSetting

Impostazione del monitoraggio delle chiamate per un cliente. Modificabile solo in un'operazione update.

Rappresentazione JSON 
{
  "callReportingEnabled": boolean,
  "callConversionReportingEnabled": boolean,
  "callConversionAction": string
}
Campi
callReportingEnabled

boolean

Attiva il reporting degli eventi di chiamata reindirizzandoli tramite il sistema di Google.
callConversionReportingEnabled

boolean

Indica se attivare i report sulle conversioni di chiamata.
callConversionAction

string

Azione di conversione di chiamata a livello di cliente a cui attribuire una conversione di chiamata. Se non è impostata, viene utilizzata un'azione di conversione predefinita. Ha effetto solo quando callConversionReportingEnabled è impostato su true.

ConversionTrackingSetting

Una raccolta di impostazioni a livello di cliente relative al monitoraggio delle conversioni di Google Ads.

Rappresentazione JSON 
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
Campi
acceptedCustomerDataTerms

boolean

Solo output. Indica se il cliente ha accettato i termini relativi ai dati dei clienti. Se utilizzi il monitoraggio delle conversioni su più account, questo valore viene ereditato dall'account amministratore. Questo campo è di sola lettura. Per ulteriori informazioni, consulta la pagina https://support.google.com/adspolicy/answer/7475709.
conversionTrackingStatus

enum (ConversionTrackingStatus)

Solo output. Stato del monitoraggio delle conversioni. Indica se il cliente utilizza il monitoraggio delle conversioni e chi è il proprietario del monitoraggio delle conversioni di questo cliente. Se questo cliente utilizza il monitoraggio delle conversioni su più account, il valore restituito varierà in base ai login-customer-id della richiesta.
enhancedConversionsForLeadsEnabled

boolean

Solo output. Se il cliente ha attivato le conversioni avanzate per i lead. Se utilizzi il monitoraggio delle conversioni su più account, questo valore viene ereditato dall'account amministratore. Questo campo è di sola lettura.
googleAdsConversionCustomer

string

Solo output. Il nome della risorsa del cliente in cui vengono create e gestite le conversioni. Questo campo è di sola lettura.
conversionTrackingId

string (int64 format)

Solo output. L'ID monitoraggio delle conversioni utilizzato per questo account. Questo ID non indica se il cliente utilizza il monitoraggio delle conversioni (conversionTrackingStatus sì). Questo campo è di sola lettura.
crossAccountConversionTrackingId

string (int64 format)

Solo output. L'ID monitoraggio delle conversioni del gestore del cliente. Viene impostato quando il cliente ha attivato il monitoraggio delle conversioni su più account e sostituisce il parametro conversionTrackingId. Questo campo può essere gestito solo tramite l'interfaccia utente di Google Ads. Questo campo è di sola lettura.

ConversionTrackingStatus

Stato del monitoraggio delle conversioni del cliente.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
NOT_CONVERSION_TRACKED Il cliente non utilizza alcun monitoraggio delle conversioni.
CONVERSION_TRACKING_MANAGED_BY_SELF Le azioni di conversione vengono create e gestite da questo cliente.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER Le azioni di conversione vengono create e gestite dal gestore specificato nelle login-customer-id della richiesta.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER Le azioni di conversione vengono create e gestite da un gestore diverso dal cliente o dal gestore specificato nell'login-customer-id della richiesta.

RemarketingSetting

Impostazione di remarketing per un cliente.

Rappresentazione JSON 
{
  "googleGlobalSiteTag": string
}
Campi
googleGlobalSiteTag

string

Solo output. Il tag Google.

CustomerPayPerConversionEligibilityFailureReason

Enum che descrive i possibili motivi per cui un cliente non è idoneo a utilizzare PaymentMode.CONVERSION.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
NOT_ENOUGH_CONVERSIONS Il cliente non dispone di un numero sufficiente di conversioni.
CONVERSION_LAG_TOO_HIGH Il tempo di conversione del cliente è troppo elevato.
HAS_CAMPAIGN_WITH_SHARED_BUDGET Il cliente utilizza budget condivisi.
HAS_UPLOAD_CLICKS_CONVERSION Il cliente registra conversioni con ConversionActionType.UPLOAD_CLIC.
AVERAGE_DAILY_SPEND_TOO_HIGH La spesa giornaliera media del cliente è troppo alta.
ANALYSIS_NOT_COMPLETE L'idoneità del cliente non è stata ancora calcolata dal backend di Google Ads. Torna a controllare presto.
OTHER Il cliente non è idoneo per altri motivi.

CustomerAgreementSetting

Impostazione del Contratto con il cliente per un cliente.

Rappresentazione JSON 
{
  "acceptedLeadFormTerms": boolean
}
Campi
acceptedLeadFormTerms

boolean

Solo output. Se il cliente ha accettato i termini di servizio del modulo per i lead.

LocalServicesSettings

Impostazioni per cliente di Servizi locali.

Rappresentazione JSON 
{
  "granularLicenseStatuses": [
    {
      object (GranularLicenseStatus)
    }
  ],
  "granularInsuranceStatuses": [
    {
      object (GranularInsuranceStatus)
    }
  ]
}
Campi
granularLicenseStatuses[]

object (GranularLicenseStatus)

Solo output. Un elenco di sola lettura degli stati delle licenze a livello di verticale geografico.
granularInsuranceStatuses[]

object (GranularInsuranceStatus)

Solo output. Un elenco di sola lettura di stati assicurativi a livello di verticale geografico.

GranularLicenseStatus

Stato della licenza a livello geografico + verticale.

Rappresentazione JSON 
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
Campi
geoCriterionId

string (int64 format)

Solo output. ID criterio di targeting geografico associato allo stato. Può essere a livello di paese o stato/provincia, a seconda dei requisiti e della località. Per saperne di più, consulta la pagina https://developers.google.com/google-ads/api/data/geotargets.
categoryId

string

Solo output. Categoria di servizio associata allo stato. Ad esempio, xcat:service_area_business_idraulico. Per ulteriori dettagli, consulta: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
verificationStatus

enum (LocalServicesVerificationStatus)

Solo output. Stato della licenza granulare, per area geografica + verticale.

LocalServicesVerificationStatus

Enum che descrive lo stato di una determinata categoria di verifica degli annunci di Servizi locali.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Stato della verifica sconosciuto.
NEEDS_REVIEW La verifica è iniziata, ma non è terminata.
FAILED Verifica non riuscita.
PASSED La verifica è stata superata.
NOT_APPLICABLE La verifica non è applicabile.
NO_SUBMISSION La verifica è obbligatoria, ma l'invio è in attesa.
PARTIAL_SUBMISSION Non sono state inviate tutte le verifiche richieste.
PENDING_ESCALATION La verifica richiede la revisione da parte dell'esperto operativo di annunci di Servizi locali.

GranularInsuranceStatus

Stato dell'assicurazione a livello geografico e verticale.

Rappresentazione JSON 
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
Campi
geoCriterionId

string (int64 format)

Solo output. ID criterio di targeting geografico associato allo stato. Può essere a livello di paese o stato/provincia, a seconda dei requisiti e della località. Per saperne di più, consulta la pagina https://developers.google.com/google-ads/api/data/geotargets.
categoryId

string

Solo output. Categoria di servizio associata allo stato. Ad esempio, xcat:service_area_business_idraulico. Per ulteriori dettagli, consulta: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
verificationStatus

enum (LocalServicesVerificationStatus)

Solo output. Stato assicurativo granulare, per area geografica + verticale.