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

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

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

• أكمِل المتطلّبات الأساسية .
• تهيئة التطبيق لحزمة SDK لإعلانات Google على الأجهزة الجوّالة

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

إضافة رقم تعريف تطبيق "مدير إعلانات 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.

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

يمكنك بدلاً من ذلك إنشاء AdManagerAdView آليًا:

Java

AdManagerAdView adView = new AdManagerAdView(this);

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

// TODO: Add adView to your view hierarchy.

Kotlin

val adView = AdManagerAdView(this)

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

// TODO: Add adView to your view hierarchy.

نقطة رئيسية: تأكّد من ضبط حجم الإعلان ورقم تعريف الوحدة الإعلانية بالطريقة نفسها التي يتم إعدادها باستخدام تنسيق XML أو كليهما آليًا.

بعد وضع AdManagerAdView في مكانه، يمكنك الاتصال بـ loadAd() في AdManagerAdView فئة وتخصيص سلوك إعلانك باستخدام الإعلان الفعاليات.

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

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

• الإعلانات البينية
• مدمج مع المحتوى
• الإعلانات التي تضمّ مكافآت

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

يمكنك إرسال طلب بشأن "الحد الأدنى للأسعار". الجديدة.

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

Java

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();

Kotlin

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();