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)

فقط خروجی شناسه مشتری.

descriptiveName

string

نام توصیفی اختیاری و غیر منحصر به فرد مشتری.

currencyCode

string

تغییرناپذیر. ارزی که حساب در آن کار می کند. زیر مجموعه ای از کدهای ارز از استاندارد ISO 4217 پشتیبانی می شود.

timeZone

string

تغییرناپذیر. شناسه منطقه زمانی محلی مشتری.

trackingUrlTemplate

string

الگوی URL برای ساخت یک URL ردیابی خارج از پارامترها. فقط در یک عملیات update قابل تغییر است.

finalUrlSuffix

string

الگوی URL برای الحاق پارامترها به URL نهایی. فقط در یک عملیات update قابل تغییر است.

autoTaggingEnabled

boolean

اینکه آیا برچسب‌گذاری خودکار برای مشتری فعال است یا خیر.

hasPartnersBadge

boolean

فقط خروجی اینکه آیا مشتری نشان برنامه Partners دارد یا خیر. اگر مشتری با برنامه Partners مرتبط نباشد، این نادرست خواهد بود. برای اطلاعات بیشتر، به 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

فقط خروجی درست است اگر مکان مبتنی بر فید به مکان مبتنی بر دارایی منتقل شده باشد.

imageAssetAutoMigrationDone

boolean

فقط خروجی درست است اگر تصویر مبتنی بر فید به تصویر مبتنی بر دارایی منتقل شده باشد.

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 روی درست تنظیم شده باشد.

ConversionTrackingSetting

مجموعه ای از تنظیمات گسترده مشتری مرتبط با ردیابی تبدیل تبلیغات گوگل.

نمایندگی 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)

فقط خروجی شناسه ردیابی تبدیل استفاده شده برای این حساب. این شناسه نشان نمی‌دهد که آیا مشتری از ردیابی تبدیل استفاده می‌کند یا خیر (conversionTrackingStatus این کار را می‌کند). این فیلد فقط خواندنی است.

crossAccountConversionTrackingId

string ( int64 format)

فقط خروجی شناسه ردیابی تبدیل مدیر مشتری. این زمانی تنظیم می‌شود که مشتری ردیابی تبدیل بین حساب‌ها را انتخاب کند، و ConversionTrackingId را لغو می‌کند. این فیلد فقط از طریق رابط کاربری Google Ads قابل مدیریت است. این فیلد فقط خواندنی است.

ConversionTrackingStatus

وضعیت ردیابی تبدیل مشتری.

Enums
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 سیستم درخواست ایجاد و مدیریت می شود.

تنظیم مجدد بازاریابی

تنظیم بازاریابی مجدد برای مشتری

نمایندگی JSON
{
  "googleGlobalSiteTag": string
}
زمینه های
googleGlobalSiteTag

string

فقط خروجی تگ گوگل

CustomerPayPerConversionEligibility FailureReason

فهرستی که دلایل احتمالی یک مشتری برای استفاده از PaymentMode.CONVERSIONS را توضیح می دهد.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
NOT_ENOUGH_CONVERSIONS مشتری تبدیل به اندازه کافی ندارد.
CONVERSION_LAG_TOO_HIGH تاخیر تبدیل مشتری بسیار زیاد است.
HAS_CAMPAIGN_WITH_SHARED_BUDGET مشتری از بودجه های مشترک استفاده می کند.
HAS_UPLOAD_CLICKS_CONVERSION مشتری دارای تبدیل با ConversionActionType.UPLOAD_CLICKS است.
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

نوع مشتری.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
GOOGLE_ADS_API Google Ads API.
GOOGLE_ADS_WEB_CLIENT سرویس گیرنده وب Google Ads، که می تواند شامل چندین منبع مانند Ads UI، SFTP و غیره باشد.
ADS_DATA_CONNECTOR پلت فرم اتصال.

وضعیت تشخیصی تبدیل آفلاین

