Caution: You are viewing documentation for the API's REST interface. Most of our official client libraries use gRPC. See the REST Introduction for details.

Customer

A customer.

JSON representation 
{
  "resourceName": string,
  "callReportingSetting": {
    object (CallReportingSetting)
  },
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "remarketingSetting": {
    object (RemarketingSetting)
  },
  "payPerConversionEligibilityFailureReasons": [
    enum (CustomerPayPerConversionEligibilityFailureReason)
  ],
  "optimizationScoreWeight": number,
  "status": enum (CustomerStatus),
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "hasPartnersBadge": boolean,
  "manager": boolean,
  "testAccount": boolean,
  "optimizationScore": number
}
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.
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.

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.

ConversionTrackingStatus

Conversion Tracking status of the customer.

Enums
UNSPECIFIED Not specified.
UNKNOWN Used for return value only. Represents value unknown in this version.
NOT_CONVERSION_TRACKED Customer does not use any conversion tracking.
CONVERSION_TRACKING_MANAGED_BY_SELF The conversion actions are created and managed by this customer.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER The conversion actions are created and managed by the manager specified in the request's login-customer-id.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER The conversion actions are created and managed by a manager different from the customer or manager specified in the request's login-customer-id.

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.