# تخصيص iOS SDK ## التكامل * [الروابط العميقة](#deep-linking) * [الروابط الشاملة](#universal-links) * [تتبع عمليات الشراء داخل التطبيق](#in-app-purchase-tracking) * [إشعارات الدفع للمناطق الجغرافية (Geozones)](#geozones-push-notifications) * [إنشاء قائمة انتظار للوسائط الغنية (Rich Media)](#creating-a-rich-media-queue) * [التشغيل التلقائي لفيديو مُرسل في إشعار غني (Rich Notification) باستخدام اللمس القوي (force touch)](#autoplay-a-video-sent-in-a-rich-notification-with-force-touch) * [صوت إشعار دفع مخصص](#custom-push-sound) * [إشعارات الدفع المؤقتة لنظام iOS](#ios-provisional-push) ### الروابط العميقة في ملف **Info.plist** الخاص بك، أضف مصفوفة `URL types` مع `URL Identifier` و `URL Scheme`.\ في المثال أدناه، `URL Scheme` هو _com.pushwoosh_ و `URL Identifier` هو _promotion_.

في ملف App Delegate الخاص بك (عادةً AppDelegate.m لنظام iOS 12 والإصدارات الأقدم، أو SceneDelegate.m لنظام iOS 13 والإصدارات الأحدث)، أضف دالة التفويض openURL المناسبة كما هو موضح في المثال أدناه. يتحقق المثال من الصفحة الصحيحة، ويحلل قيمة "id" من عنوان URL، ويفتح PromoPageViewController استجابةً لذلك. ```AppDelegate.swift``` ```swift func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool { let components = URLComponents(url: url, resolvingAgainstBaseURL: false) let page = components?.host var promotionId: String? if page == "promotion" { return } let items = components?.queryItems ?? [] for item in items { if item.name == "id" { promotionId = item.value } } //show PromoPageViewController } ``` ```objective-c - (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation { NSURLComponents *components = [NSURLComponents componentsWithURL:url resolvingAgainstBaseURL:NO]; NSString *page = components.host; NSString *promotionId = nil; //return if this is not a promotion deep link if(![page isEqualToString:@"promotion"]) return NO; for(NSURLQueryItem *item in components.queryItems) { if([item.name isEqualToString:@"id"]) promotionId = item.value; } PromoPageViewController *vc = [[PromoPageViewController alloc] init]; vc.promotionId = promotionId [self presentViewController:vc animated:YES completion:nil]; } ``` ```SceneDelegate.swift``` ```swift func scene(_ scene: UIScene, openURLContexts URLContexts: Set) { guard let urlContext = URLContexts.first else { return } let components = URLComponents(url: urlContext.url, resolvingAgainstBaseURL: false) let page = components?.host var promotionId: String? guard page == "promotion" else { return } let items = components?.queryItems ?? [] for item in items { if item.name == "id" { promotionId = item.value } } //show PromoPageViewController } ``` ```objective-c - (void)scene:(UIWindowScene *)scene openURLContexts:(NSSet *)URLContexts { UIOpenURLContext *urlContext = URLContexts.anyObject; if (!urlContext) { return; } NSURLComponents *components = [NSURLComponents componentsWithURL:urlContext.URL resolvingAgainstBaseURL:NO]; NSString *page = components.host; NSString *promotionId = nil; if (![page isEqualToString:@"promotion"]) { return; } for (NSURLQueryItem *item in components.queryItems) { if ([item.name isEqualToString:@"id"]) { promotionId = item.value; } } //show PromoPageViewController } ``` ### الروابط الشاملة تسمح الروابط الشاملة (Universal Links) للمستخدمين بفتح تطبيقك مباشرة عند النقر على رابط لموقعك الإلكتروني. على عكس مخططات URL المخصصة، تستخدم الروابط الشاملة عناوين URL القياسية `https://` وتوفر تجربة مستخدم أكثر سلاسة. #### كيف تعمل عندما يحتوي إشعار الدفع على عنوان URL `https://` (في المعلمة "url" أو "l")، سيقوم SDK بما يلي: 1. إنشاء `NSUserActivity` مع عنوان URL 2. استدعاء معالج الروابط الشاملة في تطبيقك (`scene:continueUserActivity:` أو `application:continueUserActivity:restorationHandler:`) 3. إذا لم يتعامل تطبيقك مع عنوان URL، فسيتم فتحه في Safari كحل بديل #### الإعداد 1. **تكوين النطاقات المرتبطة في Xcode** أضف إمكانية النطاقات المرتبطة (Associated Domains) إلى تطبيقك وأضف نطاقك: ``` applinks:yourdomain.com ``` 2. **استضافة ملف Apple App Site Association** أنشئ ملف `apple-app-site-association` على خادم الويب الخاص بك في `https://yourdomain.com/.well-known/apple-app-site-association`: ```json { "applinks": { "apps": [], "details": [ { "appID": "TEAM_ID.com.your.bundleid", "paths": ["/path/*", "/promotion/*"] } ] } } ``` استبدل `TEAM_ID` بمعرف فريق مطوري Apple الخاص بك و `com.your.bundleid` بمعرف حزمة تطبيقك. 3. **تنفيذ معالج الروابط الشاملة** ```SceneDelegate.swift``` (iOS 13+) ```swift func scene(_ scene: UIScene, continue userActivity: NSUserActivity) { guard userActivity.activityType == NSUserActivityTypeBrowsingWeb, let url = userActivity.webpageURL else { return } // Handle the Universal Link URL let components = URLComponents(url: url, resolvingAgainstBaseURL: false) let path = components?.path if path?.starts(with: "/promotion") == true { // Navigate to promotion screen let promotionId = components?.queryItems?.first(where: { $0.name == "id" })?.value // Show promotion with promotionId } } ``` ```objective-c - (void)scene:(UIScene *)scene continueUserActivity:(NSUserActivity *)userActivity { if (![userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) { return; } NSURL *url = userActivity.webpageURL; if (!url) { return; } // Handle the Universal Link URL NSURLComponents *components = [NSURLComponents componentsWithURL:url resolvingAgainstBaseURL:NO]; NSString *path = components.path; if ([path hasPrefix:@"/promotion"]) { // Navigate to promotion screen NSString *promotionId = nil; for (NSURLQueryItem *item in components.queryItems) { if ([item.name isEqualToString:@"id"]) { promotionId = item.value; break; } } // Show promotion with promotionId } } ``` ```AppDelegate.swift``` (iOS 12 والإصدارات الأقدم، أو كحل بديل) ```swift func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool { guard userActivity.activityType == NSUserActivityTypeBrowsingWeb, let url = userActivity.webpageURL else { return false } // Handle the Universal Link URL let components = URLComponents(url: url, resolvingAgainstBaseURL: false) let path = components?.path if path?.starts(with: "/promotion") == true { // Navigate to promotion screen return true } return false } ``` ```objective-c - (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray> *restorableObjects))restorationHandler { if (![userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) { return NO; } NSURL *url = userActivity.webpageURL; if (!url) { return NO; } // Handle the Universal Link URL NSURLComponents *components = [NSURLComponents componentsWithURL:url resolvingAgainstBaseURL:NO]; NSString *path = components.path; if ([path hasPrefix:@"/promotion"]) { // Navigate to promotion screen return YES; } return NO; } ``` #### إرسال إشعار دفع برابط شامل عند إنشاء إشعار دفع، استخدم عنوان URL لموقعك الإلكتروني في حقل **الإجراء (Action)**: ``` https://yourdomain.com/promotion?id=123 ``` سيقوم SDK تلقائيًا بتوجيه عنوان URL هذا إلى معالج الروابط الشاملة الخاص بك، مما يسمح لك بتوجيه المستخدم إلى الشاشة المناسبة في تطبيقك. ### تتبع عمليات الشراء داخل التطبيق بشكل افتراضي، يتم تعطيل تتبع عمليات الشراء داخل التطبيق. إذا كنت ترغب في تتبع عمليات الشراء داخل التطبيق عند تكوين [Customer Journeys](/ar/product/customer-journey/pushwoosh-journey-overview)، فقم بتعيين علامة _Pushwoosh\_PURCHASE\_TRACKING\_ENABLED_ إلى _true_ في ملف _info.plist_. يمكنك العثور على قائمة بالعلامات المتاحة في [الجدول](/ar/developer/pushwoosh-sdk/ios-sdk/setting-up-pushwoosh-ios-sdk/advanced-integration-guide/#complete-list-of-infoplist-properties). إذا كنت ترغب في تتبع عمليات الشراء داخل التطبيق يدويًا، يمكنك استخدام الكود أدناه. في دالة التفويض `paymentQueue:updatedTransactions:`، استدعِ دالة `sendSKPaymentTransactions` من `PushManager` ```swift func paymentQueue(_ queue: SKPaymentQueue, updatedTransactions transactions: [SKPaymentTransaction]) { // In-Apps Tracking Pushwoosh code here Pushwoosh.sharedInstance().sendSKPaymentTransactions(transactions) // the rest of the code, consume transactions, etc } ``` ```objective-c - (void)paymentQueue:(SKPaymentQueue *)queue updatedTransactions:(NSArray *)transactions { [[PushNotificationManager pushManager] sendSKPaymentTransactions:transactions]; //the rest of the code, consume transactions, etc } ``` InAppTrackingViewController.swift

