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

إذا واجهت مشاكل أثناء استخدام Search Ads 360 API، اطّلِع على قسم تحديد المشاكل وحلّها.

إذا واجهت مشكلة لا يمكنك حلّها بعد قراءة المراجع على هذا الموقع الإلكتروني، يُرجى التواصل مع فريق الدعم وتجهيز المعلومات التالية:

• رقم تعريف الوكالة ورقم تعريف المعلِن في "إعلانات شبكة البحث 360" اللذَين تحاول الوصول إليهما

• رقم المشروع من وحدة تحكّم Google API

• اسم مستخدم حساب Google الذي تستخدمه للوصول إلى واجهة برمجة التطبيقات.
  هذا هو الحساب الذي تم منحه الإذن بالوصول إلى "إعلانات شبكة البحث 360"، وهو الحساب نفسه الذي تستخدمه للقيام بخطوة إعداد التفويض.

• مقتطف الرمز البرمجي لطلبك

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

أخطاء المصادقة

في ما يلي بعض أخطاء التفويض الشائعة:

الرسالة	الوصف
Access Not Configured. Please use Google API Console to activate the API for your project.	يحدث هذا الخطأ إذا لم تكن قد فعّلت Search Ads 360 API لحسابك. تأكَّد من تنفيذ ما يلي: انتقِل إلى وحدة التحكم في واجهة Google API. اختَر مشروعك. إذا لم يسبق لك إنشاء مشروع، اطّلِع على مقالة إنشاء مشروع لعميلك. في الشريط الجانبي على اليمين، وسِّع واجهات برمجة التطبيقات والمصادقة. بعد ذلك، انقر على واجهات برمجة التطبيقات. في قائمة واجهات برمجة التطبيقات، تأكّد من أنّ حالة Search Ads 360 API هي مفعّلة.
Invalid grant	يحدث هذا الخطأ عندما يكون الرمز المميّز لإعادة التحميل غير صالح. يمكنك الحصول على رمز مميّز لإعادة التحميل من خلال استدعاء النص البرمجي لأداة "إعلانات شبكة البحث 360" على النحو التالي: sa360Api.py --login مزيد من المعلومات عن سير العمل المقترَح للحصول على الإذن
Invalid client no application name	يحدث هذا الخطأ إذا لم تحدِّد اسم منتج عند إعداد مشروعك في Google API Console. لحلّ هذا الخطأ، أدخِل اسم منتجك في شاشة طلب الموافقة في "وحدة تحكّم واجهة برمجة التطبيقات من Google".
أنواع أخرى من أخطاء التفويض	احرص على استخدام حساب Google تم منحه إذن الوصول إلى "إعلانات شبكة البحث 360" عند تسجيل الدخول إلى Google API Console لاسترداد رقم تعريف العميل وسرّه، وعند الحصول على رمز إعادة التنشيط.

الأخطاء في تحميل الإحالات الناجحة

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

