يوضّح هذا الدليل كيفية تشغيل الميزات المختلفة في "أداة فحص الإعلانات" واستخدامها.
المتطلبات الأساسية
لاستخدام "أداة فحص الإعلانات"، عليك إجراء ما يلي:
- أكمِل دليل البدء.
- استخدِم الإصدار 9.1.0 أو إصدارًا أحدث من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة.
- أضِف جهازك كجهاز اختباري. لا يتم تشغيل "أداة فحص الإعلانات" إلا على الأجهزة الاختبارية.
تشغيل "أداة فحص الإعلانات"
يمكن تشغيل "أداة فحص الإعلانات" من أي مكان في تطبيقك بالطرق التالية:
- استخدِم الإيماءة المحدّدة في واجهة مستخدم AdMob عند تسجيل جهاز اختباري.
- باستخدام واجهة برمجة التطبيقات المتوفّرة بشكل آلي
- استخدِم زر التشغيل من قائمة تصحيح الأخطاء.
تشغيل التطبيقات باستخدام الإيماءات
لا يلزم إجراء أي تغييرات على تطبيقك لتشغيل "أداة فحص الإعلانات" بإيماءة، ما عليك سوى تنفيذ الإيماءة (التمرير السريع المزدوج أو الهزّ) التي أعددتها في AdMob لجهاز الاختبار هذا. مزيد من المعلومات
بعد ضبط إيماءة في واجهة مستخدم AdMob (والانتظار لمدة 15 دقيقة حتى يتم نشرها)، يجب أن يرسل تطبيقك طلب عرض إعلان إلى حزمة تطوير البرامج "SDK لإعلانات Google على الأجهزة الجوّالة" للتعرّف على إعدادات الإيماءة. إذا لم تنجح الإيماءة التي حدّدتها، جرِّب تحميل إعلان وإعادة تشغيل تطبيقك واختبار الإيماءة مرة أخرى.
التشغيل آليًا
يمكن أيضًا تشغيل "أداة فحص الإعلانات" آليًا:
تعمل واجهة برمجة التطبيقات هذه مع الأجهزة الاختبارية التي تم تسجيلها آليًا أو في واجهة مستخدم AdMob.
عرض الوحدات الإعلانية وتحديد المشاكل فيها وحلّها
بعد إطلاق "أداة فحص الإعلانات"، ستظهر شاشة "أداة فحص الإعلانات" الرئيسية التي تحتوي على قائمة بجميع الوحدات الإعلانية في واجهة مستخدم AdMob المرتبطة بمعرّف تطبيقك على AdMob والتي تتضمّن إعدادات عروض الأسعار أو التوسّط:
ننصح بإعداد حزمة تطوير البرامج (SDK) الخاصة بـ "إعلانات Google على الأجهزة الجوّالة" قبل استخدام "فاحص الإعلانات".
عرض تفاصيل تدفّق التوسّط لوحدة إعلانية
انقر على إحدى الوحدات الإعلانية للاطّلاع على سجلّ طلبات حزمة تطوير البرامج (SDK) المتعلّقة بها، والذي يقدّم تفاصيل عن تدفّق التوسّط إلى أن تمت تعبئة الإعلان (أو انتهى تدفّق التوسّط من غير تعبئة إعلان) لأحدث طلبات الإعلان.
يمكن توسيع كل طلب باستخدام مؤشر الإفصاح لعرض نتائج تدفّق التوسّط لهذا الطلب، بالإضافة إلى أي خطأ ووقت استجابة كانا منطبقَين على هذا الطلب.
بالنسبة إلى مصادر الإعلانات التابعة لجهة خارجية، يتم إرسال رسائل الخطأ مباشرةً من مصدر الإعلان. إذا كنت بحاجة إلى مزيد من المعلومات، يُرجى الرجوع إلى مصدر إعلانك التابع لجهة خارجية.
عرض تفاصيل عروض الأسعار لوحدة إعلانية
إذا كنت حديث العهد بعروض الأسعار، ننصحك بقراءة نظرة عامة.
في سجلّ طلبات حزمة تطوير البرامج (SDK)، يمكنك الاطّلاع على مصادر الإعلانات المستندة إلى عروض الأسعار التي يتم طلبها في طلب عرض الإعلان. انقر على وحدة إعلانية في سجلّ طلبات حزمة تطوير البرامج (SDK) للاطّلاع على تفاصيل كل مصدر إعلان في مزاد عروض الأسعار.
يتم ترتيب نتائج عروض الأسعار من أجل تقريب العناصر القابلة للتنفيذ إلى أعلى القائمة:
في أعلى الصفحة، تظهر شبكة الإعلانات التي فازت بالمزاد.
بعد ذلك، ستظهر شبكات الإعلانات التي تتضمّن مشاكل. يمكنك اتّباع خطوات تحديد المشاكل وحلّها.
بعد ذلك، هناك شبكات الإعلانات التي لم تعرِض أي إعلانات أو لم تقدِّم عرض سعر. ويُعدّ ذلك مؤشرًا محتملاً للعديد من المشاكل المختلفة المتعلقة بمصدر الإعلان، إذ قد لا يقدّم عروض أسعار بسبب الإعدادات أو عمليات اتخاذ القرارات. يمكنك الرجوع إلى دليل إعداد مصدر الإعلان أو التواصل مع مصدر الإعلان مباشرةً للحصول على الدعم.
أخيرًا، في أسفل القائمة، تظهر شبكات الإعلانات التي لم تفُز بمزاد عروض الأسعار.
يمكن لتدفّق التوسّط وضع مصدر الإعلان الفائز بمزاد عروض الأسعار وفقًا لقيمة التكلفة الفعلية لكل ألف ظهور.
عند طلب مصدر إعلان في تدفق التوسط، يمكن لهذا المصدر عرض الإعلانات. لمزيد من المعلومات عن طريقة عمل عروض الأسعار مع تدفق التوسط، يمكنك الاطّلاع على المثال 2 والمثال 3 لمصادر الإعلانات المستندة إلى عروض الأسعار ومصادر الإعلانات للعرض بدون انقطاع في مجموعة التوسط.
تصحيح الأخطاء المتقدّم في الوحدات الإعلانية
عند تحديد المشاكل وحلّها في الوحدات الإعلانية، قد يكون من المفيد التعرّف على طلب عرض الإعلان والاستجابة له لتحديد موضع حدوث الخطأ، أو مشاركة المعلومات مع فريق الدعم في Google للمساعدة في تصحيح الأخطاء. انقر على رمز القائمة في أعلى سلسلة العرض المتتالي واختَر مشاركة طلب عرض الإعلان والردّ لتصدير طلب عرض الإعلان والردّ بالكاملَين. ويوفّر عليك ذلك عناء تتبُّع الشبكة في تطبيقك.
بالإضافة إلى ذلك، يمكنك الاطّلاع على مَعلمات عروض الأسعار التابعة لجهة خارجية التي تم فك تشفيرها من خلال النقر على الخيار مَعلمة عروض الأسعار التابعة لجهة خارجية في القائمة نفسها التي تتضمّن سلسلة الطلب. يوفّر ذلك تفاصيل حول مَعلمات عروض الأسعار التابعة لجهات خارجية التي قد تواجه مشاكل، ما يساعدك في تصحيح أخطاء تطبيقك أو التأكّد من أنّ إحدى الشبكات تجمع إشاراتها بنجاح.
عرض المحوِّلات المتاحة
انقر على علامة التبويب المحوِّلات للاطّلاع على قائمة بجميع المحوِّلات التابعة لجهات خارجية والمرتبطة بمصادر الإعلانات في إعدادات عروض الأسعار أو التوسّط في تطبيقك، ثم وسِّع البطاقات للاطّلاع على حالات الإعداد وإصدارات حزمة تطوير البرامج (SDK). بالإضافة إلى المحوِّلات المتوافقة التابعة لجهات خارجية، يمكنك أيضًا الاطّلاع على محوِّلات الأحداث المخصّصة.
تتيح الأحداث المخصّصة للناشرين استخدام شبكات إعلانية لا تتوافق مع AdMob. يمكن تمييز الأحداث المخصّصة عن المحوّلات العادية التابعة لجهات خارجية في قائمة المحوّلات من خلال أسماء الفئات الفريدة الخاصة بها. بالإضافة إلى تقديم معلومات عن اسم الفئة والحالة، تعرض أداة فحص الإعلانات أيضًا التصنيفات المخصّصة لتلك الأحداث المخصّصة في واجهة الويب الخاصة بمنصة AdMob.
في حال عدم العثور على وسيط أو تعذُّر إعداده، يُرجى الاطّلاع على حلّ المشاكل التي يتم رصدها باستخدام "أداة فحص الإعلانات" للحصول على مزيد من المعلومات.
اختبار وحداتك الإعلانية
إذا أردت اختبار وحدتك الإعلانية بدون الحاجة إلى الانتقال إليها في واجهة مستخدم تطبيقك، تتيح لك "أداة فحص الإعلانات" إجراء ذلك مباشرةً من شاشة تفاصيل الوحدة الإعلانية. بالإضافة إلى ذلك، يمكنك اختبار وحدات إعلانية متعدّدة في الوقت نفسه، وتحميل طلبات الإعلانات الاختبارية وعرضها بشكل غير متزامن، ويمكنك أيضًا إجراء اختبارات لمصدر إعلان فردي.
اختبار الإعلانات
تُعدّ اختبارات الإعلانات في "أداة فحص الإعلانات" الموضّحة في هذا القسم أداة رائعة للتحقّق من تجربة الإعلانات الأساسية والتحقّق من صحة إعدادات التوسّط عند استخدامها مع اختبار مصدر إعلان واحد.
عندما تكون مستعدًا لاختبار وحدتك الإعلانية، انقر على الزر طلب إعلان اختباري في أعلى شاشة "أداة فحص الإعلانات" لبدء اختبار الإعلان في "أداة فحص الإعلانات". بعد ذلك، تظهر نتائج الاختبار في سجلّ طلبات حزمة تطوير البرامج (SDK) أسفل العنوان تمّ الطلب من "أداة فحص الإعلانات".
اختبار مصدر إعلان فردي
تتضمّن "أداة فحص الإعلانات" ميزة لحصر طلبات الإعلانات في تطبيقك على عرض الإعلانات من مصدر واحد فقط من مصادر توسّط عروض الأسعار أو توسّط العرض الإعلاني بدون انقطاع. يتيح لك ذلك التأكّد من أنّك نفّذت المحوّل التابع لجهة خارجية بشكلٍ صحيح وأنّ مصدر الإعلان يعرِض الإعلانات على النحو المتوقع.
لتفعيل هذه الميزة، فعِّل خيار اختبار مصدر إعلان فردي في أسفل الشاشة. يؤدي ذلك إلى عرض مربّع الحوار التالي لاختيار مصدر الإعلان:
يجب إعداد حزمة تطوير البرامج (SDK) الخاصة بـ "إعلانات Google على الأجهزة الجوّالة" قبل أن تتمكّن من اختبار مصدر إعلان واحد.
يمكنك بعد ذلك اختيار مصدر إعلان واحد لاختباره. بعد اختيار مصدر إعلان، تظهر الشاشة التالية:
ينطبق إعداد اختبار مصدر إعلان فردي على أي طلبات عرض إعلانات مستقبلية تقدّمها في الجلسة نفسها. ومع ذلك، لا ينطبق ذلك على أي إعلانات مخزَّنة مؤقتًا في تلك الجلسة ولم يتم عرضها بعد. ننصحك بفرض إعادة تشغيل تطبيقك عند تطبيق اختبار مصدر إعلان فردي لإبطال أي إعلانات مخزّنة مؤقتًا يمكن عرضها بدلاً من تلقّي مصدر الإعلان الذي اخترته طلبًا.
بعد إعادة تشغيل تطبيقك، ستحاول جميع مواضع الوحدات الإعلانية عرض إعلان من الشبكة المحدّدة فقط. عند تشغيل "أداة فحص الإعلانات" عندما يكون اختبار مصدر إعلان فردي نشطًا، سيتم عرض مصدر الإعلان النشط للاختبار:
في وضع اختبار مصدر إعلان فردي، تحاول جميع طلبات الإعلان تعبئة الإعلانات باستخدام مصدر الإعلان المُحدّد، بغض النظر عمّا إذا كان مصدر الإعلان قد تم إعداده لعروض الأسعار أو التوسّط للوحدة الإعلانية المطلوبة. إذا لم يكن مصدر الإعلان الذي تختبره مُدرجًا في تدفق التوسط لإحدى الوحدات الإعلانية، ستظهر لك رسالة خطأ "تعذُّر عرض الإعلان".
عند اختبار مصدر إعلان فردي، يمكنك النقر على وحدة إعلانية للاطّلاع على سجلّ طلبات حزمة تطوير البرامج (SDK) المتعلّقة بها. وهذا يتيح لك معرفة ما إذا كان مصدر الإعلان قد تمكّن من تعبئة طلبات الإعلان التي تم إجراؤها بعد تفعيل اختبار مصدر إعلان فردي. إذا تعذّر على مصدر الإعلان تحميل إعلان، ستظهر رسالة خطأ توضّح الخطأ.
في حال أضفت عدّة مثيلات من مصدر الإعلان المُحدّد إلى تدفق التوسّط، سيظهر لك كل مثيل من الطلب المقدّم إلى مصدر الإعلان في العرض الإعلاني بدون انقطاع إلى أن تمّت تعبئة الإعلان أو انتهى العرض الإعلاني بدون انقطاع من غير تعبئة إعلان.
إيقاف اختبار مصدر إعلان فردي
لإيقاف الاختبار، أوقِف الزر:
ستظهر بعد ذلك رسالة تأكيد على شاشة إعادة التشغيل التالية:
ننصحك بفرض إعادة تشغيل تطبيقك بعد إيقاف الاختبار من أجل إبطال أي إعلانات مخزّنة مؤقتًا لمصدر الإعلان الذي تم اختباره.
تصحيح أخطاء إعدادات الخصوصية
المتطلّبات الأساسية: الإصدار 9.6.0 أو إصدار أحدث من حزمة SDK لإعلانات Google على الأجهزة الجوّالة
يمكنك استخدام "أداة فحص الإعلانات" لعرض إشارات الخصوصية التالية التي تم تمريرها في طلب عرض الإعلان كجزء من تكامُل الناشر مع "إطار الشفافية والموافقة" الصادر عن مكتب IAB في أوروبا:
- تطبيق "اللائحة العامة لحماية البيانات" (
IABTCF_gdprApplies) - سلسلة الموافقة الإضافية (
IABTCF_AddtlConsent) - سلسلة الموافقة والشفافية (
IABTCF_TCString)
بعد تحميل إعلان أو إجراء اختبار إعلان في "أداة فحص الإعلانات"، انقر على رمز القائمة في الطلب ضمن سجلّ طلبات حزمة تطوير البرامج (SDK). بعد ذلك، انقر على الخيار إشارات الخصوصية.
تعرض شاشة إشارات الخصوصية إشارات الخصوصية التي تم تمريرها في طلب الإعلان.
لمزيد من المعلومات عن سلسلة الموافقة الإضافية، يمكنك الاطّلاع على المواصفات الفنية لـ "الموافقة الإضافية" من Google. لعرض تفاصيل الموافقة الدقيقة في سلسلة الموافقة والشفافية، مثل معرّف منصة إدارة الموافقة وقائمة معرّفات المورّدين الذين تمّت الموافقة عليهم والمرتبطة بمكتب IAB، انقر على فك التشفير لفتح أداة الترميز / فك الترميز في إطار GPP الصادر عن مكتب IAB.
في حال مواجهة أي أخطاء، اتّبِع الخطوات الواردة في مقالة فهم مشاكل الخصوصية لتحديد المشاكل وحلّها.
نسخ جميع نتائج تصحيح الأخطاء
تتيح "أداة فحص الإعلانات" نسخ سلسلة JSON تحتوي على جميع نواتج تصحيح الأخطاء من الأداة، بما في ذلك تفاصيل تطبيق يستخدم AdMob، وحالات تهيئة المحوّل البرمجي ونتائج اختبار جميع الوحدات الإعلانية.
لإجراء ذلك، انقر على رمز التطبيق سبع مرات إلى أن تظهر لك الرسالة تم نسخ بيانات JSON الخاصة بأداة فحص الإعلانات إلى الحافظة.