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

إذا واجهت مشاكل أثناء استخدام 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 لحسابك. تأكَّد من تنفيذ ما يلي:

  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 غير صالح. أعِد تحميل الإحالات الناجحة بعد تنفيذ ما يلي:

  • التأكّد من أنّه تمّ إنشاء معرّف النقرة قبل 6 ساعات من تحميل الإحالات الناجحة

  • فعَّل خدمة الإحالات الناجحة في واجهة برمجة التطبيقات.

  • إذا كنت تُنسِب الإحالات الناجحة إلى زيارات معيّنة، انتظِر 6 ساعات على الأقل بعد الزيارة قبل تحميل الإحالة الناجحة. قد لا تتعرّف "إعلانات شبكة البحث 360" على معرّف النقرة للزيارة في حال تحميله قبل مرور 6 ساعات على الزيارة. في حالات نادرة، قد تحتاج إلى الانتظار لمدة تصل إلى 24 ساعة قبل أن تتمكّن "إعلانات شبكة البحث 360" من التعرّف على مَعلمة clickId.

  • التأكّد من أنّ النقرة مصدرها مصدر صالح كما هو مُشار إليه بالمَعلمة gclsrc

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

  • التأكّد من أنّه تم إنشاء معرّف النقرة خلال آخر 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 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 أو اسمه الذي قدّمته مع نوع الإحالة الناجحة الذي حدّدته.
0x00000126 Service internal error

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

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

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

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

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