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

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

تتيح حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" تحقيق الربح من تطبيقاتك باستخدام موقع على Ad Exchange. يوضّح لك هذا الدليل كيفية إعداد تطبيقاتك لجميع أشكال الإعلانات التي يتيحها 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];