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

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

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

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

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

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

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

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

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

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