راهنمای Cordova

این متن جهت آماده‌سازی و استفاده از پلاگین کوردوا مگنت در برنامه کاربردی اندروید شما تهیه شده است. در صورت داشتن هر گونه سوال، از طریق پست الکترونیک info@magnet.ir آن را با ما در میان بگذارید.

۱- پیش‌نیاز‌ها

۱-۱- نصب پلاگین کوردوا مگنت

ایتدا پلاگین را از اینجا دانلود و پس از خارج نمودن از حالت زیپ، دستور زیر را در مسیر پروژه خود اجرا کنید. (DOWNLOADED_PLUGIN_PATH آدرس محل دانلود شدن پلاگین است)

cordova plugin add DOWNLOADED_PLUGIN_PATH

۲- راه‌اندازی سیستم تبلیغ

راه‌اندازی اولیه را پس از رویداد deviceready انجام دهید.

magnet.initialize(function() {
        alert('init success');
    }, function() {
        alert('init fail');
    }
);

پس از راه‌اندازی اولیه حالت تست مود را تعیین کنید.

magnet.setTestMode(true, null, null);

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

۲-۱- Mobile Banner

شما می‌توانید بنر را در بالا یا پایین اپلیکشن خود نمایش دهید magnet.Position مقادیر ثابت جایگاه بنر را نگه می‌دارد .

magnet.showBanner('YourAdUnitId', magnet.Position.BOTTOM, null, null);

• به جای YourAdUnitId شناسه خود را قرار دهید.

برای توقف آپدیت تبلیغات می‌توانید از کد زیر استفاده کنید:

magnet.stopBanner(null, null);

۲-۲- Interstitial

ابتدا تبلیغ میانی را لود کنید سپس از طریق رویداد onInterstitialReceived از لود شدن آن مطلع شوید و تبلیغ را به نمایش در آورید.

function loadInterstitial() {
    document.addEventListener(magnet.Event.onInterstitialAdReceived, onInterstitialReceived, false);
    magnet.loadInterstitial('YourAdUnitId', null, null);
}

function showInterstitial() {
    magnet.showInterstitial(null, null);
}

function onInterstitialReceived() {
    alert('Interstitial is ready');
    // or call showInterstitial()
}

• به جای YourAdUnitId شناسه خود را قرار دهید.

۲-۳- Rewarded

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

function loadRewarded() {
    document.addEventListener(magnet.Event.onRewardedAdReceived, onRewardedReceived, false);
    magnet.loadRewarded('YourAdUnitId', null, function (errorMsg) {
        alert(errorMsg);
    });
}

function showRewarded() {
    document.addEventListener(magnet.Event.onRewardedAdFinish, onRewardedFinish, false);
    magnet.showRewarded(null, null);
}

function onRewardedReceived() {
    console.log("Rewarded received");
    alert('Rewarded is ready');
}

function onRewardedFinish(event) {
    alert('Reward? ' + event.data);
    if (event.data === 'true') {
        //successful reward
    }
}

• به جای YourAdUnitId شناسه خود را قرار دهید.

۲-۴- نمونه کد پیاده‌سازی مگنت

در پلاگینی که دریافت کردید، در پوشه Sample فایل index.xml موجود است که می‌توانید نحوه پیاده‌سازی SDK مگنت را مشاهده کنید.