Універсальні посилання для iOS

Огляд

Відділення дозволяє легко включати універсальні посилання, одночасно значно покращуючи їх, пропонуючи повну атрибуцію, підтримуючи крайні випадки, коли Universal Links виходить з ладу (загальний) і дозволяє глибоко пов'язувати, коли користувач не встановлює вашу програму.

Налаштування

Увімкніть універсальні посилання на інформаційній панелі відділення

1. Перейдіть до Параметри посилання на панелі інструментів відділення.
2. Встановіть прапорець Увімкнути універсальні посилання з переадресацій iOS.
3. Введіть ідентифікатор пакета програми.
4. Введіть префікс програми Apple App (знайдений, натиснувши на його додаток цієї сторінки на порталі розробників Apple).
5. Прокрутіть вниз і натисніть кнопку Зберегти.

Увімкніть пов'язані домени в Xcode

1. Перейдіть на вкладку Можливості файлу проекту.
2. Прокрутіть вниз і ввімкніть асоційовані домени.

Якщо після цього кроку ви бачите помилку

Будь ласка ...

• Права команда обрана для вашого проекту Xcode.
• Ідентифікатор Bundle вашого проекту Xcode відповідає тому, який використовується для реєстрації ідентифікатора програми з Apple.

Додайте домен посилання "Відділення"

1. Перейдіть до Параметри посилання сторінки на інформаційній панелі.
2. Прокрутіть вниз до області Домен посилання.
3. Скопіюйте своє доменне ім'я.
4. У розділі Домени натисніть піктограму + та додайте такі записи: (переконайтеся, що xxxx відповідає префіксу субдомену, який ви призначали або вибрали для себе)
   • applinks: xxxx.app.link
   • applinks: xxxx-alternate.app.link
   • applinks: xxxx.test-app.link
   • applinks: xxxx-alternate.test-app.link

Підтримка застарілих посилань

Якщо в полі Ім'я домену за промовчанням відображається домен назви bnc.lt, замість цього слід використовувати наступний запис: applinks: bnc.lt

Програми / браузери, які підтримують універсальні посилання

На жаль, універсальні посилання ще не працюють всюди. Ми склали статус підтримки універсальних посилань деяких з найбільш популярних додатків.

Програми, які завжди працюють

Якщо ви відкриєте універсальну посилання в одному з цих програм, він повинен працювати правильно весь час.

App / Browser Статус повідомлень працює Пошта працює WhatsApp працює Gmail працює Вхідні роботи

Програми, обмежені Apple

Компанія Apple має обмежені універсальні посилання в певних ситуаціях, мабуть, щоб уникнути заплутаних користувачів:

• Універсальні посилання не працюватимуть, якщо вставити посилання в поле URL веб-переглядача.
• Універсальні посилання працюють з <a href="..."> кліком, який керується користувачем, між доменами . Приклад: якщо на google.com є універсальна посилання, яка вказує на bnc.lt, вона відкриє програму.
• Універсальні посилання не будуть працювати з <a href="..."> елементом, який керується користувачем, на одному і тому ж домені . Приклад: якщо на google.com є універсальна посилання, яка вказує на іншу універсальну посилання на google.com, вона не відкриє програму.
• Універсальні посилання не можуть бути запущені через Javascript (у window.onload або через виклик .click () на елементі <a>), якщо це не частина дій користувача.

App / Browser Status Safari працює умовно, Chrome працює умовно

Програми, які іноді працюють

Програми з вбудованими веб-переглядами (Google, Twitter, Facebook, Facebook Messenger, WeChat тощо) працюють із універсальними посиланнями лише тоді, коли веб-перегляд вже відкрито. Іншими словами, універсальні посилання не працюють у додатку з переглядів каналів або основних програм.

Щоб обійти це обмеження, ваші посилання повинні мати deepviews або щось подібне ввімкнено, з посиланням / кнопкою "заклик до дії", що має універсальне посилання за ним. Таким чином, натискання посилання з каналу програми відкриє веб-перегляд, що містить вашу сторінку глибокого перегляду, після чого користувач може натиснути посилання / кнопку, щоб запустити програму. Всі обмеження Apple (у розділі вище) досі застосовуються до сторінки deepview.

App / Browser Status Google працює умовно Facebook працює умовно Facebook Messenger працює умовно WeChat працює умовно Twitter працює умовно LinkedIn працює умовно Будь-яке додаток, що використовує SFSafariViewController працює умовно

Програми з особливими випадками

App / Browser Status Slack працює, якщо налаштовано відкривати посилання в Safari. В іншому випадку, працює умовно, як у наведеному вище розділі.

Програми, які не працюють

