راه‌اندازی پروژه QT

راه‌اندازی پروژه QT
پیاده‌سازی تبلیغات ویدئویی (Interstitial/Rewarded Video) و بنری تمام صفحه (Interstitial Banner) در پروژه Qt
پیاده‌سازی تبلیغات بنری هم‌نما (Native Banner) در پروژه Qt
پیاده‌سازی تبلیغات ویدیویی هم‌نما (Native Video) در پروژه Qt
پیاده‌سازی تبلیغات بنری استاندارد در پروژه Qt
پروژه نمونه

راه‌اندازی پروژه QT

گام ۱: دریافت پلاگین تپسل برای Qt

ابتدا فایل پلاگین تپسل برای Qt را از آدرس زیر را دانلود کنید.

دانلود پلاگین

گام ۲: راه اندازی پلتفرم های android و iOS

حال با توجه به پلتفرم مورد نظر شما ، ادامه‌ی مراحل را در لینک زیر ادامه دهید و سپس به این صفحه بازگشته و به گام ۳ بروید:

پلتفرم Android

پلتفرم iOS

گام ۳:‌ اضافه کردن پلاگین تپسل به پروژه Qt

پلاگین دریافت شده در گام یک را از حالت فشرده خارج کرده و آن را در محل پروژه خود قرار دهید. سپس کد های زیر را به فایل pro. پروژه خود اضافه کنید:

QT += gui gui-private

ios: SOURCES +=
TapsellSDKAndHelpers/tapsellIos.cpp \

ios: HEADERS +=
TapsellSDKAndHelpers/tapsellIos.h

ios: OBJECTIVE_SOURCES +=
TapsellSDKAndHelpers/TSTapsell.mm

ios: OBJECTIVE_HEADERS +=
TapsellSDKAndHelpers/TSTapsell.h

QMAKE_INFO_PLIST = TapsellSDKAndHelpers/info.plist

android: QT += androidextras

android: SOURCES +=
TapsellSDKAndHelpers/tapsellAndroid.cpp

android: HEADERS +=
TapsellSDKAndHelpers/tapsellAndroid.h

android: DISTFILES +=
android/AndroidManifest.xml
android/gradle/wrapper/gradle-wrapper.jar
android/gradlew
android/res/values/libs.xml
android/build.gradle
android/gradle/wrapper/gradle-wrapper.properties
android/gradlew.bat
android/src/ir/tapsell/sdk/Tapsell.java

ANDROID_PACKAGE_SOURCE_DIR = $$PWD/android

نمونه پیاده‌سازی

یک نمونه پیاده‌سازی پلاگین Qt تپسل در repository زیر آمده است.

مشاهده پروژه نمونه

راه‌اندازی پلاگین تپسل در پلتفرم android در Qt

گام ۱: ساختن پوشه android در پروژه Qt

اگر قبلا پوشه android در مسیر پروژه Qt خود نساخته اید ، این مراحل را طی کنید و پوشه android را بسازید :

وارد قسمت تنظیمات پروژه شوید :

در قسمت Build Android APK گزینه Create Templates را انتخاب کنید :

سپس گزینه Finish را انتخاب کنید ، با این کار پوشه android باید ساخته شود :

گام ۲ : اضافه کردن tapsell.jar به پروژه اندروید

فایل tapsell.jar موجود در پلاگین تپسل (دانلود شده در مراحل قبلی) ، را در پوشه android/libs از محل پروژه خود ، کپی کنید.

گام ۳: اضافه کردن فایل Tapsell.java به پروژه اندروید

فایل Tapsell.java موجود در پلاگین تپسل را در پوشهandroid/src/ir/tapsell/sdk از محل پروژه خود ، کپی کنید.

گام ۴: اضافه کردن TapsellAdActivity به AndroidManifest.xml

فایل AndroidManifest.xml پروژه اندروید (واقع در پوشهandroid از محل پروژه) را باز کرده و تکه کد زیر را درون تگ <application>...</application> قرار دهید :

