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

string

Immutabile. Il nome della risorsa del cliente. I nomi delle risorse dei clienti 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 cliente nel punteggio di ottimizzazione.

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 il cliente di Servizi locali.
videoBrandSafetySuitability

enum (BrandSafetySuitability)

Solo output. Impostazione della sicurezza del brand a livello di account. Consente di selezionare un tipo di inventario per pubblicare gli annunci nei contenuti adatti al tuo brand. Consulta la pagina https://support.google.com/google-ads/answer/7515513.
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 fuso orario locale del cliente.
trackingUrlTemplate

string

Il modello di URL per creare un URL di monitoraggio sulla base dei 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, sarà 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 ai fini del 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 la sezione "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 a una 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 di base dell'asset nel formato aaaa-MM-gg HH:mm:ss.
imageAssetAutoMigrationDoneDateTime

string

Solo output. Timestamp della migrazione dall'immagine basata sul feed all'immagine di 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 Google.
callConversionReportingEnabled

boolean

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 imposti, viene utilizzata un'azione di conversione predefinita. Ha effetto solo quando callConversionReportingEnabled è impostato su true.

ConversionTrackingSetting

Una raccolta di impostazioni a livello di cliente correlate 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. Se il cliente ha accettato i termini per i dati dei clienti. Se utilizzi il monitoraggio delle conversioni su più account, questo valore viene ereditato dall'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 sarà diverso in base al login-customer-id della richiesta.
enhancedConversionsForLeadsEnabled

boolean

Solo output. Indica 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'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). 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'UI di Google Ads. Questo campo è di sola lettura.

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 ha registrato 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. Ricontrolla a breve.
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 il 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 area geografica.
granularInsuranceStatuses[]

object (GranularInsuranceStatus)

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

GranularLicenseStatus

Stato delle licenze 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à. Consulta la pagina https://developers.google.com/google-ads/api/data/geotargets per saperne di più.
categoryId

string

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

enum (LocalServicesVerificationStatus)

Solo output. Stato granulare delle licenze, 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 Verifica superata.
NOT_APPLICABLE La verifica non è applicabile.
NO_SUBMISSION La verifica è obbligatoria, ma è in attesa di invio.
PARTIAL_SUBMISSION Non sono state inviate tutte le verifiche richieste.
PENDING_ESCALATION La verifica deve essere esaminata dallo specialista operativo degli 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à. Consulta la pagina https://developers.google.com/google-ads/api/data/geotargets per saperne di più.
categoryId

string

Solo output. Categoria di servizio associata allo stato. Ad esempio, xcat:area_servizio_azienda_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.