Customer

• JSON 表示法
• CallReportingSetting
  • JSON 表示法
• ConversionTrackingSetting
  • JSON 表示法
• RemarketingSetting
  • JSON 表示法
• CustomerPayPerConversionEligibilityFailureReason
• CustomerAgreementSetting
  • JSON 表示法
• LocalServicesSettings
  • JSON 表示法
• GranularLicenseStatus
  • JSON 表示法
• LocalServicesVerificationStatus
• GranularInsuranceStatus
  • JSON 表示法

客戶。

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 }

欄位
resourceName	string 不可變動。客戶的資源名稱。客戶資源名稱的格式如下： customers/{customerId}
callReportingSetting	object (CallReportingSetting) 客戶的來電報表設定。只能在 update 作業中變動。
conversionTrackingSetting	object (ConversionTrackingSetting) 僅供輸出。客戶的轉換追蹤設定。
remarketingSetting	object (RemarketingSetting) 僅供輸出。客戶的再行銷設定。
payPerConversionEligibilityFailureReasons[]	enum (CustomerPayPerConversionEligibilityFailureReason) 僅供輸出。客戶無法使用 PaymentMode.CONVERSIONS 的原因。如果清單空白，表示客戶符合資格。這是唯讀欄位。
optimizationScoreWeight	number 僅供輸出。客戶的最佳化分數權重。 最佳化分數權重可用來比較/匯總多個非管理員客戶的最佳化分數。系統會將管理員的匯總最佳化分數，視為「Customer.optimization_score * Customer.optimization_score_weight」所有客戶的總和。對所有管理員客戶 (非管理員客戶) 來說，這個欄位的值為 0。 這是唯讀欄位。
status	enum (CustomerStatus) 僅供輸出。客戶的狀態。
customerAgreementSetting	object (CustomerAgreementSetting) 僅供輸出。客戶之客戶協議設定。
localServicesSettings	object (LocalServicesSettings) 僅供輸出。在地生活服務客戶的設定。
videoBrandSafetySuitability	enum (BrandSafetySuitability) 僅供輸出。帳戶層級的品牌安全設定。可透過選取廣告空間類型，讓廣告在符合品牌形象的內容中顯示。請參閱 https://support.google.com/google-ads/answer/7515513。
id	string (int64 format) 僅供輸出。客戶的 ID。
descriptiveName	string 選填的不重複客戶描述性名稱。
currencyCode	string 不可變動。帳戶運作方式的貨幣。系統支援部分 ISO 4217 標準的貨幣代碼。
timeZone	string 不可變動。客戶的當地時區 ID。
trackingUrlTemplate	string 使用參數建立追蹤網址的網址範本。只能在 update 作業中變動。
finalUrlSuffix	string 用於將參數附加至最終到達網址的網址範本。只能在 update 作業中變動。
autoTaggingEnabled	boolean 是否為客戶啟用自動標記功能。
hasPartnersBadge	boolean 僅供輸出。客戶是否有合作夥伴徽章。如果客戶未加入合作夥伴計畫，將視為無效。詳情請參閱 https://support.google.com/partners/answer/3125774。
manager	boolean 僅供輸出。客戶是否為經理。
testAccount	boolean 僅供輸出。客戶是否為測試帳戶。
optimizationScore	number 僅供輸出。客戶的最佳化分數。 最佳化分數可用來預估客戶的廣告活動效益。範圍介於 0% (0.0) 到 100% (1.0) 之間。對所有管理員客戶及未計分的非管理員客戶，這個欄位都是空值。 請參閱「關於最佳化分數」一文：https://support.google.com/google-ads/answer/9061546。 這是唯讀欄位。
locationAssetAutoMigrationDone	boolean 僅供輸出。如果以動態饋給為準的地點已遷移至素材資源型地點，則為 True。
imageAssetAutoMigrationDone	boolean 僅供輸出。如果動態饋給型圖片已遷移至素材資源型圖片，則為 True。
locationAssetAutoMigrationDoneDateTime	string 僅供輸出。從動態饋給位置遷移至資產基本位置的時間戳記，格式為 yyyy-MM-dd HH:mm:ss。
imageAssetAutoMigrationDoneDateTime	string 僅供輸出。從動態饋給型圖片遷移至素材資源基本圖片的時間戳記，格式為 yyyy-MM-dd HH:mm:ss。

CallReportingSetting

客戶的來電報表設定。只能在 update 作業中變動。

JSON 表示法
{ "callReportingEnabled": boolean, "callConversionReportingEnabled": boolean, "callConversionAction": string }

欄位
callReportingEnabled	boolean 透過 Google 系統重新導向來電事件，啟用回報功能。
callConversionReportingEnabled	boolean 是否要啟用來電轉換報表。
callConversionAction	string 可將來電轉換歸因於顧客層級的來電轉換動作。如果未設定，系統就會使用預設轉換動作。僅適用於 callConversionReportingEnabled 設為 true 時。

ConversionTrackingSetting

一系列與 Google Ads 轉換追蹤相關的顧客整體設定。

JSON 表示法
{ "acceptedCustomerDataTerms": boolean, "conversionTrackingStatus": enum (ConversionTrackingStatus), "enhancedConversionsForLeadsEnabled": boolean, "googleAdsConversionCustomer": string, "conversionTrackingId": string, "crossAccountConversionTrackingId": string }

