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

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

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

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

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

الرسالة الوصف

Access Not Configured. Please use Google API Console to activate the API for your project.

يحدث هذا الخطأ إذا لم تكن قد فعّلت Search Ads 360 API لحسابك. تأكَّد من تنفيذ ما يلي:

  1. انتقِل إلى وحدة التحكم في واجهة Google API.

  2. اختَر مشروعك. إذا لم يسبق لك إنشاء مشروع، اطّلِع على مقالة إنشاء مشروع لعميلك.

  3. في الشريط الجانبي على اليمين، وسِّع واجهات برمجة التطبيقات والمصادقة. بعد ذلك، انقر على واجهات برمجة التطبيقات. في قائمة واجهات برمجة التطبيقات، تأكّد من أنّ حالة 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 غير صالح. أعِد تحميل الإحالات الناجحة بعد تنفيذ ما يلي:

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