التحكّم في أحداث النقر التي يجريها المستخدِمون
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يوضّح هذا الدليل كيفية تنفيذ المزيد من التحكّم في النقر في عملية تنفيذ حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية. يشير "النقر" إلى عملية نقر المستخدِم على إعلان ووصوله إلى
الصفحة المقصودة لهذا الإعلان. توضِّح الأمثلة الواردة في هذا الدليل كيفية ضبط مكان فتح
الصفحة المقصودة وكيفية الاستماع إلى الأحداث المتعلّقة بالمستخدمين الذين يزورون تلك الصفحة.
المتطلبات الأساسية
تطبيق iOS تم تنفيذ حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية فيه
ضبط النقر للوصول
تغيير تطبيق فتح الرابط
توفّر حزمة تطوير البرامج لإعلانات الوسائط التفاعلية خيارَين لفتح الصفحات المقصودة للإعلانات، إما من خلال متصفّح داخل التطبيق أو من خلال
Safari. تفتح حزمة تطوير البرامج (SDK) الصفحات تلقائيًا باستخدام Safari. لتحديث حزمة تطوير البرامج (SDK) لاستخدام متصفح داخل التطبيق، عليك استخدام
IMAAdsRenderingSettings
:
Swift
func createAdsRenderingSettings() {
self.adsRenderingSettings = IMAAdsRenderingSettings();
self.adsRenderingSettings.linkOpenerDelegate = self;
self.adsRenderingSettings.linkOpenerPresentingController = self;
}
Objective-C
- (void)createAdsRenderingSettings {
self.adsRenderingSettings = [[IMAAdsRenderingSettings alloc] init];
self.adsRenderingSettings.linkOpenerDelegate = self;
self.adsRenderingSettings.linkOpenerPresentingController = self;
}
بعد ضبط مثيل
IMAAdsRenderingSettings
، يمكنك تمريره إلى
IMAAdsManager
طريقة الإعداد:
Swift
self.adsManager.initialize(withAdsRenderingSettings: adsRenderingSettings);
Objective-C
[self.adsManager initializeWithAdsRenderingSettings:adsRenderingSettings];
توفّر حزمة IMA SDK
IMALinkOpenerDelegate
للتواصل عندما يكون المستخدم على وشك
الاطّلاع على صفحة قابلة للنقر أو أنه أغلقها للتو. لاستخدام هذا المفوَّض، أضِفه إلى قائمة المفوَّضين
في العنوان، ونفِّذ طرقه. في العنوان:
Swift
class ViewController: UIViewController, IMALinkOpenerDelegate {
Objective-C
@interface ViewController : UIViewController<IMALinkOpenerDelegate>
وفي مرحلة التنفيذ:
Swift
func linkOpenerWillOpen(externalBrowser: NSObject) {
print("External browser will open.")
}
func linkOpenerWillOpen(inAppLink: NSObject) {
print("In-app browser will open.")
}
func linkOpenerDidOpen(inAppLink: NSObject) {
print("In-app browser did open.")
}
func linkOpenerWillClose(inAppLink: NSObject) {
print("In-app browser will close.")
}
func linkOpenerDidClose(inAppLink: NSObject) {
print("In-app browser did close.")
}
Objective-C
- (void)linkOpenerWillOpenExternalBrowser:(NSObject *)linkOpener {
NSLog(@"External browser will open.");
}
- (void)linkOpenerWillOpenInAppBrowser:(NSObject *)linkOpener {
NSLog(@"In-app browser will open.");
}
- (void)linkOpenerDidOpenInAppBrowser:(NSObject *)linkOpener {
NSLog(@"In-app browser did open.");
}
- (void)linkOpenerWillCloseInAppBrowser:(NSObject *)linkOpener {
NSLog(@"In-app browser will close.");
}
- (void)linkOpenerDidCloseInAppBrowser:(NSObject *)linkOpener {
NSLog(@"In-app browser did close.");
}
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis guide explains how to control ad clickthrough behavior within your iOS app using the IMA SDK.\u003c/p\u003e\n"],["\u003cp\u003eYou can configure the IMA SDK to open ad landing pages either in an in-app browser or in Safari.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eIMALinkOpenerDelegate\u003c/code\u003e provides events to track when clickthrough pages are opened and closed, allowing developers to respond to user interactions.\u003c/p\u003e\n"],["\u003cp\u003eTo utilize clickthrough control features, you must implement the \u003ccode\u003eIMAAdsRenderingSettings\u003c/code\u003e and the \u003ccode\u003eIMALinkOpenerDelegate\u003c/code\u003e within your iOS application.\u003c/p\u003e\n"]]],[],null,["# Control user click events\n\nThis guide explains how to implement more control over clickthrough in your IMA SDK\nimplementation. \"Clickthrough\" refers to the process of a user clicking on an ad and getting to\nthe landing page for that ad. The examples in this guide demonstrates how to configure where that\nlanding page opens and how to listen for events related to users visiting that page.\n\nPrerequisites\n-------------\n\n\nAn iOS application with the IMA SDK implemented.\n\nConfiguring clickthrough\n------------------------\n\n### Changing the link opener\n\nThe IMA SDK offers two options for opening ad landing pages---via an in-app browser, or via Safari. By default, the SDK opens pages using Safari. To update the SDK to use an in-app browser, you need to use `IMAAdsRenderingSettings`: \n\n### Swift\n\n```swift\nfunc createAdsRenderingSettings() {\n self.adsRenderingSettings = IMAAdsRenderingSettings();\n self.adsRenderingSettings.linkOpenerDelegate = self;\n self.adsRenderingSettings.linkOpenerPresentingController = self;\n}\n```\n\n### Objective-C\n\n```objective-c\n- (void)createAdsRenderingSettings {\n self.adsRenderingSettings = [[IMAAdsRenderingSettings alloc] init];\n self.adsRenderingSettings.linkOpenerDelegate = self;\n self.adsRenderingSettings.linkOpenerPresentingController = self;\n}\n```\nOnce you've configured the `IMAAdsRenderingSettings` instance, you can pass it to the `IMAAdsManager` initialization method: \n\n### Swift\n\n```swift\nself.adsManager.initialize(withAdsRenderingSettings: adsRenderingSettings);\n```\n\n### Objective-C\n\n```objective-c\n[self.adsManager initializeWithAdsRenderingSettings:adsRenderingSettings];\n```\n\n### Listening for clickthrough-related events\n\nThe IMA SDK provides the `IMALinkOpenerDelegate` to communicate when the user is about to see or has just closed a clickthrough page. To use this delegate, add it to your delegate list in the header, and implement its methods. In the header: \n\n### Swift\n\n```swift\nclass ViewController: UIViewController, IMALinkOpenerDelegate {\n```\n\n### Objective-C\n\n```objective-c\n@interface ViewController : UIViewController\u003cIMALinkOpenerDelegate\u003e\n```\nAnd in the implementation: \n\n### Swift\n\n```swift\nfunc linkOpenerWillOpen(externalBrowser: NSObject) {\n print(\"External browser will open.\")\n}\n\nfunc linkOpenerWillOpen(inAppLink: NSObject) {\n print(\"In-app browser will open.\")\n}\n\nfunc linkOpenerDidOpen(inAppLink: NSObject) {\n print(\"In-app browser did open.\")\n}\n\nfunc linkOpenerWillClose(inAppLink: NSObject) {\n print(\"In-app browser will close.\")\n}\n\nfunc linkOpenerDidClose(inAppLink: NSObject) {\n print(\"In-app browser did close.\")\n}\n```\n\n### Objective-C\n\n```objective-c\n- (void)linkOpenerWillOpenExternalBrowser:(NSObject *)linkOpener {\n NSLog(@\"External browser will open.\");\n}\n\n- (void)linkOpenerWillOpenInAppBrowser:(NSObject *)linkOpener {\n NSLog(@\"In-app browser will open.\");\n}\n\n- (void)linkOpenerDidOpenInAppBrowser:(NSObject *)linkOpener {\n NSLog(@\"In-app browser did open.\");\n}\n\n- (void)linkOpenerWillCloseInAppBrowser:(NSObject *)linkOpener {\n NSLog(@\"In-app browser will close.\");\n}\n\n- (void)linkOpenerDidCloseInAppBrowser:(NSObject *)linkOpener {\n NSLog(@\"In-app browser did close.\");\n}\n```"]]