Customer

Un client.

Représentation 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
}
Champs
resourceName

string

Immuable. Nom de ressource du client. Le nom des ressources client se présente sous la forme suivante:

customers/{customerId}
callReportingSetting

object (CallReportingSetting)

Paramètre de suivi des appels pour un client. Modifiable uniquement dans une opération update.
conversionTrackingSetting

object (ConversionTrackingSetting)

Uniquement en sortie. Paramètre de suivi des conversions d'un client.
remarketingSetting

object (RemarketingSetting)

Uniquement en sortie. Paramètre de remarketing d'un client.
payPerConversionEligibilityFailureReasons[]

enum (CustomerPayPerConversionEligibilityFailureReason)

Uniquement en sortie. Raisons pour lesquelles le client ne peut pas utiliser PaymentMode.CONVERSIONS. Si la liste est vide, le client est éligible. Ce champ est en lecture seule.
optimizationScoreWeight

number

Uniquement en sortie. Pondération du taux d'optimisation du client.

Vous pouvez utiliser la pondération du score d'optimisation pour comparer/agréger les scores d'optimisation de plusieurs clients qui ne sont pas des responsables. Le score d'optimisation agrégé d'un administrateur correspond à la somme de tous les clients de Customer.optimization_score * Customer.optimization_score_weight. Ce champ correspond à 0 pour tous les clients administrateurs, ainsi que pour les autres clients non notés.

Ce champ est en lecture seule.
status

enum (CustomerStatus)

Uniquement en sortie. État du client.
customerAgreementSetting

object (CustomerAgreementSetting)

Uniquement en sortie. Paramètre du contrat client pour un client.
localServicesSettings

object (LocalServicesSettings)

Uniquement en sortie. Paramètres du client Local Services.
videoBrandSafetySuitability

enum (BrandSafetySuitability)

Uniquement en sortie. brand safety au niveau du compte. Vous pouvez sélectionner un type d'inventaire pour diffuser vos annonces sur des contenus adaptés à votre marque. Consultez la page https://support.google.com/google-ads/answer/7515513.
id

string (int64 format)

Uniquement en sortie. ID du client.
descriptiveName

string

Nom descriptif facultatif et non unique du client.
currencyCode

string

Immuable. Devise de fonctionnement du compte. Accepte un sous-ensemble de codes de devise ISO 4217.
timeZone

string

Immuable. ID du fuseau horaire local du client.
trackingUrlTemplate

string

Modèle d'URL permettant de créer une URL de suivi à partir de paramètres. Modifiable uniquement dans une opération update.
finalUrlSuffix

string

Modèle d'URL permettant d'ajouter des paramètres à l'URL finale. Modifiable uniquement dans une opération update.
autoTaggingEnabled

boolean

Indique si le taggage automatique est activé pour le client.
hasPartnersBadge

boolean

Uniquement en sortie. Indique si le client possède un badge du programme Partners. Si le Client n'est pas associé au programme Partners, la réponse est "faux". Pour en savoir plus, consultez la page https://support.google.com/partners/answer/3125774.
manager

boolean

Uniquement en sortie. Indique si le client est un gestionnaire.
testAccount

boolean

Uniquement en sortie. Indique si le client est un compte de test.
optimizationScore

number

Uniquement en sortie. Taux d'optimisation du client.

Le score d'optimisation fournit une estimation des performances des campagnes d'un client telles qu'elles ont été configurées. Il est compris entre 0% (0,0) et 100% (1,0). Ce champ est nul pour tous les clients administrateurs, ainsi que pour les autres clients non notés.

Consultez la section "À propos du taux d'optimisation" à l'adresse https://support.google.com/google-ads/answer/9061546.

Ce champ est en lecture seule.
locationAssetAutoMigrationDone

boolean

Uniquement en sortie. Vrai si la zone géographique basée sur le flux a été migrée vers une zone basée sur des composants.
imageAssetAutoMigrationDone

boolean

Uniquement en sortie. Vrai si l'image basée sur un flux a été migrée vers une image basée sur des éléments.
locationAssetAutoMigrationDoneDateTime

string

Uniquement en sortie. Horodatage de la migration de l'emplacement basé sur le flux vers l'emplacement de base de l'élément, au format aaaa-MM-jj HH:mm:ss.
imageAssetAutoMigrationDoneDateTime

string

Uniquement en sortie. Horodatage de la migration de l'image basée sur le flux vers l'image de base de l'élément, au format aaaa-MM-jj HH:mm:ss.

CallReportingSetting

Paramètre de suivi des appels pour un client. Modifiable uniquement dans une opération update.

Représentation JSON 
{
  "callReportingEnabled": boolean,
  "callConversionReportingEnabled": boolean,
  "callConversionAction": string
}
Champs
callReportingEnabled

boolean

Activez la création de rapports sur les événements d'appel téléphonique en les redirigeant via le système Google.
callConversionReportingEnabled

boolean

Permet d'activer ou non le suivi des conversions par appel.
callConversionAction

string

Action de conversion par appel au niveau du client à laquelle attribuer une conversion par appel. Si cette règle n'est pas configurée, une action de conversion par défaut est utilisée. Cette règle s'applique uniquement lorsque "callConversionReportingEnabled" est défini sur "true".

ConversionTrackingSetting

Ensemble de paramètres concernant le suivi des conversions Google Ads concernant l'ensemble du client.

Représentation JSON 
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
Champs
acceptedCustomerDataTerms

boolean

Uniquement en sortie. Indique si le client a accepté les conditions d'utilisation des données client. Si vous utilisez le suivi des conversions multicomptes, cette valeur est héritée de l'administrateur. Ce champ est en lecture seule. Pour en savoir plus, consultez la page https://support.google.com/adspolicy/answer/7475709.
conversionTrackingStatus

