Customer

• JSON 表示法
• CallReportingSetting
  • JSON 表示法
• ConversionTrackingSetting
  • JSON 表示法
• ConversionTrackingStatus
• 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) }, "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) 僅供輸出。「在地生活服務」客戶的設定。
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 使用者介面管理。這是唯讀欄位。

ConversionTrackingStatus

客戶的轉換追蹤狀態。

列舉
UNSPECIFIED	未指定。
UNKNOWN	僅適用於傳回值。代表此版本中未知的值。
NOT_CONVERSION_TRACKED	客戶未使用任何轉換追蹤。
CONVERSION_TRACKING_MANAGED_BY_SELF	轉換動作是由這個客戶建立及管理。
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER	轉換動作是由要求 login-customer-id 中指定的管理員建立及管理。
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER	轉換動作是由管理員建立及管理，而不是由要求 login-customer-id 中指定的客戶或管理員不同。

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_叢集 的轉換。
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) 僅供輸出。按地理區域和產業區分的精細保險狀態。