دمج Zucks مع التوسط
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
هذا الدليل مخصّص للناشرين المهتمين باستخدام التوسّط في "إعلانات Google على الأجهزة الجوّالة" مع Zucks. توضّح هذه المقالة كيفية إعداد محوّل توسّط ليعمل مع تطبيق iOS الحالي وكيفية ضبط إعدادات إضافية.
المتطلبات الأساسية
إضافة Zucks إلى مشروعك
ادمِج الإعلانات في تطبيقك كما كان الحال في السابق. لدمج الإعلانات غير البينية (إعلانات البانر وإعلانات لوحة الصدارة وما إلى ذلك)، راجِع إعلانات البانر. لدمج الإعلانات البينية (إعلانات بملء الشاشة تحجب كل المحتوى الآخر)، راجِع الإعلانات البينية.
تؤدي الخطوات التالية إلى تغيير موضع إعلانك إلى موضع إعلان للتوسّط يمكنه عرض إعلانات من شبكات متعدّدة.
نزِّل المحوّل وحزمة تطوير البرامج (SDK) الخاصة بـ Zucks من المراجع أعلاه.
أضِف محوّل الشبكة/حزمة SDK التي تم تنزيلها في Xcode: انقر بزر الماوس الأيمن على مشروعك، ثم انقر على إضافة ملفات إلى project.
أدرِج أي أُطر أو علامات مترجم أو علامات رابط تتطلّبها Zucks. لست بحاجة إلى كتابة رمز إضافي. تستدعي خدمة التوسّط محوّل Zucks وحزمة تطوير البرامج (SDK) حسب الحاجة لإنشاء الإعلانات.
إعداد إشعارات الأحداث
لتلقّي إشعارات بشأن أحداث دورة حياة الإعلان، مثل مرّات الظهور، يمكنك تنفيذ GADBannerViewDelegate
. عند استخدام التوسّط، يتم إعلام مفوّض التوسّط هذا تلقائيًا بالأحداث من Zucks. على سبيل المثال، يتم تسجيل مرات الظهور من أي شبكة إعلانية من خلال الطريقة adViewDidReceiveAd:
في GADBannerViewDelegate
.
التحقّق من قيمة adNetworkClassName
يمكنك اختياريًا التحقّق من السمة adNetworkClassName
في GAMBannerView
، ما يؤدي إلى عرض اسم فئة شبكة الإعلانات التي استرجعت البانر الحالي بعد استدعاء معاودة الاتصال adViewDidReceiveAd
:
Swift
func adViewDidReceiveAd(_ bannerView: GAMBannerView) {
print("Banner adapter class name: \(bannerView.adNetworkClassName)")
}
Objective-C
- (void)adViewDidReceiveAd:(GAMBannerView *)bannerView {
NSLog(@"Banner adapter class name: %@", bannerView.adNetworkClassName);
}
وبالمثل، بالنسبة إلى الإعلانات البينية، تحقَّق من السمة adNetworkClassName
في GAMInterstitialAd
داخل interstitialDidReceiveAd
:
Swift
func interstitialDidReceiveAd(_ ad: GAMInterstitialAd) {
print("Interstitial adapter class name: \(ad.adNetworkClassName)")
}
Objective-C
- (void)interstitialDidReceiveAd:(GAMInterstitialAd *)interstitial {
NSLog(@"Interstitial adapter class name: %@", interstitial.adNetworkClassName);
}
بالنسبة إلى الإعلانات التي يتم جلبها من خلال
الأحداث المخصّصة، تعرض هذه السمة القيمة
GADMAdapterCustomEvents
.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis guide helps publishers integrate Zucks ads into their iOS apps using Google Mobile Ads mediation.\u003c/p\u003e\n"],["\u003cp\u003eYou need a Google Ad Manager account and an iOS app with the Google Mobile Ads SDK to get started.\u003c/p\u003e\n"],["\u003cp\u003eThe integration process involves adding the Zucks adapter and SDK to your Xcode project and configuring mediation settings.\u003c/p\u003e\n"],["\u003cp\u003eYou can receive ad lifecycle event notifications by implementing a \u003ccode\u003eGADBannerViewDelegate\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eadNetworkClassName\u003c/code\u003e property can be used to identify the ad network that served the current ad.\u003c/p\u003e\n"]]],["Publishers integrating Google Mobile Ads mediation with Zucks should download the Zucks adapter and SDK from the provided resources. Integrate these into their iOS app via Xcode, adding necessary frameworks and flags. No extra code is needed; mediation will use the Zucks adapter and SDK. To receive ad lifecycle event notifications, implement `GADBannerViewDelegate`. Check `adNetworkClassName` on `GAMBannerView` or `GAMInterstitialAd` to identify the ad network after ad reception.\n"],null,["# Integrate Zucks with Mediation\n\nThis guide is intended for publishers who are interested in using Google\nMobile Ads mediation with **Zucks**. It walks\nthrough the setup of a mediation adapter to work with your current iOS app\nand the configuration of additional settings.\n\n| Zucks Resources |\n|---------------------------------------------------------------------------------|\n| [Documentation](http://ms.zucksadnetwork.com/media/sdk/manual/admob-mediation/) |\n| [SDK](http://ms.zucksadnetwork.com/media/sdk/manual/ios/) |\n| [Adapter](http://ms.zucksadnetwork.com/media/sdk/manual/admob-mediation/) |\n| [Customer support](mailto:support@zucksadnetwork.com) |\n\nPrerequisites\n-------------\n\n- An iOS app with the Google Mobile Ads SDK integrated. (If you don't\n have one, see [Get Started](/ad-manager/mobile-ads-sdk/ios/quick-start).)\n\n- A Google Ad Manager account with [Mediation for mobile\n apps](//support.google.com/admanager/answer/6272813) configured.\n\nAdd Zucks to your project\n-------------------------\n\nIntegrate ads into your app the same as before. To integrate\nnon-interstitial ads (banner size, leaderboard size, and so on),\nsee [Banner Ads](/ad-manager/mobile-ads-sdk/ios/banner). To integrate\ninterstitial ads (full-screen ads that mask all other content),\nsee [Interstitial Ads](/ad-manager/mobile-ads-sdk/ios/interstitial).\n\nThe following steps change your ad placement into a mediation\nplacement that can show ads from multiple networks.\n\n1. Download the adapter and SDK for Zucks from the\n [resources above](#resources).\n\n2. Add the downloaded network adapter/SDK in Xcode: right-click\n on your project and click **Add Files to \u003cvar class=\"readonly\" translate=\"no\"\u003eproject\u003c/var\u003e**.\n\n3. Include any frameworks, compiler flags, or linker flags that Zucks\n require. There's no need to write additional code. Mediation invokes the\n Zucks adapter and SDK as necessary to create ads.\n\n### Set up event notification\n\nTo be notified of ad lifecycle events like impressions, you can implement\na `GADBannerViewDelegate`. When using mediation, this delegate is\nautomatically notified of events from Zucks. For example, impressions\nfrom any ad network are reported through the `adViewDidReceiveAd:` method of\n`GADBannerViewDelegate`.\n\n### Check the value of adNetworkClassName\n\nYou can optionally check the `adNetworkClassName` property on\n`GAMBannerView`, which returns the ad network class\nname of the ad network that fetched the current banner once the\n`adViewDidReceiveAd` callback is called: \n\n### Swift\n\n func adViewDidReceiveAd(_ bannerView: GAMBannerView) {\n print(\"Banner adapter class name: \\(bannerView.adNetworkClassName)\")\n }\n\n### Objective-C\n\n - (void)adViewDidReceiveAd:(GAMBannerView *)bannerView {\n NSLog(@\"Banner adapter class name: %@\", bannerView.adNetworkClassName);\n }\n\nSimilarly, for interstitials, check the `adNetworkClassName` property\non `GAMInterstitialAd` inside `interstitialDidReceiveAd`: \n\n### Swift\n\n func interstitialDidReceiveAd(_ ad: GAMInterstitialAd) {\n print(\"Interstitial adapter class name: \\(ad.adNetworkClassName)\")\n }\n\n### Objective-C\n\n - (void)interstitialDidReceiveAd:(GAMInterstitialAd *)interstitial {\n NSLog(@\"Interstitial adapter class name: %@\", interstitial.adNetworkClassName);\n }\n\nFor ads fetched through [custom events](/ad-manager/mobile-ads-sdk/ios/custom-events), it returns `GADMAdapterCustomEvents`.\n\n\u003cbr /\u003e"]]