أداة فحص الإعلانات (إصدار تجريبي)

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

باستخدام "أداة فحص الإعلانات"، يمكنك إجراء ما يلي:

  • فحص وحداتك الإعلانية
  • التحقّق من تعبئة إعلاناتك على النحو المتوقّع
  • تحديد الأخطاء وعرض تفاصيل حول كيفية حلها
  • الاطّلاع على تفاصيل كل شبكة إعلانات "عرض أسعار مفتوح" لكل طلب
  • عرض تفاصيل التوسط لكل شبكة إعلانات في كل طلب
  • اختبار مصادر إعلانات فردية لتوسّط العرض الإعلاني بدون انقطاع أو عروض الأسعار المفتوحة التابعة لجهات خارجية
  • تأكّد من ضبط كل وحدة إعلانية بشكل صحيح لاستخدام "عرض الأسعار المفتوح" وتوسّط العرض الإعلاني بدون انقطاع

يوضِّح هذا الدليل كيفية إطلاق الميزات المختلفة واستخدامها في أداة "فحص الإعلانات".

المتطلبات الأساسية

لاستخدام "أداة فحص الإعلانات"، عليك:

  • استخدِم الإصدار 8.10.0 أو إصدار أحدث من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".

تشغيل "أداة فحص الإعلانات"

يمكن تشغيل "أداة فحص الإعلانات" من أي مكان في تطبيقك بالطرق التالية:

  1. استخدِم زر الإطلاق من قائمة تصحيح الأخطاء.
  2. استخدِم الإيماءة التي اختَرتها في إعدادات "أداة فحص الإعلانات".
  3. استخدام واجهة برمجة التطبيقات المتوفرة آليًا

الإطلاق باستخدام قائمة تصحيح الأخطاء

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

إذا لم تربط جهازك، قد يُطلب منك تسجيل الدخول إلى حسابك على "مدير الإعلانات".

يمكنك أيضًا اختيار إعدادات "أداة فحص الإعلانات" من إعدادات تصحيح الأخطاء واختيار إيماءة يمكن أن تفتح "أداة فحص الإعلانات" في المستقبل بدون الحاجة إلى الانتقال إلى قائمة تصحيح الأخطاء.

التشغيل آليًا

يمكن أيضًا تشغيل "أداة فحص الإعلانات" آليًا:

Swift

GADMobileAds.sharedInstance().presentAdInspector(from: viewController) { error in
  // Error will be non-nil if there was an issue and the inspector was not displayed.
}

Objective-C

[GADMobileAds.sharedInstance presentAdInspectorFromViewController:viewController
  completionHandler:^(NSError *error) {
    // Error will be non-nil if there was an issue and the inspector was not displayed.
}];

تعمل واجهة برمجة التطبيقات هذه على أجهزة الاختبار المسجّلة آليًا.

تأكَّد من أنّ وحدة التحكّم في العرض التي تم تمريرها إلى واجهة برمجة التطبيقات هذه تظهر بالكامل على الشاشة (تم استدعاء viewDidAppear:). إذا كانت وحدة التحكّم في العرض التي تم تمريرها قيد عملية العرض، مثلاً عند استدعاء واجهة برمجة التطبيقات في دالة viewDidLoad ضمن وحدة التحكّم في الملفات، سيتعذّر عرض أداة فحص الإعلانات.

عرض الوحدات الإعلانية وتحديد مشاكلها وحلّها

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

ننصح بإعداد حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة قبل استخدام أداة فحص الإعلانات.

عرض تفاصيل العرض الإعلاني بدون انقطاع للتوسّط لوحدة إعلانية

انقر على وحدة إعلانية للاطّلاع على سجلّ طلبات حزمة تطوير البرامج (SDK) الخاصة بها، والذي يقدّم تفاصيل عن العرض الإعلاني بدون انقطاع للتوسّط حتى وقت ملء الإعلان (أو العرض الإعلاني بدون انقطاع ينتهي بدون تعبئة) لأحدث طلبات الإعلان.

