تحديد المشاكل وحلّها

تتطلّب إدارة الإحالات الناجحة عملية دمج معقّدة، وغالبًا ما تشمل أدوات وعمليات متعددة مترابطة. يقدّم هذا الدليل خطوات مفصّلة يمكنك اتّخاذها لتحديد أي مشاكل تواجهك وحلّها، سواء كنت تتلقّى أخطاءً من واجهة برمجة التطبيقات لا تفهمها، أو إذا كنت غير متأكّد من المقاييس أو بيانات التشخيص التي تظهر لك في واجهة المستخدم.

ملاحظة مهمة: لا يعني تلقّي استجابة ناجحة من واجهة برمجة التطبيقات بشأن عملية الاستيراد أنّه تم تحديد مصدر الإحالات الناجحة. يُرجى الاطّلاع على مقالة مركز المساعدة هذه لمزيد من التفاصيل حول التناقضات في البيانات بعد عملية استيراد ناجحة.

قراءة المقاييس في واجهة مستخدم "إعلانات Google"

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

مشاكل في ميزة "الإحالات الناجحة المحسّنة للعملاء المحتملين"

يركّز هذا القسم على معالجة المشاكل الشائعة التي تواجهك أثناء استيراد الإحالات الناجحة المحسّنة للعملاء المحتملين.

الأخطاء الشائعة

خطأ
NO_CONVERSION_ACTION_FOUND	إجراء الإحالة الناجحة المحدّد غير مفعَّل أو لا يمكن لحساب العميل المحدّد من خلال الحقل `client_id` في الطلب الوصول إليه. تأكَّد من أنّ إجراء الإحالة الناجحة في عملية التحميل مفعّل وأنّ العميل الذي يرسل طلب التحميل هو مالكه. قد يحدث هذا الخطأ أيضًا إذا كان معرّف GCLID في الطلب ينتمي إلى حساب عميل لا يمكنه الوصول إلى إجراء الإحالة الناجحة المحدّد في الطلب. يمكنك التحقّق مما إذا كان معرّف النقرة من Google ‏(GCLID) يخصّ حساب عميل باستخدام المرجع click_view، وذلك عن طريق إرسال طلب بحث يفلتر حسب click_view.gclid وsegments.date، حيث يكون التاريخ هو تاريخ حدوث النقرة.
INVALID_CONVERSION_ACTION_TYPE	يتضمّن إجراء الإحالة الناجحة المحدّد نوعًا غير صالح لميزة "الإحالات الناجحة المحسّنة للعملاء المحتملين". تأكَّد من أنّ ConversionAction المحدّد في طلب التحميل هو من النوع UPLOAD_CLICKS.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS	تأكَّد من تفعيل ميزة "الإحالات الناجحة المحسّنة للعملاء المحتملين" في إعدادات الإحالة الناجحة. يمكنك العثور على تعليمات حول ذلك في دليل المتطلبات الأساسية.
DUPLICATE_ORDER_ID	تتضمّن الأحداث المستورَدة إحالات ناجحة متعددة بمعرّف الطلب نفسه ولم تتم معالجتها. يُرجى التأكّد من أنّ معرّفات الطلبات فريدة وإعادة المحاولة.
CLICK_NOT_FOUND	لم يتم العثور على أي نقرة تطابق معرّفات المستخدم المقدَّمة. لا تعرض Google Ads API هذا الخطأ إلا إذا كانت قيمة debug_enabled هي true في UploadClickConversionsRequest. ملاحظة: تعامَل مع هذا الخطأ على أنّه تحذير ما لم يحدث مع معظم إحالاتك الناجحة. إذا ظهر هذا التحذير لإحدى الإحالات الناجحة، ستدرجها Google Ads API في successful_event_count ضمن بيانات التشخيص المتعلّقة بالبيانات المتوفّرة بلا إنترنت. يتضمّن Google Ads API إدخالاً خاصًا بـ CLICK_NOT_FOUND في مجموعة alerts، ما يتيح لك تتبُّع عدد مرات ظهور هذا التحذير. من المتوقّع حدوث هذا الخطأ إذا لم تكن النقرة واردة من حملة على "إعلانات Google". على سبيل المثال، قد يأتي من SA360 أو DV360. تشمل الأسباب المحتملة الأخرى ما يلي: يختلف العميل الذي يحمّل البيانات عن عميل الإحالة الناجحة في "إعلانات Google". لم يتم ضبط وضع العلامات بشكل صحيح لنموذج العملاء المحتملين. لم تتم تسوية البيانات وتجزئتها التي تم تحميلها بشكلٍ صحيح. في حالات نادرة يكون فيها العميل الذي يحمّل البيانات مختلفًا عن العميل الذي أجرى الإحالة الناجحة في "إعلانات Google"، قد يعني هذا الخطأ أنّ العميل الذي يحمّل البيانات قد وافق على بنود بيانات العملاء، ولكن العميل الذي أجرى الإحالة الناجحة لم يوافق عليها. يمكنك تحديد ما إذا كان الحساب قد قبل بنود بيانات العملاء من خلال طلب البحث عن مصدر customer والتحقّق من الحقل customer.offline_conversion_tracking_info.accepted_customer_data_terms.

