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

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

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

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)

النتائج فقط. ملخّص إحصاءات السجلّ حسب آخر "عدد" من المهام

alerts[]

object (OfflineConversionUploadAlert)

النتائج فقط. تفاصيل كل رمز خطأ. يتم إنشاء التنبيهات من آخر يوم تقويمي مع إحصاءات التحميل.

OfflineEventUploadClient

نوع العميل.

عمليات التعداد
UNSPECIFIED غير محدَّد.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
GOOGLE_ADS_API واجهة برمجة التطبيقات مع "إعلانات Google".
GOOGLE_ADS_WEB_CLIENT برنامج الويب على "إعلانات Google"، والذي يمكن أن يتضمّن مصادر متعددة مثل واجهة مستخدم "إعلانات Google" وبروتوكول النقل الآمن للملفات (SFTP) وما إلى ذلك.
ADS_DATA_CONNECTOR نظام أساسي للاتصال

OfflineConversionDiagnosticStatus

الحالات المحتملة لإعداد نقل البيانات المتوفّرة بلا إنترنت.

عمليات التعداد
UNSPECIFIED غير محدَّد.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
EXCELLENT إعداد نقل البيانات المتوفّرة بلا إنترنت مفعّل ومثالي لمعالجة بيانات ما بعد بيع المنتج.
GOOD إعداد نقل البيانات المتوفّرة بلا إنترنت مفعّل، ولكن هناك تحسينات إضافية يمكنك إجراؤها. الاطّلاع على تنبيهات
NEEDS_ATTENTION إعداد نقل البيانات المتوفّرة بلا إنترنت مفعّل، ولكن هناك أخطاء تستدعي انتباهك. الاطّلاع على تنبيهات
NO_RECENT_UPLOAD لم يتلقَّ إعداد نقل البيانات المتوفّرة بلا إنترنت أي بيانات في آخر 28 يومًا، لذا قد يكون هناك خطأ.

OfflineConversionUploadSummary

ملخّص عمليات التحميل السابقة، مجمّعًا حسب تاريخ التحميل أو المهمة

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

يصف قيم التعداد الأخطاء المحتملة في حجم المجموعة.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيم التعداد.
UNKNOWN رمز الخطأ الذي تم استلامه غير معروف في هذا الإصدار.
TOO_FEW عدد قليل جدًا.
TOO_MANY عدد العناصر كبير جدًا.

ConversionAdjustmentUploadError

يشير حقل التعداد إلى أخطاء تحميل تعديلات الإحالات الناجحة المحتملة.

عمليات التعداد
UNSPECIFIED غير محدَّد.
UNKNOWN يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
TOO_RECENT_CONVERSION_ACTION لا يمكن استيراد الأحداث إلى إجراء إحالة ناجحة تم إنشاؤه للتو. جرِّب الاستيراد مرة أخرى بعد 6 ساعات.
INVALID_CONVERSION_ACTION تأكّد من تحديد إجراء إحالة ناجحة نشط يمكن تعديله.
CONVERSION_ALREADY_RETRACTED سبق أن تم سحب الإحالة الناجحة. لم تتم معالجة هذه التسوية.
CONVERSION_NOT_FOUND لا يمكن العثور على الإحالة الناجحة لإجراء الإحالة الناجحة ومعرّفها. تأكّد من ارتباط معرفات الإحالة الناجحة بإجراء الإحالة الناجحة الصحيح وأعِد المحاولة.
CONVERSION_EXPIRED لا يمكن إجراء تعديل على إحالة ناجحة حدثت قبل أكثر من 54 يومًا.
ADJUSTMENT_PRECEDES_CONVERSION تحتوي التسوية على 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 تعديل في أي طلب بيانات واحد من واجهة برمجة التطبيقات.
TOO_MANY_ADJUSTMENTS سبق أن تم تعديل الإحالة الناجحة لأقصى عدد من المرات. تأكّد من إجراء التعديلات اللازمة فقط على الإحالة الناجحة الحالية.
RESTATEMENT_ALREADY_EXISTS تمت إعادة صياغة سابقة للإحالة الناجحة باستخدام adjustmentDateTime نفسه. تأكَّد من أنّ التعديل يتضمّن قيمة adjustmentDateTime الصحيحة والفريدة من نوعها وأعِد المحاولة.
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 لا يمكن ضبط كل من gclidDateTimeزوج وorderId. يُرجى استخدام نوع واحد فقط وإعادة المحاولة.
CONVERSION_ALREADY_ENHANCED تحتوي الإحالة الناجحة حاليًا على تحسينات لها مُعرّف الطلب وإجراء الإحالة الناجحة نفسهما. تأكّد من ضبط بياناتك بشكل صحيح وأعِد المحاولة.
DUPLICATE_ENHANCEMENT_IN_REQUEST تتضمّن تحسينات متعددة إجراء الإحالة الناجحة ومُعرّف الطلب نفسَيهما. تأكّد من ضبط بياناتك بشكل صحيح وأعِد المحاولة.
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCEMENT لا يمكن استخدام ميزة الإحالات الناجحة المحسّنة لهذا الحساب بسبب سياسات بيانات العميل في Google. يُرجى التواصل مع ممثّل Google الذي تتعامل معه.
MISSING_ORDER_ID_FOR_WEBPAGE إنّ تعديل الإحالة الناجحة للموقع الإلكتروني يتطلب معرّف الطلب (أي معرّف المعاملة). تأكّد من أن علامات موقعك الإلكتروني تسجِّل مُعرّفات الطلبات ومن أنك ترسل معرّفات الطلبات نفسها مع تعديلك.
ORDER_ID_CONTAINS_PII لا يمكن استخدام التعديل مع مُعرّفات الطلبات التي تحتوي على معلومات تحديد الهوية الشخصية.