App / Статус браузера \ t

Загальні проблеми, які призводять до помилок універсальних посилань

Автоматизована перевірка для вашого проекту Xcode

Ви можете перевірити правильність налаштування вашого проекту Xcode за допомогою нашого Універсальний посилання .

Ви тестуєте, вводячи вручну в Safari?

Універсальні посилання не працюють належним чином при введенні в Safari. Використовуйте Notes або iMessage для тестування.

Ви упаковуєте посилання Branch іншим посиланням і перенаправляєте?

У більшості випадків універсальні посилання не відкриватимуть додаток, коли вони "загорнуті" посиланнями відстеження кліків. Універсальні посилання, включаючи посилання на відділення, повинні бути окремими. Якщо ви хочете, щоб універсальні посилання працювали у всіх ситуаціях, не використовуйте інші посилання, які перенаправляють на ваші посилання відділення.

Ваш ідентифікатор команди та ідентифікатор пакета відповідають таким на вашій інформаційній панелі?

Їх можна знайти на панелі інструментів у розділі "Налаштування> Параметри зв'язку" в розділі iOS поруч із пунктом "Увімкнути універсальні посилання". Вони повинні відповідати ідентифікатору команди та ідентифікатору пакета. Командний ідентифікатор можна знайти тут https://developer.apple.com/membercenter/index.action#accountSummary . Ваш ідентифікатор пакета знаходиться в Xcode, на вкладці Загальні для правильної мети збирання. Якщо префікс Apple App відрізняється від вашого ідентифікатора команди, слід використовувати префікс програми. Префікс програми можна знайти з ідентифікаторів App на порталі розробників Apple.

Ви видалили програму та перевстановили її?

iOS не повторно очищає файл-асоціацію apple-app-файлу, якщо ви не видалите та переінсталюєте програму. (Єдиним винятком є ​​оновлення App Store. IOS повторно здійснює відновлення кожного оновлення. Це означає, що коли користувачі оновлюються до версії вашої програми за допомогою права applinks, Universal Links почне працювати на них.)

На жаль, універсальні посилання можуть бути відключені.

Якщо ви успішно перенесетеся в програму за допомогою універсального посилання, ви побачите "app.link" (або ваш домен) і кнопку "Вперед" у верхньому правому куті рядка стану. Якщо натиснути цю кнопку, компанія Apple більше не активуватиме універсальні посилання у майбутньому. Щоб знову ввімкнути універсальні посилання, довго натискайте на посилання в Повідомлення (iOS 9 лише через iMessage revamp в 10) або Notes (iOS 10/9) і виберіть "Відкрити в <>".

Використання власного домену?

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

У вашому журналі на рівні ОС з'явиться таке повідомлення про помилку, якщо домен не налаштовано належним чином:

21 вересня 14: 27: 01 Derricks - iPhone swcd [2044] <Примітка>: 2015 - 09 - 21 02: 27: 01.878907 PM [SWC] ### Відхилення URL-адреси "https://examplecustomdomain.com/apple-app- site-association 'для методу auth' NSURLAuthenticationMethodServerTrust ': - 6754 / 0xFFFFE59E kAuthenticationErr

Ці журнали можна знайти для фізичних пристроїв, підключених до Xcode, перейшовши в меню "Вікно"> "Пристрої">, вибравши пристрій, а потім натиснувши стрілку "вгору" в лівому нижньому куті головного вікна.

Якщо ви користуєтеся користувальницьким субдоменом, ваш CNAME має вказувати на custom.bnc.lt у розділі Параметри посилання у приладовій панелі відділення.

Поверніть YES для продовженняДоступність

Коли користувачі вводять вашу програму за допомогою універсального посилання, перевіряємо, чи містить URL-адреса посилання bnc.lt. Якщо так, handledByBranch поверне YES. Якщо ні, handledByBranch поверне NO. Це дозволяє нам явно підтверджувати вхідне посилання з відділення без виклику сервера.

Для більшості реалізацій це ніколи не буде проблемою, оскільки ваші глибокі посилання будуть маршрутизовані правильно в будь-який спосіб. Однак, якщо ви використовуєте власний домен посилання і ви покладаєтеся на handledByBranch, щоб повернути YES для кожної вхідної породженої універсальної посилання, ви можете повідомити SDK відділення, виконавши наступні дії:

1. У файлі Info.plist створіть новий ключ під назвою branch_universal_link_domains.
2. Додайте власний домен (и) як рядок.
3. Збережіть файл.

Кілька власних доменів

Якщо ви маєте незвичайну ситуацію з кількома користувацькими доменами, ви також можете налаштувати branch_universal_link_domains як масив рядків.