الاختلافات في المقاييس

يُرجى مراعاة المشاكل الشائعة التالية:

• قد يتم إسقاط الإحالات الناجحة من خلال مسار المعالجة الخاص بنا لأسباب مختلفة، ولا يمكن استرداد هذه الإحالات الناجحة. لمزيد من المعلومات، يُرجى الاطّلاع على المقالة التناقضات بين البيانات بعد التحميل الناجح.

• تأكَّد من إعداد "علامة Google" بشكلٍ صحيح على صفحة الويب، ومن أنّها يتم تنشيطها عند إرسال نماذج العملاء المحتملين. إذا لم يتم تنشيط علامتك عند إرسال النماذج، أو إذا كانت ترسل بيانات غير صحيحة، من المحتمل أن تلاحظ مستوى إحالات ناجحة منخفضًا أو عدم توفّر إحالات ناجحة في الإحالات الناجحة التي تم تحميلها. راجِع مقالات مركز المساعدة حول ضبط "علامة Google" وضبط أداة "إدارة العلامات من Google" لاستخدام ميزة "الإحالات الناجحة المحسّنة للعملاء المحتملين".

• إذا كنت تستخدم ميزة "الإحالات الناجحة المحسّنة للعملاء المحتملين" بدون علامة Google على صفحة الويب، يجب تضمين معرّف النقرة من Google في عمليات استيراد الإحالات الناجحة من خلال ضبط الحقل ClickConversion.gclid في كل إحالة ناجحة.

• تأكَّد من تحديد الموافقة بشكل صحيح في عمليات التحميل. يمكنك إجراء ذلك من خلال ضبط إعدادات الموافقة التلقائية لحسابك (في واجهة مستخدم "إعلانات Google"، انقر على الأدوات -> إدارة بيانات إعلانات Google -> إعدادات الموافقة) أو من خلال ضبط الحقل ClickConversion.consent لكل إحالة ناجحة تم تحميلها.

مشاكل في أداء الحملة

إذا لم تواجه أي مشاكل فنية في تحميل إحالاتك الناجحة وكنت مرتاحًا للمقاييس المعروضة، ولكن لم تلاحظ التحسينات المتوقّعة في أداء الحملة أو "الزيادة" بعد تنفيذ ميزة "الإحالات الناجحة المحسّنة للعملاء المحتملين"، يُرجى التواصل مع فريق دعم منتجات "إعلانات Google" للحصول على المساعدة.

المشاكل المتعلّقة بميزة "الإحالات الناجحة المحسّنة للويب"

يركّز هذا القسم على معالجة المشاكل الشائعة التي تواجهك أثناء استيراد الإحالات الناجحة المحسّنة للويب.

الأخطاء الشائعة