وضعیت‌های احتمالی تنظیم انتقال آفلاین.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
EXCELLENT تنظیم انتقال داده آفلاین شما برای پردازش پایین دستی فعال و بهینه است.
GOOD راه‌اندازی انتقال آفلاین شما فعال است، اما بهبودهای بیشتری وجود دارد که می‌توانید انجام دهید. هشدارها را ببینید.
NEEDS_ATTENTION راه‌اندازی انتقال آفلاین شما فعال است، اما خطاهایی وجود دارد که نیاز به توجه شما دارد. هشدارها را ببینید.
NO_RECENT_UPLOAD تنظیمات انتقال آفلاین شما در 28 روز گذشته داده دریافت نکرده است، ممکن است مشکلی وجود داشته باشد.

OfflineConversionUpload خلاصه

خلاصه آپلود تاریخی، گروه بندی شده بر اساس تاریخ یا شغل آپلود.

نمایندگی 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

Enum خطاهای احتمالی اندازه مجموعه را توصیف می کند.

Enums
UNSPECIFIED تعداد نامشخص
UNKNOWN کد خطای دریافتی در این نسخه مشخص نیست.
TOO_FEW خیلی کم.
TOO_MANY خیلی زیاد.

خطای ConversionAdjustmentUpload

Enum خطاهای احتمالی آپلود تنظیم تبدیل را توصیف می کند.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
TOO_RECENT_CONVERSION_ACTION نمی‌توان رویدادها را به یک اقدام تبدیلی که به تازگی ایجاد شده است وارد کرد. 6 ساعت دیگر دوباره وارد کردن را امتحان کنید.
INVALID_CONVERSION_ACTION مطمئن شوید که یک اقدام تبدیل فعال را مشخص کرده اید که می تواند تنظیم شود.
CONVERSION_ALREADY_RETRACTED تبدیل قبلاً پس گرفته شده بود. این تنظیم پردازش نشد.
CONVERSION_NOT_FOUND تبدیل برای این کنش تبدیل و شناسه تبدیل پیدا نمی شود. مطمئن شوید که شناسه‌های تبدیل شما با عمل تبدیل صحیح مرتبط هستند و دوباره امتحان کنید.
CONVERSION_EXPIRED برای تبدیلی که بیش از 54 روز پیش رخ داده است، نمی توان تنظیم کرد.
ADJUSTMENT_PRECEDES_CONVERSION Adjustment دارای یک 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 سعی کنید کمتر از 2001 تنظیمات را در یک درخواست API آپلود کنید.
TOO_MANY_ADJUSTMENTS تبدیل قبلاً حداکثر تعداد دفعات تنظیم شده است. مطمئن شوید که فقط تنظیمات لازم را برای تبدیل موجود انجام می دهید.
RESTATEMENT_ALREADY_EXISTS این تبدیل دارای یک بیان مجدد با همان adjustmentDateTime است. مطمئن شوید که تنظیم شما دارای adjustmentDateTime صحیح و منحصر به فرد DateTime است و دوباره امتحان کنید.
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 تبدیل قبلاً با همان شناسه سفارش و اقدام تبدیل دارای پیشرفت‌هایی است. مطمئن شوید که داده های شما به درستی پیکربندی شده اند و دوباره امتحان کنید.
DUPLICATE_ENHANCEMENT_IN_REQUEST چندین پیشرفت دارای عملکرد تبدیل و شناسه سفارش یکسان هستند. مطمئن شوید که داده های شما به درستی پیکربندی شده اند و دوباره امتحان کنید.
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCEMENT به دلیل خط‌مشی‌های داده مشتری Google، نمی‌توان از تبدیل‌های پیشرفته برای این حساب استفاده کرد. با نماینده Google خود تماس بگیرید.
MISSING_ORDER_ID_FOR_WEBPAGE تنظیم برای تبدیل وب سایت به شناسه سفارش (یعنی شناسه تراکنش) نیاز دارد. مطمئن شوید که برچسب‌های وب‌سایت شما شناسه‌های سفارش را می‌گیرند و شما همان شناسه‌های سفارش را با تنظیم خود ارسال می‌کنید.
ORDER_ID_CONTAINS_PII نمی‌توان با شناسه‌های سفارش حاوی اطلاعات قابل شناسایی شخصی (PII) از تنظیم استفاده کرد.

ConversionUploadError

Enum خطاهای احتمالی آپلود تبدیل را توصیف می کند.

