تتطلّب إدارة الإحالات الناجحة عملية دمج معقّدة، وغالبًا ما تتضمّن أدوات وعمليات متعددة مترابطة. يقدّم هذا الدليل خطوات مفصّلة يمكنك اتّباعها لتحديد أي مشاكل تواجهها وحلّها، سواء كنت تتلقّى أخطاء من واجهة برمجة التطبيقات لا تفهمها، أو إذا كنت مرتبكًا بشأن المقاييس أو بيانات التشخيص التي تظهر لك في واجهة المستخدم.
قراءة المقاييس في واجهة مستخدم "إعلانات Google"
لا تنظّم واجهة مستخدم "إعلانات Google" مقاييس الإحالات الناجحة حسب تاريخ الاستيراد، لذا فإنّ استخدام تقارير الحملات في واجهة المستخدم للتحقّق من نتائج الاستيراد يمكن أن يكون مضلِّلاً. للتحقّق من صحة عملية الاستيراد على مستوى طلبات البيانات من واجهة برمجة التطبيقات، ابدأ ببيانات تشخيص البيانات غير الإلكترونية. لا تقيّم بيانات تشخيص الإحالات الناجحة غير الإلكترونية مطابقة العلامات غير المتزامنة أو جودة معرّف المستخدم للإحالات الناجحة المحسّنة. للتحقّق من صحة المطابقة، اطّلِع على تقارير التشخيص في واجهة مستخدم "إعلانات Google" لكلّ من الإحالات الناجحة المحسّنة للعملاء المهتمين والإحالات الناجحة المحسّنة للويب. للاطّلاع على خطوات تحديد المشاكل وحلّها، يُرجى مراجعة تنبيهات بيانات التشخيص في واجهة المستخدم بعد التحميل الناجح من خلال واجهة برمجة التطبيقات.
مشاكل في ميزة "الإحالات الناجحة المحسّنة للعملاء المهتمين"
يركّز هذا القسم على معالجة المشاكل الشائعة التي تحدث أثناء استيراد الإحالات الناجحة المحسّنة للعملاء المحتملين.
الأخطاء الشائعة
تساعدك الإرشادات التالية في تشخيص الأخطاء الشائعة وحلّها في ما يتعلّق بميزة "الإحالات الناجحة المحسّنة للعملاء المهتمين".
| خطأ | |
|---|---|
NO_CONVERSION_ACTION_FOUND
|
إجراء الإحالة الناجحة المحدّد غير مفعَّل أو لا يمكن الوصول إليه من خلال الحساب في الحقل قد يحدث هذا الخطأ أيضًا إذا كانت معلَمة GCLID في الطلب تنتمي إلى حساب عميل لا يمكنه الوصول إلى إجراء الإحالة الناجحة المحدّد في الطلب. يمكنك التحقّق مما إذا كان معرّف النقرة من Google (GCLID) ينتمي إلى حساب عميل باستخدام المورد |
INVALID_CONVERSION_ACTION_TYPE
|
يحتوي إجراء الإحالة الناجحة المحدّد على نوع غير صالح لميزة "الإحالات الناجحة المحسّنة للعملاء المحتملين". تأكَّد من أنّ السمة ConversionAction المحدّدة في
طلب التحميل من النوع UPLOAD_CLICKS.
|
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS
|
تأكَّد من تفعيل ميزة "الإحالات الناجحة المحسّنة للعملاء المحتملين" في إعدادات الإحالات الناجحة. يمكنك العثور على تعليمات حول ذلك في دليل المتطلبات الأساسية. |
DUPLICATE_ORDER_ID
|
تتضمّن الأحداث المستورَدة إحالات ناجحة متعددة بمعرّف الطلب نفسه ولم تتم معالجتها. يُرجى التأكّد من أنّ معرّفات الطلبات فريدة، ثم إعادة المحاولة. |
CLICK_NOT_FOUND
|
لم يتم العثور على أي نقرة تتطابق مع معرّفات المستخدمين المقدَّمة.
إذا واجهت إحالة ناجحة هذا التحذير، ستضمّنها Google Ads API في هذا الخطأ متوقّع إذا لم تكن النقرة واردة من حملة على "إعلانات Google". على سبيل المثال، قد يكون مصدرها SA360 أو DV360. في ما يلي الأسباب المحتملة الأخرى:
في الحالات النادرة التي يكون فيها العميل الذي يحمّل البيانات مختلفًا عن عميل الإحالة الناجحة في "إعلانات 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" للحصول على المساعدة.
مشاكل في ميزة "الإحالات الناجحة المحسّنة للويب"
يركّز هذا القسم على معالجة المشاكل الشائعة التي تحدث أثناء استيراد الإحالات الناجحة المحسّنة للويب.
الأخطاء الشائعة
تساعدك الإرشادات التالية في تشخيص الأخطاء الشائعة وحلّها في ما يتعلّق بميزة "الإحالات الناجحة المحسّنة للويب".
| خطأ | |
|---|---|
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS
|
لم يتم قبول أحكام وشروط بيانات العملاء في
customer_id من الطلب. يمكنك العثور على تعليمات حول ذلك في دليل المتطلبات الأساسية.
|
CONVERSION_ALREADY_ENHANCED
|
سبق أن تلقّت هذه الإحالة الناجحة تعديلاً من النوع ENHANCEMENT
باستخدام الحقلَين order_id وconversion_action المحدّدَين. تأكَّد من تقديم قيمة فريدة لسمة order_id لكل إحالة ناجحة.
|
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT
|
conversion_action المقدَّمة غير مؤهَّلة لاستخدام ميزة "الإحالات الناجحة المحسّنة للويب". في واجهة مستخدم "إعلانات Google"، تأكَّد من وضع علامة في المربّع تفعيل الإحالات الناجحة المحسّنة في إجراء الإحالة الناجحة المُشار إليه في طلبك. يمكنك العثور على تعليمات حول كيفية إجراء ذلك في
مركز المساعدة.
|
INVALID_USER_IDENTIFIER
|
حقل معرّف المستخدم المجزّأ (hashed_email أو
hashed_phone_number أو hashed_first_name أو
hashed_last_name أو hashed_street_address) ليس
ملخّصًا صالحًا لخوارزمية SHA-256 السداسية العشرية المكوّنة من 64 حرفًا. تسوية البيانات المقدَّمة من المستخدم وتجزئتها قبل استيرادها للحصول على التعليمات، يُرجى الاطّلاع على مقالة تسوية البيانات المقدَّمة من المستخدِم وتجزئتها.
|
CONVERSION_NOT_FOUND
|
تعذّر على "إعلانات Google" العثور على إحالة ناجحة تتطابق مع الحقل
بالنسبة إلى تعديلات |
تنبيهات بيانات التشخيص في واجهة المستخدم بعد تحميل البيانات بنجاح من خلال واجهة برمجة التطبيقات
عند تحميل تعديلات ENHANCEMENT باستخدام خدمة
ConversionAdjustmentUploadService
، تتحقّق واجهة برمجة التطبيقات من صحة تنسيق الطلب في وقت نقل البيانات وتطابق
التحسينات مع أحداث علامات الموقع الإلكتروني بشكل غير متزامن. نتيجةً لذلك، يمكن أن تنجح طلبات البيانات من واجهة برمجة التطبيقات بدون ظهور أي أخطاء في الحقل partial_failure_error، وتظهر الحالة EXCELLENT في بيانات تشخيص البيانات غير الإلكترونية. في الوقت نفسه، يمكن أن يستمرّ تقرير تشخيص الإحالات الناجحة المحسّنة في واجهة مستخدم "إعلانات Google" في عرض التنبيهات.
يُرجى التحقّق من الأسباب التالية عند ظهور تنبيهات بيانات التشخيص في واجهة المستخدم بعد عمليات التحميل الناجحة من خلال واجهة برمجة التطبيقات:
حقول العنوان المطلوبة غير متوفّرة: يتطلّب عنصر
OfflineUserAddressInfoفي حقلaddress_infoأربعة حقول في الإدخال نفسه:hashed_first_nameوhashed_last_nameوcountry_codeوpostal_code. الحقولhashed_street_addressوcityوstateاختيارية (إذا ملأت الحقلhashed_street_address، يجب أن يكون ملخصًا سداسيًا عشريًا صالحًا من 64 حرفًا بتنسيق SHA-256). تقبل واجهة برمجة التطبيقات عناصرaddress_infoجزئية غير فارغة (مثل الاسم الأول واسم العائلة فقط) بدون عرض خطأ في الحقلpartial_failure_error. ومع ذلك، فإن المطابقة النهائية تتجاهل العناوين غير المكتملة وتطلق تنبيهًا لحقول العناوين المفقودة. إذا لم يتوفّر أيّ من الحقول الأربعة المطلوبة، يجب حذف العنصرUserIdentifierمن الحقلaddress_info.معرّفات المعاملات غير متوفّرة في أحداث علامات التتبُّع على الموقع الإلكتروني: يؤدي حذف الحقل
order_idمن تعديلENHANCEMENTفي واجهة برمجة التطبيقات إلى عرض الخطأ المتزامنFieldError.REQUIRED. عندما تتضمّن طلبات بياناتك من واجهة برمجة التطبيقات الحقلorder_id، يشير تنبيه واجهة المستخدم بشأن عدم توفّر معرّف معاملة من حدث الإحالة الناجحة إلى علامة موقعك الإلكتروني. يظهر هذا التنبيه عندما يتضمّن أقل من %90 من أحداث علامات تتبُّع الإحالات الناجحة على الموقع الإلكتروني معرّف معاملة صالحًا (أو عندما ترسل العلامة سلاسل نائبة مثل"undefined"أو"null"). عليك ضبط علامة تتبُّع الإحالات الناجحة على الموقع الإلكتروني لإرسال معرّف معاملة فريد لكل حدث إحالة ناجحة.عدم تطابق معرّف الطلب في العلامة وواجهة برمجة التطبيقات أو عمليات التحميل المتأخرة: بالنسبة إلى
ENHANCEMENTالتعديلات، لا تعرض واجهة برمجة التطبيقات الخطأCONVERSION_NOT_FOUNDأوCONVERSION_EXPIREDفي وقت التحميل. بدلاً من ذلك، تؤدي قيمorder_idغير المتطابقة إلى ظهور تنبيه بعدم تطابق معرّف الطلب في واجهة المستخدم، وتؤدي التحسينات التي يتم تحميلها بعد أكثر من 24 ساعة من الإحالة الناجحة إلى ظهور تنبيه بشأن التأخر في التحميل. يجب مطابقة حقل واجهة برمجة التطبيقاتorder_idمع سلسلة معرّف المعاملة بالضبط التي تم إرسالها من خلال علامة تتبُّع الإحالات الناجحة على موقعك الإلكتروني، وتحميل التحسين في غضون 24 ساعة من حدث الإحالة الناجحة.بيانات المستخدمين غير الموحّدة التي تمّت تجزئتها قبل التحميل: إنّ تجزئة القيم غير الموحّدة، مثل الأحرف اللاتينية الكبيرة أو المسافات البيضاء في بداية النص أو نهايته أو أرقام الهواتف التي لا تتّبع تنسيق E.164، تؤدي إلى إنشاء ملخّص سداسي عشري صالح مكوّن من 64 حرفًا باستخدام خوارزمية SHA-256. تقبل واجهة برمجة التطبيقات عملية التحميل بدون عرض خطأ
INVALID_USER_IDENTIFIER، في حين يتعذّر إجراء المطابقة في المراحل اللاحقة ويتم الإبلاغ عن تنبيهات بشأن التنسيق أو انخفاض نسبة المطابقة. اتّبِع قواعد التسوية في مقالة تسوية البيانات المقدَّمة من المستخدِم وتجزئتها.انخفاض حجم تحسينات واجهة برمجة التطبيقات مقارنةً بحجم علامات الموقع الإلكتروني: تقارن بيانات التشخيص في واجهة المستخدم تحسينات واجهة برمجة التطبيقات التي تمت إزالة تكرارها والتي تحتوي على معرّفات المستخدمين بأحداث علامات الموقع الإلكتروني التي تمت إزالة تكرارها والتي تمّت الموافقة عليها:
إعدادات "وضع الموافقة": عندما يشير "وضع الموافقة" في علامة التتبُّع من Google إلى الإعداد
ad_storage='denied'، تستبعد بيانات التشخيص في واجهة المستخدم أحداث علامات التتبُّع في الموقع الإلكتروني التي لم يتم منح الموافقة عليها من المقارنة، لذا فإنّ حذف هذه الأحداث من عمليات التحميل عبر واجهة برمجة التطبيقات لا يؤدي إلى ظهور تنبيه بانخفاض حجم البيانات. ومع ذلك، فإنّ عدم تطابق معالجة الموافقة بين علامة موقعك الإلكتروني والمشغّلات الخلفية يؤدي إلى ظهور التنبيهات التالية:- لا تتضمّن العلامة المَعلمة
ad_storage='denied'، وتتخطّى الخلفية عملية التحميل: تحتسب بيانات التشخيص في واجهة المستخدم أحداث العلامة على أنّها حصلت على الموافقة، وتُبلغ عن تنبيه بانخفاض التغطية. - إشارات العلامات
ad_storage='denied'، تحسين عمليات التحميل في الخلفية: لا تتضمّن التحسينات التي تم تحميلها حدث علامة مطابقًا تمت الموافقة عليه، وتساهم في ظهور تنبيهات بشأن عدم تطابق معرّفات الطلبات.
طبِّق حالة الموافقة نفسها على كلّ من علامة موقعك الإلكتروني وعمليات تحميل التحسينات من خلال واجهة برمجة التطبيقات.
- لا تتضمّن العلامة المَعلمة
أحداث المواقع الإلكترونية المجهولة الهوية: لا تفعِّل ميزة "الإحالات الناجحة المحسّنة" في إجراءات الإحالات الناجحة في أعلى مسار الإحالة الناجحة (مثل مشاهدات الصفحات أو مشاهدات السلع) التي يتم فيها تنشيط علامة الموقع الإلكتروني للزوّار المجهولين. إذا كان خادمك يرسل تحسينات واجهة برمجة التطبيقات فقط للمستخدمين الذين سجّلوا الدخول ولديهم تفاصيل اتصال معروفة، ستؤدي أحداث العلامات المجهولة غير المطابقة إلى ظهور تنبيه بانخفاض التغطية. فعِّل ميزة "الإحالات الناجحة المحسّنة" فقط في إجراءات الإحالات الناجحة التي تتوفّر فيها البيانات المقدَّمة من المستخدم بشكلٍ منتظم.
المشاكل العامة المتعلّقة بإدارة الإحالات الناجحة
يُرجى تذكُّر المشاكل الشائعة التالية:
ستؤدي محاولة ضبط أي حقل تعداد على
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 من الطلب.
استرداد معلومات عن إعداد تتبُّع الإحالات الناجحة
للتأكّد من تفعيل إجراء الإحالة الناجحة يجب أن يكون مالك إجراء الإحالة الناجحة إما عميل الإحالة الناجحة في "إعلانات Google" للنقرة أو حسابًا في التسلسل الهرمي لتتبُّع الإحالات الناجحة لحساب التحميل.
على سبيل المثال، يحدث هذا الخطأ إذا كان إجراء الإحالة الناجحة ينتمي إلى حساب إداري سابق تم إلغاء ربطه بعد النقرة.
|
TOO_RECENT_CONVERSION_ACTION
|
تم إنشاء إجراء الإحالة الناجحة حديثًا. انتظِر لمدة 6 ساعات على الأقل بعد إنشاء الإجراء قبل إعادة محاولة تحميل الإحالات الناجحة التي تعذّر تحميلها. |
INVALID_CUSTOMER_FOR_CLICK
|
لا يتطابق حقل customer_id في الطلب مع
عميل الإحالة الناجحة في "إعلانات Google"
في وقت النقر. يحدث هذا الخطأ عندما لا يتوفّر أيضًا للحساب الذي يحمّل البيانات إذن الوصول إلى حسابات متعددة لإجراء الإحالة الناجحة. عدِّل الحقل 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 لتجنُّب تكرار الإحالة الناجحة التي تم تحميلها سابقًا.
|
EXPIRED_EVENT
|
حدثت النقرة المستورَدة قبل الإطار الزمني المحدّد في حقل
click_through_lookback_window_days. لا يؤثر أي تغيير في click_through_lookback_window_days إلا في النقرات المسجَّلة بعد التغيير، لذا لن يؤدي تغيير فترة معاينة الإعلان إلى حلّ هذا الخطأ في النقرة المحدّدة. إذا كان ذلك مناسبًا، يمكنك تغيير
conversion_action إلى إجراء آخر يتضمّن فترة معاينة إعلان
أطول. |
CONVERSION_PRECEDES_EVENT
|
تاريخ ووقت conversion_date_time يسبقان تاريخ ووقت
النقرة. يُرجى تعديل السمة conversion_date_time إلى قيمة لاحقة.
|
VALUE_MUST_BE_UNSET
|
تم ضبط قيمة السمة |