Customer

Khách hàng.

Biểu diễn dưới dạng 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
}
Các trường
resourceName

string

Không thể thay đổi. Tên tài nguyên của khách hàng. Tên tài nguyên của khách hàng có dạng:

customers/{customerId}
callReportingSetting

object (CallReportingSetting)

Chế độ cài đặt báo cáo cuộc gọi cho một khách hàng. Chỉ có thể thay đổi trong thao tác update.
conversionTrackingSetting

object (ConversionTrackingSetting)

Chỉ có đầu ra. Chế độ theo dõi lượt chuyển đổi cho một khách hàng.
remarketingSetting

object (RemarketingSetting)

Chỉ có đầu ra. Cài đặt tái tiếp thị cho khách hàng.
payPerConversionEligibilityFailureReasons[]

enum (CustomerPayPerConversionEligibilityFailureReason)

Chỉ có đầu ra. Lý do khiến khách hàng không đủ điều kiện sử dụng PaymentMode.Migration. Nếu danh sách này trống thì khách hàng đủ điều kiện. Trường này chỉ để đọc.
optimizationScoreWeight

number

Chỉ có đầu ra. Trọng số của điểm tối ưu hoá của khách hàng.

Bạn có thể sử dụng trọng số của điểm tối ưu hoá để so sánh/tổng hợp điểm tối ưu hoá của nhiều khách hàng không phải người quản lý. Điểm tối ưu hoá tổng hợp của một người quản lý được tính bằng tổng điểm của tất cả các khách hàng sử dụng Customer.optimization_score * Customer.optimization_score_weight. Trường này có giá trị là 0 đối với tất cả khách hàng là người quản lý và đối với khách hàng không phải người quản lý nhưng chưa được chấm điểm.

Trường này chỉ để đọc.
status

enum (CustomerStatus)

Chỉ có đầu ra. Trạng thái của khách hàng.
offlineConversionClientSummaries[]

object (OfflineConversionClientSummary)

Chỉ có đầu ra. Thông tin chẩn đoán về lượt chuyển đổi ngoại tuyến tải lên.
customerAgreementSetting

object (CustomerAgreementSetting)

Chỉ có đầu ra. Cài đặt Thỏa thuận khách hàng cho một khách hàng.
id

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng của khách hàng.
descriptiveName

string

Tên mô tả không bắt buộc, không phải duy nhất của khách hàng.
currencyCode

string

Không thể thay đổi. Đơn vị tiền tệ mà tài khoản hoạt động. Một số mã đơn vị tiền tệ từ tiêu chuẩn ISO 4217 được hỗ trợ.
timeZone

string

Không thể thay đổi. Mã múi giờ địa phương của khách hàng.
trackingUrlTemplate

string

Mẫu URL để tạo URL theo dõi từ các tham số. Chỉ có thể thay đổi trong thao tác update.
finalUrlSuffix

string

Mẫu URL để thêm các tham số vào URL cuối cùng. Chỉ có thể thay đổi trong thao tác update.
autoTaggingEnabled

boolean

Liệu tính năng tự động gắn thẻ có được bật cho khách hàng hay không.
hasPartnersBadge

boolean

Chỉ có đầu ra. Liệu Khách hàng có huy hiệu Chương trình Partners hay không. Nếu Khách hàng chưa liên kết với chương trình Partners, thì giá trị này sẽ là sai. Để biết thêm thông tin, hãy xem https://support.google.com/partners/answer/3125774.
manager

boolean

Chỉ có đầu ra. Liệu khách hàng có phải là người quản lý hay không.
testAccount

boolean

Chỉ có đầu ra. Liệu khách hàng có phải là tài khoản thử nghiệm hay không.
optimizationScore

number

Chỉ có đầu ra. Điểm tối ưu hoá của khách hàng.

Điểm tối ưu hoá là điểm số ước tính về mức độ hiệu quả của hoạt động thiết lập cho các chiến dịch của khách hàng. Nó dao động từ 0% (0,0) đến 100% (1,0). Trường này rỗng đối với tất cả khách hàng là người quản lý và đối với khách hàng không phải người quản lý nhưng không có điểm.

Xem bài viết "Giới thiệu về điểm tối ưu hoá" tại https://support.google.com/google-ads/answer/9061546.

Trường này chỉ để đọc.
locationAssetAutoMigrationDone

boolean

Chỉ có đầu ra. Đúng nếu vị trí dựa trên nguồn cấp dữ liệu đã được di chuyển sang vị trí dựa trên thành phần.
imageAssetAutoMigrationDone

boolean

Chỉ có đầu ra. Đúng nếu hình ảnh dựa trên nguồn cấp dữ liệu đã được chuyển sang hình ảnh dựa trên thành phần.
locationAssetAutoMigrationDoneDateTime

string

Chỉ có đầu ra. Dấu thời gian của quá trình di chuyển từ vị trí dựa trên nguồn cấp dữ liệu sang vị trí cơ sở của tài sản ở định dạng yyyy-MM-dd HH:mm:ss.
imageAssetAutoMigrationDoneDateTime

