«کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» از درآمدزایی برنامه‌هایتان با دارایی Ad Exchange پشتیبانی می‌کند. این راهنما نحوه پیکربندی برنامه‌هایتان را برای همه قالب‌های آگهی پشتیبانی‌شده توسط Ad Exchange به شما نشان می‌دهد.
پیش‌نیازها
- پیش‌نیازها را تکمیل کنید.
- برنامه خود را برای کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google پیکربندی کنید.
برنامه‌تان را برای دسترسی به 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.
سپس می‌توانید کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google را مقداردهی اولیه کنید و قالب آگهی را برای نمایش انتخاب کنید. بقیه این راهنما قالب برنمایی را پیاده‌سازی می‌کند تا نشان دهد چگونه می‌توانید آگهی را از Ad Exchange بار کنید. همین مراحل می‌تواند برای هر قالب آگهی‌ای که «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» پشتیبانی می‌کند اعمال شود.
بار کردن آگهی از Ad Exchange
می‌توانید از کد دارایی وب Ad Exchange با خط مورب انتهایی به‌جای شناسه واحد آگهی استفاده کنید. برای مثال، ca-mb-app-pub-5629679302779023/.
برای مثال، برای بار کردن آگهی برنما با قرار دادن 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>
یا می‌توانید سلسله‌مراتب نمایشی را به‌صورت برنامه‌ریزی‌شده ایجاد کنید:
جاوا
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.
پس‌از اینکه AdManagerAdView در جای خود قرار گرفت، می‌توانید روش loadAd()
را در کلاس
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.
فقط همین! برنامه شما اکنون آماده بار کردن و نمایش آگهی‌های برنمایی از Ad Exchange است.
علاوه‌براین، می‌توانید از دارایی وب Ad Exchange برای بار کردن و نمایش قالب‌های آگهی دیگر از Ad Exchange با دنبال کردن راهنماهای مربوطه استفاده کنید:
(فقط ناشران تأییدشده اروپایی) افزودن کف قیمت
می‌توانید درخواستی برای ویژگی «کف قیمت» ارسال کنید.
پس‌از تأیید شدن، می‌توانید کف قیمت عمومی یا کف قیمت خصوصی را در درخواست آگهی
بااستفاده از پارامترهای pubf و pvtf به‌ترتیب اضافه کنید. در کد مثال زیر، «۱۲۳» را با قیمت‌های کف در میکرو و واحد پول پیش‌فرض شبکه خود جایگزین کنید. مثالی از نحوه اعمال میکروها: اگر واحد پول پیش‌فرض شما دلار امریکا است، وارد کردن «۶۰۰۰۰۰۰» معادل ۶ دلار است.
جاوا
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();