إعداد الوصول المباشر إلى Ad Exchange

اختيار النظام الأساسي: Android New-selected Android iOS

تتيح حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" تحقيق الربح من تطبيقاتك باستخدام موقع إلكتروني على Ad Exchange property. يوضّح لك هذا الدليل كيفية ضبط إعدادات تطبيقاتك لجميع أشكال الإعلانات التي يوفّرها Ad Exchange.

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

ضبط إعدادات تطبيقك للوصول إلى Ad Exchange

أضِف رقم تعريف تطبيقك على "مدير إعلانات Google" (المحدّد في واجهة مستخدم "مدير إعلانات Google") إلى ملف AndroidManifest.xml الخاص بتطبيقك من خلال علامة <meta-data> مع android:name="com.google.android.gms.ads.APPLICATION_ID". بالنسبة إلى android:value، أدخِل رقم تعريف تطبيقك على "مدير إعلانات Google" الخاص بك، محاطًا بعلامتَي اقتباس.

<manifest>
    <application>
        <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    </application>
</manifest>

يُرجى العِلم أيضًا أنّ عدم إضافة علامة <meta-data> كما هو موضّح أعلاه يؤدي إلى حدوث عطل مع ظهور الرسالة التالية:

Missing application ID.

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

تحميل إعلان من Ad Exchange

يمكنك استخدام رمز موقع إلكتروني على Ad Exchange مع شرطة مائلة في النهاية بدلاً من رقم تعريف الوحدة الإعلانية. على سبيل المثال: ca-mb-app-pub-5629679302779023/.

يضيف المثال التالي رمز موقع إلكتروني على Ad Exchange إلى طلب إعلان بانر:

Kotlin 

val adRequest = BannerAdRequest.Builder("ca-mb-app-pub-5629679302779023/", AdSize.BANNER).build()

BannerAd.load(
  adRequest,
  object : AdLoadCallback<BannerAd> {
    override fun onAdLoaded(ad: BannerAd) {
      bannerAd = ad
      activity?.runOnUiThread {
        binding.bannerViewContainer.addView(ad.getView(requireActivity()))
      }
    }
  }
)

جافا 

BannerAdRequest adRequest = new BannerAdRequest.Builder("ca-mb-app-pub-5629679302779023/",
    AdSize.BANNER).build();

BannerAd.load(
    adRequest,
    new AdLoadCallback<BannerAd>() {
      @Override
      public void onAdLoaded(@NonNull BannerAd ad) {
        bannerAd = ad;
        runOnUiThread(
            () -> binding.bannerViewContainer.addView(ad.getView(MainActivity.this)));
      }
    });

يُرجى العِلم أنّ عدم إضافة شرطة مائلة في نهاية رمز موقع إلكتروني على Ad Exchange يؤدي إلى حدوث خطأ في طلب عرض الإعلان مع ظهور الرسالة التالية:

Invalid Request. Cannot determine request type. Is your ad unit id correct?

يمكنك أيضًا تحويل رمز موقع إلكتروني على Ad Exchange إلى وحدة إعلانية. بعد ذلك، استخدِم واجهة مستخدم "مدير إعلانات Google" لـ إنشاء علامة Ad Exchange ونسخها إلى تطبيقك. يجب أن تتضمّن العلامة التي تم إنشاؤها رمز موقع إلكتروني على Ad Exchange، يليه أرقام تعريف الوحدات الإعلانية الفرعية بدون شرطة مائلة في النهاية، على سبيل المثال: ca-mb-app-pub-5629679302779023/banner.

هذا كل شيء! أصبح تطبيقك الآن جاهزًا لتحميل وعرض إعلانات البانر من Ad Exchange.

بالإضافة إلى ذلك، يمكنك استخدام موقع إلكتروني على Ad Exchange لتحميل وعرض أشكال إعلانات أخرى من Ad Exchange باتّباع الأدلة ذات الصلة:

(الناشرون الأوروبيون الذين تمت الموافقة عليهم فقط) إضافة حدود سعرية

يمكنك إرسال طلب لاستخدام ميزة "الحدود السعرية".

بعد الموافقة، يمكنك تضمين حدّ أدنى علني أو حدّ أدنى خاص في طلب عرض الإعلان باستخدام المعلَمتَين pubf وpvtf على التوالي. في مثال الرمز التالي، استبدِل "123" بالحدود السعرية بالوحدات الصغيرة والعملة التلقائية لشبكتك. مثال على كيفية تطبيق الوحدات الصغيرة: إذا كانت عملتك التلقائية هي الدولار الأمريكي، فإنّ إدخال "6000000" يعادل 6.00 دولار أمريكي.

Kotlin

val extras = Bundle();
// Public floor parameter.
extras.putString("pubf", "123");
// Private floor parameter.
extras.putString("pvtf", "123");

val request = AdRequest.Builder("ca-mb-app-pub-5629679302779023/")
    .setGoogleExtrasBundle(extras)
    .build();

جافا 

Bundle extras = new Bundle();
// Public floor parameter.
extras.putString("pubf", "123");
// Private floor parameter.
extras.putString("pvtf", "123");

AdRequest request = new AdRequest.Builder("ca-mb-app-pub-5629679302779023/")
    .setGoogleExtrasBundle(extras)
    .build();