enum (ConversionTrackingStatus)

Uniquement en sortie. État du suivi des conversions. Elle indique si le client utilise le suivi des conversions et qui en est le propriétaire. Si le client utilise le suivi des conversions multicomptes, la valeur renvoyée diffère en fonction de l'login-customer-id de la requête.
enhancedConversionsForLeadsEnabled

boolean

Uniquement en sortie. Indique si le client a activé le suivi avancé des conversions pour les prospects. Si vous utilisez le suivi des conversions multicomptes, cette valeur est héritée de l'administrateur. Ce champ est en lecture seule.
googleAdsConversionCustomer

string

Uniquement en sortie. Nom de la ressource du client dans laquelle les conversions sont créées et gérées. Ce champ est en lecture seule.
conversionTrackingId

string (int64 format)

Uniquement en sortie. ID de suivi des conversions utilisé pour ce compte. Cet identifiant n'indique pas si le client utilise le suivi des conversions (contrairement à conversionTrackingStatus). Ce champ est en lecture seule.
crossAccountConversionTrackingId

string (int64 format)

Uniquement en sortie. ID de suivi des conversions du responsable du client. Ce paramètre est défini lorsque le client a activé le suivi des conversions multicomptes et remplace conversionTrackingId. Ce champ ne peut être géré que via l'interface utilisateur de Google Ads. Ce champ est en lecture seule.

RemarketingSetting

Paramètre de remarketing d'un client.

Représentation JSON 
{
  "googleGlobalSiteTag": string
}
Champs
googleGlobalSiteTag

string

Uniquement en sortie. La balise Google.

CustomerPayPerConversionEligibilityFailureReason

Énumération décrivant les raisons possibles pour lesquelles un client ne peut pas utiliser PaymentMode.CONVERSIONS.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
NOT_ENOUGH_CONVERSIONS Le client n'a pas enregistré suffisamment de conversions.
CONVERSION_LAG_TOO_HIGH Le délai avant conversion du client est trop long.
HAS_CAMPAIGN_WITH_SHARED_BUDGET Le client utilise des budgets partagés.
HAS_UPLOAD_CLICKS_CONVERSION Le client a généré des conversions avec ConversionActionType.UPLOAD_ visible.
AVERAGE_DAILY_SPEND_TOO_HIGH Les dépenses quotidiennes moyennes du client sont trop élevées.
ANALYSIS_NOT_COMPLETE L'éligibilité du client n'a pas encore été calculée par le backend Google Ads. Revenez plus tard.
OTHER Le Client n'est pas éligible pour d'autres raisons.

CustomerAgreementSetting

Paramètre du contrat client pour un client.

Représentation JSON 
{
  "acceptedLeadFormTerms": boolean
}
Champs
acceptedLeadFormTerms

boolean

Uniquement en sortie. Indique si le client a accepté les conditions d'utilisation du formulaire pour prospects.

LocalServicesSettings

Paramètres du client Local Services.

Représentation JSON 
{
  "granularLicenseStatuses": [
    {
      object (GranularLicenseStatus)
    }
  ],
  "granularInsuranceStatuses": [
    {
      object (GranularInsuranceStatus)
    }
  ]
}
Champs
granularLicenseStatuses[]

object (GranularLicenseStatus)

Uniquement en sortie. Liste en lecture seule des états de licence au niveau du secteur géographique.
granularInsuranceStatuses[]

object (GranularInsuranceStatus)

Uniquement en sortie. Liste en lecture seule des états d'assurance au niveau du secteur géographique.

GranularLicenseStatus

État de la licence au niveau géographique et vertical.

Représentation JSON 
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
Champs
geoCriterionId

string (int64 format)

Uniquement en sortie. ID du critère de cible géographique associé à l'état. Peut être défini au niveau géographique d'un pays ou d'un État/une province, en fonction des exigences et de la zone géographique. Pour en savoir plus, consultez la page https://developers.google.com/google-ads/api/data/geotargets.
categoryId

string

Uniquement en sortie. Catégorie de service associée à l'état. Exemple : xcat:service_area_business_plomberie. Pour en savoir plus, consultez la page https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids.
verificationStatus

enum (LocalServicesVerificationStatus)

Uniquement en sortie. État précis de la licence, par zone géographique et secteur.

LocalServicesVerificationStatus

Énumération décrivant l'état d'une catégorie de validation des annonces Local Services spécifique.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN État de validation inconnu.
NEEDS_REVIEW La validation a commencé, mais n'est pas terminée.
FAILED Échec de la validation.
PASSED Validation réussie.
NOT_APPLICABLE La validation n'est pas applicable.
NO_SUBMISSION Validation requise, mais en attente d'envoi.
PARTIAL_SUBMISSION Certaines des validations requises n'ont pas été envoyées.
PENDING_ESCALATION La validation doit être examinée par un spécialiste des opérations publicitaires Local Services.

GranularInsuranceStatus

Statut de l'assurance au niveau géographique et au niveau du secteur.

Représentation JSON 
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
Champs
geoCriterionId

string (int64 format)

Uniquement en sortie. ID du critère de cible géographique associé à l'état. Peut être défini au niveau géographique d'un pays ou d'un État/une province, en fonction des exigences et de la zone géographique. Pour en savoir plus, consultez la page https://developers.google.com/google-ads/api/data/geotargets.
categoryId

string

Uniquement en sortie. Catégorie de service associée à l'état. Exemple : xcat:service_area_business_plomberie. Pour en savoir plus, consultez la page https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids.
verificationStatus

enum (LocalServicesVerificationStatus)

Uniquement en sortie. État précis de l'assurance, par zone géographique et secteur.