خطأ
CONVERSION_NOT_FOUND	تعذّر العثور على إحالة ناجحة لإجراء الإحالة الناجحة ومعرّف الإحالة الناجحة المحدّدَين أو order_id. تأكَّد من أنّ الإحالة الناجحة هي إحالة ناجحة في "إعلانات Google" لعميل الإحالة الناجحة في "إعلانات Google" المحدّد في customer_id للطلب. بالإضافة إلى ذلك، تأكَّد من أنّ الإحالة الناجحة لم تكن لنقرة تم فيها ملء gbraid أو wbraid بدلاً من gclid. لا تتيح "إعلانات Google" ميزة "الإحالات الناجحة المحسّنة للويب" لهذه الإحالات الناجحة.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS	لم يتم قبول أحكام وشروط بيانات العملاء الخاصة بـ customer_id الطلب. يمكنك العثور على تعليمات حول ذلك في دليل المتطلبات الأساسية.
CONVERSION_ALREADY_ENHANCED	سبق أن تلقّت هذه الإحالة الناجحة تعديلاً باستخدام order_id وconversion_action المحدّدين. احرص على تقديم order_id فريد لكل إحالة ناجحة.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT	إنّ conversion_action المقدَّم غير مؤهَّل لاستخدام ميزة "الإحالات الناجحة المحسّنة للويب". في واجهة مستخدم "إعلانات Google"، تأكَّد من وضع علامة في المربّع تفعيل ميزة الإحالات الناجحة المحسّنة في إجراء الإحالة الناجحة المشار إليه في طلبك. يمكنك الاطّلاع على التعليمات الخاصة بذلك في مركز المساعدة.

المشاكل العامة المتعلّقة بإدارة الإحالات الناجحة

يُرجى مراعاة المشاكل الشائعة التالية:

• ستؤدي محاولة ضبط أي حقل تعداد على UNKNOWN إلى حدوث خطأ RequestError.INVALID_ENUM_VALUE. وهذه مشكلة شائعة عند تحديد consent عندما لا يعرف المعلِن ما إذا تم منح الموافقة أم لا. إذا كانت حالة consent غير معروفة، يجب ضبطها على DENIED.

• عند إنشاء إجراء إحالة ناجحة للإحالات الناجحة للتطبيقات أو إحصاءات التطبيقات التابعة لجهات خارجية وFirebase، يمكنك تعديل الحقل app_id عند الإنشاء فقط، ولا يمكن تغيير هذا الحقل بعد إنشاء إجراء الإحالة الناجحة.

• عند إنشاء إجراء إحالة ناجحة، يمكنك ضبط الحقل ConversionAction.attribution_model_settings.attribution_model على GOOGLE_ADS_LAST_CLICK أو GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN فقط. سيؤدي أي خيار آخر إلى حدوث خطأ CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. يتضمّن منشور المدوّنة الذي أعلنّا فيه عن إيقاف نماذج تحديد المصدر الأخرى مزيدًا من التفاصيل.

• النطاق المسموح به للحقل click_through_lookback_window_days هو [1, 60] لإجراءات الإحالات الناجحة من النوع AD_CALL وWEBSITE_CALL. بالنسبة إلى معظم إجراءات الإحالات الناجحة الأخرى، النطاق المسموح به هو [1, 30].

• النطاق المسموح به للحقل view_through_lookback_window_days هو [1, 30] لمعظم إجراءات الإحالات الناجحة. يجب إلغاء ضبط هذا الحقل لإجراءات الإحالات الناجحة من النوع AD_CALL وWEBSITE_CALL.

• سيؤدي ضبط حقل include_in_conversion_metrics أو تعديله في إجراء إحالة ناجحة إلى حدوث خطأ FieldError.IMMUTABLE_FIELD. بدلاً من ذلك، اضبط الحقل primary_for_goal، كما هو موضّح في دليل أهداف الإحالات الناجحة.

• عند إنشاء إجراء إحالة ناجحة من النوع WEBSITE_CALL أو AD_CALL، يجب ضبط value_settings.always_use_default_value على true. سيؤدي تحديد القيمة false إلى حدوث الخطأ INVALID_VALUE.

الأخطاء الشائعة