// AndroidManifest.xml
<activity
    android:name="ir.tapsell.sdk.TapsellAdActivity"
    android:label="TapsellAdActivity"
    android:configChanges="keyboard|keyboardHidden|orientation|screenSize"
    android:windowSoftInputMode="adjustPan">
</activity>

همچنین مطمئن شوید persmission های زیر را دارد :

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

راه‌اندازی پلاگین تپسل در پلتفرم iOS در Qt

گام ۱: اضافه کردن پوشه SDK به پروژه Qt

پوشه TapsellSDKAndHelpers (دانلود شده در مراحل قبلی) را به محل پروژه خود اضافه کنید.

گام ۲: اضافه کردن مرحله build تپسل به پروژه Qt

در حالی که در حالت Build iOS هستید وارد قسمت تنظیمات پروژه شوید :

در قسمت Build Steps گزینه Add Build Step را انتخاب نموده و پس از آن گزینه Custom Process Step را انتخاب کنید. دقت کنید که این Build Step باید در بین ‌Build Step های qmake و Make باشد.(شما می توانید ترتیب این Build Step ها را مشخص کنید)

حال در قسمت Command کد زیر را وارد کنید:

python

حال در قسمت Arguments کد زیر را وارد کنید:

%{sourceDir}/TapsellSDKAndHelpers/embed.py %{buildDir}/<YOUR_PROJECT_NAME>.xcodeproj %{sourceDir}/TapsellSDKAndHelpers/TapsellSDKv3.framework

در قطعه کد بالا بجای <YOUR_PROJECT_NAME> اسم پروژه خود را قرار دهید و توجه کنید که شما باید پایتون را به صورت نصب شده بر روی سیستم خود داشته باشید.

در پایان Build Steps پروژه شما باید وضعیتی شبیه به تصویر مقابل داشته باشد:

پیاده‌سازی تبلیغات ویدئویی (Interstitial/Rewarded Video) و بنری تمام صفحه (Interstitial Banner) در پروژه Qt

گام ۱ : راه اندازی پروژه Qt

ابتدا به لینک زیر مراجعه کنید و پلاگین تپسل را به پروژه ی خود اضافه کنید :

راه اندازی پروژه

گام ۲: دریافت کلید تپسل

وارد پنل مدیریت تپسل شده و با تعریف یک اپلیکیشن جدید با عنوان پکیج اپلیکیشن اندرویدی خود، یک کلید تپسل دریافت کنید.

ورود به داشبورد تپسل

گام ۳: شروع کار با SDK تپسل

ابتدا فایل هدر تپسل را include کنید :

#include "tapsell.h"

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

Tapsell::initialize(appKey);

ورودی appKey کلید تپسلی است که در گام قبل از پنل تپسل دریافت کردید.

گام ۴: دریافت تبلیغ

نمایش یک تبلیغ ویدئویی در اپلیکیشن به دو صورت ممکن است صورت پذیرد. یک روش، نمایش تبلیغ بصورت stream می باشد. در این حالت، همزمان که کاربر درحال مشاهده بخشی از تبلیغ است، ادامه آن از اینترنت لود می گردد. ممکن است به دلیل کندی سرعت اینترنت، در این حالت کاربر با مکث های متعددی در هنگام دریافت و مشاهده تبلیغ مواجه شود. برای اینکه کاربر در هنگام نمایش تبلیغ منتظر نماند و تجربه کاربر در استفاده از اپلیکیشن بهبود یابد،روش دیگری نیز در SDK تپسل تعبیه شده است که در آن ابتدا فایل ویدئوی تبلیغاتی بطور کامل بارگذاری شده و سپس تبلیغ نمایش داده می شود. همچنین در تپسل، تبلیغ می تواند در ناحیه‌های مختلفی از برنامه شما (مانند فروشگاه، انتهای هر مرحله، ابتدای مرحله جهت دریافت امتیاز دوبرابر، دریافت بنزین/لایف و ...) پخش شود. در تپسل به این ناحیه‌ها zone گفته می شود. ناحیه‌های هر اپلیکیشن در پنل تپسل تعریف می شوند.

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