string

Chỉ có đầu ra. Dấu thời gian của quá trình di chuyển từ hình ảnh dựa trên nguồn cấp dữ liệu sang hình ảnh gốc của thành phần ở định dạng yyyy-MM-dd HH:mm:ss.

CallReportingSetting

Chế độ cài đặt báo cáo cuộc gọi cho một khách hàng. Chỉ có thể thay đổi trong thao tác update.

Biểu diễn dưới dạng JSON 
{
  "callReportingEnabled": boolean,
  "callConversionReportingEnabled": boolean,
  "callConversionAction": string
}
Các trường
callReportingEnabled

boolean

Cho phép báo cáo các sự kiện cuộc gọi điện thoại bằng cách chuyển hướng các sự kiện đó qua Hệ thống Google.
callConversionReportingEnabled

boolean

Liệu có bật báo cáo lượt chuyển đổi cuộc gọi hay không.
callConversionAction

string

Hành động chuyển đổi liên quan đến cuộc gọi ở cấp khách hàng để phân bổ lượt chuyển đổi liên quan đến cuộc gọi. Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng một hành động chuyển đổi mặc định. Chỉ có hiệu lực khi đặt lệnh callconversionReportingEnabled thành true.

ConversionTrackingSetting

Tập hợp các chế độ cài đặt của toàn khách hàng liên quan đến tính năng Theo dõi lượt chuyển đổi của Google Ads.

Biểu diễn dưới dạng JSON 
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
Các trường
acceptedCustomerDataTerms

boolean

Chỉ có đầu ra. Liệu khách hàng đã chấp nhận các điều khoản về dữ liệu khách hàng hay chưa. Nếu bạn sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản, thì giá trị này sẽ được kế thừa từ người quản lý. Trường này chỉ để đọc. Để biết thêm thông tin, hãy xem https://support.google.com/adspolicy/answer/7475709.
conversionTrackingStatus

enum (ConversionTrackingStatus)

Chỉ có đầu ra. Trạng thái theo dõi lượt chuyển đổi. Mã này cho biết liệu khách hàng có đang sử dụng tính năng theo dõi lượt chuyển đổi hay không và ai là chủ sở hữu tính năng theo dõi lượt chuyển đổi của khách hàng này. Nếu khách hàng này đang sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản, thì giá trị được trả về sẽ khác nhau dựa trên login-customer-id của yêu cầu.
enhancedConversionsForLeadsEnabled

boolean

Chỉ có đầu ra. Khách hàng có chọn sử dụng tính năng lượt chuyển đổi nâng cao cho khách hàng tiềm năng hay không. Nếu bạn sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản, thì giá trị này sẽ được kế thừa từ người quản lý. Trường này chỉ để đọc.
googleAdsConversionCustomer

string

Chỉ có đầu ra. Tên tài nguyên của khách hàng nơi lượt chuyển đổi được tạo và quản lý. Trường này chỉ để đọc.
conversionTrackingId

string (int64 format)

Chỉ có đầu ra. Mã theo dõi lượt chuyển đổi được sử dụng cho tài khoản này. Mã này không cho biết liệu khách hàng có sử dụng tính năng theo dõi lượt chuyển đổi hay không (conversionTrackingStatus có sử dụng). Trường này chỉ để đọc.
crossAccountConversionTrackingId

string (int64 format)

Chỉ có đầu ra. Mã theo dõi lượt chuyển đổi của người quản lý của khách hàng. Mã này được đặt khi khách hàng chọn sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản và ghi đè conversionTrackingId. Bạn chỉ có thể quản lý trường này thông qua giao diện người dùng Google Ads. Trường này chỉ để đọc.

ConversionTrackingStatus

Trạng thái Theo dõi lượt chuyển đổi của khách hàng.

Enum
UNSPECIFIED Chưa xác định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
NOT_CONVERSION_TRACKED Khách hàng không sử dụng bất kỳ tính năng theo dõi lượt chuyển đổi nào.
CONVERSION_TRACKING_MANAGED_BY_SELF Các hành động chuyển đổi do khách hàng này tạo và quản lý.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER Các hành động chuyển đổi được tạo và quản lý bởi người quản lý được chỉ định trong login-customer-id của yêu cầu.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER Các hành động chuyển đổi do người quản lý tạo và quản lý, khác với khách hàng hoặc người quản lý được chỉ định trong login-customer-id của yêu cầu.

RemarketingSetting

Cài đặt tái tiếp thị cho khách hàng.

Biểu diễn dưới dạng JSON 
{
  "googleGlobalSiteTag": string
}
Các trường
googleGlobalSiteTag

string

Chỉ có đầu ra. Thẻ Google.

CustomerPayPerConversionEligibilityFailureReason

Enum mô tả các lý do có thể khiến khách hàng không đủ điều kiện sử dụng PaymentMode.lpurl.

