Customer

A customer.

JSON representation 
{
  "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
}
Fields
resourceName

string

Immutable. The resource name of the customer. Customer resource names have the form:

customers/{customerId}
callReportingSetting

object (CallReportingSetting)

Call reporting setting for a customer. Only mutable in an update operation.
conversionTrackingSetting

object (ConversionTrackingSetting)

Output only. Conversion tracking setting for a customer.
remarketingSetting

object (RemarketingSetting)

Output only. Remarketing setting for a customer.
payPerConversionEligibilityFailureReasons[]

enum (CustomerPayPerConversionEligibilityFailureReason)

Output only. Reasons why the customer is not eligible to use PaymentMode.CONVERSIONS. If the list is empty, the customer is eligible. This field is read-only.
optimizationScoreWeight

number

Output only. Optimization score weight of the customer.

Optimization score weight can be used to compare/aggregate optimization scores across multiple non-manager customers. The aggregate optimization score of a manager is computed as the sum over all of their customers of Customer.optimization_score * Customer.optimization_score_weight. This field is 0 for all manager customers, and for unscored non-manager customers.

This field is read-only.
status

enum (CustomerStatus)

Output only. The status of the customer.
customerAgreementSetting

object (CustomerAgreementSetting)

Output only. Customer Agreement Setting for a customer.
localServicesSettings

object (LocalServicesSettings)

Output only. Settings for Local Services customer.
videoBrandSafetySuitability

enum (BrandSafetySuitability)

Output only. Brand Safety setting at the account level. Allows for selecting an inventory type to show your ads on content that is the right fit for your brand. See https://support.google.com/google-ads/answer/7515513.
id

string (int64 format)

Output only. The ID of the customer.
descriptiveName

string

Optional, non-unique descriptive name of the customer.
currencyCode

string

Immutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
timeZone

string

Immutable. The local timezone ID of the customer.
trackingUrlTemplate

string

The URL template for constructing a tracking URL out of parameters. Only mutable in an update operation.
finalUrlSuffix

string

The URL template for appending params to the final URL. Only mutable in an update operation.
autoTaggingEnabled

boolean

Whether auto-tagging is enabled for the customer.
hasPartnersBadge

boolean

Output only. Whether the Customer has a Partners program badge. If the Customer is not associated with the Partners program, this will be false. For more information, see https://support.google.com/partners/answer/3125774.
manager

boolean

Output only. Whether the customer is a manager.
testAccount

boolean

Output only. Whether the customer is a test account.
optimizationScore

number

Output only. Optimization score of the customer.

Optimization score is an estimate of how well a customer's campaigns are set to perform. It ranges from 0% (0.0) to 100% (1.0). This field is null for all manager customers, and for unscored non-manager customers.

See "About optimization score" at https://support.google.com/google-ads/answer/9061546.

This field is read-only.
locationAssetAutoMigrationDone

boolean

Output only. True if feed based location has been migrated to asset based location.
imageAssetAutoMigrationDone

boolean

Output only. True if feed based image has been migrated to asset based image.
locationAssetAutoMigrationDoneDateTime

string

Output only. Timestamp of migration from feed based location to asset base location in yyyy-MM-dd HH:mm:ss format.
imageAssetAutoMigrationDoneDateTime

string

Output only. Timestamp of migration from feed based image to asset base image in yyyy-MM-dd HH:mm:ss format.

CallReportingSetting

Call reporting setting for a customer. Only mutable in an update operation.

JSON representation 
{
  "callReportingEnabled": boolean,
  "callConversionReportingEnabled": boolean,
  "callConversionAction": string
}
Fields
callReportingEnabled

boolean

Enable reporting of phone call events by redirecting them through Google System.
callConversionReportingEnabled

boolean

Whether to enable call conversion reporting.
callConversionAction

string

Customer-level call conversion action to attribute a call conversion to. If not set a default conversion action is used. Only in effect when callConversionReportingEnabled is set to true.

ConversionTrackingSetting

A collection of customer-wide settings related to Google Ads Conversion Tracking.

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

boolean

Output only. Whether the customer has accepted customer data terms. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only. For more information, see https://support.google.com/adspolicy/answer/7475709.
conversionTrackingStatus

enum (ConversionTrackingStatus)

