بدء الاستخدام

تعرض SDK للمكون الإضافي Audience Network Unity الإعلانات للناشرين باستخدام Unity على تطبيقات iOS وAndroid. ويمكن استخدام محول Unity لإعلانات البانر والإعلانات الخلالية والإعلانات الأصلية.

احرص على قراءة دليل بدء استخدام Audience Network قبل المتابعة.

المتطلبات الأساسية

تثبيت الإصدار Unity 5.0 أو إصدار أحدث.

التأكد من تثبيت أحدث إصدار من الأدوات التالي:

إضافة إعلان Audience Network إلى تطبيق Unity

الخطوة 1: تنزيل SDK للمكون الإضافي Audience Network Unity

الخطوة 2: إنشاء وإعداد نموذج مشروع تطبيق Unity لمنصة Audience Network

الخطوة 3: إنشاء تطبيق iOS من مشروع Unity

الخطوة 4: إنشاء تطبيق Android من مشروع Unity

الخطوة 1: تنزيل Audience Network SDK

تشكل مجموعة Audience Network Unity SDK جزءًا من Facebook SDK لمنصة Unity. لبدء الاستخدام، قم بتنزيل Facebook SDK لمنصة Unity واستخراجها.

الخطوة 2: إنشاء وإعداد نموذج مشروع تطبيق Unity لمنصة Audience Network

بعد تثبيت Unity وتنزيل أحدث SDK للمكون الإضافي Audience Network Unity، يمكنك فتح تطبيق Unity وإنشاء نموذج مشروع.

قم بفتح تطبيق Unity وتسمية المشروع AudienceNetworkUnityTutorial، ثم قم بتعيين الموقع الذي تريد تخزين المشروع به.
في محرر Unity، من القائمة Assets (الأصول)، حدد Import Package (استيراد الحزمة) ثم Custom Package…(حزمة مخصصة ...)، ثم حدد audience-network-unity-sdk.unitypackagee من مجلد AudienceNetworkSDK لاستيراد المكون الإضافي إلى المشروع.

بعد استيراد Audience Network SDK، ستتمكن من التنقل إلى محتوى SDK من لوحة Project (المشروع) على النحو التالي:
في لوحة المشروع بمحرر Unity، من المفترض أن يظهر لك مجلد AudienceNetwork الذي تم إنشاؤه أسفل مجلد Assets (الأصول). قم بفتح مجلد Samples (النماذج)، وستظهر لك AdViewScene وInterstitialAdSceneوNativeAdScene وهي عبارة عن ملفات منظر. أما AdViewTest.cs وInterstitialAdScene.cs وNativeAdScene.cs فعبارة عن ملفات cs يتم استخدامها في استدعاء Audience Network API لطلب عرض محتوى الإعلان وتحميله.

انقر نقرًا مزدوجًا لفتح AdViewTest.cs وقم بالبحث عن YOUR_PLACEMENT_ID. سترى عملية الاستدعاء التالية.
```
AdView adView = new AdView ("YOUR_PLACEMENT_ID", AdSize.BANNER_HEIGHT_50);</code>
```
قم باستبدال YOUR_PLACEMENT_ID بسلسلة معرف الموضع الخاصة بك. إذا لم يكن لديك معرف موضع أو ليس لديك معرفة عن كيفية الحصول على معرف، راجع دليل بدء الاستخدام. قم بتكرار هذا الإجراء مع كل من InterstitialAdScene.cs و NativeAdScene.cs.
انقر نقرًا مزدوجًا على NativeAdScene ثم انقر على زر "Play (تشغيل)" في أعلى اللوحة، وسيكون بإمكانك رؤية إعلان Audience Network الاختباري افتراضيًا على النحو التالي:

الخطوة 3: إنشاء تطبيق iOS من مشروع Unity

بعد إنشاء نموذج مشروع Unity الذي تم دمجه بمجموعة SDK للمكون الإضافي Audience Network Unity، يمكنك التعرف على كيفية إنشاء تطبيق iOS الذي يمكنه عرض إعلانات Audience Network من فيسبوك.

الرجاء مراجعة الأسئلة المتكررة بشأن أدني إصدار لنظام التشغيل تدعمه Audience Network SDK.

انقر نقرًا مزدوجًا على AdViewScene من مجلد Samples (النماذج) واختر File (ملف) -> Build Settings (إعدادات الإنشاء). من نافذة Scenes In Build (المشاهد قيد الإنشاء)، انقر على زر Add Open Scenes (إضافة مشاهدة مفتوحة) وحدد AudienceNetwork/Samples/AdViewScene. قم بتكرار هذه الخطوة مع كل من InterstitialScene وNativeAdScene على النحو التالي:

حدد منصة iOS وانقر على Build And Run (إنشاء وتشغيل) سيستغرق الأمر بضع ثوانٍ لإنشاء نموذج مشروع iOS.
قم بفتح مشروع Xcode بعد إنشائه من Unity. انقر على ملف المشروع وحدد عملية الإنشاء المستهدفة من قائمة Targets (عمليات الإنشاء المستهدفة). تحقق مما إذا كان لديك معرف حزمة صالح على النحو التالي:

Note that XCode will create a bundle identifier for your project. In this example, the bundle identifier is com.yourcompany.AudienceNetworkTutorial. You will use this bundle identifier later when you submit your app for approval as explained in Submit For Review.
لا يوفر المكون الإضافي الأصلي لتطبيق Unity واجهة API لإضافة مكتبات مستقلة مطلوب ربطها لمشروع iOS. ستظهر لك أخطاء الإنشاء التالية:
```
Undefined symbols for architecture arm64:
  "_xmlXPathFreeObject", referenced from: lxml::xpath::object::object(_xmlXPathObject*) in FBAudienceNetwork(FNFMediaPresentationDescription.o)
```
لتصحيح خطأ الإنشاء الموضح أعلاه، ستحتاج إلى إضافة '-lxml2' إلى 'Other Linker Flags (علامات أداة الربط الأخرى)' في صفحة "Build Settings (إعدادات الإنشاء)" في المشروع على النحو التالي:
قم بإضافة StoreKit.framework إلى Linked Frameworks and Libraries (أطر العمل والمكتبات المرتبطة) على النحو التالي:
اختر الجهاز كهدف للإنشاء، ثم قم بإنشاء المشروع وتشغيله. يمكن رؤية إعلانات Audience Network الواردة من تطبيق تم إنشاؤه عبر Unity على النحو التالي:

الخطوة 4: إنشاء تطبيق Android من مشروع Unity

أدني إصدار تدعمه Audience Network SDK لنظام التشغيل Android هو الإصدار 11 لواجهة API لمجموعة Android SDK.

انقر نقرًا مزدوجًا على AdViewScene من مجلد Samples (النماذج) واختر File (ملف) -> Build Settings (إعدادات الإنشاء). من نافذة Scenes In Build (المشاهد قيد الإنشاء)، انقر على زر Add Open Scenes (إضافة مشاهدة مفتوحة) وحدد AudienceNetwork/Samples/AdViewScene. قم بتكرار هذه الخطوة مع كل من InterstitialScene وNativeAdScene على النحو التالي:

في منصة Android، حدد كل من الخيارين Google Android Project (مشروع Google Android) وDevelopment Build (إنشاء إصدار في مرحلة التطوير).
انقر على Player Settings (إعدادات المشغل). في Other Settings (إعدادات أخرى) -> Identification (التعريف) -> Version (الإصدار)، حدد "Android 3.0 'Honeycomb' ( API level 11'واجهة API المستوى 11')". انقر على Build And Run (إنشاء وتشغيل). سيستغرق الأمر بضع ثوانٍ لإنشاء نموذج مشروع Android.
قم بفتح Android Studio وحدد Import project (استيراد المشروع).

قم بتحديد موقع مشروع android الذي تم إنشاؤه بواسطة Unity لإنشاء مشروع gradle.
بعد أن ينتهي Android Studio من إنشاء مشروع gradle، قم بفتحه وحدد جهاز Android الخاص بك على أنه Deployment Target (هدف النشر). يمكن رؤية إعلانات Audience Network الواردة من تطبيق تم إنشاؤه عبر Unity على النحو التالي:

الخطوات التالية

قم بتقديم تطبيقك للمراجعة.
بمجرد استلامنا طلبًا لإعلان من تطبيقك أو موقع الويب، سنقوم بمراجعته للتأكد من توافقه مع سياسات Audience Network ومعايير مجتمع فيسبوك. اعرف المزيد عن عملية المراجعة لدينا.