Enum
UNSPECIFIED Chưa xác định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
NOT_ENOUGH_CONVERSIONS Khách hàng không có đủ số lượt chuyển đổi.
CONVERSION_LAG_TOO_HIGH Độ trễ chuyển đổi của khách hàng quá cao.
HAS_CAMPAIGN_WITH_SHARED_BUDGET Khách hàng sử dụng ngân sách dùng chung.
HAS_UPLOAD_CLICKS_CONVERSION Khách hàng có các lượt chuyển đổi có conversionActionType.UPLOAD_clicks.
AVERAGE_DAILY_SPEND_TOO_HIGH Mức chi tiêu trung bình hằng ngày của khách hàng quá cao.
ANALYSIS_NOT_COMPLETE Máy chủ phụ trợ của Google Ads chưa tính toán liệu Khách hàng có đủ điều kiện sử dụng hay không. Hãy sớm quay lại nhé!
OTHER Khách hàng không đủ điều kiện vì những lý do khác.

OfflineConversionClientSummary

Khách hàng tóm tắt thông tin chẩn đoán về tệp tải lượt chuyển đổi ngoại tuyến lên. Proto này chứa thông tin chung, bảng chi tiết theo ngày/công việc và cảnh báo cho kết quả tải lượt chuyển đổi ngoại tuyến lên.

Biểu diễn dưới dạng JSON 
{
  "client": enum (OfflineEventUploadClient),
  "status": enum (OfflineConversionDiagnosticStatus),
  "totalEventCount": string,
  "successfulEventCount": string,
  "successRate": number,
  "lastUploadDateTime": string,
  "dailySummaries": [
    {
      object (OfflineConversionUploadSummary)
    }
  ],
  "jobSummaries": [
    {
      object (OfflineConversionUploadSummary)
    }
  ],
  "alerts": [
    {
      object (OfflineConversionUploadAlert)
    }
  ]
}
Các trường
client

enum (OfflineEventUploadClient)

Chỉ có đầu ra. Loại ứng dụng của sự kiện tải lên.
status

enum (OfflineConversionDiagnosticStatus)

Chỉ có đầu ra. Trạng thái tổng thể của trang tóm tắt về khách hàng có lượt chuyển đổi ngoại tuyến. Trạng thái được tạo từ ngày gần đây nhất theo lịch với số liệu thống kê về lượt tải lên.
totalEventCount

string (int64 format)

Chỉ có đầu ra. Tổng số sự kiện được tải lên.
successfulEventCount

string (int64 format)

Chỉ có đầu ra. Tổng số sự kiện được tải lên thành công.
successRate

number

Chỉ có đầu ra. Tỷ lệ thành công.
lastUploadDateTime

string

Chỉ có đầu ra. Ngày của lô tải lên mới nhất.
dailySummaries[]

object (OfflineConversionUploadSummary)

Chỉ có đầu ra. Tóm tắt số liệu thống kê trong quá khứ theo N ngày qua.
jobSummaries[]

object (OfflineConversionUploadSummary)

Chỉ có đầu ra. Tóm tắt số liệu thống kê về nhật ký theo N công việc gần đây nhất.
alerts[]

object (OfflineConversionUploadAlert)

Chỉ có đầu ra. Thông tin chi tiết cho từng mã lỗi. Cảnh báo được tạo từ ngày gần đây nhất theo lịch có số liệu thống kê về tệp tải lên.

OfflineEventUploadClient

Loại ứng dụng.

Enum
UNSPECIFIED Chưa xác định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
GOOGLE_ADS_API API Google Ads.
GOOGLE_ADS_WEB_CLIENT Ứng dụng web Google Ads có thể bao gồm nhiều nguồn như Giao diện người dùng của Google Ads, Giao thức truyền tệp bảo mật (SFTP), v.v.
ADS_DATA_CONNECTOR Nền tảng kết nối.

OfflineConversionDiagnosticStatus

Trạng thái có thể có của chế độ thiết lập quy trình nhập dữ liệu ngoại tuyến.

Enum
UNSPECIFIED Chưa xác định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
EXCELLENT Chế độ thiết lập quy trình nhập dữ liệu ngoại tuyến của bạn đang hoạt động và được tối ưu cho quá trình xử lý về sau.
GOOD Chế độ thiết lập quy trình nhập dữ liệu ngoại tuyến của bạn đang hoạt động, nhưng bạn vẫn có thể cải thiện thêm. Xem các cảnh báo.
NEEDS_ATTENTION Chế độ thiết lập quy trình nhập dữ liệu ngoại tuyến của bạn đang hoạt động, nhưng có một số lỗi mà bạn cần chú ý. Xem các cảnh báo.
NO_RECENT_UPLOAD Chế độ thiết lập quy trình nhập dữ liệu ngoại tuyến chưa nhận được dữ liệu trong 28 ngày qua, có thể đã xảy ra lỗi.

OfflineConversionUploadSummary

Bản tóm tắt tệp tải lên trước đây, được nhóm theo ngày tải lên hoặc công việc.

Biểu diễn dưới dạng 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.
}
Các trường
successfulCount

string (int64 format)

Chỉ có đầu ra. Tổng số sự kiện thành công.
failedCount

