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

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

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

• أكمِل المتطلبات الأساسية.
• استيراد حزمة SDK لإعلانات Google على الأجهزة الجوّالة
• عدِّل Info.plist.

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

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

تجدر الإشارة أيضًا إلى أنّ عدم ضبط مفتاح 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://googlemobileadssdk.page.link/admob-ios-update-plist to set a valid
application ID. Google Ad Manager publishers, follow instructions at
https://googlemobileadssdk.page.link/ad-manager-ios-update-plist.'

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

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

يمكنك استخدام رمز موقع ويب Ad Exchange مع شرطة مائلة للأمام في تطبيقك بدلاً من رقم تعريف الوحدة الإعلانية.

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

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

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

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

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

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

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

أكملت هذه الخطوة. تطبيقك جاهز الآن لتحميل إعلانات البانر وعرضها من Ad Exchange.

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

• الإعلانات البينية
• مدمجة مع المحتوى
• إعلان بمكافأة

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

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

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

Swift

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

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

Objective-C

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

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