تبلیغات جایزه‌ای و آنی در اندروید

• ساخت تبلیغگاه
• درخواست تبلیغ
  • تنظیمات درخواست
• نمایش تبلیغ
  • تنظیمات نمایش
• دریافت نتیجه تبلیغ جایزه‌ای

پیاده‌سازی تبلیغات جایزه‌ای و آنی (هم ویدیو‌ و هم بنری) به یک صورت است. فقط کافی است نوع تبلیغگاه را از پنل انتخاب کنید.

ساخت تبلیغگاه

ابتدا از پنل یلوادوایز یک تبلیغ‌گاه از نوعی که مایل هستید بسازید.

درخواست تبلیغ

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

Yelloadwise.requestAd(CONTEXT,
        ZONE_ID,
        new YelloadwiseAdRequestOptions(),
        new YelloadwiseAdRequestListener() {
            @Override
            public void onAdAvailable(String adId) {
            }

            @Override
            public void onError(String message) {
            }
        });

ورودی اول CONTEXT میباشد.
ورودی دوم ZONE_ID برابر با شناسه تبلیغ‌گاهی هست که در پنل ساخته‌اید.
ورودی سوم OPTIONS از نوع YelloadwiseAdRequestOptions است. تنظیمات زمان درخواست تبلیغ را از این طریق می‌توانید انجام بدهید.
ورودی چهارم از نوع YelloadwiseAdRequestListener است.

متدهای YelloadwiseAdRequestListener مطابق جدول زیر است و نتیجه درخواست تبلیغ با کمک این بخش برمیگردد.

اگر تمایل دارید در کالبک onError مجددا درخواست تبلیغ کنید، حتما این کار را به کمک متغیری به عنوان شمارنده انجام دهید. زیرا به کمک آن متغیر می‌توانید محدودیت تعداد دفعات را برای درخواست لحاظ کنید. به عنوان مثال وقتی این جایگاه تبلیغاتی را از پنل غیرفعال نمودید، اگر بدون محدود کردن دفعات، هر بار در کالبک onError مجددا درخواست تبلیغ دهید، برنامه‌تان در یک حلقه‌ی بی‌نهایت می‌افتد و عملکرد آن مختل می‌شود.

تنظیمات درخواست

با روش زیر می‌توانید نوع cache شدن ویدیو را با کمک ورودی options را تغییر دهید.

YelloadwiseAdRequestOptions options = new YelloadwiseAdRequestOptions();
options.setCacheType(CACHE_TYPE);

مقدار CACHE_TYPE میتواند برابر مقادیر زیر باشد.

تنها زمانی از CACHE_TYPE_CACHED استفاده کنید که احتمال دیدن ویدیو توسط کاربر زیاد باشد، تا مصرف اینترنت بالا نرود.

نمایش تبلیغ

برای نمایش تبلیغ از تابغ زیر استفاده کنید.

Yelloadwise.showAd(CONTEXT,
        ZONE_ID,
        AD_ID,
        new YelloadwiseShowOptions(),
        new YelloadwiseAdShowListener() {
            @Override
            public void onOpened() {
            }

            @Override
            public void onClosed() {
            }

            @Override
            public void onError(String message) {
            }

            @Override
            public void onRewarded(boolean completed) {
            }
        });

ورودی اول CONTEXT میباشد.
ورودی دوم شناسه تبلیغ‌گاه است. ورودی سوم شناسه تبلیغ که در زمان درخواست تبلیغ توسط متد onAdAvailable داده شده است. ورودی چهارم از نوع YelloadwiseShowOptions است. تنظیمات زمان نمایش تبلیغ را از این طریق می‌توانید انجام بدهید.
ورودی پنجم از نوع YelloadwiseAdShowListener است. مراحل نمایش تبلیغ را از این طریق می‌توانید دریافت کنید.

متدهای YelloadwiseAdShowListener مطابق جدول زیر است.

تنظیمات نمایش

تنظیمات زمان نمایش را می‌توانید مطابق روش زیر با کمک ورودی showOptions تغییر دهید.

YelloadwiseShowOptions showOptions = new YelloadwiseShowOptions();
showOptions.setBackDisabled(true|false);
showOptions.setImmersiveMode(true|false);
showOptions.setShowDialog(true|false);
showOptions.setRotationMode(ROTATION_MODE);

به هر یک از متدهای بالا می‌توانید مقدار true یا false را بدهید تا آن قابلیت فعال یا غیر فعال بشود. مقادیر قابل انتخاب برای setRotationMode پایینتر توضیح داده شده‌اند.

کاربرد هر یک از این متدها مطابق جدول زیر است.

مقادیری که می‌توانید به setRotationMode بدهید مطابق جدول زیر است.

دریافت نتیجه تبلیغ جایزه‌ای

در تبلیغات جایزه‌ای در صورتی که متفییر completed در متد onRewarded هنگام نمایش تبلیغ true باشد می‌توانید جایزه را به کاربر بدهید.