استخدام شبكة الاعلانات StartApp في تطبيقات الاندرويد برمجياً

بسم الله الرحمن الرحيم

في البداية هذه شبكة اعلانية وسيطة ما بين المبرمج والشبكات او الافراد الذي يضعون الاعلانات لدى هذه الشبكة بمبلغ مادي, وتقوم بتوزيع الاعلان على عدد من التطبيقات المضافة لديها من قبل المبرمجين, وإعطائهم حصتهم في نشر هذا الاعلان ~

نظرة سريعة لموقع StartApp ربح من الاعلانات لتطبيقات الاندرويد

لفتح عضوية في الموقع, اضغط هنا.

بعد التسجيل وفتح الحساب, من الجهة اليسرى اضغط على Apps & Sites ثم في الجهة اليمنى زر Add New App .

 سوف تظهر لك نافذة إضافة التطبيق Add App.

URL Address / ادخل رابط التطبيق في المتجر, إذا كنت لم ترفع تطبيقك للمتجر بعد, أدخل الرابط التالي + معرف id الخاص بتطبيقك. // تستطيع تجاهل وضع الرابط.

https://play.google.com/store/apps/details?id=[ID_APP]

// change [ID_APP] with applicationId in build.gradle

App Name / اسم التطبيق.

Platform / المنصة التي تم إنشاء التطبيق عليها.

Mediation / اذا كنت لا تستخدم شبكة اعلانات من التي تظهر في الخيارات لديك اختر No

App Info / فئة التطبيق + الفئة التي تناسبها التطبيق.

بعد الضغط على إنشاء سوف يظهر لك App ID خاص لهذا التطبيق.

أسفل هذا المعرف يوجد زر Download SDK اضغط عليه, سوف تظهر لك صفحة التحميلات, اختر نظام اندرويد ثم من خانة Download the relevant SDK اختر In App إذا كنت تستخدم تطبيق, وليس احد محركات الالعاب المعروضة. ثم اختر Download, سوف يبدأ تحميل الـ SDK الخاصة بالموقع.

التحميل عبارة عن ملف ارشيف بصيغة Zip قم بفك الضغط, ثم قم بنقل من داخله الملف الذي نحتاجه وهو ملف StartAppInApp-x.x.x.jar إلى مجلد libs الخاص بمشروعك الاندرويد.

 

الآن ننتقل إلى بيئة الاندرويد ستوديو لتجهيز مشروع الاندرويد لاستقبال هذه الاعلانات.

في البداية في ملف build.gradle تأكد من وجود السطر الافتراضي :

compile fileTree(dir: 'libs', include: ['*.jar'])

لتفعيل جميع ملفات jar في مشروعك, فإذا لم تتعرف عليه الكلاسات فإذاً قم بإضافة السطر التالي : مع تغيير x لرقم الاصدار لديك.

compile files('libs/StartAppInApp-x.x.x.jar')

أما في ملف AndroidManifest.xml فإضف الصلاحيات التالية :

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

صلاحيات واضحة, لدخول الانترنت ومعرفة حالة الاتصال.

ثم إضف التالي داخل اوسمة <application> :

<activity android:name="com.startapp.android.publish.list3d.List3DActivity"
          android:theme="@android:style/Theme" />

<activity android:name="com.startapp.android.publish.OverlayActivity"
          android:theme="@android:style/Theme.Translucent"
          android:configChanges="orientation|keyboardHidden|screenSize" />

<activity android:name="com.startapp.android.publish.FullScreenActivity"
          android:theme="@android:style/Theme"
          android:configChanges="orientation|keyboardHidden|screenSize" />

في الاكتفتي الرئيسية لتطبيقك , اضف التالي قبل تحديد اللياوت . أي قبل :

setContentView(R.layout.activity_main);

ضع :

StartAppSDK.init(this, "Your App ID", true);

استبدل Your App ID بـ رقم المعرف الخاص بالتطبيق App ID الذي حصلنا عليه سابقاً عند إضافة التطبيق, فإن لم تجده سجل دخولك في الموقع ثم أذهب خانة Apps & Sites سوف تجد جميع تطبيقاتك وبجانب كل تطبيق الـمعرف الخاص به.

الآن هكذا جهزنا مشروعنا لتلقي جميع انواع الاعلانات من شبكة الاعلانات StartApp.com .

بعد تنفيذ الخطوات السابقة .. تستطيع الآن اختيار الاعلان الذي تريده وتركيبه في مشروعك 🙂

تركيب بانر إعلاني : Banners

فقط قم بوضع التالي في أي لياوت تريد :

<com.startapp.android.publish.banner.Banner
        android:id="@+id/startAppBanner"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"/>

بانر ثري دي 3D :

<com.startapp.android.publish.banner.banner3d.Banner3D
        android:id="@+id/startApp3DBanner"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"/>

تركيب البانر برمجياً من الاكتفتي :

// Get the Main relative layout of the entire activity
RelativeLayout mainLayout = (RelativeLayout)findViewById(R.id.mainLayout);   
// Define StartApp Banner
Banner startAppBanner = new Banner(context);
RelativeLayout.LayoutParams bannerParameters =
            new RelativeLayout.LayoutParams(
                        RelativeLayout.LayoutParams.WRAP_CONTENT,
                        RelativeLayout.LayoutParams.WRAP_CONTENT);
bannerParameters.addRule(RelativeLayout.CENTER_HORIZONTAL);
bannerParameters.addRule(RelativeLayout.ALIGN_PARENT_BOTTOM);    
// Add to main Layout
mainLayout.addView(startAppBanner, bannerParameters);

RelativeLayout / نوع اللياوت للرئيسية داخل xml الذي تريد وضع الاعلان داخله.
R.id.mainLayout / الاي دي قم بتغيره حسب الاي دي لديك للياوت.
context / بمعنى سياق او حالة موضع تفعيل الاعلان .. إذا كان داخل دالة معينة إلخ , افترضياً ضع بدلها this .
bannerParameters / خصائص للاعلان, حسب الكود يظهر الاعلان في الاسفل ويأخذ المنتصف .

في حال تركيب البانر برمجياً لا يحتاج تركيب بانر في ملفات xml 🙂

تركيب الإعلان البيني : Interstitial Ads

هو الإعلان الذي يملأ الشاشة ويظهر في الغالب من خلال الانتقال من شاشة إلى أخرى.

لتعريف الاعلان البيني ضع السطر التالي داخل الكلاس وخارج الدوال :

private StartAppAd startAppAd = new StartAppAd(this);

ثم قم بعرض هذا الاعلان بالموضع الذي تريد, مثلاً :

عند بداية تشغيل اي اكتفتي :

startAppAd.showAd(); // show the ad
startAppAd.loadAd(); // load the next ad

تستطيع استخدام نفس الكود في الانتنت عند الانتقال من واجهة إلى اخرى.

عند الضغط على زر الباك ( الرجوع ) : يوضع الكود خارج دالة الاون كريت.

@Override
public void onBackPressed() {
    startAppAd.onBackPressed();
    super.onBackPressed();
}

مشاهدة فيديو اعلاني , وإذا تم مشاهدة الفيديو بالكامل يحصل أمراً ما, مثلاً فتح مراحل جديدة, إضافة خصائص جديدة إلخ ..

startAppAd.loadAd(StartAppAd.AdMode.REWARDED_VIDEO);

يتم تنفيذ الكود داخل دالة الاون كريت + :

startAppAd.setVideoListener(new VideoListener() {
     @Override
     public void onVideoCompleted() {
          // ضع هنا الاوامر التي تريد تنفيذها بعد مشاهدة الفيديو الاعلاني
     }
});

إعلان مميز Splash Screen :

إعلان مميز يظهر بداية تشغيل التطبيق. فقط ضع السطر التالي في الاكتفتي الرئيسية للتطبيق :

StartAppAd.showSplash(this, savedInstanceState);

this / اشارة الى الاكتفتي الذي نحن فيه.
savedInstanceState / وهو الـ Bundle لدالة الاون كريت, بداية فتح دالة الاون كريت تجد Bundle بين قوسين بجانبه متغير. في الغالب تجده مثل ما موجود بالكود, لو مختلف قم بتغيره حسب الموجود لديك.

إعلان سايد Slider :

اعلان في الجانب , يستطيع المستخدم استخدامه كشريط للبحث في الويب او الصور, مع عرض بعض الاعلانات. قم بتجربته سهل التركيب وممتع يظهر انه جزء من التطبيق. فقط باستخدام السطر التالي :

StartAppAd.showSlider(this);

طرق الاعلان مع شبكة StartApp كثيرة, ولكن بينت أغلبها وأكثرها شيوعاً , ولكن الشبكة مميزة فلو بحثت معها تجد ان هناك الكثير من الخصائص , إن شاء الله في مستويات متقدمة سوف اشرحها , وأتمنى للجميع دوام الصحة والعافية .

جميع مافي الموضوع تم تجربته قبل نشره, أتمنى الاستفادة للجميع وانتظرونا في كل جديد وحصري .. والسلام عليكم ~