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.conversion. إذا كانت القائمة فارغة، يكون العميل مؤهّلاً. هذا الحقل للقراءة فقط.
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

النتائج فقط. ما إذا كان "العميل" حاصلاً على شارة "برنامج الشركاء" إذا لم يكن "العميل" مرتبطًا ببرنامج "الشركاء"، ستكون هذه المعلومات خاطئة. لمزيد من المعلومات، يُرجى الاطّلاع على 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

مجموعة من الإعدادات على مستوى العميل ذات الصلة بميزة "تتبُّع الإحالات الناجحة" في "إعلانات Google".

تمثيل 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)

النتائج فقط. رقم تعريف تتبُّع الإحالات الناجحة لمدير العميل. يتم ضبط ذلك عند تفعيل العميل لميزة "تتبُّع الإحالات الناجحة في جميع الحسابات"، ويتم بالتالي إلغاء قيمة الإحالة الناجحةTrackingId. لا يمكن إدارة هذا الحقل إلّا من خلال واجهة مستخدِم "إعلانات Google". هذا الحقل للقراءة فقط.

RemarketingSetting

إعداد تجديد النشاط التسويقي للعميل.

تمثيل JSON 
{
  "googleGlobalSiteTag": string
}
الحقول
googleGlobalSiteTag

string

النتائج فقط. علامة Google

CustomerPayPerConversionEligibilityFailureReason

يشير هذا المقياس إلى التعداد الذي يصف الأسباب المحتملة لعدم أهلية العميل لاستخدام PaymentMode.conversion.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
NOT_ENOUGH_CONVERSIONS ليس لدى العميل عدد كافٍ من الإحالات الناجحة.
CONVERSION_LAG_TOO_HIGH تأخُّر اكتمال الإحالة الناجحة للعميل مرتفع جدًا.
HAS_CAMPAIGN_WITH_SHARED_BUDGET يستخدم العميل ميزانيات مشتركة.
HAS_UPLOAD_CLICKS_CONVERSION يمتلك العميل إحالات ناجحة من نوع ConversionActionType.UPLOAD_MINUTES.
AVERAGE_DAILY_SPEND_TOO_HIGH متوسط الإنفاق اليومي للعميل مرتفع جدًا.
ANALYSIS_NOT_COMPLETE لم يتم بعد احتساب أهلية العميل من خلال خلفية "إعلانات Google". يُرجى التحقّق مرة أخرى قريبًا.
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_ رأيك. لمزيد من التفاصيل، يُرجى الاطّلاع على: 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)

النتائج فقط. معرّف معيار الاستهداف الجغرافي المرتبط بالحالة. يمكن أن يكون على المستوى الجغرافي للبلد أو الولاية/المقاطعة، بناءً على المتطلبات والموقع. يمكنك الانتقال إلى https://developers.google.com/google-ads/api/data/geotargets لمزيد من المعلومات.
categoryId

string

النتائج فقط. فئة الخدمة المرتبطة بالحالة. على سبيل المثال، xcat:service_area_business_ رأيك. لمزيد من التفاصيل، يُرجى الاطّلاع على: https://developers.google.com/google-ads/api/data/codes-formats#local_services_ids
verificationStatus

enum (LocalServicesVerificationStatus)

النتائج فقط. حالة التأمين الدقيقة، حسب الموقع الجغرافي والقطاع