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

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

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

يمكنك استخدام رمز موقع إلكتروني على Ad Exchange مع شرطة مائلة للأمام في تطبيقك بدلاً من معرّف الوحدة الإعلانية.

على سبيل المثال، لتحميل إعلان بانر من خلال وضع AdManagerAdView في تنسيق Activity على النحو التالي:

# main_activity.xml
...
  <com.google.android.gms.ads.admanager.AdManagerAdView
      xmlns:ads="http://schemas.android.com/apk/res-auto"
      android:id="@+id/adManagerAdView"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_centerHorizontal="true"
      android:layout_alignParentBottom="true"
      ads:adSize="BANNER"
      ads:adUnitId="ca-mb-app-pub-5629679302779023/">
  </com.google.android.gms.ads.admanager.AdManagerAdView>

يُرجى العلم أنّ عدم إضافة الشرطة المائلة للخلف إلى رمز موقع الويب في 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

بدلاً من ذلك، يمكنك إنشاء AdManagerAdView برمجيًا:

JavaKotlin
AdManagerAdView adView = new AdManagerAdView(this);

adView.setAdSizes(AdSize.BANNER);
adView.setAdUnitId("ca-mb-app-pub-5629679302779023/");

// TODO: Add adView to your view hierarchy.

val adView = AdManagerAdView(this)

adView.adSizes = AdSize.BANNER
adView.adUnitId = "ca-mb-app-pub-5629679302779023/"

// TODO: Add adView to your view hierarchy.

بعد وضع AdManagerAdView، يمكنك استدعاء loadAd() الطريقة في AdManagerAdView الفئة وتخصيص سلوك إعلانك باستخدام ad الأحداث.

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

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

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

يمكنك إرسال طلب للحصول على ميزة "الحد الأدنى للسعر".

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

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

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter.class, extras)
    .build();

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

val request = AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter::class::java, extras)
    .build();