### إشعارات الدفع للمناطق الجغرافية (Geozones) يتم تغليف إشعارات الدفع للمناطق الجغرافية (Geozones) في إطار عمل منفصل **PushwooshGeozones**. 1. أضف PushwooshGeozones.framework إلى مشروعك لإضافة PushwooshGeozones.framework إلى مشروعك باستخدام مدير التبعيات، ضع الأسطر التالية في `podfile` أو `cartfile` الخاص بك: ```plaintext pod 'PushwooshXCFramework/Geozones' ``` ```plaintext github "Pushwoosh/pushwoosh-ios-sdk" ``` إذا كنت ترغب في استخدام **PushwooshGeozones.xcframework**، أدخل عنوان URL الحزمة التالي: [PushwooshGeozones-XCFramework](https://github.com/Pushwoosh/PushwooshGeozones-XCFramework) بدلاً من ذلك، يمكنك ببساطة سحب وإفلات إطار العمل في **Link Binaries With Libraries** في **Build Phases** الخاصة بمشروعك. 2. أضف المفاتيح التالية إلى Info.plist الخاص بك: - **NSLocationWhenInUseUsageDescription** – *(مطلوب)* لكي يتتبع التطبيق المناطق الجغرافية (Geozones) فقط أثناء تشغيله في المقدمة. - **NSLocationAlwaysAndWhenInUseUsageDescription** – *(مطلوب)* لكي يتتبع التطبيق المناطق الجغرافية (Geozones) **في كل من المقدمة والخلفية** ولإظهار نافذة منبثقة لطلب الإذن. - **NSLocationAlwaysUsageDescription** – *(اختياري)* لكي يتتبع التطبيق المناطق الجغرافية (Geozones) **في جميع الأوقات**؛ يجب استخدامه إذا كان تطبيقك يستهدف iOS 10 والإصدارات الأقدم. ```xml NSLocationAlwaysAndWhenInUseUsageDescription for app to track Geozones in both conditions and to show a permission request dialog NSLocationWhenInUseUsageDescription for app to track Geozones only while running in the foreground ``` ![]() 3. استيراد إطار العمل ```swift import PushwooshGeozones ``` ```objc #import ``` 4. بدء تتبع المناطق الجغرافية (Geozones) ```swift PWGeozonesManager.shared()?.startLocationTracking() ``` [مرجع GitHub](https://github.com/Pushwoosh/pushwoosh-quickstart-ios/blob/main/customizing/customizing/Geozones%20Push%20Notification/GeozonesViewController.swift) ```objc [[PWGeozonesManager sharedManager] startLocationTracking]; ``` [مرجع GitHub](https://github.com/Pushwoosh/pushwoosh-quickstart-ios/blob/main/customizing/customizingObjC/customizingObjC/Geozones%20Push%20Notification/PWGeozonesViewController.m) ##### مثال ```swift override func viewDidLoad() { super.viewDidLoad() // Start Geozones tracking when needed PWGeozonesManager.shared().startLocationTracking() } ``` ```objc - (void)viewDidLoad { [super viewDidLoad]; // Do any additional setup after loading the view. // Start Geozones tracking when needed [[PWGeozonesManager sharedManager] startLocationTracking]; } ``` ### إنشاء قائمة انتظار للوسائط الغنية (Rich Media) في حال وجود عدة صفحات وسائط غنية (Rich Media) لعرضها في وقت واحد (على سبيل المثال، تحدث أحداث التشغيل لاثنين أو أكثر من الرسائل داخل التطبيق في لحظة واحدة، أو يتم عرض صفحة وسائط غنية بالفعل في اللحظة التي يحدث فيها حدث تشغيل مختلف)، يمكنك إعداد قائمة انتظار لعرض صفحات الوسائط الغنية. لإنشاء قائمة انتظار، اتبع الخطوات الموضحة أدناه. 1. أنشئ فئة تنفذ PWRichMediaPresentingDelegate: ```objective-c @interface ChainedRichMediaPresentingDelegate () @property (nonatomic) NSMutableArray *queue; @property (nonatomic) BOOL inAppIsPresenting; @end @implementation ChainedRichMediaPresentingDelegate - (instancetype)init { self = [super init]; if (self) { _queue = [NSMutableArray new]; } return self; } - (BOOL)richMediaManager:(PWRichMediaManager *)richMediaManager shouldPresentRichMedia:(PWRichMedia *)richMedia { [_queue addObject:richMedia]; return !_inAppIsPresenting; } - (void)richMediaManager:(PWRichMediaManager *)richMediaManager didPresentRichMedia:(PWRichMedia *)richMedia { _inAppIsPresenting = YES; } - (void)richMediaManager:(PWRichMediaManager *)richMediaManager didCloseRichMedia:(PWRichMedia *)richMedia { _inAppIsPresenting = NO; [_queue removeObject:richMedia]; if (_queue.count) { [[PWRichMediaManager sharedManager] presentRichMedia:_queue.firstObject]; } } - (void)richMediaManager:(PWRichMediaManager *)richMediaManager presentingDidFailForRichMedia:(PWRichMedia *)richMedia withError:(NSError *)error { [self richMediaManager:richMediaManager didCloseRichMedia:richMedia]; } @end ``` 2\. قم بتعيين المفوّض: ```objective-c [PWRichMediaManager sharedManager].delegate = [ChainedRichMediaPresentingDelegate new]; ``` ### التشغيل التلقائي لفيديو مُرسل في إشعار غني (Rich Notification) باستخدام اللمس القوي (force touch) لجعل الفيديو المرسل كمرفق [إشعار غني (Rich Notification)](/ar/developer/pushwoosh-sdk/ios-sdk/ios-rich-notifications-integration/) يعمل تلقائيًا عند توسيع الإشعار دون أي تفاعل من المستخدم، اتبع الخطوات أدناه: 1. أضف ملحق محتوى الإشعارات (Notification Content Extension) إلى مشروعك: * في Xcode، حدد File > New > Target. * اختر Notification Content Extension. * قم بتعيين اسم له وأكمل الإعداد. ملحق محتوى الإشعارات - إشعار دفع غني لنظام iOS

