راهنمای پیاده‌سازی تبلیغات موبایلی در اندروید استودیو (Android Studio)

نوشته شده توسط شروین قریب

راه اندازی در اندروید استادیو

ابتدا فایل SDK ای‌نتورک را از اینجا دریافت کنید و سپس آن را در اندروید استادیو با توجه به مراحل زیر anetwork-sdk را به پروژه خود اضافه کنید.

پس از اضافه کردن اس دی کی (SDK)، فایل build.gradle برنامه شما به صورت زیر در‌خواهد آمد و فویلدر anetwork-sdk به پروژه شما اضافه می‌شود.

حال باید anetwork-sdk را به نیازمندی‌های پروژه خود اضافه کنید:



در نظر داشته باشید حتما کتابخانه support-v4 در dependencies پروژه وجود داشته باشد. (اجباری)

+.compile com.android.support:support-v4:25

برای هدفمندی تبلیغاتی بهتر می‌توانید کتابخانه play-services-ads را در dependencies پروژه خود اضافه کنید.(اختیاری)

+.compile com.google.android.gms:play-services-ads:10

تنظیمات فایل AndroidManifest.xml

اضافه کردن دسترسی های زیر optional می باشد. درخواست دسترسی‌ها بر عهده برنامه‌نویس است.

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>

استفاده از  anetwork-sdk در پروژه خود

کلاس Application را به شکل زیر ایجاد کنید و در آن کلاس AnetworkAdvertising را initialize کنید. توجه داشته باشید مقدار appToken مربوط به packageName برنامه خود را به تابع initialize بدهید در غیر این صورت تبلیغی در یافت نخواهید کرد.

مقدار appToken را می توانید از تظیمات اپلیکیشن خود در پنل پلتفرم anetwork بدست آورید.

حال باید نام کلاسی را که ساخته‌اید به فایل AndroidManidest.xml پروژه خود اضافه کنید.

پیاده‌سازی تبلیغات بنری در موبایل

کلاس AnetworkBannerView را به فایل Layout مربوط به کلاس Activity یا fragment خود اضافه کنید. توجه داشته باشید باید برای AnetworkBannerView مقدار android:id وجود داشته باشد.

BANNER MOBILE SDK

<com.anetwork.android.sdk.advertising.view.AnetworkBannerView
android:id="@+id/banner_1"
android:layout_marginTop="25dp"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="center"
android:layout_alignParentBottom="true"
android:layout_centerHorizontal="true"
/>

برنامه را اجرا کنید و تبلیغ را مشاهده کنید.

توابع کنترلی تبلیغ بنری:

مخفی کردن تبلیغ
AnetworkBannerView.hide(Context context);
نمایش تبلیغ
AnetworkBannerView.show(Context context);
اضافه کردن event listener
AnetworkBannerView.setListener(Context context);
چک کردن آماده بودن تبلیغ
AnetworkBannerView.isReady();
چک کردن نمایان بودن تبلیغ
AnetworkBannerView.isVisible();

برای آگاهی از رخ دادها می تواید از AnetworkBannerAdListener استفاده کنید:

BANNER SDK ANETWORK-min

onAnetworkBannerAdLoad
وقتی که تبلیغ آماده نمایش است  فراخوانی می شود.

onAnetworkBannerAdShow
وقتی که تبلیغ نمایش داده می شود فراخوانی می شود.

onAnetworkBannerAdError
وقتی که تبلیغ دچار خطا می شود  فراخوانی می شود.

onAnetworkBannerAdDestroy
وقتی که تبلیغ در صفحه مورد نظر destroy می شود فراخوانی می شود.

onAnetworkBannerAdHide
وقتی که تبلیغ مخفی می شود فراخوانی می شود.

onAnetworkBannerAdClick
وقتی که تبلیغ کلیک می شود فراخوانی می شود.

onAnetworkBannerAdRefresh
وقتی که تبلیغ تازه می شود فراخوانی می شود.

پیاده‌سازی بنر تمام صفحه در تبلیغات موبایلی

تبلیغ بنری تمام صفحه را به دوحالت زیر می توانید ایجاد کنید.

AnetworkAdvertising.createFullscreenBannerAd(Context);
AnetworkAdvertising.createFullscreenBannerAd(Context,AnetworkFullscreenAdListener);

بهتر است ساخت و تخریب تبلیغ بنری تمام صفحه در کلاس Application انجام شود.

توابع کنترلی تبلیغ بنری تمام صفحه:


listener اضافه کردن یک
AnetworkAdvertising.setFullscreenBannerAdListener(AnetworkFullscreenBannerAdListener);
نمایش تبلیغ
AnetworkAdvertising.showFullscreenBannerAd(Context context);
چک کردن آماده بودن تبلیغ
AnetworkAdvertising.isFullscreenBannerAdReady();
چک کردن نمایان بودن تبلیغ
AnetworkAdvertising.isFullscreenBannerAdVisible();
تخریب تبلیغ
AnetworkAdvertising.destroyFullscreenBannerAd(Context context);

