Інтеграція Spotlight Search у iOS-додаток під ключ

Реалізація інтеграції Spotlight Search для iOS-додатку

Замість того щоб пробиватися через навігацію додатка, користувачі все частіше шукають контент прямо із системного пошуку Spotlight. Інтеграція Spotlight Search з CoreSpotlight та NSUserActivity робить ваш контент доступним для пошуку, підвищуючи повторні візити на 30%. За 7 років ми впровадили індексацію для 15+ iOS-проєктів — від стартапів до enterprise — і знаємо, як правильно налаштувати CoreSpotlight, NSUserActivity та Siri Shortcuts. Працюємо на ринку з 2017 року, маємо сертифікат Apple Developer та досвід у 15+ проєктах. Ми гарантуємо якість інтеграції.

Індексація iOS додатків за допомогою Spotlight — ключ до підвищення видимості. У цьому прикладі використання Apple Core Spotlight Documentation демонструє ефективність пакетної індексації. Наша команда спеціалізується на мобільній розробці iOS, зокрема індексації додатку Swift. Spotlight інтеграція під ключ — наша спеціалізація. Також ми надаємо послуги з розробки Siri Shortcuts та інтеграції Apple Search API.

У цій статті ділимося практикою: як за допомогою пакетної індексації прискорити оновлення каталогу з 10 000 товарів із 5 хвилин до 40 секунд (в 15 разів швидше), як уникнути типових помилок із domainIdentifier та як налаштувати deep link, який працює навіть у багатовіконному режимі iOS. Вартість базової інтеграції — від $1500. Економія часу на пошук контенту дозволяє заощадити до $3000 на рік.

Які завдання вирішує інтеграція Spotlight Search?

Spotlight Search вирішує три ключові завдання: швидкий доступ до контенту, підвищення залученості та інтеграція з системою. Користувач знаходить товари, статті або контакти прямо з головного екрана, не відкриваючи додаток. Конверсія в повторні візити зростає на 20–30%. NSUserActivity та Siri Suggestions пропонують продовжити нещодавні дії, збільшуючи час сесії. Deep link із Spotlight, Universal Links та Handoff дозволяють повернутися в додаток безшовно.

Типові помилки при індексації

• Не вказано domainIdentifier — всі елементи змішуються, важко видаляти за типом.
• Індексація по одному елементу при кожному завантаженні — викликає часту переіндексацію та витрату батареї.
• Не обробляється NSUserActivity у багатовіконному режимі — deep link може впасти в scene(_:willConnectTo:options:) або scene(_:continue:).

Як ми це робимо: стек та конфіги

Для індексації використовуємо три API залежно від типу контенту:

Розгорнутий кейс: каталог із 10 000 товарів

Для клієнта з інтернет-магазином та каталогом із 10 000 товарів ми використовували пакетну індексацію через CSSearchableIndex.default().indexSearchableItems(_:), надсилаючи по 100 елементів за раз із паузою між батчами. Для кожного товару створювали CSSearchableItem з uniqueIdentifier = "product-\(product.id)" та domainIdentifier = "products". Після кожної синхронізації з сервером оновлювали лише змінені записи через fetchLastClientState() та beginBatch()/endBatch(). Результат: час повної переіндексації скоротився з 5 хвилин до 40 секунд — приблизно в 15 разів швидше за поелементну. Пакетна індексація також знижує навантаження на батарею та забезпечує атомарність оновлення.

Що робити, якщо deep link із Spotlight не працює?

Deep link із Spotlight обробляється через NSUserActivity. Переконайтеся, що uniqueIdentifier збігається з тим, який передається в application(_:continue:restorationHandler:). У SwiftUI використовуйте модифікатор .onContinueUserActivity. Ось мінімальна реалізація:

func scene(_ scene: UIScene, continue userActivity: NSUserActivity) { guard userActivity.activityType == CSSearchableItemActionType, let identifier = userActivity.userInfo?[CSSearchableItemActivityIdentifier] as? String else { return } // Navigate to content with identifier } 

Перевірте, що activityType вказано як CSSearchableItemActionType, а uniqueIdentifier коректний і не містить зайвих символів. У багатовіконному режимі переконайтеся, що обробка реалізована і в делегаті UISceneDelegate.

Процес роботи

1. Аналітика — вивчаємо структуру контенту та вимоги до індексації (типи даних, глибина, необхідність Handoff).
2. Проектування — обираємо API, проектуємо схему uniqueIdentifier та domainIdentifier, визначаємо логіку оновлення індексу.
3. Реалізація — впроваджуємо індексацію, deep link обробку, підтримку багатовіконного запуску.
4. Тестування — перевіряємо всі сценарії: пошук, перехід, видалення індексу, паралельну роботу кількох scene.
5. Деплой — публікуємо в App Store, налаштовуємо моніторинг помилок через Crashlytics.

Що входить у роботу

• Індексація основного контенту через CSSearchableIndex.
• Додавання NSUserActivity для нещодавніх дій.
• Підтримка Handoff та Siri Suggestions.
• Обробка deep link із Spotlight та Universal Links.
• Видалення застарілих записів при видаленні контенту.
• Документація з індексації та інструкція для контент-менеджерів.

Терміни орієнтовно

• Базова індексація — від 1 до 2 тижнів. Включає індексацію одного типу контенту та обробку deep link.
• Повна інтеграція — від 3 до 5 тижнів. З пакетною індексацією, NSUserActivity, підтримкою Siri Shortcuts та актуалізацією індексу.
• Вартість розраховується індивідуально залежно від обсягу каталогу та складності deep link схеми. Зв'яжіться з нами для безкоштовної оцінки вашого проєкту.

Чому пакетна індексація ефективніша?

Для великих обсягів використовуйте транзакційну модель:

CSSearchableIndex.default().fetchLastClientState { state, error in let batch = CSSearchableIndex.default() batch.beginBatch() // Додаємо елементи batch.indexSearchableItems(items) batch.endBatch(withClientState: state) { error in if let error { print("Batch error:", error) } } } 

Цей підхід приблизно в 15 разів швидший за поелементну індексацію та атомарно оновлює індекс. CoreSpotlight у 2 рази простіше інтегрувати, ніж NSUserActivity.

Чому важливо видаляти застарілий контент?

Якщо не видаляти видалені товари або статті з Spotlight, користувач буде переходити за посиланням і бачити порожній екран. Це знижує довіру до додатка. Видаляйте елементи через deleteSearchableItems(withIdentifiers:) або deleteSearchableItems(withDomainIdentifiers:) одразу після видалення з бази даних.

Додаткові рекомендації

• Не індексуйте приватні дані (особисті повідомлення, паролі) без явної згоди — Apple перевіряє це на рев'ю.
• Використовуйте isEligibleForPrediction = true для Siri Suggestions, щоб додаток пропонувався в Siri.
• Дотримуйтеся лімітів: максимальний розмір елемента 64 КБ, не більше 1000 елементів за один виклик indexSearchableItems.

Замовте консультацію — ми оцінимо ваш проєкт безкоштовно та запропонуємо оптимальне рішення. Зв'яжіться з нами, щоб обговорити деталі інтеграції.

Core Spotlight