Tapsell::requestAd(QString zoneId, bool isCached, std::function<void(QString)> onAdAvailable,
                   std::function<void()> onNoAdAvailable, std::function<void()> onNoNetwork,
                   std::function<void(QString)> onError, std::function<void(QString)> onExpiring);

هر درخواست شامل یک ورودی zoneId است که باید آن را از داشبورد تپسل در صفحه اپلیکیشن خود دریافت کنید. دقت کنید که برای این پارامتر نباید از مقدار null استفاده کنید. ورودی cached یک متغیر bool (با مقدار True/False) می باشد که نشان می دهد که آیا تبلیغ باید ابتدا دانلود شده و سپس به کاربر نشان داده شود یا خیر.

تنها در ناحیه‌هایی که کاربر با احتمال زیادی پس از باز کردن اپلیکیشن تبلیغ آن را مشاهده می‌کند، از تبلیغ Cached استفاده کنید. جهت توضیحات بیشتر درباره روش انتخاب متد دریافت مناسب، اینجا را مطالعه کنید.

نتیجه درخواست تبلیغ به تابع های callback ورودی بازگردانده می شود. یک نمونه پیاده سازی تابع های callback لازم در ادامه آمده است.

در onAdAvailable شناسه یک تبلیغ به شما برگردانده می شود که می بایست جهت نمایش تبلیغ آن را ذخیره نمایید. جهت توضیحات بیشتر به قطعه کد پیاده سازی اکشن که در ادامه آمده است توجه نمایید. (در این مثال از lambda expression استفاده کردیم. از std::function هم می توانید استفاده کنید)

Tapsell::requestAd(ZONE_ID, false, [](QString adId) {
            qDebug() << "onAdAvailable";
            AD_ID = adId;
        }, []() {
            qDebug() << "onNoAdAvailable";
        }, []() {
            qDebug() << "onNoNetwork";
        }, [](QString error) {
            qDebug() << "onError: " << error;
        }, [](QString adId) {
            qDebug() << "onExpiring " << adId;
        });

توضیحات اکشن های مختلف و شرایط اجرا شدن آن ها در جدول ۱ آمده است.

جدول ۱ اکشن های دریافت نتیجه درخواست تبلیغ

تابع	توضیحات (زمان اجرا)
onError(QString error)	هنگامی که هر نوع خطایی در پروسه‌ی دریافت تبلیغ بوجود بیاید
onAdAvailable(QString adId)	زمانی که تبلیغ دریافت شده و آماده‌ی نمایش باشد.
onNoAdAvailable()	در صورتی که تبلیغی برای نمایش وجود نداشته باشد.
onNoNetwork()	زمانی که دسترسی به شبکه موجود نباشد.
onExpiring(QString adId)	زمانی که تبلیغ منقضی شود. هر تبلیغ مدت زمان مشخصی معتبر است و در صورتی که تا قبل از آن نمایش داده نشود منقضی شده و دیگر قابل نمایش نخواهد بود.

گام ۵: نمایش تبلیغ

هر تبلیغ یک id از نوع string دارد. جهت نمایش تبلیغ، می‌توانید از دو تابع زیر استفاده نمایید (این تابع حداکثر یک بار برای هر تبلیغ قابل اجراست) :

Tapsell::showAd(QString zoneId, QString adId, bool back_disabled,
                bool immersive_mode, int rotation_mode, bool showExitDialog);
Tapsell::showAd(QString zoneId, QString adId, bool back_disabled,
                bool immersive_mode, int rotation_mode, bool showExitDialog,
                std::function<void(QString)> onOpened, std::function<void(QString)> onClosed);