خطأ
INVALID_CONVERSION_ACTION_TYPE	يتضمّن إجراء الإحالة الناجحة المحدّد نوعًا غير صالح لتحميل الإحالات الناجحة الناتجة عن النقر. تأكَّد من أنّ ConversionAction المحدّد في طلب التحميل هو من النوع UPLOAD_CLICKS.
NO_CONVERSION_ACTION_FOUND	إجراء الإحالة الناجحة المحدّد غير مفعّل أو لا يمكن العثور عليه ضمن customer_id التحميل. استرداد معلومات حول إعداد الإحالة الناجحة للتأكّد من أنّ إجراء الإحالة الناجحة في عملية التحميل مفعّل وأنّ customer_id يملك طلب التحميل.
TOO_RECENT_CONVERSION_ACTION	تم إنشاء إجراء الإحالة الناجحة حديثًا. انتظر 6 ساعات على الأقل بعد إنشاء الإجراء قبل إعادة محاولة الإحالات الناجحة التي تعذّر تسجيلها.
INVALID_CUSTOMER_FOR_CLICK	إنّ customer_id للطلب ليس هو رقم تعريف العميل نفسه الذي كان حساب الإحالة الناجحة في Google Ads API في وقت النقر. عدِّل customer_id الطلب ليصبح موجّهًا إلى العميل الصحيح.
EVENT_NOT_FOUND	يتعذّر على "إعلانات Google" العثور على المجموعة التي تشمل رقم تعريف النقرة وcustomer_id. راجِع متطلبات customer_id وتأكَّد من أنّك تحمّل البيانات باستخدام حساب "إعلانات Google" الصحيح.
DUPLICATE_CLICK_CONVERSION_IN_REQUEST	تتضمّن الإحالات الناجحة المتعددة في الطلب المجموعة نفسها من معرّف النقرة وconversion_date_time وconversion_action. أزِل الإحالات الناجحة المكرّرة من طلبك.
CLICK_CONVERSION_ALREADY_EXISTS	سبق أن تمّ تحميل إحالة ناجحة تتضمّن المجموعة نفسها من معرّف النقرة وconversion_date_time وconversion_action. تجاهَل هذا الخطأ إذا كنت تعيد محاولة التحميل وقد نجحت هذه الإحالة الناجحة سابقًا. إذا أردت إضافة إحالة ناجحة أخرى بالإضافة إلى الإحالة الناجحة التي تم تحميلها سابقًا، عدِّل conversion_date_time ClickConversion لتجنُّب تكرار الإحالة الناجحة التي تم تحميلها سابقًا.
EVENT_NOT_FOUND	يتعذّر على "إعلانات Google" العثور على المجموعة التي تشمل رقم تعريف النقرة وcustomer_id. راجِع متطلبات customer_id وتأكَّد من أنّك تحمّل البيانات باستخدام حساب "إعلانات Google" الصحيح.
EXPIRED_EVENT	حدثت النقرة المستورَدة قبل الإطار الزمني المحدّد في الحقل click_through_lookback_window_days. إنّ إجراء تغيير على click_through_lookback_window_days يؤثّر فقط في النقرات التي تم تسجيلها بعد التغيير، وبالتالي لن يؤدّي تغيير فترة معاينة الإعلان إلى حلّ هذا الخطأ للنقرة المحدّدة. إذا كان ذلك مناسبًا، غيِّر conversion_action إلى إجراء آخر يتضمّن فترة معاينة أطول.
CONVERSION_PRECEDES_EVENT	يجب أن يكون conversion_date_time قبل تاريخ ووقت النقر. عدِّل conversion_date_time إلى قيمة لاحقة.
GBRAID_WBRAID_BOTH_SET	يحتوي ClickConversion على قيمة مضبوطة لكل من gbraid وwbraid. عدِّل الإحالة الناجحة لاستخدام معرّف نقرة واحد فقط، وتأكَّد من أنّك لا تجمع نقرات متعددة في الإحالة الناجحة نفسها. لكل نقرة معرّف نقرة واحد فقط.
VALUE_MUST_BE_UNSET	تحقَّق من location الخاص بـ GoogleAdsError لتحديد المشكلة التالية التي أدّت إلى حدوث الخطأ. تحتوي السمة ClickConversion على قيمة تم ضبطها على gclid بالإضافة إلى قيمة واحدة على الأقل من gbraid أو wbraid. عدِّل الإحالة الناجحة لاستخدام معرّف نقرة واحد فقط، وتأكَّد من عدم الجمع بين نقرات متعددة في الإحالة الناجحة نفسها. لكل نقرة معرّف نقرة واحد فقط. يحتوي ClickConversion على قيمة مضبوطة إما gbraid أو wbraid، كما يحتوي على قيمة custom_variables. لا تتيح "إعلانات Google" استخدام متغيّرات مخصّصة لإحالة ناجحة تتضمّن معرّف نقرة gbraid أو wbraid. ألغِ ضبط قيمة الحقل custom_variables للإحالة الناجحة.