يوضّح لك هذا الدليل كيفية دمج محوِّل التوسّط مع تطبيق iOS.
المتطلبات الأساسية
قبل أن تتمكن من دمج التوسط لأحد أشكال الإعلانات، يلزمك دمج شكل الإعلان هذا في تطبيقك:
- إعلانات البانر
- الإعلانات البينية
- الإعلانات المدمجة مع المحتوى
- الإعلانات التي تضم مكافأة
- الإعلانات البينية التي تضمّ مكافأة
هل أنت حديث العهد بالتوسّط؟ يُرجى الاطّلاع على مقدّمة عن التوسّط.
لتقديم عروض الأسعار: حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" 7.53.1 أو إصدار أحدث
إعداد حزمة تطوير البرامج (SDK) لعرض الإعلانات للأجهزة الجوّالة
يوضِّح لك دليل البدء السريع كيفية إعداد حزمة تطوير البرامج (SDK) لإعلانات الأجهزة الجوّالة. وخلال مكالمة الإعداد هذه، يتم أيضًا تهيئة محوّلات التوسط. من المهم الانتظار حتى تكتمل عملية الإعداد قبل loadingتحميل الإعلانات لضمان المشاركة الكاملة من كل شبكة إعلانات في طلب الإعلان الأول.
يوضّح الرمز البرمجي النموذجي التالي كيفية التحقّق من حالة بدء كل محوِّل قبل تقديم طلب إعلان.
Swift
import GoogleMobileAds
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
func application(_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
let ads = GADMobileAds.sharedInstance()
ads.start { status in
// Optional: Log each adapter's initialization latency.
let adapterStatuses = status.adapterStatusesByClassName
for adapter in adapterStatuses {
let adapterStatus = adapter.value
NSLog("Adapter Name: %@, Description: %@, Latency: %f", adapter.key,
adapterStatus.description, adapterStatus.latency)
}
// Start loading ads here...
}
return true
}
}
Objective-C
@import GoogleMobileAds;
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
GADMobileAds *ads = [GADMobileAds sharedInstance];
[ads startWithCompletionHandler:^(GADInitializationStatus *status) {
// Optional: Log each adapter's initialization latency.
NSDictionary *adapterStatuses = [status adapterStatusesByClassName];
for (NSString *adapter in adapterStatuses) {
GADAdapterStatus *adapterStatus = adapterStatuses[adapter];
NSLog(@"Adapter Name: %@, Description: %@, Latency: %f", adapter,
adapterStatus.description, adapterStatus.latency);
}
// Start loading ads here...
}];
return YES;
}
@end
معرفة شبكة المواقع الإعلانية الفائزة
تحتوي كل فئة من فئات أشكال الإعلانات على سمة GADResponseInfo
تحتوي على
adNetworkClassName
التي تعرض اسم فئة شبكة الإعلانات للإعلان
الحالي. لا تُحدَّد قيمة لسمة adNetworkClassName
إلا بعد تحميل إعلان بنجاح. يوضّح لك الرمز التالي كيفية الحصول على هذه المعلومات لإعلانات البانر.
Swift
func adViewDidReceiveAd(_ bannerView: GAMBannerView) {
print("Banner adapter class name: \(bannerView.responseInfo.adNetworkClassName)")
}
Objective-C
- (void)adViewDidReceiveAd:(GAMBannerView *)bannerView {
NSLog(@"Banner adapter class name: %@", bannerView.responseInfo.adNetworkClassName);
}
راجِع استرداد معلومات عن Ad Response لمعرفة التفاصيل.
استخدام إعلانات البانر مع التوسّط
تأكَّد من إيقاف ميزة إعادة التحميل في جميع واجهات مستخدم مصادر الإعلانات التابعة لجهات خارجية ل وحدات إعلانات البانر المستخدَمة في التوسّط. ويمنع ذلك إعادة تحميل مضاعفة لأنّ "مدير إعلانات Google" يُجري أيضًا عملية إعادة تحميل استنادًا إلى معدّل إعادة تحميل الوحدة الإعلانية لإعلان البانر.
استخدام الإعلانات المدمجة مع المحتوى مع التوسّط
في ما يلي بعض أفضل الممارسات التي يجب أخذها في الاعتبار عند تنفيذ التوسّط المضمّن.
- سياسة عرض الإعلانات المدمجة مع المحتوى
- لكل شبكة إعلانات سياساتها الخاصة. عند استخدام التوسّط، من المهم remembered أنّ تطبيقك لا يزال بحاجة إلى الالتزام بسياسات الشبكة التي تم التوسّط بينها والتي قدّمت الإعلان.
- تجنَّب استخدام فئة
GADMultipleAdsAdLoaderOptions
عند إجراء الطلبات. - لا تعرِض طلبات الإعلانات المدمجة المتعددة سوى إعلانات Google. لا تتيح ميزة الإعلانات المضمّنة المتعدّدة التوسّط.
قوانين الخصوصية في الولايات الأمريكية و"اللائحة العامّة لحماية البيانات"
إذا كنت بحاجة إلى الامتثال لمَثَل قوانين الخصوصية في الولايات الأمريكية أو اللائحة العامة لحماية البيانات (GDPR)، اتّبِع الخطوات الواردة في إعدادات اللوائح التنظيمية في الولايات الأمريكية أو إعدادات اللائحة العامة لحماية البيانات لإضافة شركاء التوسّط في صفحة "الخصوصية والمراسلة" ضمن "مدير إعلانات Google" في الولايات الأمريكية أو قائمة شركاء الإعلانات بموجب "اللائحة العامة لحماية البيانات". وقد يؤدي عدم إجراء ذلك إلى عدم تمكّن الشركاء من عرض الإعلانات على تطبيقك.
اطّلِع على مزيد من المعلومات عن تفعيل المعالجة المحدودة للبيانات (RDP) والحصول على موافقة اللائحة العامّة لحماية البيانات (GDPR) باستخدام حزمة تطوير البرامج (SDK) لمنصّة Google User Messaging Platform (UMP) .