string (int64 format)

Chỉ có đầu ra. Tổng số sự kiện không thành công.
Trường nhóm dimension_key. Khoá phương diện để tóm tắt. dimension_key chỉ có thể là một trong những trạng thái sau đây:
jobId

string (int64 format)

Chỉ có đầu ra. Khoá thứ nguyên cho N công việc gần đây nhất.
uploadDate

string

Chỉ có đầu ra. Khoá phương diện cho N ngày qua.

OfflineConversionUploadAlert

Thông báo về thông tin tóm tắt về khách hàng có lượt chuyển đổi ngoại tuyến.

Biểu diễn dưới dạng JSON 
{
  "error": {
    object (OfflineConversionUploadError)
  },
  "errorPercentage": number
}
Các trường
error

object (OfflineConversionUploadError)

Chỉ có đầu ra. Đã xảy ra lỗi trong thông báo về ứng dụng có lượt chuyển đổi ngoại tuyến.
errorPercentage

number

Chỉ có đầu ra. Tỷ lệ phần trăm lỗi.

OfflineConversionUploadError

Các lỗi có thể xảy ra trong phần thông tin tóm tắt về ứng dụng có lượt chuyển đổi ngoại tuyến.

Biểu diễn dưới dạng 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.
}
Các trường
Trường nhóm error_code. Đã xảy ra lỗi với nội dung mô tả. error_code chỉ có thể là một trong những trạng thái sau đây:
collectionSizeError

enum (CollectionSizeError)

Chỉ có đầu ra. Lỗi kích thước bộ sưu tập.
conversionAdjustmentUploadError

enum (ConversionAdjustmentUploadError)

Chỉ có đầu ra. Lỗi tải lên điều chỉnh chuyển đổi.
conversionUploadError

enum (ConversionUploadError)

Chỉ có đầu ra. Lỗi tải lượt chuyển đổi lên.
dateError

enum (DateError)

Chỉ có đầu ra. Lỗi ngày.
distinctError

enum (DistinctError)

Chỉ có đầu ra. Lỗi khác biệt.
fieldError

enum (FieldError)

Chỉ có đầu ra. Lỗi trường.
mutateError

enum (MutateError)

Chỉ có đầu ra. Lỗi thay đổi.
notAllowlistedError

enum (NotAllowlistedError)

Chỉ có đầu ra. Lỗi không có trong danh sách cho phép.
stringFormatError

enum (StringFormatError)

Chỉ có đầu ra. Lỗi định dạng chuỗi.
stringLengthError

enum (StringLengthError)

Chỉ có đầu ra. Lỗi độ dài chuỗi.

CollectionSizeError

Enum mô tả các lỗi có thể xảy ra liên quan đến kích thước bộ sưu tập.

Enum
UNSPECIFIED Chưa xác định enum.
UNKNOWN Không xác định được mã lỗi nhận được trong phiên bản này.
TOO_FEW Quá ít.
TOO_MANY Quá nhiều.

ConversionAdjustmentUploadError

Enum mô tả các lỗi tải lên mức điều chỉnh chuyển đổi có thể xảy ra.