يمكن توسيع كل طلب باستخدام مؤشر الإفصاح لعرض نتائج تدفق التوسّط لهذا الطلب، بالإضافة إلى أي خطأ ووقت استجابة سارَين على ذلك الطلب.

بالنسبة إلى مصادر الإعلانات التابعة لجهة خارجية، يتم إرسال رسائل الخطأ مباشرةً من مصدر الإعلان. وإذا كنت بحاجة إلى مزيد من المعلومات، يُرجى الرجوع إلى مصدر إعلانك التابع لجهة خارجية.

عرض تفاصيل عروض الأسعار لوحدة إعلانية

إذا كنت مستخدِمًا جديدًا لميزة "عرض الأسعار المفتوح"، اطّلِع على مقدمة عن "عرض الأسعار المفتوح".

في سجلّ طلبات حزمة تطوير البرامج (SDK)، يمكنك الاطّلاع على Open Bidding مصادر الإعلانات التي تم طلبها في طلب الإعلان. انقر على وحدة إعلانية في سجلّ طلبات حزمة تطوير البرامج (SDK) للاطّلاع على تفاصيل كل مصدر إعلان في Open Bidding المزاد.

يتم ترتيب Open Bidding النتائج لتقريب العناصر القابلة للتنفيذ من أعلى القائمة:

  • وفي أعلى الصفحة، تتوفّر شبكة الإعلانات التي فازت بالمزاد.

  • في ما يلي شبكات المواقع الإعلانية التي تتضمّن مشاكل. يمكنك اتّباع خطوات تحديد المشاكل وحلّها في نهاية Open Bidding الأسئلة الشائعة

  • بعد ذلك، هناك شبكات المواقع الإعلانية التي لم يتم عرض إعلانات أو لم تقدم عروض أسعار. ويشكّل ذلك مؤشرًا محتملاً للعديد من المشاكل المختلفة في مصدر الإعلان، لأنّه قد لا يتضمّن عرض سعر بسبب إعداده أو قراره. يمكنك الرجوع إلى دليل إعداد مصدر الإعلان أو الأسئلة الشائعة عن ميزة "عرض الأسعار المفتوح" للحصول على مزيد من الدعم

  • أخيرًا، تظهر في أسفل القائمة شبكات المواقع الإعلانية التي فقدت Open Bidding المزاد.

يمكن أن يضع تدفق التوسّط مصدر الإعلان الذي فاز Open Bidding بالمزاد وفقًا لقيمة التكلفة الفعلية لكل ألف ظهور.

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

تصحيح أخطاء الوحدات الإعلانية المتقدم

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

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

عرض المحوّلات المتاحة

انقر على علامة التبويب المحوِّلات للاطّلاع على قائمة بجميع المحوِّلات التابعة لجهات خارجية المرتبطة بمصادر الإعلانات في إعدادات عروض الأسعار أو التوسّط في تطبيقك. بعد ذلك، وسِّع البطاقات لعرض حالات الإعداد وإصدارات حِزم تطوير البرامج (SDK). إلى جانب المحوِّلات المتوافقة التابعة لجهات خارجية، يمكنك أيضًا الاطّلاع على معدِّلات الأحداث المخصّصة. الأحداث المخصّصة تتيح للناشرين استخدام شبكات مواقع إعلانية Ad Managerغير متاحة يمكن تمييز الأحداث المخصّصة عن المحوِّلات العادية التابعة لجهات خارجية في قائمة المحوِّلات من خلال أسماء فئاتها الفريدة. بالإضافة إلى تقديم اسم الفئة ومعلومات الحالة، يعرض "أداة فحص الإعلانات" أيضًا التصنيفات المخصّصة لهذه الأحداث المخصّصة فيAd Manager واجهة الويب.

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

اختبار وحداتك الإعلانية

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

اختبار الإعلانات

إنّ اختبارات الإعلانات في "أداة فحص الإعلانات" الموضّحة في هذا القسم هي أداة رائعة للتحقّق من تجربة الإعلان الأساسي وللتحقق من صحة إعدادات التوسّط عند استخدامها مع اختبار مصدر إعلان فردي.

