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

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

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

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

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

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

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

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

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

خطأ
NO_CONVERSION_ACTION_FOUND	إجراء الإحالة الناجحة المحدّد إما غير مفعَّل أو لا يمكن الوصول إليه من خلال حساب العميل المحدّد في الحقل customer_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 في successful_event_count ضمن بيانات تشخيص الإحالات الناجحة غير الإلكترونية. تتضمّن Google Ads API إدخالاً لـ CLICK_NOT_FOUND في مجموعة alerts لتتمكّن من تتبُّع معدّل تكرار هذا التحذير. هذا الخطأ متوقّع إذا لم تكن النقرة واردة من حملة على "إعلانات Google". على سبيل المثال، قد تأتي من SA360 أو DV360. في ما يلي الأسباب المحتملة الأخرى: يختلف العميل الذي يحمّل البيانات عن عميل الإحالة الناجحة في "إعلانات Google". لم يتم ضبط وضع العلامات بشكل صحيح لنموذج العملاء المحتملين. لم تتم تسوية البيانات التي تم تحميلها وتجزئتها بشكلٍ صحيح. في الحالات النادرة التي يختلف فيها العميل الذي يحمّل البيانات عن عميل الإحالة الناجحة في "إعلانات Google"، قد يعني هذا الخطأ أنّ العميل الذي يحمّل البيانات قد وافق على بنود بيانات العملاء، ولكنّ العميل الذي يعرض الإعلانات لم يوافق عليها. يمكنك تحديد ما إذا كان الحساب قد قبل بنود بيانات العملاء من خلال طلب البحث في مورد customer والتحقّق من حقل customer.conversion_tracking_setting.accepted_customer_data_terms.

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

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

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

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

• إذا كنت تستخدِم ميزة "الإحالات الناجحة المحسّنة للعملاء المحتملين" بدون علامة التتبُّع من Google على صفحة الويب، عليك تضمين معرّف النقرة من Google ‏(GCLID) في عمليات استيراد الإحالات الناجحة من خلال ضبط الحقل 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 و90 يوم.

• النطاق المسموح به لحقل "view_through_lookback_window_days" هو بين 1 و30 يوم لمعظم إجراءات الإحالات الناجحة. يجب أن يكون هذا الحقل غير محدّد لإجراءات الإحالات الناجحة من النوع AD_CALL وWEBSITE_CALL.

• سيؤدي ضبط حقل include_in_conversions_metric أو تعديله في إجراء إحالة ناجحة إلى ظهور الخطأ 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. عدِّل الإحالة الناجحة لاستخدام معرّف نقرة واحد أو مَعلمة عنوان URL واحدة فقط، وتأكَّد من عدم دمج نقرات متعددة في الإحالة الناجحة نفسها. تحتوي كل نقرة على معرّف نقرة واحد فقط أو مَعلمة عنوان URL واحدة فقط.
VALUE_MUST_BE_UNSET	تحقَّق من location في GoogleAdsError لتحديد أي من المشاكل التالية أدت إلى حدوث الخطأ. تم ضبط قيمة لسمة gclid في ClickConversion، بالإضافة إلى قيمة لسمة واحدة على الأقل من السمتَين gbraid أو wbraid. عدِّل الإحالة الناجحة لاستخدام معرّف نقرة واحد أو مَعلمة عنوان URL واحدة، وتأكَّد من عدم دمج نقرات متعددة في الإحالة الناجحة نفسها. وتتضمّن كل نقرة معرّف نقرة واحدًا أو مَعلمة عنوان URL واحدة فقط. يحتوي السمة ClickConversion على قيمة تم ضبطها لسمة gbraid أو wbraid، كما يحتوي على قيمة لسمة custom_variables. لا تتيح "إعلانات Google" المتغيّرات المخصّصة لإحالة ناجحة تتضمّن مَعلمة عنوان URL‏ gbraid أو wbraid. ألغِ ضبط حقل custom_variables للإحالة الناجحة.