Tapsell::showAd(ZONE_ID, AD_ID, false, false, ROTATION_UNLOCKED, true,
            [](QString adId) {
                qDebug() << "onOpened";
            },
            [](QString adId) {
                qDebug() << "onClosed";
            });

دو ورودی onOpened و onClosed از جنس تابع هستند و این callback ها زمان اجرا و پایان نمایش تبلیغ صدا زده می شوند. جدول ۲ فیلدهای adOptions

متغیر (نوع)	توضیحات
back_disabled (bool)	در هنگام پخش تبلیغ دکمه‌ی بازگشت گوشی فعال باشد یا خیر
immersive_mode(bool)	فعال‌سازی حالت Immersive در هنگام پخش تبلیغ (فقط در اندروید)
rotation_mode (int)	تعیین وضعیت گوشی در هنگام پخش تبلیغ به یکی از سه حالت: ROTATION_LOCKED_PORTRAIT ROTATION_LOCKED_LANDSCAPE ROTATION_UNLOCKED ROTATION_LOCKED_REVERSED_PORTRAIT ROTATION_LOCKED_REVERSED_LANDSCAPE
showExitDialog(bool)	نمایش دیالوگ اخطار در هنگام بازگشت از تبلیغات جایزه‌دار

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

Tapsell::showAd(ZONE_ID, AD_ID, false, false, ROTATION_UNLOCKED, true,
            [](QString adId) {
                qDebug() << "onOpened";
            },
            [](QString adId) {
                qDebug() << "onClosed";
            });

گام ۶: دریافت نتیجه نمایش تبلیغ

در صورتیکه در اپلیکیشن خود از تبلیغات جایزه‌دار استفاده می‌کنید، جهت دریافت نتیجه نمایش تبلیغ‌ها، باید یک اکشن مطابق زیر به SDK تپسل بدهید.

Tapsell::setRewardListener([](QString zoneId, QString adId, bool completed, bool rewarded) {
        qDebug() << "Reward! " << completed << ", " << rewarded;
    });

پس از نمایش تبلیغ، اکشن onAdShowFinished اجرا می‌شود و نتیجه نمایش تبلیغ بازگردانده می‌شود. درصورتیکه تبلیغ نمایش داده شده جایزه‌دار باشد، متغیر rewarded در این شی دارای مقدار true خواهد بود. همچنین درصورتیکه تبلیغ تا انتها دیده شود، متغیر completed در ای شین دارای مقدار true خواهد بود. در صورتی که تبلیغ جایزه‌دار باشد و مشاهده ویدئو تا انتها انجام شده باشد، باید جایزه درون برنامه (سکه، اعتبار، بنزین یا ...) را به کاربر بدهید.

نمونه پیاده‌سازی

یک نمونه پیاده‌سازی SDK تپسل در Qt در repository زیر آمده است.

مشاهده پروژه نمونه

لطفا نظرات خود درباره محتوای این فایل و مشکلاتی که در پیاده‌سازی SDK تپسل با آنها مواجه شدید را به ما اطلاع دهید.

پیاده‌سازی تبلیغات بنری هم‌نما (Native Banner) در پروژه Qt

گام ۱ : راه اندازی پروژه Qt

ابتدا به لینک زیر مراجعه کنید و پلاگین تپسل را به پروژه ی خود اضافه کنید :

راه اندازی پروژه

گام ۲: دریافت کلید تپسل

وارد پنل مدیریت تپسل شده و با تعریف یک اپلیکیشن جدید با عنوان پکیج اپلیکیشن اندرویدی خود، یک کلید تپسل دریافت کنید.

ورود به داشبورد تپسل

گام ۳: شروع کار با SDK تپسل

ابتدا فایل هدر تپسل را include کنید :

#include "tapsell.h"

برای مقداردهی اولیه ، تابع زیر را با ورودی کلید اپ خود صدا بزنید.

Tapsell::initialize(appKey);

ورودی appKey کلید تپسلی است که در گام قبل از پنل تپسل دریافت کردید.

گام ۴: دریافت تبلیغ