عندما تكون مستعدًا لاختبار وحدتك الإعلانية، انقر على الزرّ طلب إعلان اختباري في أعلى شاشة "أداة فحص الإعلانات" لبدء اختبار إعلان "أداة فحص الإعلانات". تظهر نتائج الاختبار بعد ذلك في سجلّ طلبات حزمة تطوير البرامج (SDK) أسفل العنوان تم الطلب من أداة فحص الإعلانات.

تعرَّف على طريقة استخدام "أداة فحص الإعلانات" في تطبيقك

اختبار مصدر إعلان واحد

توفِّر "أداة فحص الإعلانات" ميزة لتقييد طلبات الإعلان في تطبيقك لعرض الإعلانات فقط من مصدر Open Bidding واحد أو مصدر إعلان واحد لتوسّط العرض الإعلاني بدون انقطاع. يتيح لك ذلك التحقّق من أنّك نفّذت معدِّل الجهة الخارجية بشكل صحيح وأنّ مصدر الإعلان يعرِض الإعلانات على النحو المتوقّع.

لتفعيل هذه الميزة، يمكنك تبديل مفتاح اختبار مصدر الإعلان الفردي في أسفل الشاشة. يؤدّي ذلك إلى عرض مربّع الحوار التالي لاختيار مصدر الإعلان:

يجب إعداد حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة قبل أن تتمكّن من استخدام اختبار مصدر إعلان فردي.

يمكنك بعد ذلك اختيار مصدر إعلان واحد لاختباره. بعد اختيار مصدر الإعلان، ستظهر الشاشة التالية:

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

بعد إعادة تشغيل تطبيقك، تحاول جميع مواضع الوحدات الإعلانية عرض إعلان من الشبكة المحدّدة فقط. يؤدي تشغيل "أداة فحص الإعلانات" عندما يكون اختبار مصدر إعلان واحد نشطًا إلى عرض مصدر الإعلان الاختباري النشط:

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

في اختبار مصدر إعلان فردي، يمكنك النقر على وحدة إعلانية للاطّلاع على سجلّ طلبات حزمة تطوير البرامج (SDK) المتعلّقة بها. يتيح لك ذلك معرفة ما إذا كان مصدر الإعلان قد ملأ طلبات الإعلان التي تمّ إجراؤها بعد تفعيل اختبار مصدر إعلان واحد. إذا تعذّر على مصدر الإعلان تحميل إعلان، ستظهر رسالة خطأ تصف الخطأ.

إذا أضفت عدّة مثيلات من مصدر الإعلان المحدّد إلى تدفق للتوسّط، سترى كل مثيل من الطلب المقدّم إلى مصدر الإعلان في العرض الإعلاني بدون انقطاع إلى أن تتم تعبئة الإعلان أو انتهى العرض الإعلاني بدون انقطاع من غير تعبئة إعلان.

إيقاف اختبار مصدر إعلان واحد

لإيقاف الاختبار، يمكنك إيقاف مفتاح التبديل:

ستظهر حينئذٍ رسالة تأكيد فوق شاشة إعادة التشغيل التالية:

ننصح بإعادة تشغيل تطبيقك تلقائيًا بعد إيقاف الاختبار لإلغاء صلاحية أي إعلانات مخزّنة مؤقتًا لمصدر الإعلان الذي تمّ اختباره.

نسخ مخرجات تصحيح الأخطاء بالكامل

تتيح "أداة فحص الإعلانات" نسخ سلسلة JSON تحتوي على نتائج تصحيح الأخطاء الكاملة من الأداة، بما في ذلك تفاصيل Ad Manager تطبيقك وحالات إعداد المحوِّل ونتائج اختبار جميع الوحدات الإعلانية.

لإجراء ذلك، انقر على رمز التطبيق سبع مرات حتى تظهر لك رسالة تم نسخ ملف JSON لفحص الإعلانات إلى الحافظة.