Enum
UNSPECIFIED Chưa xác định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
TOO_RECENT_CONVERSION_ACTION Không thể nhập sự kiện vào hành động chuyển đổi vừa tạo. Hãy thử nhập lại sau 6 giờ nữa.
INVALID_CONVERSION_ACTION Hãy đảm bảo bạn đã chỉ định một hành động chuyển đổi đang hoạt động có thể điều chỉnh được.
CONVERSION_ALREADY_RETRACTED Lượt chuyển đổi này đã được rút lại. Mức điều chỉnh này chưa được xử lý.
CONVERSION_NOT_FOUND Không tìm thấy lượt chuyển đổi cho hành động chuyển đổi và giá trị nhận dạng lượt chuyển đổi này. Hãy đảm bảo rằng bạn đã liên kết giá trị nhận dạng lượt chuyển đổi với đúng hành động chuyển đổi, rồi thử lại.
CONVERSION_EXPIRED Không thể điều chỉnh lượt chuyển đổi đã xảy ra hơn 54 ngày trước.
ADJUSTMENT_PRECEDES_CONVERSION Mức điều chỉnh có adjustmentDateTime đã xảy ra trước lượt chuyển đổi liên quan. Hãy đảm bảo adjustmentDateTime của bạn là chính xác rồi thử lại.
MORE_RECENT_RESTATEMENT_FOUND Mức điều chỉnh khác gần đây (adjustmentDateTime) đã được báo cáo cho lượt chuyển đổi liên quan. Hãy đảm bảo mức điều chỉnh adjustmentDateTime của bạn là chính xác, rồi thử lại.
TOO_RECENT_CONVERSION Mức điều chỉnh không được ghi lại vì lượt chuyển đổi xảy ra quá gần đây. Hãy thử điều chỉnh một lượt chuyển đổi xảy ra ít nhất 24 giờ trước.
CANNOT_RESTATE_CONVERSION_ACTION_THAT_ALWAYS_USES_DEFAULT_CONVERSION_VALUE Không thể điều chỉnh lượt chuyển đổi được thiết lập để sử dụng giá trị mặc định. Hãy kiểm tra chế độ cài đặt giá trị hành động chuyển đổi, rồi thử lại.
TOO_MANY_ADJUSTMENTS_IN_REQUEST Hãy thử tải lên tối đa 2.001 mức điều chỉnh trong một yêu cầu API.
TOO_MANY_ADJUSTMENTS Đã đạt đến số lần điều chỉnh lượt chuyển đổi tối đa. Hãy đảm bảo rằng bạn chỉ thực hiện mức điều chỉnh cần thiết đối với lượt chuyển đổi hiện có.
RESTATEMENT_ALREADY_EXISTS Lượt chuyển đổi này đã được sửa đổi trước đó với cùng adjustmentDateTime. Hãy đảm bảo mức điều chỉnh có adjustmentDateTime chính xác và riêng biệt, rồi thử lại.
DUPLICATE_ADJUSTMENT_IN_REQUEST Mức điều chỉnh đã nhập có mức điều chỉnh lượt chuyển đổi trùng lặp với cùng adjustmentDateTime. Hãy đảm bảo mức điều chỉnh có adjustmentDateTime chính xác, rồi thử lại.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS Đảm bảo bạn đồng ý với các điều khoản xử lý dữ liệu khách hàng trong phần cài đặt lượt chuyển đổi, rồi thử lại.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT Không thể sử dụng tính năng lượt chuyển đổi nâng cao với hành động chuyển đổi đã chỉ định.
INVALID_USER_IDENTIFIER Đừng quên băm dữ liệu do người dùng cung cấp bằng thuật toán SHA-256 và đảm bảo bạn đang chuẩn hoá theo nguyên tắc.
UNSUPPORTED_USER_IDENTIFIER Hãy sử dụng dữ liệu do người dùng cung cấp như email hoặc số điện thoại đã băm bằng thuật toán SHA-256, rồi thử lại.
GCLID_DATE_TIME_PAIR_AND_ORDER_ID_BOTH_SET Không thể đặt cả gclidDateTimePair và orderId. Vui lòng chỉ sử dụng một loại, rồi thử lại.
CONVERSION_ALREADY_ENHANCED Lượt chuyển đổi đã được nâng cao với cùng một mã đơn hàng và hành động chuyển đổi. Hãy đảm bảo dữ liệu của bạn được thiết lập chính xác, rồi thử lại.
DUPLICATE_ENHANCEMENT_IN_REQUEST Nhiều mức nâng cao có cùng hành động chuyển đổi và mã đơn hàng. Hãy đảm bảo dữ liệu của bạn được thiết lập chính xác, rồi thử lại.
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCEMENT Không thể sử dụng tính năng lượt chuyển đổi nâng cao cho tài khoản này do chính sách về dữ liệu khách hàng của Google. Hãy liên hệ với người đại diện của Google.
MISSING_ORDER_ID_FOR_WEBPAGE Để điều chỉnh lượt chuyển đổi trên trang web, bạn phải nhập mã đơn hàng (ví dụ: mã giao dịch). Hãy đảm bảo rằng thẻ trang web của bạn có mã đơn hàng và bạn gửi cùng mã đơn hàng cho mức điều chỉnh của mình.
ORDER_ID_CONTAINS_PII Không thể sử dụng mức điều chỉnh đối với mã đơn hàng có chứa thông tin nhận dạng cá nhân (PII).

ConversionUploadError

Enum mô tả các lỗi có thể xảy ra liên quan đến lượt tải lượt chuyển đổi lên.

