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

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

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

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

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

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

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

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

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

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