Customer

客戶。

JSON 表示法 
{
  "resourceName": string,
  "callReportingSetting": {
    object (CallReportingSetting)
  },
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "remarketingSetting": {
    object (RemarketingSetting)
  },
  "payPerConversionEligibilityFailureReasons": [
    enum (CustomerPayPerConversionEligibilityFailureReason)
  ],
  "optimizationScoreWeight": number,
  "status": enum (CustomerStatus),
  "offlineConversionClientSummaries": [
    {
      object (OfflineConversionClientSummary)
    }
  ],
  "customerAgreementSetting": {
    object (CustomerAgreementSetting)
  },
  "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)

僅供輸出。客戶的狀態。
offlineConversionClientSummaries[]

object (OfflineConversionClientSummary)

僅供輸出。離線轉換上傳診斷資料。
customerAgreementSetting

object (CustomerAgreementSetting)

僅供輸出。客戶的客戶協議設定。
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 客戶因其他原因而不符資格。

OfflineConversionClientSummary

由客戶匯總離線轉換上傳診斷診斷結果。這個通訊協定包含一般資訊，按日期/工作細分資料，以及離線轉換上傳結果的快訊。

JSON 表示法 
{
  "client": enum (OfflineEventUploadClient),
  "status": enum (OfflineConversionDiagnosticStatus),
  "totalEventCount": string,
  "successfulEventCount": string,
  "successRate": number,
  "lastUploadDateTime": string,
  "dailySummaries": [
    {
      object (OfflineConversionUploadSummary)
    }
  ],
  "jobSummaries": [
    {
      object (OfflineConversionUploadSummary)
    }
  ],
  "alerts": [
    {
      object (OfflineConversionUploadAlert)
    }
  ]
}
欄位
client

enum (OfflineEventUploadClient)

僅供輸出。上傳事件的用戶端類型。
status

enum (OfflineConversionDiagnosticStatus)

僅供輸出。離線轉換客戶摘要的整體狀態。系統是根據最近一天的上傳統計資料產生狀態。
totalEventCount

string (int64 format)

僅供輸出。上傳的事件總數。
successfulEventCount

string (int64 format)

僅供輸出。成功上傳事件的總數。
successRate

number

僅供輸出。成功率。
lastUploadDateTime

string

僅供輸出。最新上傳批次的日期。
dailySummaries[]

object (OfflineConversionUploadSummary)

僅供輸出。最近 N 天的記錄統計資料摘要。
jobSummaries[]

object (OfflineConversionUploadSummary)

僅供輸出。最近 N 項工作的記錄統計資料摘要。
alerts[]

object (OfflineConversionUploadAlert)

僅供輸出。每個錯誤代碼的詳細資料。快訊是根據最近一天的上傳統計資料產生。

OfflineEventUploadClient

用戶端類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅適用於傳回值。代表此版本中未知的值。
GOOGLE_ADS_API Google Ads API。
GOOGLE_ADS_WEB_CLIENT Google Ads 網路用戶端，當中可能包含多個來源，例如 Google Ads UI、SFTP 等。
ADS_DATA_CONNECTOR 連線平台。

OfflineConversionDiagnosticStatus

離線擷取設定可能的狀態。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅適用於傳回值。代表此版本中未知的值。
EXCELLENT 離線資料擷取設定已啟用，且最適合下游處理。
GOOD 離線擷取設定已啟用，但仍有改善空間。查看快訊。
NEEDS_ATTENTION 離線擷取設定已啟用，但有錯誤，請您留意。查看快訊。
NO_RECENT_UPLOAD 離線擷取設定在過去 28 天內未收到任何資料，其中可能發生問題。

OfflineConversionUploadSummary

歷來上傳摘要，按照上傳日期或工作分組。

JSON 表示法 
{
  "successfulCount": string,
  "failedCount": string,

  // Union field dimension_key can be only one of the following:
  "jobId": string,
  "uploadDate": string
  // End of list of possible types for union field dimension_key.
}
欄位
successfulCount

string (int64 format)

僅供輸出。成功事件總數。
failedCount

string (int64 format)

僅供輸出。失敗的事件總數。
聯集欄位 dimension_key。摘要的維度鍵。dimension_key 只能是下列其中一項：
jobId

string (int64 format)

僅供輸出。最近 N 個工作的維度鍵。
uploadDate

string

僅供輸出。最近 N 天的維度鍵。

OfflineConversionUploadAlert

離線轉換用戶端摘要的快訊。

JSON 表示法 
{
  "error": {
    object (OfflineConversionUploadError)
  },
  "errorPercentage": number
}
欄位
error

object (OfflineConversionUploadError)

僅供輸出。離線轉換用戶端快訊錯誤。
errorPercentage

number

僅供輸出。錯誤百分比。

OfflineConversionUploadError

離線轉換用戶端摘要可能發生錯誤。

JSON 表示法 
{

  // Union field error_code can be only one of the following:
  "collectionSizeError": enum (CollectionSizeError),
  "conversionAdjustmentUploadError": enum (ConversionAdjustmentUploadError),
  "conversionUploadError": enum (ConversionUploadError),
  "dateError": enum (DateError),
  "distinctError": enum (DistinctError),
  "fieldError": enum (FieldError),
  "mutateError": enum (MutateError),
  "notAllowlistedError": enum (NotAllowlistedError),
  "stringFormatError": enum (StringFormatError),
  "stringLengthError": enum (StringLengthError)
  // End of list of possible types for union field error_code.
}
欄位
聯集欄位 error_code。說明有誤。error_code 只能是下列其中一項：
collectionSizeError

enum (CollectionSizeError)

僅供輸出。集合大小錯誤。
conversionAdjustmentUploadError

enum (ConversionAdjustmentUploadError)

僅供輸出。轉換調整項上傳錯誤。
conversionUploadError

enum (ConversionUploadError)

僅供輸出。轉換上傳錯誤。
dateError

enum (DateError)

僅供輸出。日期錯誤。
distinctError

enum (DistinctError)

僅供輸出。不重複錯誤。
fieldError

enum (FieldError)

僅供輸出。欄位錯誤。
mutateError

enum (MutateError)

僅供輸出。更改錯誤。
notAllowlistedError

enum (NotAllowlistedError)

僅供輸出。未加入許可清單的錯誤。
stringFormatError

enum (StringFormatError)

僅供輸出。字串格式錯誤。
stringLengthError

enum (StringLengthError)

僅供輸出。字串長度錯誤。

CollectionSizeError

列舉可能的集合大小錯誤。

列舉
UNSPECIFIED 未指定列舉。
UNKNOWN 這個版本不知道收到的錯誤代碼。
TOO_FEW 太少，
TOO_MANY 太多人。

ConversionAdjustmentUploadError

列舉可能的轉換調整項上傳錯誤。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅適用於傳回值。代表此版本中未知的值。
TOO_RECENT_CONVERSION_ACTION 無法將事件匯入剛建立的轉換動作。請於 6 小時後再次嘗試匯入。
INVALID_CONVERSION_ACTION 請務必指定可調整的有效轉換動作。
CONVERSION_ALREADY_RETRACTED 轉換已撤銷，因此系統並未處理這項調整項。
CONVERSION_NOT_FOUND 找不到與這個轉換動作和轉換 ID 相對應的轉換。請確認轉換 ID 連結至正確的轉換動作，然後再試一次。
CONVERSION_EXPIRED 無法對發生時間超過 54 天的轉換進行調整。
ADJUSTMENT_PRECEDES_CONVERSION 調整項包含發生在相關轉換之前的adjustmentDateTime。請確認你的 adjustmentDateTime 正確無誤，然後再試一次。
MORE_RECENT_RESTATEMENT_FOUND 系統已針對相關轉換記錄較近期的調整項 adjustmentDateTime。請確認調整項 adjustmentDateTime 正確無誤，然後再試一次。
TOO_RECENT_CONVERSION 轉換發生時間太近，因此無法記錄調整項。請調整發生超過 24 個小時的轉換。
CANNOT_RESTATE_CONVERSION_ACTION_THAT_ALWAYS_USES_DEFAULT_CONVERSION_VALUE 無法對設為使用預設值的轉換進行調整。請檢查轉換動作價值設定，然後再試一次。
TOO_MANY_ADJUSTMENTS_IN_REQUEST 在單一 API 要求中上傳的調整項必須少於 2,001 個。
TOO_MANY_ADJUSTMENTS 轉換的次數已調整上限。請務必只對現有轉換進行必要的調整。
RESTATEMENT_ALREADY_EXISTS 轉換先前已以相同的 adjustmentDateTime 重編。請確認調整項含有正確且專屬的adjustmentDateTime，然後再試一次。
DUPLICATE_ADJUSTMENT_IN_REQUEST 匯入的調整項含有重複的轉換調整項 (為adjustmentDateTime)。請確認調整項的adjustmentDateTime正確無誤，然後再試一次。
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS 請務必同意轉換設定中的客戶資料處理條款，然後再試一次。
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT 無法搭配指定的轉換動作使用強化轉換。
INVALID_USER_IDENTIFIER 請務必使用 SHA-256 對使用者提供的資料進行雜湊處理，並確實按照規範進行正規化處理。
UNSUPPORTED_USER_IDENTIFIER 請利用使用者提供的資料 (例如電子郵件或電話號碼) 使用 SHA-256 雜湊處理，然後再試一次。
GCLID_DATE_TIME_PAIR_AND_ORDER_ID_BOTH_SET 無法同時設定 gclidDateTimePair 和 orderId。請只使用其中 1 種類型，然後再試一次。
CONVERSION_ALREADY_ENHANCED 轉換已包含具有相同訂單 ID 和轉換動作的強化項目。請確認資料設定正確無誤，然後再試一次。
DUPLICATE_ENHANCEMENT_IN_REQUEST 多個強化項目具有相同的轉換動作和訂單 ID。請確認資料設定正確無誤，然後再試一次。
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCEMENT 根據 Google 客戶資料政策，這個帳戶無法使用強化轉換。請與您的 Google 代表聯絡。
MISSING_ORDER_ID_FOR_WEBPAGE 網站轉換調整項需要訂單 ID (即交易 ID)。請確認網站代碼會擷取訂單 ID，且相同的訂單 ID 會連同調整項一併送出。
ORDER_ID_CONTAINS_PII 調整項的訂單 ID 含有個人識別資訊 (PII)，因此無法使用。

ConversionUploadError

以列舉方式說明可能的轉換上傳錯誤。

列舉
UNSPECIFIED 未指定列舉。
UNKNOWN 僅適用於傳回值。代表此版本中未知的值。
TOO_MANY_CONVERSIONS_IN_REQUEST 在單一要求中上傳的事件少於 2,001 個。
UNPARSEABLE_GCLID 無法解碼匯入的 Google 點擊 ID。確認您並未修改點擊 ID。
CONVERSION_PRECEDES_EVENT 匯入事件的 conversionDateTime 早於點擊。請確認你的 conversionDateTime 正確無誤，然後再試一次。
EXPIRED_EVENT 此轉換的點擊時間早於點閱後回溯期，因此無法記錄匯入的事件。請確認您匯入的是最新資料。
TOO_RECENT_EVENT 與指定 ID 或 iOS 網址參數相關的點擊發生時間不到 6 小時。請於 6 小時後再試。
EVENT_NOT_FOUND 匯入的事件無法歸因於特定點擊。原因可能是該事件並非來自 Google Ads 廣告活動。
UNAUTHORIZED_CUSTOMER 點擊 ID 或來電連結至您無權存取的 Google Ads 帳戶。請確認要匯入轉換資料的帳戶由您的管理員帳戶管理。
INVALID_CONVERSION_ACTION 請確認您已為離線匯入設定有效的轉換動作。
TOO_RECENT_CONVERSION_ACTION 無法將事件匯入剛建立的轉換動作。請於 6 小時後再次嘗試匯入。
CONVERSION_TRACKING_NOT_ENABLED_AT_IMPRESSION_TIME 點擊時，該次點擊 Google Ads 帳戶的有效轉換帳戶中並未啟用轉換追蹤。
EXTERNAL_ATTRIBUTION_DATA_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION 匯入的事件包含外部歸因資料，但轉換動作並未設為使用外部歸因模式。請確認轉換動作設定正確無誤，然後再試一次。
EXTERNAL_ATTRIBUTION_DATA_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION 轉換動作已設為使用外部歸因模式，但匯入的事件缺少資料。請確認匯入的事件包含外部歸因功勞，以及所有必要欄位。
ORDER_ID_NOT_PERMITTED_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION 訂單 ID 不適用於使用外部歸因模式評估的轉換。請確認轉換設定正確無誤，且匯入的事件僅包含必要資料，然後再試一次。
ORDER_ID_ALREADY_IN_USE 匯入的事件包含先前記錄的訂單 ID，因此無法處理。
DUPLICATE_ORDER_ID 匯入的事件包含具有相同訂單 ID 的多個轉換，因此無法處理。請確認訂單 ID 並未重複，然後再試一次。
TOO_RECENT_CALL 無法匯入發生不到 6 小時前的來電。請於 6 小時後再次嘗試上傳。
EXPIRED_CALL 通話發生時間早於這個轉換動作的回溯期，因此無法記錄。並務必設定匯入功能，以取得最新資料。
CALL_NOT_FOUND 找不到促成匯入事件的通話或點擊。確認資料來源設定包含正確的 ID。
CONVERSION_PRECEDES_CALL 呼叫的 conversionDateTime 早於相關聯點擊。請確認您的 conversionDateTime 正確無誤。
CONVERSION_TRACKING_NOT_ENABLED_AT_CALL_TIME 匯入來電時，點擊 Google Ads 帳戶的有效轉換帳戶未啟用轉換追蹤。
UNPARSEABLE_CALLERS_PHONE_NUMBER 請確定電話號碼格式為 E.164 (+16502531234)、國際 (+64 3-331 6005) 或美國國內電話號碼 (6502531234)。
CLICK_CONVERSION_ALREADY_EXISTS 匯入的事件與現有轉換具有相同的點擊次數和 conversionDateTime。請為每個不重複的活動使用專屬的 conversionDateTime 或訂單 ID，然後再試一次。
CALL_CONVERSION_ALREADY_EXISTS 匯入的來電與現有轉換的 conversionDateTime 相同。請確認 conversionDateTime 設定正確無誤，然後再試一次。
DUPLICATE_CLICK_CONVERSION_IN_REQUEST 多個事件有相同的點擊和 conversionDateTime。請確認 conversionDateTime 設定正確無誤，然後再試一次。
DUPLICATE_CALL_CONVERSION_IN_REQUEST 多項事件具有相同的呼叫和 conversionDateTime。請確認 conversionDateTime 設定正確無誤，然後再試一次。
CUSTOM_VARIABLE_NOT_ENABLED 請在轉換設定中啟用自訂變數，然後再試一次。
CUSTOM_VARIABLE_VALUE_CONTAINS_PII 事件的自訂變數包含個人識別資訊 (PII)，因此無法匯入。請移除這些變數，然後再試一次。
INVALID_CUSTOMER_FOR_CLICK 匯入事件中的點擊連結至其他 Google Ads 帳戶。請確認您匯入至正確的帳戶。
INVALID_CUSTOMER_FOR_CALL 來電點擊與不同的 Google Ads 帳戶相關聯。請確認您匯入至正確的帳戶。對客戶查詢 conversionTrackingSetting.google_ads_conversion_customer，以找出正確的帳戶。
CONVERSION_NOT_COMPLIANT_WITH_ATT_POLICY 轉換來源不符合 Apple 應用程式資訊公開追蹤 (ATT) 政策的規定，或客戶不同意追蹤，因此無法匯入轉換版本。
CLICK_NOT_FOUND 系統無法將這個事件的電子郵件地址或電話號碼對應至任何點擊。這可能是因為該事件不是由 Google Ads 廣告活動促成，您可以放心忽略這則警告。如果包含的匯入事件數量超出預期，建議您檢查設定。
INVALID_USER_IDENTIFIER 請務必使用 SHA-256 對使用者提供的資料進行雜湊處理，並確實按照規範進行正規化處理。
EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION_NOT_PERMITTED_WITH_USER_IDENTIFIER 使用者提供的資料無法與外部歸因模式搭配使用。請改用其他歸因模式或省略使用者 ID，然後再試一次。
UNSUPPORTED_USER_IDENTIFIER 不支援您提供的使用者 ID。請只使用經過雜湊處理的電子郵件或電話號碼，然後再試一次。
GBRAID_WBRAID_BOTH_SET 無法同時使用 gbraid 和 wbraid 參數。請只使用其中一個參數，然後再試一次。
UNPARSEABLE_WBRAID 無法剖析事件匯入資料。請檢查 wbraid 參數是否未修改，然後再試一次。
UNPARSEABLE_GBRAID 無法剖析事件匯入資料。請檢查 gbraid 參數是否遭到修改，然後再試一次。
ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID 採用單次點擊單次轉換計算設定的轉換動作無法與 gbraid 或 wbraid 參數搭配使用。
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS 根據 Google 客戶資料政策，這個帳戶無法使用強化轉換。請與您的 Google 代表聯絡。
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS 請務必同意轉換設定中的客戶資料處理條款，然後再試一次。如需檢查設定，請在客戶上查詢 conversionTrackingSetting.accepted_customer_data_terms。
ORDER_ID_CONTAINS_PII 事件的訂單 ID 包含個人識別資訊 (PII)，因此無法匯入。
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS 請確認已在轉換設定中啟用待開發客戶強化轉換，然後再試一次。您可以在客戶上查詢 conversionTrackingSetting.Enhanced_conversions_for_leads_enabled 來檢查設定。

DateError

以列舉方式說明可能的日期錯誤。

列舉
UNSPECIFIED 未指定列舉。
UNKNOWN 這個版本不知道收到的錯誤代碼。
INVALID_FIELD_VALUES_IN_DATE 必須提供有效的日期。
INVALID_FIELD_VALUES_IN_DATE_TIME 必須提供有效的日期時間。
INVALID_STRING_DATE 字串的日期格式必須為 yyyy-mm-dd。
INVALID_STRING_DATE_TIME_MICROS 字串的日期時間格式必須為 yyyy-mm-dd hh:mm:ss.sssss。
INVALID_STRING_DATE_TIME_SECONDS 字串的日期時間格式必須為 yyyy-mm-dd hh:mm:ss。
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET 字串的日期時間格式必須為 yyyy-mm-dd hh:mm:ss+|-hh:mm。
EARLIER_THAN_MINIMUM_DATE 日期過早。
LATER_THAN_MAXIMUM_DATE 日期晚於系統允許的期限。
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE 日期範圍的上下限必須按照順序排列。
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL 範圍內的兩個日期都是空值。

DistinctError

以列舉方式說明可能的不同錯誤。

列舉
UNSPECIFIED 未指定列舉。
UNKNOWN 這個版本不知道收到的錯誤代碼。
DUPLICATE_ELEMENT 元素重複。
DUPLICATE_TYPE 類型重複。

FieldError

以列舉方式說明可能的欄位錯誤。

列舉
UNSPECIFIED 未指定列舉。
UNKNOWN 這個版本不知道收到的錯誤代碼。
REQUIRED 必填欄位不存在。
IMMUTABLE_FIELD 嘗試變更的欄位無法變更。
INVALID_VALUE 欄位值無效。
VALUE_MUST_BE_UNSET 無法設定這個欄位。
REQUIRED_NONEMPTY_LIST 必填的重複欄位空白。
FIELD_CANNOT_BE_CLEARED 無法清除這個欄位。
BLOCKED_VALUE 欄位值列在這個欄位的拒絕清單中。
FIELD_CAN_ONLY_BE_CLEARED 無法修改欄位值 (清除資料除外)。

MutateError

以列舉方式說明可能的變更錯誤。

列舉
UNSPECIFIED 未指定列舉。
UNKNOWN 這個版本不知道收到的錯誤代碼。
RESOURCE_NOT_FOUND 找不到要求的資源。
ID_EXISTS_IN_MULTIPLE_MUTATES 無法在一項要求中對相同資源兩次修改。
INCONSISTENT_FIELD_VALUES 欄位內容與其他代表相同資料的欄位不相符。
MUTATE_NOT_ALLOWED 無法對要求的資源進行更改。
RESOURCE_NOT_IN_GOOGLE_ADS 這項資源不在 Google Ads 中。屬於其他廣告系統。
RESOURCE_ALREADY_EXISTS 建立的資源已存在。
RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY 這項資源無法與「validateOnly」搭配使用。
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE 這項作業無法與「partialFailure」搭配使用。
RESOURCE_READ_ONLY 嘗試寫入唯讀欄位。

NotAllowlistedError

以列舉方式說明可能未加入許可清單的錯誤。

列舉
UNSPECIFIED 未指定列舉。
UNKNOWN 這個版本不知道收到的錯誤代碼。
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE 顧客尚未加入許可清單，因此無法使用這項功能。

StringFormatError

列舉可能的字串格式錯誤。

列舉
UNSPECIFIED 未指定列舉。
UNKNOWN 這個版本不知道收到的錯誤代碼。
ILLEGAL_CHARS 輸入的字串值包含不允許的字元。
INVALID_FORMAT 您在關聯欄位輸入的字串值無效。

StringLengthError

列舉可能的字串長度錯誤。

列舉
UNSPECIFIED 未指定列舉。
UNKNOWN 這個版本不知道收到的錯誤代碼。
EMPTY 指定的欄位應包含至少一個非空白字元。
TOO_SHORT 太短。
TOO_LONG 名稱過長，

CustomerAgreementSetting

客戶的客戶協議設定。

JSON 表示法 
{
  "acceptedLeadFormTerms": boolean
}
欄位
acceptedLeadFormTerms

boolean

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