برای آگاهی از رخ دادها می تواید از AnetworkFullscreenBannerAdListener استفاده کنید:

onAnetworkFullscreenBannerAdLoad
وقتی که تبلیغ آماده نمایش است  فراخوانی می شود.

onAnetworkFullscreenBannerAdShow
وقتی که تبلیغ نمایش داده می شود فراخوانی می شود.

onAnetworkFullscreenBannerAdError
وقتی که تبلیغ دچار خطا می شود فراخوانی می شود.

onAnetworkFullscreenBannerClosed
وقتی که تبلیغ در صفحه مورد نظر close می شود فراخوانی می شود..

onAnetworkFullscreenBannerAdClick
وقتی که تبلیغ کلیک می شود فراخوانی می شود.

onAnetworkFullscreenBannerAdDestroy
وقتی که تبلیغ تخریب می شود فراخوانی می شود.

پیاده‌سازی تبلیغات ویدیویی در موبایل

تبلیغ ویدیویی را به دوحالت زیر می توانید ایجاد کنید.

AnetworkAdvertising.createVideoAd(Context);
AnetworkAdvertising.createVideoAd(Context, AnetworkVideoAdListener);

بهتر است ساخت و تخریب تبلیغ ویدویی در کلاس Application انجام شود.

توابع کنترلی تبلیغ ویدیویی:


listener اضافه کردن یک
AnetworkAdverting.setVideAdListener(AnetworkVideoAdListener anetworkVideoAdListener);
نمایش تبلیغ
AnetworkAdverting.showVideoAd(Context context);
چک کردن آماده بودن تبلیغ
AnetworkAdverting.isVideoAdReady();
چک کردن نمایان بودن تبلیغ
AnetworkAdverting.isVideoAdVisible();
تخریب تبلیغ
AnetworkAdverting.destroyVideoAd(Context context);

برای آگاهی از رخ دادها می تواید از AnetworkVideoAdListener استفاده کنید:

onAnetworkVideoAdLoad
وقتی که تبلیغ آماده نمایش است فراخوانی می شود.

OnAnetworkVideoAdShow
وقتی که تبلیغ نمایش داده می شود فراخوانی می شود.

onAnetworkVideoAdError
وقتی که تبلیغ دچار خطا می شود فراخوانی می شود.

onAnetworkVideoAdClick
وقتی که تبلیغ کلیک می شود فراخوانی می شود.

onAnetworkVideoAdClosed
وقتی که تبلیغ در صفحه مورد نظر close می شود فراخوانی می شود..

onAnetworkVideoAdComplete
وقتی که تبلیغ تکمیل می شود فراخوانی می شود.

onAnetworkVideoAdDestroy
وقتی که تبلیغ destroy می شود فراخوانی می شود.

تبلیغ نمونه:

به صورت پیش فرض تبلیغات نمونه نمایش داده می‌شود. برای غیر فعال کردن تبلیغات نمونه کلاس AnetworkAdvertising  را به صورت زیر مقدار دهی اولیه کنید
AnetworkAdvertising.initialize(this, “YOUR APP_TOKEN GOES HERE”, false);

خطاهای معمول:

خطاهای مربوط به sdk در logCat نمایش داده می شوند:


ANETWORK_ADVERTISING_IS_NOT_INITIALIZE
NETWORK_NOT_AVAILABLE
WRONG_APP_TOKEN
WRONG_PACKAGENAME
APP_NOT_APPROVED
APP_REJECTED

فعال و غیر فعال کردن تبلیغات

توجه داشته باشید در ابتدا تبلیغات به صورت پیش فرض فعال می‌باشد. شما می‌توانید با استفاده از تابع زیر وضعیت فعال یا غیر فعال بودن تبلیغات را تنظیم کنید.

AnetworkAdvertising.setEnable(context,true)
AnetworkAdvertising.setEnable(context,false)

برای دریافت و مشاهده نمونه اپلیکیشن می‌توانید به گیت هاب ای‌نتورک مراجعه کنید یا فایل apk برنامه را دریافت کنید.

جهت مشاهده سوالات متداول مرتبط با SDK ای‌نتورک کلیک کنید

  • آیا این نوشته مشکل شما را حل کرد؟
  • بله   خیر

جواب سوالاتون رو پیدا نکردین؟

اگر در مطالب آموزشی بخش پشتیبانی نتوانستید جواب سوال خود را پیدا کنید ،
کارشناسان ما آماده پاسخگویی به شما هستند

ارسال تیکت