Enums
UNSPECIFIED تعداد نامشخص
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
TOO_MANY_CONVERSIONS_IN_REQUEST کمتر از 2001 رویداد را در یک درخواست آپلود کنید.
UNPARSEABLE_GCLID gclid وارد شده رمزگشایی نشد. مطمئن شوید که شناسه های کلیک را تغییر نداده اید.
CONVERSION_PRECEDES_EVENT رویداد وارد شده دارای یک conversionDateTime است که قبل از کلیک قرار دارد. مطمئن شوید که conversionDateTime شما صحیح است و دوباره امتحان کنید.
EXPIRED_EVENT رویداد وارد شده را نمی توان ثبت کرد زیرا کلیک آن قبل از پنجره کلیکی این تبدیل رخ داده است. مطمئن شوید که جدیدترین داده ها را وارد کرده اید.
TOO_RECENT_EVENT کلیک مرتبط با شناسه داده شده یا پارامتر URL iOS در کمتر از 6 ساعت پیش رخ داده است. پس از گذشت 6 ساعت دوباره تلاش کنید.
EVENT_NOT_FOUND رویداد وارد شده را نمی توان به یک کلیک نسبت داد. این ممکن است به این دلیل باشد که این رویداد از یک کمپین تبلیغاتی گوگل نشات گرفته است.
UNAUTHORIZED_CUSTOMER شناسه کلیک یا تماس با حساب 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 شناسه‌های سفارش را نمی‌توان برای تبدیل اندازه‌گیری شده با مدل اسناد خارجی استفاده کرد. مطمئن شوید که تبدیل به درستی پیکربندی شده است و رویدادهای وارد شده فقط شامل داده‌های ضروری هستند و دوباره امتحان کنید.
ORDER_ID_ALREADY_IN_USE رویداد وارد شده شامل شناسه سفارشی است که قبلاً ثبت شده است، بنابراین رویداد پردازش نشد.
DUPLICATE_ORDER_ID رویدادهای وارد شده شامل چندین تبدیل با شناسه سفارش یکسان است و پردازش نشدند. مطمئن شوید شناسه‌های سفارش منحصربه‌فرد هستند و دوباره امتحان کنید.
TOO_RECENT_CALL نمی‌توان تماس‌هایی را که کمتر از 6 ساعت پیش رخ داده‌اند وارد کرد. 6 ساعت دیگر دوباره آپلود کنید.
EXPIRED_CALL تماس ضبط نمی‌شود زیرا قبل از پنجره بازبینی این اقدام تبدیل رخ داده است. مطمئن شوید که واردات شما برای دریافت جدیدترین داده‌ها پیکربندی شده است.
CALL_NOT_FOUND تماس یا کلیک منتهی به رویداد وارد شده یافت نمی شود. مطمئن شوید که منبع داده شما طوری تنظیم شده است که دارای شناسه های صحیح باشد.
CONVERSION_PRECEDES_CALL تماس دارای یک conversionDateTime است که قبل از کلیک مرتبط است. مطمئن شوید که conversionDateTime شما صحیح است.
CONVERSION_TRACKING_NOT_ENABLED_AT_CALL_TIME در زمان تماس وارد شده، ردیابی تبدیل در حساب تبدیل موثر حساب Google Ads کلیک فعال نبود.
UNPARSEABLE_CALLERS_PHONE_NUMBER مطمئن شوید شماره‌های تلفن به‌عنوان E.164 (16502531234+)، بین‌المللی (6005 3-331 64+) یا شماره ملی ایالات متحده (6502531234) قالب‌بندی شده باشند.
CLICK_CONVERSION_ALREADY_EXISTS رویداد وارد شده دارای همان کلیک و conversionDateTime به عنوان یک تبدیل موجود است. برای هر رویداد منحصر به فرد از یک conversionDateTime یا شناسه سفارش منحصر به فرد استفاده کنید و دوباره امتحان کنید.
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 App Transparency Tracking (ATT) مطابقت ندارد یا مشتری با ردیابی موافقت نکرده است.
CLICK_NOT_FOUND آدرس ایمیل یا شماره تلفن این رویداد را نمی توان با یک کلیک مطابقت داد. این ممکن است به این دلیل باشد که از یک کمپین تبلیغاتی گوگل تهیه نشده است، و شما می توانید با خیال راحت این هشدار را نادیده بگیرید. اگر این شامل رویدادهای وارداتی بیش از حد انتظار است، ممکن است لازم باشد تنظیمات خود را بررسی کنید.
INVALID_USER_IDENTIFIER مطمئن شوید که داده‌های ارائه شده توسط کاربر را با استفاده از SHA-256 هش کرده‌اید و مطمئن شوید که طبق دستورالعمل‌ها عادی می‌شوید.
EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION_NOT_PERMITTED_WITH_USER_IDENTIFIER داده های ارائه شده توسط کاربر را نمی توان با مدل های اسناد خارجی استفاده کرد. از مدل انتساب دیگری استفاده کنید یا شناسه های کاربر را حذف کنید و دوباره امتحان کنید.
UNSUPPORTED_USER_IDENTIFIER شناسه های کاربر ارائه شده پشتیبانی نمی شوند. فقط از ایمیل یا شماره تلفن هش شده استفاده کنید و دوباره امتحان کنید.
GBRAID_WBRAID_BOTH_SET نمی توان از هر دو پارامتر gbraid و wbraid استفاده کرد. فقط از 1 استفاده کنید و دوباره امتحان کنید.
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 نمی‌توان رویدادها را با شناسه‌های سفارش حاوی اطلاعات شناسایی شخصی (PII) وارد کرد.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS مطمئن شوید که در تنظیمات تبدیل، تبدیل‌های پیشرفته برای سرنخ‌ها را روشن کرده‌اید و دوباره امتحان کنید. می‌توانید تنظیمات خود را با درخواست conversionTrackingSetting.enhanced_conversions_for_leads_enabled در مشتری بررسی کنید.

