إعداد خادم الوكيل Charles لحزمة "SDK لإعلانات Google على الأجهزة الجوّالة" على نظام التشغيل Android N أو الإصدارات الأحدث

على نظام التشغيل Android N أو الإصدارات الأحدث، لا تظهر طلبات الإعلانات في خادم Charles الوكيل إلا عند تنفيذ الخطوات التالية:

  1. تحديث "خدمات Google Play" على الجهاز الجوّال
  2. فعِّل ميزة "تتبُّع الشبكة" على الجهاز الجوّال.
  3. ثبِّت شهادة طبقة المقابس الآمنة (SSL) في Charles على جهازك، واضبط الخادم الوكيل.
  4. فعِّل خادم وكيل طبقة المقابس الآمنة لتطبيقك المتوافق مع الأجهزة الجوّالة.

تحديث "خدمات Google Play" على الجهاز الجوّال

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

استخدِم القائمة الجانبية للتحقق من توفّر تحديثات لـ "خدمات Google Play" وتثبيت أحدث إصدار. الحد الأدنى للإصدار القابل للاستخدام من "خدمات Google Play" هو 14.5.74.

بالنسبة إلى الجهاز الجوّال (الهاتف أو الجهاز اللوحي)، يمكنك البحث عن Google Play أو اتّباع هذا الرابط لفتح Google Play مباشرةً.

تفعيل ميزة "تتبُّع الشبكة" على الجهاز الجوّال

لتفعيل ميزة تتبُّع الشبكة، عليك تفعيل خيارات المطوّر في جهازك. افتح تطبيق "إعدادات Google" واختَر Google > إعلانات Google > تفعيل تسجيل debugging للإعلانات. يتوفّر دليل أكثر تفصيلاً للناشرين على كلّ من AdMob و"مدير إعلانات Google".

تثبيت شهادة طبقة المقابس الآمنة (SSL) في Charles على جهازك وإعداد الخادم الوكيل

لاستخدام Charles كخادم وكيل لتطبيقك المتوافق مع الأجهزة الجوّالة، عليك تنزيله و تثبيته على جهاز كمبيوتر. اتّبِع تعليمات Charles لتثبيت شهادة SSL على محاكي Android أو الجهاز الجوّال.

من الأسهل استخدام المحاكي مع خادم وكيل لأنّه يكون المحاكي متصلاً بشبكة Wi-Fi نفسها التي يعمل عليها الكمبيوتر المزوّد ببرنامج Charles. عند استخدام المحاكي مع خادم وكيل، اضبط الخادم الوكيل على localhost (http://127.0.0.1) والمنفذ الذي يعمل عليه خادم وكيل Charles (يمكن العثور عليه في خيار قائمة Charles الخادم الوكيل > إعدادات الخادم الوكيل).

إذا كنت تستخدم جهازًا جوّالاً (هاتف أو جهاز لوحي)، عليك ربط الجهاز الجوّال بشبكة Wi-Fi نفسها التي يتّصل بها الكمبيوتر الذي يعمل ببرنامج Charles باستخدام إعدادات الشبكة المتقدّمة. عند إعداد إعدادات الوكيل لجهازك، استخدِم خيار قائمة Charles المساعدة > عنوان IP المحلي للحصول على عنوان IP لجهاز الكمبيوتر، وإدخال عنوان الوكيل على جهازك (يجب أن تكون على شبكة Wi-Fi نفسها لكي يعمل هذا الإجراء). استخدِم المنفذ الذي يعمل عليه الخادم الوكيل Charles.

تفعيل خادم وكيل طبقة المقابس الآمنة لتطبيقك المتوافق مع الأجهزة الجوّالة

لكي يتمكّن Charles من اعتراض حركة بيانات طبقة المقابس الآمنة (SSL) في تطبيقك المتوافق مع الأجهزة الجوّالة، عليك الإفصاح عن أنّه يمكن لتطبيقك الوثوق بشهادة طبقة المقابس الآمنة التي يقدّمها المستخدم.

أولاً، عليك إضافة ملف موارد XML جديد لإعدادات أمان الشبكة ضمن المسار res/xml/network_security_config.xml:

<network-security-config>
   <debug-overrides>
       <trust-anchors>
           <!-- Trust user added CAs while debuggable only -->
           <certificates src="user" />
       </trust-anchors>
   </debug-overrides>
</network-security-config>

بعد ذلك، عدِّل ملف AndroidManifest.xml لاستخدام إعدادات أمان الشبكة.

<?xml version="1.0" encoding="utf-8"?>
<manifest ... >
    <application ...
                 android:networkSecurityConfig="@xml/network_security_config"
                 ... >
        ...
    </application>
</manifest>

بعد ذلك، يمكنك تشغيل التطبيق المتوافق مع الأجهزة الجوّالة والبحث عن طلبات الإعلانات في log.

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