Enum
UNSPECIFIED Chưa xác định enum.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
TOO_MANY_CONVERSIONS_IN_REQUEST Tải ít hơn 2.001 sự kiện lên trong một yêu cầu.
UNPARSEABLE_GCLID Không thể giải mã GCLID đã nhập. Hãy đảm bảo rằng bạn chưa sửa đổi mã lượt nhấp.
CONVERSION_PRECEDES_EVENT Sự kiện được nhập có conversionDateTime đứng trước lượt nhấp. Hãy đảm bảo conversionDateTime của bạn là chính xác rồi thử lại.
EXPIRED_EVENT Không thể ghi lại sự kiện được nhập vì lượt nhấp của sự kiện đó đã xảy ra trước khoảng thời gian xảy ra lượt nhấp của lượt chuyển đổi này. Hãy đảm bảo bạn nhập dữ liệu mới nhất.
TOO_RECENT_EVENT Lượt nhấp được liên kết với giá trị nhận dạng hoặc tham số URL cho iOS đã xảy ra chưa đến 6 giờ trước. Hãy thử lại sau 6 giờ.
EVENT_NOT_FOUND Không thể phân bổ sự kiện được nhập cho một lượt nhấp. Điều này có thể xảy ra do sự kiện này không đến từ một chiến dịch trên Google Ads.
UNAUTHORIZED_CUSTOMER Mã lượt nhấp hoặc cuộc gọi được liên kết với một tài khoản Google Ads mà bạn không có quyền truy cập. Hãy đảm bảo bạn nhập lượt chuyển đổi cho các tài khoản được quản lý bởi tài khoản người quản lý của bạn.
INVALID_CONVERSION_ACTION Đảm bảo bạn đã thiết lập hành động chuyển đổi hợp lệ để nhập dữ liệu ngoại tuyến.
TOO_RECENT_CONVERSION_ACTION Không thể nhập sự kiện vào hành động chuyển đổi vừa tạo. Hãy thử nhập lại sau 6 giờ nữa.
CONVERSION_TRACKING_NOT_ENABLED_AT_IMPRESSION_TIME Tại thời điểm xảy ra lượt nhấp, tính năng theo dõi lượt chuyển đổi chưa được bật trong tài khoản chuyển đổi hiệu quả thuộc tài khoản Google Ads của lượt nhấp đó.
EXTERNAL_ATTRIBUTION_DATA_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION Sự kiện đã nhập bao gồm dữ liệu phân bổ bên ngoài, nhưng hành động chuyển đổi không được thiết lập để sử dụng mô hình phân bổ bên ngoài. Hãy đảm bảo hành động chuyển đổi được thiết lập chính xác, rồi thử lại.
EXTERNAL_ATTRIBUTION_DATA_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION Bạn đã thiết lập hành động chuyển đổi để sử dụng mô hình phân bổ bên ngoài, nhưng sự kiện đã nhập bị thiếu dữ liệu. Hãy đảm bảo sự kiện đã nhập bao gồm giá trị đóng góp được phân bổ bên ngoài và tất cả các trường cần thiết.
ORDER_ID_NOT_PERMITTED_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION Bạn không thể sử dụng mã đơn hàng cho lượt chuyển đổi được đo lường bằng mô hình phân bổ bên ngoài. Hãy đảm bảo rằng lượt chuyển đổi được định cấu hình chính xác và các sự kiện được nhập chỉ bao gồm dữ liệu cần thiết, rồi thử lại.
ORDER_ID_ALREADY_IN_USE Sự kiện đã nhập bao gồm mã đơn hàng đã được ghi lại trước đó, vì vậy, sự kiện này chưa được xử lý.
DUPLICATE_ORDER_ID Sự kiện đã nhập bao gồm nhiều lượt chuyển đổi có cùng mã đơn hàng và chưa được xử lý. Hãy đảm bảo mã đơn hàng không trùng lặp, rồi thử lại.
TOO_RECENT_CALL Không thể nhập các cuộc gọi diễn ra chưa đến 6 giờ. Hãy thử tải video lên lại sau 6 giờ nữa.
EXPIRED_CALL Không thể ghi lại cuộc gọi vì cuộc gọi đó đã xảy ra trước giai đoạn xem lại của hành động chuyển đổi này. Hãy đảm bảo dữ liệu đã nhập của bạn được định cấu hình để nhận dữ liệu mới nhất.
CALL_NOT_FOUND Không thể tìm thấy cuộc gọi hoặc lượt nhấp dẫn đến sự kiện đã nhập. Đảm bảo nguồn dữ liệu của bạn được thiết lập để bao gồm đúng giá trị nhận dạng.
CONVERSION_PRECEDES_CALL Lệnh gọi có một conversionDateTime đứng trước lượt nhấp liên kết. Hãy đảm bảo conversionDateTime của bạn là chính xác.
CONVERSION_TRACKING_NOT_ENABLED_AT_CALL_TIME Tại thời điểm diễn ra cuộc gọi được nhập, tính năng theo dõi lượt chuyển đổi chưa được bật trong tài khoản chuyển đổi hiệu quả thuộc tài khoản Google Ads của lượt nhấp.
UNPARSEABLE_CALLERS_PHONE_NUMBER Đảm bảo số điện thoại có định dạng là E.164 (+16502531234), Quốc tế (+64 3-331 6005) hoặc số quốc gia Hoa Kỳ (6502531234).
CLICK_CONVERSION_ALREADY_EXISTS Sự kiện được nhập có cùng lượt nhấp và conversionDateTime với một lượt chuyển đổi hiện có. Hãy sử dụng một mã conversionDateTime hoặc mã đơn hàng riêng cho mỗi sự kiện riêng biệt rồi thử lại.
CALL_CONVERSION_ALREADY_EXISTS Cuộc gọi đã nhập có cùng conversionDateTime với một lượt chuyển đổi hiện có. Hãy đảm bảo bạn đã định cấu hình conversionDateTime chính xác rồi thử lại.
DUPLICATE_CLICK_CONVERSION_IN_REQUEST Nhiều sự kiện có cùng lượt nhấp và conversionDateTime. Hãy đảm bảo conversionDateTime của bạn được định cấu hình chính xác, rồi thử lại.
DUPLICATE_CALL_CONVERSION_IN_REQUEST Nhiều sự kiện có cùng lệnh gọi và conversionDateTime. Hãy đảm bảo conversionDateTime của bạn được định cấu hình chính xác, rồi thử lại.
CUSTOM_VARIABLE_NOT_ENABLED Hãy bật biến tuỳ chỉnh trong phần cài đặt lượt chuyển đổi của bạn rồi thử lại.
CUSTOM_VARIABLE_VALUE_CONTAINS_PII Không thể nhập những sự kiện có biến tuỳ chỉnh chứa thông tin nhận dạng cá nhân (PII). Hãy xoá các biến này, rồi thử lại.
INVALID_CUSTOMER_FOR_CLICK Lượt nhấp từ sự kiện đã nhập được liên kết với một tài khoản Google Ads khác. Hãy đảm bảo rằng bạn đang nhập sự kiện vào đúng tài khoản.
INVALID_CUSTOMER_FOR_CALL Lượt nhấp từ cuộc gọi được liên kết với một tài khoản Google Ads khác. Hãy đảm bảo rằng bạn đang nhập sự kiện vào đúng tài khoản. Truy vấn conversionTrackingSettings.google_ads_conversion_customer trên Khách hàng để xác định đúng tài khoản.
CONVERSION_NOT_COMPLIANT_WITH_ATT_POLICY Bạn không thể nhập lượt chuyển đổi do nguồn chuyển đổi không tuân thủ các chính sách Theo dõi minh bạch ứng dụng (ATT) của Apple hoặc do khách hàng không đồng ý với việc theo dõi.
CLICK_NOT_FOUND Không thể so khớp địa chỉ email hoặc số điện thoại của sự kiện này với một lượt nhấp. Lỗi này có thể là do sự kiện không bắt nguồn từ một chiến dịch trên Google Ads, nên bạn có thể yên tâm bỏ qua cảnh báo này. Nếu lỗi này bao gồm nhiều sự kiện được nhập hơn so với dự kiến, thì bạn có thể cần kiểm tra chế độ thiết lập của mình.
INVALID_USER_IDENTIFIER Đừng quên băm dữ liệu do người dùng cung cấp bằng thuật toán SHA-256 và đảm bảo bạn đang chuẩn hoá theo nguyên tắc.
EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION_NOT_PERMITTED_WITH_USER_IDENTIFIER Bạn không thể sử dụng dữ liệu do người dùng cung cấp với các mô hình phân bổ bên ngoài. Hãy sử dụng một mô hình phân bổ khác hoặc bỏ qua giá trị nhận dạng người dùng, rồi thử lại.
UNSUPPORTED_USER_IDENTIFIER Mã nhận dạng người dùng đã cung cấp không được hỗ trợ. Chỉ sử dụng email hoặc số điện thoại đã băm, rồi thử lại.
GBRAID_WBRAID_BOTH_SET Không thể sử dụng cả tham số gBraid và wBraid. Vui lòng chỉ sử dụng một tham số, rồi thử lại.
UNPARSEABLE_WBRAID Không thể phân tích cú pháp dữ liệu nhập sự kiện. Hãy kiểm tra xem tham số wBraid có bị sửa đổi hay không rồi thử lại.
UNPARSEABLE_GBRAID Không thể phân tích cú pháp dữ liệu nhập sự kiện. Hãy kiểm tra xem tham số gBraid có bị sửa đổi hay không, rồi thử lại.
ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID Không thể sử dụng những hành động chuyển đổi áp dụng phương thức tính một lần cho mỗi lượt nhấp với tham số gBraid hoặc wBraid.
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS Không thể sử dụng tính năng lượt chuyển đổi nâng cao cho tài khoản này do chính sách về dữ liệu khách hàng của Google. Hãy liên hệ với người đại diện của Google.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS Đảm bảo bạn đồng ý với các điều khoản xử lý dữ liệu khách hàng trong phần cài đặt lượt chuyển đổi, rồi thử lại. Bạn có thể kiểm tra chế độ cài đặt của mình bằng cách truy vấn conversionTrackingSettings.accepted_customer_data_terms trên Customer.
ORDER_ID_CONTAINS_PII Không thể nhập những sự kiện có mã đơn hàng chứa thông tin nhận dạng cá nhân (PII).
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS Đảm bảo rằng bạn đã bật tính năng lượt chuyển đổi nâng cao cho khách hàng tiềm năng trong phần cài đặt lượt chuyển đổi, rồi thử lại. Bạn có thể kiểm tra chế độ cài đặt của mình bằng cách truy vấn conversionTrackingSettings.enhanced_conversions_for_leads_enabled trên Khách hàng.

