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)
  },
  "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. Les noms de ressources client se présentent 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 n'est pas autorisé à 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 score 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 responsables. Le score d'optimisation global d'un administrateur correspond à la somme de tous ses clients dans Customer.optimization_score * Customer.optimization_score_weight. Ce champ est défini sur 0 pour tous les clients administrateurs et pour ceux qui n'ont pas été évalués.

Ce champ est en lecture seule.
status

enum (CustomerStatus)

Uniquement en sortie. État du client.
customerAgreementSetting

object (CustomerAgreementSetting)

Uniquement en sortie. Définition du contrat client pour un client.
localServicesSettings

object (LocalServicesSettings)

Uniquement en sortie. Paramètres du client Local Services.
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 valeur est "false". 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 administrateur.
testAccount

boolean

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

number

Uniquement en sortie. Taux d'optimisation du client.

Le taux d'optimisation fournit une estimation des performances potentielles des campagnes d'un client. Il est compris entre 0% (0,0) et 100% (1,0). Ce champ est vide pour tous les clients administrateur et pour les clients non-administrateur non notés.

Pour en savoir plus, 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 l'emplacement basé sur un flux a été migré vers un emplacement basé sur des assets.
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 assets.
locationAssetAutoMigrationDoneDateTime

string

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

string

Uniquement en sortie. Code temporel de la migration de l'image basée sur le flux vers l'image de base de l'asset, 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. Cela ne s'applique que lorsque callConversionReportingEnabled est défini sur "true".

ConversionTrackingSetting

Ensemble de paramètres liés au suivi des conversions Google Ads à l'échelle 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 ce client utilise le suivi des conversions multicomptes, la valeur renvoyée sera différente 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 où 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 active le suivi des conversions multicomptes et remplace conversionTrackingId. Ce champ ne peut être géré que via l'interface utilisateur Google Ads. Ce champ est en lecture seule.

ConversionTrackingStatus

État du suivi des conversions du client.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
NOT_CONVERSION_TRACKED Le Client n'utilise aucun suivi des conversions.
CONVERSION_TRACKING_MANAGED_BY_SELF Les actions de conversion sont créées et gérées par ce client.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER Les actions de conversion sont créées et gérées par le gestionnaire spécifié dans le login-customer-id de la requête.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER Les actions de conversion sont créées et gérées par un administrateur différent du client ou de l'administrateur spécifié dans le login-customer-id de la requête.

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 n'est pas autorisé à 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 enregistré des conversions avec ConversionActionType.UPLOAD_CL.
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

Définition 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 des licences géographiques au niveau sectoriel.
granularInsuranceStatuses[]

object (GranularInsuranceStatus)

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

GranularLicenseStatus

État de la licence aux niveaux 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. Il peut s'agir du niveau géographique du pays ou de l'État/la 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. (par exemple, xcat:service_area_entreprise_plombier). 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 Annonces Local Services particulière.

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 La validation est obligatoire, mais l'envoi est en attente.
PARTIAL_SUBMISSION Certaines validations requises n'ont pas été envoyées.
PENDING_ESCALATION La validation doit être examinée par un spécialiste des opérations des annonces 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. Il peut s'agir du niveau géographique du pays ou de l'État/la 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. (par exemple, xcat:service_area_entreprise_plombier). 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.