خطای تاریخ

Enum خطاهای احتمالی تاریخ را توصیف می کند.

Enums
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.ssssss باشد.
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 هر دو تاریخ در محدوده صفر هستند.

خطای متمایز

Enum خطاهای متمایز احتمالی را توصیف می کند.

Enums
UNSPECIFIED تعداد نامشخص
UNKNOWN کد خطای دریافتی در این نسخه مشخص نیست.
DUPLICATE_ELEMENT عنصر تکراری
DUPLICATE_TYPE نوع تکراری

فیلد خطا

Enum خطاهای احتمالی فیلد را توصیف می کند.

Enums
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

Enum خطاهای احتمالی جهش را توصیف می کند.

Enums
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 این عملیات را نمی توان با "جزئی" استفاده کرد.
RESOURCE_READ_ONLY سعی کنید در فیلدهای فقط خواندنی بنویسید.

NotAllowlistedError

Enum خطاهای احتمالی در لیست مجاز را شرح می دهد.

Enums
UNSPECIFIED تعداد نامشخص
UNKNOWN کد خطای دریافتی در این نسخه مشخص نیست.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE مشتری برای دسترسی به این ویژگی در لیست مجاز نیست.

StringFormatError

Enum خطاهای احتمالی قالب رشته را توصیف می کند.

Enums
UNSPECIFIED تعداد نامشخص
UNKNOWN کد خطای دریافتی در این نسخه مشخص نیست.
ILLEGAL_CHARS مقدار رشته ورودی حاوی کاراکترهای غیر مجاز است.
INVALID_FORMAT مقدار رشته ورودی برای فیلد مرتبط نامعتبر است.

StringLengthError

Enum خطاهای احتمالی طول رشته را توصیف می کند.

Enums
UNSPECIFIED تعداد نامشخص
UNKNOWN کد خطای دریافتی در این نسخه مشخص نیست.
EMPTY فیلد مشخص شده باید حداقل یک کاراکتر بدون فاصله سفید در آن داشته باشد.
TOO_SHORT خیلی کوتاه.
TOO_LONG خیلی طولانی است.

CustomerAgreementSetting

تنظیم توافق نامه مشتری برای مشتری.

نمایندگی JSON
{
  "acceptedLeadFormTerms": boolean
}
زمینه های
acceptedLeadFormTerms

boolean

فقط خروجی اینکه آیا مشتری مدت خدمات از فرم سرنخ را پذیرفته است یا خیر.