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

اختيار النظام الأساسي: Android iOS Android (الإصدار القديم)

تتيح حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" تحقيق الربح من تطبيقاتك باستخدام موقع على "Ad Exchange". يوضّح لك هذا الدليل كيفية ضبط تطبيقاتك على جميع أشكال الإعلانات المتوافقة مع 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 على الأجهزة الجوّالة واختيار شكل إعلان لعرضه. تستخدِم بقية هذا الدليل شكل إعلان البانر لتوضيح كيفية تحميل إعلان من &quot;Ad Exchange&quot;. يمكن تطبيق الخطوات نفسها على أي أشكال إعلانات تتوافق مع حزمة "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 إلى وحدة إعلانية. بعد ذلك، استخدِم واجهة مستخدم &quot;إدارة إعلانات Google&quot; من أجل إنشاء علامة 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();