欄位
acceptedCustomerDataTerms	boolean 僅供輸出。客戶是否已接受顧客數位資料條款。如果使用跨帳戶轉換追蹤，這個值會沿用管理員帳戶。這是唯讀欄位。詳情請參閱 https://support.google.com/adspolicy/answer/7475709。
conversionTrackingStatus	enum (ConversionTrackingStatus) 僅供輸出。轉換追蹤狀態。它會指出客戶是否使用轉換追蹤，以及這位客戶的轉換追蹤擁有者。如果這位客戶採用跨帳戶轉換追蹤功能，傳回的值會因要求的 login-customer-id 而異。
enhancedConversionsForLeadsEnabled	boolean 僅供輸出。客戶是否選擇採用待開發客戶強化轉換。如果使用跨帳戶轉換追蹤，這個值會沿用管理員帳戶。這是唯讀欄位。
googleAdsConversionCustomer	string 僅供輸出。建立及管理轉換的客戶資源名稱。這是唯讀欄位。
conversionTrackingId	string (int64 format) 僅供輸出。這個帳戶使用的轉換追蹤 ID。這個 ID 不會指出客戶是否使用轉換追蹤 (conversionTrackingStatus 適用)。這是唯讀欄位。
crossAccountConversionTrackingId	string (int64 format) 僅供輸出。客戶經理的轉換追蹤 ID。這個設定會在客戶採用跨帳戶轉換追蹤時設定，且會覆寫 conversionTrackingId。這個欄位只能透過 Google Ads 使用者介面管理。這是唯讀欄位。

RemarketingSetting

客戶的再行銷設定。

JSON 表示法
{ "googleGlobalSiteTag": string }

欄位
googleGlobalSiteTag	string 僅供輸出。Google 代碼。

CustomerPayPerConversionEligibilityFailureReason

說明客戶無法使用 PaymentMode.CONVERSIONS 的可能原因。

列舉
UNSPECIFIED	未指定。
UNKNOWN	僅用於傳回值。代表這個版本未知的值。
NOT_ENOUGH_CONVERSIONS	客戶的轉換量不足。
CONVERSION_LAG_TOO_HIGH	客戶的轉換時間差過高。
HAS_CAMPAIGN_WITH_SHARED_BUDGET	客戶使用共用預算。
HAS_UPLOAD_CLICKS_CONVERSION	客戶使用 ConversionActionType.UPLOAD_CLICK 獲得轉換。
AVERAGE_DAILY_SPEND_TOO_HIGH	客戶的平均每日支出過高。
ANALYSIS_NOT_COMPLETE	Google Ads 後端尚未計算客戶的資格。請過一陣子再試試看。
OTHER	客戶因其他原因而不符資格。

CustomerAgreementSetting

客戶之客戶協議設定。

JSON 表示法
{ "acceptedLeadFormTerms": boolean }

欄位
acceptedLeadFormTerms	boolean 僅供輸出。客戶是否已接受待開發客戶表單服務條款。

LocalServicesSettings

在地生活服務客戶的設定。

JSON 表示法
{ "granularLicenseStatuses": [ { object (GranularLicenseStatus) } ], "granularInsuranceStatuses": [ { object (GranularInsuranceStatus) } ] }

欄位
granularLicenseStatuses[]	object (GranularLicenseStatus) 僅供輸出。地理區域垂直層級執照狀態的唯讀清單。
granularInsuranceStatuses[]	object (GranularInsuranceStatus) 僅供輸出。地理區域垂直層級保險狀態的唯讀清單。

GranularLicenseStatus

提供地理區域和產業層級的授權狀態。

JSON 表示法
{ "geoCriterionId": string, "categoryId": string, "verificationStatus": enum (LocalServicesVerificationStatus) }

欄位
geoCriterionId	string (int64 format) 僅供輸出。與狀態相關聯的指定地理區域條件 ID。視規定和地點而定，可能是國家/地區或州/省的地理區域層級。詳情請參閱 https://developers.google.com/google-ads/api/data/geotargets。
categoryId	string 僅供輸出。與狀態相關聯的服務類別。例如「xcat:service_area_business_plumber」。詳情請參閱：https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
verificationStatus	enum (LocalServicesVerificationStatus) 僅供輸出。精細授權狀態，以地理區域和產業為單位。

LocalServicesVerificationStatus

以列舉方式說明特定在地生活服務廣告驗證類別的狀態。

列舉
UNSPECIFIED	未指定。
UNKNOWN	驗證狀態不明。
NEEDS_REVIEW	驗證作業已開始，但尚未完成。
FAILED	驗證失敗。
PASSED	驗證已通過。
NOT_APPLICABLE	無法進行驗證。
NO_SUBMISSION	必須進行驗證，但尚待提交。
PARTIAL_SUBMISSION	您並未提交所有必要的驗證資訊。
PENDING_ESCALATION	在地生活服務廣告營運專員必須審核驗證程序。

GranularInsuranceStatus

按地理區域 + 產業層級的保險狀態。

JSON 表示法
{ "geoCriterionId": string, "categoryId": string, "verificationStatus": enum (LocalServicesVerificationStatus) }

欄位
geoCriterionId	string (int64 format) 僅供輸出。與狀態相關聯的指定地理區域條件 ID。視規定和地點而定，可能是國家/地區或州/省的地理區域層級。詳情請參閱 https://developers.google.com/google-ads/api/data/geotargets。
categoryId	string 僅供輸出。與狀態相關聯的服務類別。例如「xcat:service_area_business_plumber」。詳情請參閱：https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
verificationStatus	enum (LocalServicesVerificationStatus) 僅供輸出。精細保險狀態 (按地理區域 + 產業劃分)。