DateError

Enum mô tả các lỗi ngày có thể xảy ra.

Enum
UNSPECIFIED Chưa xác định enum.
UNKNOWN Không xác định được mã lỗi nhận được trong phiên bản này.
INVALID_FIELD_VALUES_IN_DATE Các giá trị đã cho của trường không tương ứng với ngày hợp lệ.
INVALID_FIELD_VALUES_IN_DATE_TIME Các giá trị trường đã cho không tương ứng với ngày giờ hợp lệ.
INVALID_STRING_DATE Định dạng ngày của chuỗi phải là yyyy-mm-dd.
INVALID_STRING_DATE_TIME_MICROS Định dạng của ngày giờ của chuỗi phải là yyyy-mm-dd hh:mm:ss.sssss.
INVALID_STRING_DATE_TIME_SECONDS Định dạng của ngày giờ của chuỗi phải là yyyy-mm-dd hh:mm:ss.
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET Định dạng của ngày giờ của chuỗi phải là yyyy-mm-dd hh:mm:ss+|-hh:mm.
EARLIER_THAN_MINIMUM_DATE Ngày vượt quá ngày tối thiểu cho phép.
LATER_THAN_MAXIMUM_DATE Ngày vượt quá ngày tối đa cho phép.
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE Các giới hạn của phạm vi ngày không theo thứ tự.
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL Cả hai ngày trong phạm vi đều rỗng.

