دسترسی مستقیم را برای Ad Exchange تنظیم کنید

Google Mobile Ads SDK از کسب درآمد از برنامه‌های شما با ویژگی Ad Exchange پشتیبانی می‌کند. این راهنما به شما نشان می دهد که چگونه برنامه های خود را برای همه فرمت های تبلیغاتی که توسط Ad Exchange پشتیبانی می شوند پیکربندی کنید.

پیش نیازها

• پیش نیازها را کامل کنید .
• برنامه خود را برای Google Mobile Ads SDK پیکربندی کنید .

برنامه خود را برای دسترسی به Ad Exchange پیکربندی کنید

شناسه برنامه Ad Manager خود ( که در رابط کاربری Ad Manager مشخص شده است ) از طریق یک برچسب <meta-data> با android:name="com.google.android.gms.ads.APPLICATION_ID" به فایل AndroidManifest.xml برنامه خود اضافه کنید. برای android:value ، شناسه برنامه Ad Manager خود را که با علامت نقل قول احاطه شده است وارد کنید.

<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 بارگذاری کنید. همین مراحل می تواند برای هر قالب تبلیغاتی پشتیبانی شده توسط Google Mobile Ads SDK اعمال شود.

آگهی را از 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 Manager برای ایجاد یک برچسب Ad Exchange و کپی کردن آن در برنامه خود استفاده کنید. تگ ایجاد شده باید دارای کد دارایی وب Ad Exchange و به دنبال آن شناسه‌های واحد تبلیغاتی بعدی بدون اسلش رو به جلو باشد، برای مثال: ca-mb-app-pub-5629679302779023/banner

از طرف دیگر، می توانید یک AdManagerAdView به صورت برنامه نویسی ایجاد کنید:

جاوا

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.

نکته کلیدی: مطمئن شوید که اندازه تبلیغ و شناسه واحد تبلیغات را به یک شکل تنظیم کرده اید، یعنی هر دو را در XML یا هر دو را به صورت برنامه ریزی شده تنظیم کنید.

هنگامی که AdManagerAdView در جای خود قرار گرفت، می توانید متد loadAd() را در کلاس AdManagerAdView فراخوانی کنید و رفتار تبلیغ خود را با استفاده از رویدادهای تبلیغاتی سفارشی کنید.

خودشه! برنامه شما اکنون آماده بارگیری و نمایش بنرهای تبلیغاتی از Ad Exchange است.

علاوه بر این، می‌توانید از یک ویژگی وب Ad Exchange برای بارگیری و نمایش سایر قالب‌های تبلیغاتی از Ad Exchange با دنبال کردن راهنماهای مربوطه استفاده کنید:

• بینابینی
• بومی
• پاداش داده شد

(فقط ناشران اروپایی تایید شده) طبقات قیمت را اضافه کنید

می‌توانید درخواستی برای ویژگی «طبقات قیمت» ارسال کنید .

پس از تایید، می توانید یک طبقه عمومی یا طبقه خصوصی را به ترتیب با استفاده از پارامترهای pubf و pvtf در درخواست تبلیغ قرار دهید. در مثال کد زیر، «123» را با قیمت‌های کف در میکرو و واحد پول پیش‌فرض شبکه خود جایگزین کنید. مثالی از نحوه اعمال میکرو: اگر واحد پول پیش‌فرض شما USD است، وارد کردن "6000000" معادل 6.00 دلار است.

جاوا

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