در تبلیغات هم‌نما، شما قادر هستید ویژگی‌های ظاهری هر یک از اجزای تبلیغ (اندازه، محل قرارگیری، رنگ فونت و…) را بصورتی که هماهنگ با محتوای اپلیکیشن شما باشد تعیین کنید.

برای این منظور، شما یک درخواست تبلیغ به SDK تپسل ارسال می کنید، محتوای یک تبلیغ هم‌نمای بنری را دریافت کنید و آن را به نحوه مورد نظر خود نمایش دهید.

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

Tapsell::requestNativeBannerAd(QString zoneId,std::function<void(QString,QString,QString,QString,QString,QString,QString)> onAdAvailable,
std::function<void()> onNoAdAvailable,std::function<void()> onNoNetwork,std::function<void(QString)> onError);

ورودی zoneId، شناسه تبلیغ‌گاه از نوع بنری هم‌نما است که باید آن را از داشبورد تپسل دریافت کنید.

نتیجه درخواست تبلیغ به تابع‌های ورودی بازگردانده می شود. یک نمونه پیاده سازی تابع‌های لازم در ادامه آمده است.

Tapsell::requestNativeBannerAd(NATIVE_BANNER_ZONEID,
        [&](QString adId,QString title, QString description, QString iconUrl,
                                   QString ctaText, QString portraitUrl, QString landscapeUrl) {
        qDebug() << "onNativeBannerAdAvailable";
        }, [](){
        qDebug() << "onNoNativeBannerAdAvailable";
        }, [](){
        qDebug() << "onNoNetwork";
        }, [](QString error) {
        qDebug() << "onError: " << error;
        });

گام ۵: نمایش تبلیغ

برای نمایش تبلیغ، می‌بایست از داده های موجود در تابع onAdAvailable استفاده کنید. توضیح این داده ها در جدول زیر آمده است : جدول ۱ داده های تابع onAdAvailable

مشخصه	توضیحات
adId	شناسه تبلیغ
title	عنوان تبلیغ
description	توضیحات تبلیغ
ctaText	متن دعوت کننده از کاربر به کلیک/نصب
portraitUrl	لینک تصویر بنر تبلیغ (عمودی)
landscapeUrl	لینک تصویر بنر تبلیغ (افقی)
iconUrl	لینک آیکون تبلیغ

دقت کنید که تبلیغ‌ها ممکن است هردو بنر عمودی و افقی را نداشته باشند.

در زمان نمایش تبلیغ، باید تابع onNativeBannerAdShown از کلاس Tapsell را فراخوانی کنید ؛ این تابع یک رشته به عنوان ورودی می‌گیرد که شناسه مربوط به تبلیغی است که نمایش داده شده است.

Tapsell::onNativeBannerAdShown(adId);

گام ۶: باز کردن تبلیغ

برای باز کردن تبلیغ، هنگامی که کاربر روی آن کلیک می‌کند، از تابع زیر استفاده کنید. این تابع یک رشته به عنوان ورودی می‌گیرد که شناسه مربوط به تبلیغی است که روی آن کلیک شده است.

Tapsell::onNativeBannerAdClicked(adId);

نمونه پیاده‌سازی

یک نمونه پیاده‌سازی SDK تپسل در Qt در repository زیر آمده است.

مشاهده پروژه نمونه

لطفا نظرات خود درباره محتوای این فایل و مشکلاتی که در پیاده‌سازی SDK تپسل با آنها مواجه شدید را به ما اطلاع دهید.

پیاده‌سازی تبلیغات ویدیویی هم‌نما (Native Video) در پروژه Qt

گام ۱ : راه اندازی پروژه Qt

ابتدا به لینک زیر مراجعه کنید و پلاگین تپسل را به پروژه ی خود اضافه کنید :

راه اندازی پروژه

گام ۲: دریافت کلید تپسل