Output only. Conversion tracking status. It indicates whether the customer is using conversion tracking, and who is the conversion tracking owner of this customer. If this customer is using cross-account conversion tracking, the value returned will differ based on the login-customer-id of the request.
enhancedConversionsForLeadsEnabled

boolean

Output only. Whether the customer is opted-in for enhanced conversions for leads. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only.
googleAdsConversionCustomer

string

Output only. The resource name of the customer where conversions are created and managed. This field is read-only.
conversionTrackingId

string (int64 format)

Output only. The conversion tracking id used for this account. This id doesn't indicate whether the customer uses conversion tracking (conversionTrackingStatus does). This field is read-only.
crossAccountConversionTrackingId

string (int64 format)

Output only. The conversion tracking id of the customer's manager. This is set when the customer is opted into cross account conversion tracking, and it overrides conversionTrackingId. This field can only be managed through the Google Ads UI. This field is read-only.

RemarketingSetting

Remarketing setting for a customer.

JSON representation 
{
  "googleGlobalSiteTag": string
}
Fields
googleGlobalSiteTag

string

Output only. The Google tag.

CustomerPayPerConversionEligibilityFailureReason

Enum describing possible reasons a customer is not eligible to use PaymentMode.CONVERSIONS.

Enums
UNSPECIFIED Not specified.
UNKNOWN Used for return value only. Represents value unknown in this version.
NOT_ENOUGH_CONVERSIONS Customer does not have enough conversions.
CONVERSION_LAG_TOO_HIGH Customer's conversion lag is too high.
HAS_CAMPAIGN_WITH_SHARED_BUDGET Customer uses shared budgets.
HAS_UPLOAD_CLICKS_CONVERSION Customer has conversions with ConversionActionType.UPLOAD_CLICKS.
AVERAGE_DAILY_SPEND_TOO_HIGH Customer's average daily spend is too high.
ANALYSIS_NOT_COMPLETE Customer's eligibility has not yet been calculated by the Google Ads backend. Check back soon.
OTHER Customer is not eligible due to other reasons.

CustomerAgreementSetting

Customer Agreement Setting for a customer.

JSON representation 
{
  "acceptedLeadFormTerms": boolean
}
Fields
acceptedLeadFormTerms

boolean

Output only. Whether the customer has accepted lead form term of service.

LocalServicesSettings

Settings for Local Services customer.

JSON representation 
{
  "granularLicenseStatuses": [
    {
      object (GranularLicenseStatus)
    }
  ],
  "granularInsuranceStatuses": [
    {
      object (GranularInsuranceStatus)
    }
  ]
}
Fields
granularLicenseStatuses[]

object (GranularLicenseStatus)

Output only. A read-only list of geo vertical level license statuses.
granularInsuranceStatuses[]

object (GranularInsuranceStatus)

Output only. A read-only list of geo vertical level insurance statuses.

GranularLicenseStatus

License status at geo + vertical level.

JSON representation 
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
Fields
geoCriterionId

string (int64 format)

Output only. Geotarget criterion ID associated with the status. Can be on country or state/province geo level, depending on requirements and location. See https://developers.google.com/google-ads/api/data/geotargets for more information.
categoryId

string

Output only. Service category associated with the status. For example, xcat:service_area_business_plumber. For more details see: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
verificationStatus

enum (LocalServicesVerificationStatus)

Output only. Granular license status, per geo + vertical.

LocalServicesVerificationStatus

Enum describing status of a particular Local Services Ads verification category.

Enums
UNSPECIFIED Not specified.
UNKNOWN Unknown verification status.
NEEDS_REVIEW Verification has started, but has not finished.
FAILED Verification has failed.
PASSED Verification has passed.
NOT_APPLICABLE Verification is not applicable.
NO_SUBMISSION Verification is required but pending submission.
PARTIAL_SUBMISSION Not all required verification has been submitted.
PENDING_ESCALATION Verification needs review by Local Services Ads Ops Specialist.

GranularInsuranceStatus

Insurance status at geo + vertical level.

JSON representation 
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
Fields
geoCriterionId

string (int64 format)

Output only. Geotarget criterion ID associated with the status. Can be on country or state/province geo level, depending on requirements and location. See https://developers.google.com/google-ads/api/data/geotargets for more information.
categoryId

string

Output only. Service category associated with the status. For example, xcat:service_area_business_plumber. For more details see: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
verificationStatus

enum (LocalServicesVerificationStatus)

Output only. Granular insurance status, per geo + vertical.