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

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

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

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

في ما يلي بعض أخطاء المصادقة الشائعة:

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

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

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

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

  2. اختَر مشروعك. إذا لم تكن قد أنشأت مشروعًا حتى الآن، راجِع إنشاء مشروع لعميلك.

  3. في الشريط الجانبي على يمين الصفحة، وسِّع واجهات برمجة التطبيقات والمصادقة. بعد ذلك، انقر على واجهات برمجة التطبيقات. في قائمة واجهات برمجة التطبيقات، تأكد من أن الحالة مُفعّلة لواجهة برمجة التطبيقات في "إعلانات شبكة البحث 360".

Invalid grant

يحدث هذا الخطأ عندما يكون الرمز المميز للتحديث غير صالح. يمكنك الحصول على الرمز المميز لإعادة التحميل من خلال استدعاء النص البرمجي لأداة "إعلانات شبكة البحث 360" على النحو التالي:

sa360Api.py --login

تعرَّف على مزيد من المعلومات عن سير العمل المقترَح للتفويض.

Invalid client
no application name

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

أنواع أخرى من أخطاء التفويض

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

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

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

رمز الخطأ الرسالة الوصف
0x00000101

Click ID '{ID}' is not found

معرّف النقرة الذي حدّدته في طلب update غير صالح. أعد تحميل الإحالات الناجحة بعد إجراء ما يلي:

  • التحقق من أن معرّف النقرة قد تم إنشاؤه قبل 4 ساعات من تحميل الإحالات الناجحة.

  • تنشيط خدمة تحويل واجهة برمجة التطبيقات.

  • إذا كنت تنسب الإحالات الناجحة إلى زيارات محدّدة، انتظر لمدة 30 دقيقة على الأقل بعد الزيارة قبل تحميل الإحالة الناجحة. قد لا تتعرّف "إعلانات شبكة البحث 360" على معرّف النقرة الخاص بالزيارة إذا حمّلت الفيديو قبل 30 دقيقة من الزيارة. في حالات نادرة، قد تحتاج إلى الانتظار لمدة تصل إلى 4 ساعات قبل أن تتمكّن "إعلانات شبكة البحث 360" من التعرّف على معرّف النقرة.

  • تم التأكُّد من أنّ النقرة قد جاءت من مصدر صالح كما تشير إليه المعلّمة gclsrc.

  • أكّدت أنك حدّدت المعلِن الصحيح في عمود معرّف المعلِن.

  • تحقّق من أنه تم إنشاء معرّف النقرة خلال آخر 90 يومًا.
0x0000010E Floodlight activity name '{name}' is not found

اسم نشاط Floodlight المحدّد في عمود " segmentationName " غير صحيح أو غير متوفر حتى الآن. في حال ظهور هذا الخطأ، تحقق من المشاكل الشائعة التالية:

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

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

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

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

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