وارد پنل مدیریت تپسل شده و با تعریف یک اپلیکیشن جدید با عنوان پکیج اپلیکیشن اندرویدی خود، یک کلید تپسل دریافت کنید.

ورود به داشبورد تپسل

گام ۳: شروع کار با SDK تپسل

ابتدا فایل هدر تپسل را include کنید :

#include "tapsell.h"

برای مقداردهی اولیه ، تابع زیر را با ورودی کلید اپ خود صدا بزنید.

Tapsell::initialize(appKey);

ورودی appKey کلید تپسلی است که در گام قبل از پنل تپسل دریافت کردید.

گام ۴: دریافت تبلیغ

در تبلیغات هم‌نما، شما قادر هستید ویژگی‌های ظاهری هر یک از اجزای تبلیغ (اندازه، محل قرارگیری، رنگ فونت و…) را بصورتی که هماهنگ با محتوای اپلیکیشن شما باشد تعیین کنید.

برای این منظور، شما یک درخواست تبلیغ به SDK تپسل ارسال می کنید، محتوای یک تبلیغ هم‌نمای ویدیویی را دریافت کنید و آن را به نحوه مورد نظر خود نمایش دهید.

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

Tapsell::requestNativeBannerAd(QString zoneId,std::function<void(QString,QString,QString,QString,QString,QString)> onAdAvailable,
std::function<void()> onNoAdAvailable,std::function<void()> onNoNetwork,std::function<void(QString)> onError);

ورودی zoneId، شناسه تبلیغ‌گاه از نوع ویدیویی هم‌نما است که باید آن را از داشبورد تپسل دریافت کنید.

نتیجه درخواست تبلیغ به تابع‌های ورودی بازگردانده می شود. یک نمونه پیاده سازی تابع‌های لازم در ادامه آمده است.

Tapsell::requestNativeVideoAd(NATIVE_VIDEO_ZONEID,
        [&](QString adId,QString title, QString description, QString iconUrl,
                                   QString ctaText, QString videoUrl) {
        qDebug() << "onNativeVideoAdAvailable";
        }, [](){
        qDebug() << "onNoNativeVideoAdAvailable";
        }, [](){
        qDebug() << "onNoNetwork";
        }, [](QString error) {
        qDebug() << "onError: " << error;
        });

گام ۵: نمایش تبلیغ

برای نمایش تبلیغ، می‌بایست از داده های موجود در تابع onAdAvailable استفاده کنید. توضیح این داده ها در جدول زیر آمده است : جدول ۱ داده های تابع onAdAvailable

مشخصه	توضیحات
adId	شناسه تبلیغ
title	عنوان تبلیغ
description	توضیحات تبلیغ
ctaText	متن دعوت کننده از کاربر به کلیک/نصب
videoUrl	لینک ویدیو تبلیغ
iconUrl	لینک آیکون تبلیغ

دقت کنید که تبلیغ‌ها ممکن است هردو بنر عمودی و افقی را نداشته باشند.

زمانی که پخش ویدیو تمام شد، باید تابع onNativeVideoAdShown از کلاس Tapsell را فراخوانی کنید ؛ این تابع یک رشته به عنوان ورودی می‌گیرد که شناسه مربوط به تبلیغی است که نمایش داده شده است.

Tapsell::onNativeVideoAdShown(adId);

گام ۶: باز کردن تبلیغ

برای باز کردن تبلیغ، هنگامی که کاربر روی آن کلیک می‌کند، از تابع زیر استفاده کنید. این تابع یک رشته به عنوان ورودی می‌گیرد که شناسه مربوط به تبلیغی است که روی آن کلیک شده است.

Tapsell::onNativeVideoAdClicked(adId);

نمونه پیاده‌سازی

یک نمونه پیاده‌سازی SDK تپسل در Qt در repository زیر آمده است.

مشاهده پروژه نمونه

لطفا نظرات خود درباره محتوای این فایل و مشکلاتی که در پیاده‌سازی SDK تپسل با آنها مواجه شدید را به ما اطلاع دهید.

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