رمز الخطأ	الرسالة	الوصف
0x00000101	Click ID '{ID}' is not found	معرّف النقرة الذي حدّدته في طلب update غير صالح. أعِد تحميل الإحالات الناجحة بعد تنفيذ ما يلي: التأكّد من أنّه تمّ إنشاء معرّف النقرة قبل 4 ساعات من تحميل الإحالات الناجحة تفعيل خدمة تحويل واجهة برمجة التطبيقات: إذا كنت تُنسِب الإحالات الناجحة إلى زيارات معيّنة، انتظِر لمدة 30 دقيقة على الأقل بعد الزيارة قبل تحميل الإحالة الناجحة. قد لا تتعرّف "إعلانات شبكة البحث 360" على معرّف النقرة للزيارة في حال تحميلها قبل 30 دقيقة من الزيارة. في حالات نادرة، قد تحتاج إلى الانتظار لمدة تصل إلى 4 ساعات قبل أن تتمكّن "إعلانات شبكة البحث 360" من التعرّف على clickId. التأكّد من أنّ النقرة مصدرها مصدر صالح كما هو مُشار إليه بالمَعلمة gclsrc تأكّد من تحديد المعلِن الصحيح في عمود advertiserId. التأكّد من أنّه تم إنشاء معرّف النقرة خلال آخر 90 يومًا
0x0000010E	Floodlight activity name '{name}' is not found	اسم نشاط Floodlight المحدّد في عمود segmentationName غير صحيح أو غير متوفّر بعد. إذا ظهر لك هذا الخطأ، تحقّق مما يلي: المشاكل الشائعة التالية: تكون الأسماء حسّاسة لحالة الأحرف، لذا تأكَّد من تطابق حالة الأحرف في طلبك تمامًا. تأكَّد من عدم تضمين أيّ حرف غير قابل للطباعة من يونيكود أو مسافات مزدوجة في اسم نشاط Floodlight. تأكّد من أنّك حدّدت اسم نشاط Floodlight، وليس عمود Floodlight. تأكَّد من توفّر نشاط Floodlight للمعلِن الذي حدّدته في عمود advertiserId. (من المحتمل أن تكون قد حددت المعلِن الخاطئ). بعد إنشاء نشاط Floodlight أو تعديله، انتظِر بضع ساعات قبل تحميل الإحالات الناجحة للنشاط.
0x00000115	Custom dimension '{name}' is not found	تأكَّد من أنّه تم إعداد المتغيّر المخصّص في Floodlight الذي حدّدته كسمة (وليس مقياسًا) للمعلِن المرتبط بالقيمة clickId أو criterionId أو productGroupId التي يتم تحديد مصدر الإحالة الناجحة لها.
0x00000116	Custom metric '{name}' is not found	تأكَّد من أنّه تم إعداد متغيّر Floodlight المخصّص الذي حدّدته كأحد المقاييس (وليس سمة) للمعلِن المرتبط بالملفّ الشخصي clickId، criterionId، أو productGroupId الذي يتم تحديد مصدر الإحالة الناجحة له.
0x0000011A	The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}	سبق أن حمّل مستخدم إحالة ناجحة للنطاق نفسه ورقم تعريف الإحالة الناجحة للمعلِن نفسه المحدّد في عمود conversionId. "رقم تعريف الإحالة الناجحة للمعلِن" هو رقم تعريف تنشئه. تتطلّب "إعلانات شبكة البحث 360" أن يكون هذا المعرّف فريدًا في نطاق معيّن. يتم إنشاء رقم تعريف الإحالة الناجحة في "إعلانات شبكة البحث 360" بواسطة "إعلانات شبكة البحث 360"، ومن المؤكد أن يكون فريدًا.
0x0000011B	Advertiser conversion ID '{ID}' is not found	حاول طلبك update تعديل رقم تعريف إحالة ناجحة للمعلِن غير موجود. تأكَّد من تحديد رقم التعريف الصحيح.
0x0000011D	User does not have permission to view advertiser {advertiser ID}	لا يملك حساب Google الذي يستخدمه عميلك إذنًا بالاطّلاع على المعلِن المحدّد في الطلب. عند تسجيل الدخول إلى "وحدة تحكّم Google API" لاسترداد رقم تعريف العميل وملف العميل السري، وعند الحصول على رمز مميّز لإعادة التحميل، احرص على استخدام حساب Google الذي تم منحه إذن الوصول إلى العميل الذي حدّدته.
0x0000011F	Advertiser conversion ID is already specified in this request	تُحدِّد إشارتان أو أكثر للإحالات الناجحة في الطلب النطاق نفسه رقم تعريف الإحالة الناجحة للمعلِن. رقم تعريف الإحالة الناجحة للمعلِن هو رقم تعريف تنشئه وتحدّده في عمود conversionId. تتطلّب "إعلانات شبكة البحث 360" أن يكون هذا المعرّف فريدًا لنطاق معيّن.
0x0000011E	The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)	لا يتطابق رقم تعريف نشاط Floodlight أو اسمه الذي قدّمته مع نوع الإحالة الناجحة الذي حدّدته.

الإبلاغ عن رموز الاستجابة ورسائل الخطأ

إذا طلبت تقريرًا وكان الردّ يعرض رسالة خطأ، يمكنك الاطّلاع على رموز الاستجابة في Search Ads 360 API وردود الأخطاء العادية للحصول على مزيد من المعلومات حول الخطأ.

لا تتطابق البيانات في واجهة مستخدِم "إعلانات شبكة البحث 360" مع تقرير يعرضه واجهة برمجة التطبيقات.

من المفترض أن تتطابق البيانات في واجهة مستخدم "إعلانات شبكة البحث 360" مع البيانات التي تعرضها واجهة برمجة التطبيقات تلقائيًا. إذا ضبطت includeRemovedEntities على true في طلب إعداد التقارير، تأكَّد من وضع علامة في مربّع الاختيار عرض المحتوى الذي تمّت إزالته أيضًا في واجهة المستخدم.