DistinctError

Enum mô tả các lỗi riêng biệt có thể xảy ra.

Enum
UNSPECIFIED Chưa xác định enum.
UNKNOWN Không xác định được mã lỗi nhận được trong phiên bản này.
DUPLICATE_ELEMENT Phần tử trùng lặp.
DUPLICATE_TYPE Loại trùng lặp.

FieldError

Enum mô tả các lỗi trường có thể xảy ra.

Enum
UNSPECIFIED Chưa xác định enum.
UNKNOWN Không xác định được mã lỗi nhận được trong phiên bản này.
REQUIRED Trường bắt buộc không xuất hiện.
IMMUTABLE_FIELD Trường đã cố gắng thay đổi là trường không thể thay đổi.
INVALID_VALUE Giá trị của trường không hợp lệ.
VALUE_MUST_BE_UNSET Không thể đặt trường này.
REQUIRED_NONEMPTY_LIST Trường lặp lại bắt buộc đang trống.
FIELD_CANNOT_BE_CLEARED Không thể xoá trường này.
BLOCKED_VALUE Giá trị của trường nằm trong danh sách từ chối cho trường này.
FIELD_CAN_ONLY_BE_CLEARED Bạn không thể sửa đổi giá trị của trường, trừ trường hợp xoá.

MutateError

Enum mô tả các lỗi biến đổi có thể xảy ra.

Enum
UNSPECIFIED Chưa xác định enum.
UNKNOWN Không xác định được mã lỗi nhận được trong phiên bản này.
RESOURCE_NOT_FOUND Không tìm thấy tài nguyên được yêu cầu.
ID_EXISTS_IN_MULTIPLE_MUTATES Không thể thay đổi cùng một tài nguyên hai lần trong một yêu cầu.
INCONSISTENT_FIELD_VALUES Nội dung của trường này không khớp với một trường khác đại diện cho cùng một dữ liệu.
MUTATE_NOT_ALLOWED Không được phép thay đổi tài nguyên được yêu cầu.
RESOURCE_NOT_IN_GOOGLE_ADS Tài nguyên không có trong Google Ads. Thuộc tính này thuộc một hệ thống quảng cáo khác.
RESOURCE_ALREADY_EXISTS Tài nguyên đang được tạo đã tồn tại.
RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY Bạn không thể sử dụng tài nguyên này với "validateOnly".
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE Không thể sử dụng thao tác này với "partialFailure".
RESOURCE_READ_ONLY Cố gắng ghi vào các trường chỉ đọc.

NotAllowlistedError

Enum mô tả các lỗi có thể xảy ra không có trong danh sách cho phép.

Enum
UNSPECIFIED Chưa xác định enum.
UNKNOWN Không xác định được mã lỗi nhận được trong phiên bản này.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE Khách hàng không có tên trong danh sách được phép sử dụng tính năng này.

StringFormatError

Enum mô tả các lỗi định dạng chuỗi có thể xảy ra.

Enum
UNSPECIFIED Chưa xác định enum.
UNKNOWN Không xác định được mã lỗi nhận được trong phiên bản này.
ILLEGAL_CHARS Giá trị chuỗi nhập vào chứa các ký tự không được phép.
INVALID_FORMAT Giá trị của chuỗi nhập vào không hợp lệ cho trường liên kết.

StringLengthError

Enum mô tả các lỗi có thể xảy ra về độ dài chuỗi.

Enum
UNSPECIFIED Chưa xác định enum.
UNKNOWN Không xác định được mã lỗi nhận được trong phiên bản này.
EMPTY Trường được chỉ định phải có ít nhất một ký tự không có khoảng trắng.
TOO_SHORT Quá ngắn.
TOO_LONG Quá dài.

CustomerAgreementSetting

Cài đặt Thỏa thuận khách hàng cho một khách hàng.

Biểu diễn dưới dạng JSON 
{
  "acceptedLeadFormTerms": boolean
}
Các trường
acceptedLeadFormTerms

boolean

Chỉ có đầu ra. Liệu khách hàng đã chấp nhận điều khoản dịch vụ của biểu mẫu khách hàng tiềm năng hay chưa.