Customer

یک مشتری.

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

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

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 قابل مدیریت است. این فیلد فقط خواندنی است.

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

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

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

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)

فقط خروجی شناسه معیار جغرافیایی مرتبط با وضعیت. بسته به شرایط و موقعیت مکانی می تواند در سطح جغرافیایی کشور یا ایالت/استان باشد. برای اطلاعات بیشتر به 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

فهرستی که وضعیت دسته‌بندی تأیید آگهی‌های خدمات محلی خاص را توصیف می‌کند.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN وضعیت تأیید نامشخص
NEEDS_REVIEW راستی‌آزمایی شروع شده است، اما تمام نشده است.
FAILED تأیید ناموفق بود.
PASSED تأیید به پایان رسیده است.
NOT_APPLICABLE تأیید قابل اجرا نیست.
NO_SUBMISSION تأیید لازم است اما در انتظار ارسال است.
PARTIAL_SUBMISSION همه تأییدیه های مورد نیاز ارسال نشده است.
PENDING_ESCALATION تأیید نیاز به بازبینی توسط متخصص عملیات تبلیغات خدمات محلی دارد.

وضعیت بیمه گرانول

وضعیت بیمه در سطح جغرافیایی + عمودی.

نمایندگی JSON
{
  "geoCriterionId": string,
  "categoryId": string,
  "verificationStatus": enum (LocalServicesVerificationStatus)
}
زمینه های
geoCriterionId

string ( int64 format)

فقط خروجی شناسه معیار جغرافیایی مرتبط با وضعیت. بسته به شرایط و موقعیت مکانی می تواند در سطح جغرافیایی کشور یا ایالت/استان باشد. برای اطلاعات بیشتر به 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 )

فقط خروجی وضعیت بیمه گرانول، در هر جغرافیایی + عمودی.