ConversionUploadError

يصف حقل التعداد أخطاء تحميل الإحالات الناجحة المحتملة.

عمليات التعداد
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 تعذّر تحديد مصدر الحدث المستورَد بالاستناد إلى إحدى النقرات. قد يرجع السبب في ذلك إلى أنّ الحدث لم يرد من حملة على "إعلانات Google".
UNAUTHORIZED_CUSTOMER يرتبط معرّف النقرة أو المكالمة بحساب على "إعلانات Google" لا تملك إذن الوصول إليه. تأكَّد من استيراد الإحالات الناجحة للحسابات التي يديرها حسابك الإداري.
INVALID_CONVERSION_ACTION تأكّد من تحديد إجراء إحالة ناجحة صالح سبق إعداده للاستيراد بلا اتصال بالإنترنت.
TOO_RECENT_CONVERSION_ACTION لا يمكن استيراد الأحداث إلى إجراء إحالة ناجحة تم إنشاؤه للتو. جرِّب الاستيراد مرة أخرى بعد 6 ساعات.
CONVERSION_TRACKING_NOT_ENABLED_AT_IMPRESSION_TIME في وقت النقرة، لم تكن ميزة تتبُّع الإحالات الناجحة مفعَّلة في حساب الإحالات الناجحة الفعّالة ضمن حساب "إعلانات Google" للنقرة.
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" للنقرة.
UNPARSEABLE_CALLERS_PHONE_NUMBER تأكَّد من كتابة أرقام الهواتف بالتنسيق E.164 (+16502531234) أو الرقم الدولي (+64 3-331 6005) أو الرقم الوطني الأمريكي (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 لا يمكن استيراد الأحداث التي تتضمن متغيّرات مخصّصة تحتوي على معلومات تحديد الهوية الشخصية. يُرجى إزالة هذه المتغيّرات وإعادة المحاولة.
INVALID_CUSTOMER_FOR_CLICK ترتبط النقرة الواردة من الحدث المستورَد بحساب آخر على "إعلانات Google". تأكّد من استيراد الحدث إلى الحساب الصحيح.
INVALID_CUSTOMER_FOR_CALL ترتبط النقرة من المكالمة بحساب مختلف على "إعلانات Google". تأكّد من استيراد الحدث إلى الحساب الصحيح. يمكنك الاستعلام عن conversionTrackingSettings.google_ads_conversion_customer في العميل لتحديد الحساب الصحيح.
CONVERSION_NOT_COMPLIANT_WITH_ATT_POLICY لا يمكن استيراد الإحالة الناجحة بسبب عدم التزام مصدر الإحالة الناجحة بسياسات "تتبُّع شفافية التطبيقات" (ATT) من Apple أو لأنّ العميل لم يوافق على التتبُّع.
CLICK_NOT_FOUND تتعذّر مطابقة عنوان البريد الإلكتروني أو رقم الهاتف الخاص بهذا الحدث مع إحدى النقرات. قد يرجع ذلك إلى أنّ هذه النقرة ليست واردة من حملة على "إعلانات Google"، وبالتالي يمكنك تجاهل هذا التحذير بشكلٍ آمن. إذا كان هذا الموقف يتضمن ظهور عدد من الأحداث المستورَدة أكبر من المتوقّع، قد تحتاج إلى إلقاء نظرة على إعداداتك.
INVALID_USER_IDENTIFIER تأكَّد من تجزئة البيانات المقدَّمة من المستخدم باستخدام خوارزمية SHA-256 والتأكّد من إجراء التسوية وفقًا للإرشادات.
EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION_NOT_PERMITTED_WITH_USER_IDENTIFIER لا يمكن استخدام البيانات المقدَّمة من المستخدِم مع نماذج تحديد المصدر الخارجية. يمكنك استخدام نموذج إحالة آخر أو حذف معرّفات المستخدمين وإعادة المحاولة.
UNSUPPORTED_USER_IDENTIFIER معرّفات المستخدمين المقدّمة غير متوافقة. استخدِم فقط عنوان بريد إلكتروني أو رقم هاتف مجزّأ وأعد المحاولة.
GBRAID_WBRAID_BOTH_SET لا يمكن استخدام gbraid وwbraid. يُرجى استخدام معلمة واحدة فقط وإعادة المحاولة.
UNPARSEABLE_WBRAID لا يمكن تحليل بيانات استيراد الحدث. تأكّد ممّا إذا لم يتم تعديل المَعلمة wbraid وأعِد المحاولة.
UNPARSEABLE_GBRAID لا يمكن تحليل بيانات استيراد الحدث. تأكّد ممّا إذا لم يتمّ تعديل المَعلمة gbraid وأعِد المحاولة.
ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID لا يمكن استخدام الإجراءات التي تَعدّ إحالة ناجحة واحدة بعد النقر مع المَعلمتين gbraid أو brbrid.
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS لا يمكن استخدام ميزة الإحالات الناجحة المحسّنة لهذا الحساب بسبب سياسات بيانات العميل في Google. يُرجى التواصل مع ممثّل Google الذي تتعامل معه.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS تأكّد من موافقتك على بنود معالجة بيانات العملاء في إعدادات الإحالة الناجحة، ثم أعِد المحاولة. يمكنك التحقّق من إعداداتك من خلال إرسال طلب بحث إلى conversionTrackingSetup.accepted_customer_data_terms on Customer.
ORDER_ID_CONTAINS_PII لا يمكن استيراد الأحداث التي تتضمن مُعرّفات طلبات تحتوي على معلومات تحديد الهوية الشخصية.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS تأكّد من تفعيل ميزة الإحالات الناجحة المحسّنة للعملاء المحتملين في إعدادات الإحالة الناجحة وأعِد المحاولة. يمكنك التحقّق من إعدادك عن طريق طلب بحث عن conversionTrackingإعداد.enhanced_conversions_for_leads_enabled في "العميل".

DateError

يصف حقل التعداد أخطاء التاريخ المحتملة.

عمليات التعداد
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.sssss.
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 كلا التاريخين في النطاق فارغان.

DistinctError

يشير حقل Enum إلى الأخطاء المميزة المحتملة.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيم التعداد.
UNKNOWN رمز الخطأ الذي تم استلامه غير معروف في هذا الإصدار.
DUPLICATE_ELEMENT العنصر مكرّر.
DUPLICATE_TYPE نوع مكرّر.

FieldError

يصف حقل Enum الأخطاء المحتملة في الحقل.

عمليات التعداد
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

يصف قيم التعداد أخطاء التبديل المحتملة.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيم التعداد.
UNKNOWN رمز الخطأ الذي تم استلامه غير معروف في هذا الإصدار.
RESOURCE_NOT_FOUND لم يتم العثور على المورد المطلوب.
ID_EXISTS_IN_MULTIPLE_MUTATES لا يمكن تبديل نفس المورد مرتين في طلب واحد.
INCONSISTENT_FIELD_VALUES لا يتطابق محتوى الحقل مع حقل آخر يمثّل البيانات نفسها.
MUTATE_NOT_ALLOWED لا يُسمح بالتبديلات للمورد المطلوب.
RESOURCE_NOT_IN_GOOGLE_ADS المورد ليس في "إعلانات Google". إنه ينتمي إلى نظام إعلانات آخر.
RESOURCE_ALREADY_EXISTS المورد الذي يتم إنشاؤه موجود من قبل.
RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY لا يمكن استخدام هذا المورد مع "verifyOnly".
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE لا يمكن استخدام هذه العملية مع "partialFailure".
RESOURCE_READ_ONLY محاولة الكتابة في الحقول المخصّصة للقراءة فقط

NotAllowlistedError

يشير قيم التعداد إلى الأخطاء المحتملة غير المدرَجة في القائمة المسموح بها.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيم التعداد.
UNKNOWN رمز الخطأ الذي تم استلامه غير معروف في هذا الإصدار.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE العميل غير مُدرَج في القائمة المسموح بها للوصول إلى هذه الميزة.

StringFormatError

يصف حقل Enum الأخطاء المحتملة لتنسيق السلسلة.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيم التعداد.
UNKNOWN رمز الخطأ الذي تم استلامه غير معروف في هذا الإصدار.
ILLEGAL_CHARS تحتوي قيمة سلسلة الإدخال على أحرف غير مسموح بها.
INVALID_FORMAT قيمة سلسلة الإدخال غير صالحة في الحقل المرتبط.

StringLengthError

يصف حقل Enum الأخطاء المحتملة في طول السلسلة.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيم التعداد.
UNKNOWN رمز الخطأ الذي تم استلامه غير معروف في هذا الإصدار.
EMPTY يجب أن يحتوي الحقل المحدد على حرف واحد على الأقل بدون مسافات بيضاء.
TOO_SHORT قصير جدًا.
TOO_LONG طويل جدًا.

CustomerAgreementSetting

إعداد اتفاقية العميل لعميل

تمثيل JSON
{
  "acceptedLeadFormTerms": boolean
}
الحقول
acceptedLeadFormTerms

boolean

النتائج فقط. ما إذا كان العميل قد قَبِل بنود الخدمة لنموذج العملاء المحتمَلين.