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

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

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

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

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

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

خطأ
NO_CONVERSION_ACTION_FOUND	إجراء الإحالة الناجحة المحدّد إما غير مفعّل أو لا يمكن للحساب العميل الوصول إليه، وذلك وفقًا للحقل client_id في الطلب. تأكّد من أنّ إجراء الإحالة الناجحة في عملية التحميل مفعّل وأنّه مملوك للعميل الذي يرسل طلب التحميل. قد يحدث هذا الخطأ أيضًا إذا كانت معرّفة GCLID في الطلب تنتمي إلى حساب عميل ليس لديه إذن بالوصول إلى إجراء الإحالة الناجحة المحدّد في الطلب. يمكنك التحقّق مما إذا كان GCLID ينتمي إلى حساب عميل باستخدام موارد click_view، وذلك من خلال إرسال طلب بحث يتمّ تصفيته حسب click_view.gclid و segments.date، حيث يكون التاريخ هو تاريخ حدوث النقرة.
INVALID_CONVERSION_ACTION_TYPE	إجراء الإحالة الناجحة المحدّد له نوع غير صالح للإحالات الناجحة المحسّنة للعملاء المحتملين. تأكَّد من أنّ ConversionAction المحدّد في طلب التحميل من النوع UPLOAD_CLICKS.
CLICK_CONVERSION_ALREADY_EXISTS	تتوفّر إحالة ناجحة حالية مرتبطة بهذا conversion_date_time لهذه النقرة. يُرجى التأكّد من أنّ conversion_date_time فريد لكل حدث وإعادة المحاولة.
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 على صفحة الويب، يجب تضمين معرّف GCLID في عمليات استيراد الإحالات الناجحة من خلال ضبط الحقل ClickConversion.gclid في كلّ إحالة ناجحة.

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