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)
  },
  "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)

النتائج فقط. إعدادات عميل "الخدمات المحلّية".
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)

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

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

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

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

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