Usage Examples

نحوه ی ایجاد تبلیغ توسط SDK وی کلیک

فرآیند کلی ایجاد و نمایش تبلیغ برای همه ی انواع مختلف تبلیغ تقریبا مشابه است. برای ایحاد تبلیغ ابتدا نیاز داریم یک درخواست تبلیغ با استفاده از کلاس WeclickAdRequestایجاد کنیم:

WeclickAdRequest request=new WeclickAdRequest.Builder()
.setAdFormat(...)
.setAdSize(...)
.build();

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

• تبلیغ بنری(Banner)
• تبلیغ تعاملی(HTML)
• تبلیغ دیوار پیشنهادات(Offerwall)
• تبلیغ همسان(Native)

Banner Ad View

---

ابتدا ویو تبلیغ رادر layout اضافه کنید:

<ir.weclick.weclickads.WeclickAdView
        android:id="@+id/weclick_ad"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_alignParentBottom="true"
        android:layout_centerHorizontal="true"
        android:elevation="20dp"
        app:adSize="FULL_BANNER"
        app:detachable="true">
</ir.weclick.weclickads.WeclickAdView>

سپس در بخش کد ویو تبلیغ را پیدا کرده و درخواست را روی آن ست کنید:

private WeclickAdView adView;

adView= (WeclickAdView) findViewById(R.id.weclick_ad);

WeclickAdRequest request=new WeclickAdRequest.Builder()
                .setAdFormat(WeclickAdFormat.BANNER)
                .setAdSize(WeclickAdSize.FULL_BANNER)
                .setAge(19)
                .setGender(1).build();

• setAdFormat(WeclickAdFormat adFormat)
  • مشخص کننده نوع تبلیغ درخواستی
  • اجباری
• setAdSize(WeclickAdSize adSize)
  • مشخص کننده سایز تبلیغ درخواستی
  • اجباری
  • مقدار های مجاز برای پارامتر adSize تبلیغ بنری(و تعاملی):
    • BANNER
    • LARGE_BANNER
    • MEDIUM_RECTANGLE
    • FULL_BANNER
    • LEADERBOARD
• setAge(int age)
  • مناسب هدفمند سازی تبلیغ نمایشی برای کاربر نهایی
  • اختیاری
• setGender(int g)
  • مناسب هدفمند سازی تبلیغ نمایشی برای کاربر نهایی
  • مقدار 1 برای مرد و مقدار 0 برای زن
  • اختیاری
• build()
  • اعمال پارامتر های انتخاب شده و ایجاد درخواست

پس از ایجاد درخواست با فراخوانی متد setRequest تبلیلغ از سرور دریافت و نمایش داده می‌شود.

adView.setRequest(request);

HTML Ad View

---

فرایند ایجاد تبلیغ از نوع تعاملی کاملا مشابه ایجاد تبلیغ بنری است.تنها مورد انتخاب فرمت تبلیغ WeclickAdFormat.HTML است

• تبلیغ بنری(Banner)

Offerwall Ad

---

برای نمایش دیوار پیشنهادات پس از ایجاد درخواست متناسب با استفاده از کلاس Offerwall برای ایجاد ویو مورد نظر اقدام کنید

weclickAdRequest request=new WeclickAdRequest.Builder()
                .setAdFormat(WeclickAdFormat.OFFERWALL)
                .setAdSize(WeclickAdSize.OFFERWALL)
                .setCount(5)
                .setAge(19)
                .setGender(0).build();

دیوار پیشنهادات امکان ایجاد ۳ ویو مختلف را برای شما فراهم کرده:

• نمایش دیالوگ

WeclickOfferwall.getInstance(getContext())
        .vertical()
        .showDialog(getContext(),request);

• نمایش اکتیویتی

WeclickOfferwall.getInstance(getContext())
        .vertical()
        .startActivity(request);

• نمایش ویو

View wOfferwallView = WeclickOfferwall.getInstance(this)
        .vertical()
        .getView(request);
//parent view       
wOfferwallContainer.addView(wOfferwallView);

Native Ad

---

برای ایجاد تبلیغ همسان کافیست درخواست این نوع تبلیغ را ایجاد کرده و با استفاده از کلاس `WeclickNative` دیتای خام تبلیغ را در کالبک `OnNativeAdLoadListener` دریافت کنید!

 WeclickAdRequest weclickAdRequest=new WeclickAdRequest.Builder()
                .setAdFormat(WeclickAdFormat.NATIVE)
                .setAdSize(WeclickAdSize.NATIVE)
                .setCount(count)
                .build();

WeclickNative.getInstance(this).getNativeAd(weclickAdRequest, new OnNativeAdLoadListener() {
            @Override
            public void loadComplete(ArrayList<WNativeAd> arrayList) {
                Toast.makeText(NativeActivity.this,"Native add loaded size = "+arrayList.size(),Toast.LENGTH_SHORT).show();
                adapter=new SimpleRVAdapter(arrayList);
                rvNative.setLayoutManager(new LinearLayoutManager(NativeActivity.this,LinearLayoutManager.VERTICAL,false));
                rvNative.setAdapter(adapter);
            }
        });

کالبک OnNativeAdLoadListener شامال متد loadComplete است ک پس ازلود شدن تبلیغ فراخوانی میشود و لیستی از تبلیغ را بصورت دیتای خام در اختیار برنامه نویس قرار می‌دهد!

اطلاعاتی ک برای هر تبلیغ WNativeAd در اختیار برنامه نویس قرار می‌گیرد:

• getTitle() : تیتر تبلیغ
• getText() : متن توضیحات تبلیغ
• getActionButtonText() : متن دکمه تبلیغ
• getFileSize() : حجم فایل دانلودی *‌در صورتی ک تبلیغ فایل قابل دانلود باشد
• getIconUrl(): عکس کوچک تبلیغ
• getLargImageUrl() : عکس بزگ تبلیغ
  • این پارامتر ممکن است مقدار null برگرداند
• getCallback() : OnClickListener هر تبلیغ ک تعیین می‌کند پس از کلیک بر روی تبلیغ چ اتفاقی رخ دهد!