گام ۱ : راه اندازی پروژه Qt

ابتدا به لینک زیر مراجعه کنید و پلاگین تپسل را به پروژه ی خود اضافه کنید :

راه اندازی پروژه

گام ۲: دریافت کلید تپسل

وارد پنل مدیریت تپسل شده و با تعریف یک اپلیکیشن جدید با عنوان پکیج اپلیکیشن اندرویدی خود، یک کلید تپسل دریافت کنید.

ورود به داشبورد تپسل

گام ۳: شروع کار با SDK تپسل

ابتدا فایل هدر تپسل را include کنید :

#include "tapsell.h"

برای مقداردهی اولیه ، تابع زیر را با ورودی کلید اپ خود صدا بزنید.

Tapsell::initialize(appKey);

ورودی appKey کلید تپسلی است که در گام قبل از پنل تپسل دریافت کردید.

گام ۴: دریافت تبلیغ

جهت نمایش بنر استاندارد، باید محلی برای نمایش آن در صفحه در نظر بگیرید. بنر استاندارد، دارای سایزهای استانداردی است که در SDK تپسل مشخص شده اند. جهت نمایش بنر، از توابع زیر استفاده کنید:

Tapsell::requestStandardBannerAd(zoneId, bannerType, horizontalGravity, verticalGravity);
Tapsell::requestStandardBannerAd(zoneId, bannerType, horizontalGravity, verticalGravity, 
                                std::function<void()> onStandardBannerNoAdAvailable, std::function<void()> onStandardBannerNoNetwork, 
                                std::function<void(std::string)> onStandardBannerError, std::function<void()> onStandardBannerRequestFilled, 
                                std::function<void()> onStandardBannerHideBannerView);

مقدار zoneId کلیدی ست که بعد از ساخت اپلیکیشن در پنل و ثبت یک zone از نوع بنری استاندارد دریافت میکنید.

تابع دوم داری پارامترهای اضافی می‌باشد. این پارامترهای اضافی توابع callback هستند که شرح آنها در جدول زیر آمده است :

جدول ۱ اکشن های دریافت نتیجه درخواست تبلیغ

تابع	توضیحات (زمان اجرا)
onStandardBannerError(std::string error)	هنگامی که هر نوع خطایی در پروسه‌ی دریافت تبلیغ بوجود بیاید
onStandardBannerRequestFilled()	زمانی که تبلیغ دریافت شده و نمایش داده شده باشد.
onStandardBannerNoAdAvailable()	در صورتی که تبلیغی برای نمایش وجود نداشته باشد.
onStandardBannerNoNetwork()	زمانی که دسترسی به شبکه موجود نباشد.
onStandardBannerHideBannerView()	زمانی که کاربر تبلیغ را ببندد. (روی ضربدر تبلیغ کلیک کند)

ورودی BannerType اندازه های مختلف را بیان میکند و شامل مقادیر زیر می‌باشد : جدول ۲ مقادیر مختلف پارامتر bannerType

مقدار	ابعاد و نام استاندارد
‌BANNER_320x50	عرض ۳۲۰ - ارتفاع ۵۰ (mobile banner)
BANNER_320x100	عرض ۳۲۰ - ارتفاع ۱۰۰ (large mobile banner)
BANNER_250x250	عرض ۲۵۰ - ارتفاع ۲۵۰ (square)
BANNER_300x250	عرض ۳۰۰ - ارتفاع ۲۵۰ (medium rectangle)

ورودی horizontalGravity نشان میدهد که آیا تبلیغ، بالا یا پایین صفحه باشد و شامل TOP, BOTTOM می باشد،

همچنین verticalGravity بیان میکند که تبلیغ از جهت عرضی در کجای صفحه باشد و میتواند شامل مقادیر LEFT, RIGHT ,CENTER باشد. یک نمونه پیاده سازی توابع بالا به شکل زیر است:

Tapsell::requestStandardBannerAd("5a44aa6565a77100013d5fb3", BANNER_320x50, BOTTOM, CENTER);
Tapsell::requestStandardBannerAd(STANDARD_BANNER_ZONEID,
		BANNER_320x100, BOTTOM,
		CENTER,
		[](){
		qDebug() << "onStandardBannerNoAdAvailable" << endl;
		}, [](){
		qDebug() << "onStandardBannerNoNetwork" << endl;
		}, [](QString error){
		qDebug() << "onStandardBannerError: " << error << endl;
		}, [](){
		qDebug() << "onStandardBannerRequestFilled" << endl;
		}, [](){
		qDebug() << "onStandardBannerHideBannerView" << endl;
		});

نمونه پیاده‌سازی

یک نمونه پیاده‌سازی SDK تپسل در Qt در repository زیر آمده است.

مشاهده پروژه نمونه

لطفا نظرات خود درباره محتوای این فایل و مشکلاتی که در پیاده‌سازی SDK تپسل با آنها مواجه شدید را به ما اطلاع دهید.

Name		Name	Last commit message	Last commit date
TapsellSDKAndHelpers		TapsellSDKAndHelpers
android		android
.gitignore		.gitignore
README.md		README.md
TestProject.pro		TestProject.pro
main.cpp		main.cpp
mainwindow.cpp		mainwindow.cpp
mainwindow.h		mainwindow.h
mainwindow.ui		mainwindow.ui

Latest commit

History

Folders and files

Repository files navigation

راه‌اندازی پروژه QT

گام ۱: دریافت پلاگین تپسل برای Qt

گام ۲: راه اندازی پلتفرم های android و iOS

گام ۳:‌ اضافه کردن پلاگین تپسل به پروژه Qt

نمونه پیاده‌سازی

راه‌اندازی پلاگین تپسل در پلتفرم android در Qt

گام ۱: ساختن پوشه android در پروژه Qt

گام ۲ : اضافه کردن tapsell.jar به پروژه اندروید

گام ۳: اضافه کردن فایل Tapsell.java به پروژه اندروید

گام ۴: اضافه کردن TapsellAdActivity به AndroidManifest.xml

راه‌اندازی پلاگین تپسل در پلتفرم iOS در Qt

گام ۱: اضافه کردن پوشه SDK به پروژه Qt

گام ۲: اضافه کردن مرحله build تپسل به پروژه Qt

پیاده‌سازی تبلیغات ویدئویی (Interstitial/Rewarded Video) و بنری تمام صفحه (Interstitial Banner) در پروژه Qt

گام ۱ : راه اندازی پروژه Qt

گام ۲: دریافت کلید تپسل

گام ۳: شروع کار با SDK تپسل

گام ۴: دریافت تبلیغ

گام ۵: نمایش تبلیغ

گام ۶: دریافت نتیجه نمایش تبلیغ

نمونه پیاده‌سازی

پیاده‌سازی تبلیغات بنری هم‌نما (Native Banner) در پروژه Qt

گام ۱ : راه اندازی پروژه Qt

گام ۲: دریافت کلید تپسل

گام ۳: شروع کار با SDK تپسل

گام ۴: دریافت تبلیغ

گام ۵: نمایش تبلیغ

گام ۶: باز کردن تبلیغ

نمونه پیاده‌سازی

پیاده‌سازی تبلیغات ویدیویی هم‌نما (Native Video) در پروژه Qt

گام ۱ : راه اندازی پروژه Qt

گام ۲: دریافت کلید تپسل

گام ۳: شروع کار با SDK تپسل

گام ۴: دریافت تبلیغ

گام ۵: نمایش تبلیغ

گام ۶: باز کردن تبلیغ

نمونه پیاده‌سازی

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

گام ۱ : راه اندازی پروژه Qt

گام ۲: دریافت کلید تپسل

گام ۳: شروع کار با SDK تپسل

گام ۴: دریافت تبلیغ

نمونه پیاده‌سازی

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages