إعداد الوصول المباشر إلى Ad Exchange

اختيار النظام الأساسي: Android جديد Android iOS

تتيح حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" تحقيق الربح من تطبيقاتك باستخدام موقع إلكتروني على Ad Exchange property. يوضّح هذا الدليل كيفية ضبط إعدادات تطبيقاتك لجميع أشكال الإعلانات التي يتيحها Ad Exchange.

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

ضبط إعدادات تطبيقك للوصول إلى Ad Exchange

عدِّل ملف Info.plist في تطبيقك لضبط المفتاح GADApplicationIdentifier على قيمة سلسلة تمثّل رقم تعريف تطبيقك في "مدير إعلانات Google" (المحدّد في واجهة مستخدم "مدير إعلانات Google").

يُرجى العِلم أيضًا أنّ عدم ضبط المفتاح GADApplicationIdentifier في ملف info.plist كما هو موضّح أعلاه يؤدي إلى حدوث عطل في التطبيق مع ظهور الرسالة التالية:

Terminating app due to uncaught exception 'GADInvalidInitializationException',
reason: 'The Google Mobile Ads SDK was initialized without an application ID.
Google AdMob publishers, follow instructions at
https://goo.gle/admob-ios-update-plist to set a valid
application ID. Google Ad Manager publishers, follow instructions at
https://goo.gle/ad-manager-ios-update-plist.'

بعد ذلك، يمكنك اختيار شكل إعلان لعرضه. يستخدِم باقي هذا الدليل شكل الإعلان البانر لتوضيح كيفية تحميل إعلان من Ad Exchange. يمكن تطبيق الخطوات نفسها على أيّ أشكال إعلانات تتيحها حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".

تحميل إعلان من Ad Exchange

يمكنك استخدام رمز موقع إلكتروني على Ad Exchange مع شرطة مائلة في النهاية بدلاً من رقم تعريف الوحدة الإعلانية. على سبيل المثال: ca-mb-app-pub-5629679302779023/.

من أجل تحميل الإعلانات البانر وعرضها، يتطلّب GAMBannerView توفّر adUnitID. يمكنك ضبط هذه السمة على رقم تعريف موقع إلكتروني على Ad Exchange على النحو التالي:

override func viewDidLoad() {
  super.viewDidLoad()
  ...

  bannerView.adUnitID = "ca-mb-app-pub-5629679302779023/"
  bannerView.rootViewController = self
}

بعد وضع GAMBannerView وضبط خصائصه، يمكنك تحميل إعلان وتخصيص سلوك إعلانك باستخدام أحداث الإعلانات.

يُرجى العِلم أنّ عدم إضافة شرطة مائلة في نهاية رمز موقع إلكتروني على Ad Exchange يؤدي إلى حدوث خطأ في طلب عرض الإعلان مع ظهور الرسالة التالية:

Invalid Request. Cannot determine request type. Is your ad unit id correct?

يمكنك أيضًا تحويل رمز موقع إلكتروني على Ad Exchange إلى وحدة إعلانية. بعد ذلك، استخدِم واجهة مستخدم "مدير إعلانات Google" لـ إنشاء علامة Ad Exchange ونسخها إلى تطبيقك. يجب أن تتضمّن العلامة التي تم إنشاؤها رمز موقع إلكتروني على Ad Exchange، يليه أرقام تعريف الوحدات الإعلانية الفرعية بدون شرطة مائلة في النهاية، على سبيل المثال: ca-mb-app-pub-5629679302779023/banner.

هذا كل شيء! أصبح تطبيقك الآن جاهزًا لتحميل الإعلانات البانر وعرضها من Ad Exchange.

بالإضافة إلى ذلك، يمكنك استخدام موقع إلكتروني على Ad Exchange لتحميل أشكال الإعلانات الأخرى وعرضها من Ad Exchange باتّباع الأدلة ذات الصلة:

(الناشرون الأوروبيون الذين تمت الموافقة عليهم فقط) إضافة حدود سعرية

يمكنك إرسال طلب لاستخدام ميزة "الحدود السعرية".

بعد الموافقة، يمكنك تضمين حدّ سعر علني أو حدّ سعر خاص في طلب عرض الإعلان باستخدام المعلَمتَين pubf وpvtf على التوالي. في مثال الرمز التالي، استبدِل "123" بالحدود السعرية بالوحدات الصغيرة والعملة التلقائية لشبكتك. مثال على كيفية تطبيق الوحدات الصغيرة: إذا كانت عملتك التلقائية هي الدولار الأمريكي، فإنّ إدخال "6000000" يعادل 6.00 دولار أمريكي.

Swift

let extras = AdNetworkExtras()
extras.additionalParameters = ["pubf": "123", "pvtf": "123"]

let request = AdManagerRequest()
request.register(extras)

Objective-C

GADAdNetworkExtras *extras = [[GADAdNetworkExtras alloc] init];
extras.additionalParameters = @{@"pubf": @"123", @"pvtf": @"123"};

GAMRequest *request = [GAMRequest request];
[request registerAdNetworkExtras:extras];