ملحق محتوى الإشعارات - إشعار دفع غني لنظام iOS

إذا طُلب منك رسالة "تفعيل المخطط"، اختر إلغاء. تفعيل مخطط محتوى الإشعارات

2. اضبط الخصائص والأساليب في ملحق المحتوى على النحو التالي: ``` import UIKit import UserNotifications import UserNotificationsUI import AVKit class NotificationViewController: UIViewController, UNNotificationContentExtension { var playerController: AVPlayerViewController! @IBOutlet weak var playerBackgroundView: UIView! override func viewDidLoad() { super.viewDidLoad() // Do any required interface initialization here. } func didReceive(_ notification: UNNotification) { let attachment = notification.request.content.attachments.first playerController = AVPlayerViewController() // Set height programmatically // preferredContentSize.height = 250 if let url = attachment?.url { setupVideoPlayer(url: url) } else { print("No valid URL...") } } private func setupVideoPlayer(url: URL) { guard let playerController = self.playerController else { return } let player = AVPlayer(url: url) playerController.player = player playerController.view.frame = self.playerBackgroundView.bounds playerBackgroundView.addSubview(playerController.view) addChild(playerController) playerController.didMove(toParent: self) player.play() } ``` 3. أدرج UIView في MainInterface.storyboard:

4. اربط playerBackgroundView IBOutlet بـ UIView الذي أضفته للتو:

5. قم بتحديث ملف info.plist بالإدخال التالي: ``` UNNotificationExtensionUserInteractionEnabled = true ```

لإرفاق فيديو بإشعارك، أدخل عنوان URL للفيديو في حقل مرفق الوسائط (Media Attachment) في لوحة التحكم (Control Panel):

عنوان URL للفيديو في حقل مرفق الوسائط في لوحة تحكم Pushwoosh

عند إرسال إشعار عبر طلب API [/createMessage](/ar/developer/api-reference/messages-api#createmessage)، قم بتضمين عنوان URL في المعلمة "ios\_attachment" وتأكد من تعيين علامة "mutable-content" على \`1\`.