«پیوندهای برنامه Android» قابلیت پیوند عمیق ویژه‌ای در Android نسخه ۶ و بالاتر است که به نشانی‌های وب تأییدشده وب‌سایت شما اجازه می‌دهد محتوای مربوطه را فوراً در برنامه Android شما باز کنند، بدون اینکه کاربر نیاز داشته باشد برنامه شما را از کادر گفتگوی ابهام‌زدایی انتخاب کند. برای ممکن کردن این امر، Android از بیانیه‌های پیوندهای دارایی دیجیتال میزبانی‌شده در وب‌سایت شما استفاده می‌کند تا ارتباطی امن و تأییدشده بین وب‌سایت و برنامه شما برقرار کند. پس‌از تأیید ارتباط، Android می‌تواند به‌طور خودکار پیوندهای عمیق به وب‌سایت شما را مستقیماً به برنامه‌تان هدایت کند تا در آنجا مدیریت شوند.
از Android 15 به بعد، «پیوندهای برنامه» با معرفی پیوندهای پویای برنامه حتی قدرتمندتر شده‌اند. با قابلیت‌های پویای جدید، می‌توانید رفتارهای پیوند عمیق برنامه‌تان را در لحظه، با کنترل بیشتر، و بدون نیاز به انتشار نسخه جدیدی از برنامه‌تان اصلاح کنید.
چرا باید از «پیوندهای برنامه» استفاده کنید:
- تجربه کاربری یکپارچه – کاربران را مستقیماً از نتایج جستجو، وب‌سایت‌ها، پیام‌رسانی، و برنامه‌های دیگر به محتوای خاصی در برنامه‌تان هدایت کنید. ازآنجایی‌که «پیوندهای برنامه» از یک نشانی وب واحد برای محتوای یکسان در وب‌سایت و برنامه شما استفاده می‌کند، کاربرانی که برنامه را نصب نکرده‌اند به‌جای برنامه به وب‌سایت شما هدایت می‌شوند — بدون خطای ۴۰۴ یا هر خطای دیگری.
- امنیت بهبودیافته – «پیوندهای برنامه» به درستی‌سنجی مالکیت دامنه نیاز دارد، که از رهگیری پیوندهای شما توسط برنامه‌های دیگر جلوگیری می‌کند.
- پیکربندی پویا (Android 15 و بالاتر) – رفتار پیوند عمیق برنامه‌تان را در لحظه به‌روز کنید تا انعطاف‌پذیری بیشتر و به‌روزرسانی‌های سریع‌تری برای مواردی مانند نشانی‌های وب سفارشی، پویش‌های فصلی، یا پیوندهای مختص کاربر داشته باشید.
- تعامل – می‌توانید ازطریق پیوندها در نتایج جستجو، آگهی‌ها، صفحه‌های وب، پیام‌رسانی، و غیره با کاربران تعامل برقرار کنید.
نحوه پشتیبانی از «پیوندهای برنامه»
- پیوندهای عمیق به محتوای خاصی در برنامه‌تان ایجاد کنید: در مانیفست برنامه‌تان، فیلترهای قصد برای URIهای وب‌سایتتان ایجاد کنید و برنامه‌تان را پیکربندی کنید تا از داده‌های قصدها برای ارسال کاربران به محتوای مناسب در برنامه‌تان استفاده کند.
- افزودن درستی‌سنجی برای پیوندهای عمیق: برنامه‌تان را برای درخواست درستی‌سنجی پیوندهای برنامه پیکربندی کنید. سپس، فایل JSON «پیوندهای دارایی دیجیتال» را در وب‌سایت‌هایتان منتشر کنید تا مالکیت را به‌تأیید برسانید.
یا می‌توانید از دستیار پیوندهای برنامه Android در Android Studio استفاده کنید تا شما را در هریک از مراحل لازم برای ایجاد و درستی‌سنجی کردن «پیوندهای برنامه Android» راهنمایی کند. برای اطلاعات بیشتر، به ابزارهای توسعه‌دهنده «پیوندهای برنامه» مراجعه کنید.
دردسترس بودن «پیوندهای برنامه»
- پیوندهای پویای برنامه – Android نسخه ۱۵ (سطح API ۳۵) یا بالاتر، در دستگاه‌هایی که سرویس‌های Google در آن‌ها نصب شده است.
- پیوندهای برنامه – Android نسخه ۶ (سطح API ۲۳) و بالاتر، در دستگاه‌هایی که سرویس‌های Google در آن‌ها نصب شده است.
- پیوند عمیق معمولی (مدیریت‌شده توسط کاربر) – همه نسخه‌های Android، در همه دستگاه‌ها.
نحوه عملکرد «پیوندهای برنامه»
«پیوندهای برنامه» روشی خاص برای پیوند عمیق است که به شما کنترل کامل بر مدیریت پیوندها به وب‌سایت خودتان را می‌دهد. این پیوند براساس همان سیستم مبتنی بر هدف ساخته شده است که انواع دیگر پیوند عمیق از آن استفاده می‌کنند، اما مرحله درستی‌سنجی را برای پیوندهایتان بااستفاده از فایل «پیوندهای دارایی دیجیتال» در وب‌سایتتان اضافه می‌کند.
«پیوندهای برنامه» بااستفاده از داده‌های برنامه و فایل assetlinks.json خاصی که در وب‌سایت یا دامنه‌تان میزبانی می‌کنید، ارتباطی امن و مطمئن بین برنامه و وب‌سایتتان ایجاد می‌کند. فایل assetlinks.json عبارت‌های «پیوند دارایی دیجیتال» را برای به‌تأیید رساندن ارتباط برنامه اعلام می‌کند.
جریان مفهومی در اینجا آمده است:
- مانیفست برنامه شما نشانی‌های وب را در فیلتر هدف با
android:autoVerify="true» اعلام می‌کند و به میزبان وب‌سایت شما اشاره می‌کند. - وقتی برنامه نصب می‌شود، سیستم Android فایل
assetlinks.jsonرا از مکان شناخته‌شده‌ای در سرور وب شما واکشی می‌کند. - سیستم درستی‌سنجی می‌کند که فایل
assetlinks.jsonمعتبر است وsha256_cert_fingerprintsبا گواهی امضای برنامه‌تان مطابقت دارد. - وقتی کاربر روی پیوند منطبقی کلیک می‌کند، سیستم او را مستقیماً به برنامه شما هدایت می‌کند، بدون اینکه کادر گفتگوی ابهام‌زدایی نشان دهد.
چون «پیوندهای برنامه» از نشانی‌های وب HTTP و ارتباط با وب‌سایت استفاده می‌کنند، کاربرانی که برنامه شما را نصب نکرده‌اند مستقیماً به محتوای سایت شما هدایت می‌شوند. به‌این‌ترتیب، «پیوندهای برنامه» تجربه‌ای مطمئن و یکپارچه برای کاربرانی که روی پیوندهای عمیق دارایی‌های وب شما ضربه می‌زنند ارائه می‌دهد.
پیوندهای پویای برنامه
با شروع Android 15، «پیوندهای برنامه» با معرفی «پیوندهای برنامه پویا» حتی قدرتمندتر شده‌اند. با «پیوندهای پویای برنامه»، این گزینه را دارید که قوانین پیوند عمیق را در سمت سرور، در فایل assetlinks.json، بدون نیاز به انتشار نسخه جدیدی از برنامه‌تان به‌روز کنید. «پیوندهای پویای برنامه» از فیلدهای «پیوندهای دارایی دیجیتال» برای پالایش قوانین پیوند عمیق پشتیبانی می‌کند. دستگاه‌های Android که
سرویس‌های Google در آن‌ها نصب شده است، فایل شما را به‌صورت دوره‌ای بازآوری می‌کنند و قوانین جدید
پیوند عمیق شما را به‌صورت پویا اعمال می‌کنند. به‌روزرسانی برنامه لازم نیست.
قبلاً این فایل اساساً برای درستی‌سنجی پایه استفاده می‌شد. اکنون، این ابزار پیکربندی قدرتمندی است که به شما امکان می‌دهد مسیرها، پارامترهای پُرسمان، تکه‌ها، و موارد استثنا را مشخص کنید و راه‌حل پیوند عمیق پویا و قدرتمندی ارائه می‌دهد:
- پشتیبانی از استثنائات: می‌توانید مسیرها یا بخش‌های خاصی از نشانی وب را مشخص کنید که نباید برنامه‌تان را باز کنند، حتی اگر با پیکربندی «پیوند برنامه» شما مطابقت داشته باشند.
- پشتیبانی از پارامترهای پُرسمان: با عملکرد جدید پارامترهای پُرسمان می‌توانید پارامترهای خاصی را تعریف کنید که اگر در نشانی وب وجود داشته باشند، از باز شدن برنامه‌تان جلوگیری می‌کنند. این امر امکانات هیجان‌انگیزی را برای مستثنی‌سازی‌های پویا، A/B Testing، و فعال کردن تدریجی پیونددهی برنامه برای بخش‌های خاصی از کاربران فراهم می‌کند.
- به‌روزرسانی‌های پویا: با مشخص کردن مسیرهای نشانی وب که برنامه‌تان مستقیماً در فایل
assetlinks.jsonمیزبانی‌شده در سرورتان مدیریت می‌کند، پیکربندی «پیوندهای برنامه» را بدون نیاز به به‌روزرسانی برنامه به‌روز کنید.
«پیوندهای پویای برنامه» همچنین به شما امکان می‌دهد کنترل دقیقی بر نشانی‌های وبی که می‌خواهید برنامه‌تان را باز کنند داشته باشید، ازجمله مطابقت دادن مسیرهای نشانی وب، قطعه‌ها، و پارامترهای پُرسمان. همچنین می‌توانید هرکدام از موارد منطبق را مستثنی کنید تا اجازه نداشته باشند برنامه شما را باز کنند. برای اطلاعات بیشتر، پیکربندی قوانین پویا را ببینید.
در اینجا جریان مفهومی برای «پیوندهای پویای برنامه» آورده شده است:
- مانیفست برنامه شما نشانی‌های وب را در فیلتر قصد با
android:autoVerify="true» اعلام می‌کند و به میزبان وب‌سایت شما اشاره می‌کند. - وقتی برنامه نصب می‌شود، سیستم Android فایل
assetlinks.jsonرا از مکان شناخته‌شده‌ای در سرور وب شما واکشی می‌کند. - سیستم درستی‌سنجی می‌کند که فایل معتبر است و
sha256_cert_fingerprintsبا گواهی امضای برنامه‌تان مطابقت دارد. - سیستم هر قانون پیونددهی عمیقی را که در فیلد
dynamic_app_link_componentsدر بیانیه «پیوندهای دارایی دیجیتال» تعریف کرده‌اید تجزیه می‌کند و آن‌ها را با قوانین اعلام‌شده در مانیفست ادغام می‌کند.- وقتی کاربر روی پیوند منطبقی کلیک می‌کند، سیستم او را مستقیماً به برنامه شما هدایت می‌کند بدون اینکه کادر گفتگوی ابهام‌زدایی نشان دهد.
- سیستم به‌طور دوره‌ای فایل
assetlinks.jsonرا مجدداً واکشی می‌کند تا جدیدترین قوانین را دریافت کند و به شما امکان دهد پیوندهایتان را بدون به‌روزرسانی برنامه به‌روز کنید. واکشی مجدد دوره‌ای در دستگاه‌های دارای Android 15 (سطح API ۳۵) یا بالاتر که سرویس‌های Google در آن‌ها نصب شده است پشتیبانی می‌شود.
نمونه موارد استفاده
- پویش‌های بازاریابی فصلی: یک برنامه خرده‌فروشی می‌تواند قانونی برای
«/promo/summer-sale» به فایل
assetlinks.jsonاضافه کند تا کاربران را به صفحه فروش خاصی هدایت کند. پس‌از پایان حراج، می‌توان قانون را بدون نیاز به به‌روزرسانی برنامه توسط کاربران برداشت. - نشانی‌های وب Vanity برای شرکا: اگر با یک تأثیرگذار شراکت دارید، می‌توانید یک نشانی وب سفارشی مانند «/partner/influencer-name» ایجاد کنید و قانونی برای آن اضافه کنید. سپس می‌توانید این نشانی وب را به‌طور پویا با تغییر مشارکت‌ها ردیابی، به‌روزرسانی، یا حذف کنید.
- مسیرهای نشانی وب آزمایش A/B: توسعه‌دهنده می‌تواند ویژگی جدیدی را تحت
مسیر نشانی وب خاصی منتشر کند و قانونی برای آن در فایل
assetlinks.jsonاضافه کند. این کار به آن‌ها اجازه می‌دهد ویژگی را با زیرمجموعه‌ای از کاربران آزمایش کنند و سپس مسیریابی را بدون استقرار کامل برنامه اصلاح کنند. - رویدادهای کوتاه‌مدت: برنامه بلیت یا رویداد می‌تواند قوانین نشانی وب را برای رویدادهای خاصی اضافه کند. پس‌از اتمام رویداد، می‌توانید این قوانین را از سرور حذف کنید.
سازگاری با پیاده‌سازی‌های «پیوندهای برنامه»
افزونه‌های «پیوندهای پویای برنامه» در Android 15 برای سازگاری کامل با پیاده‌سازی‌های موجود «پیوندهای برنامه» در دستگاه‌های دارای نسخه‌های قدیمی‌تر Android طراحی شده‌اند. نسخه‌های پایین‌تر برنامه نمی‌توانند از پیکربندی پویا یا ویژگی‌های پیکربندی استفاده کنند، آن‌ها به هر قانونی که در مانیفست اعلام شده است برمی‌گردند. «پیوند برنامه» شما همچنان می‌تواند به‌درستی برنامه‌تان را باز کند یا برای کاربران نسخه‌های قبلی Android به‌طور مناسب به وب برگردد. در اکثر موارد، می‌توانید قوانین پویا را بدون تأثیر بر تجربه بقیه پایگاه کاربرانتان به‌طور ایمن مستقر کنید. برای جزئیات بیشتر درباره نحوه پیکربندی فیلترهای قصد برای سازگاری با نسخه قدیمی، به سازگاری با نسخه قدیمی «پیوندهای پویای برنامه» برای Android 14 و نسخه‌های پایین‌تر مراجعه کنید.
ملاحظات مربوط به راه‌اندازی قوانین فیلتر «پیوندهای پویای برنامه»
اگر درحال راه‌اندازی فیلترهای «هدف» برای استفاده با «پیوندهای پویای برنامه» در Android نسخه ۱۵ و بالاتر هستید، به‌خاطر داشته باشید که قوانین مسیریابی سطح مسیر تعریف‌شده در فایل assetlinks.json سمت سرور شما نمی‌تواند دامنه‌ای را که به‌صورت ایستا در قوانین فیلتر «هدف» فایل مانیفست خود تنظیم کرده‌اید گسترش دهد.
به همین دلیل، توصیه می‌کنیم گسترده‌ترین دامنه ممکن را در فیلترهای قصد مانیفست خود تنظیم کنید و سپس برای پالایش بیشتر به قوانین assetlinks.json سمت سرور تکیه کنید. با این پیکربندی ایده‌آل، می‌توانید به‌طور پویا «پیوندهای برنامه» جدیدی اضافه کنید که در محدوده وسیع تعیین‌شده در مانیفست قرار می‌گیرند.
اصلاح قابلیت اطمینان برای قوانین پویا
در سپتامبر ۲۰۲۶، مشکلی را در خدمات Google Play برطرف کردیم که
به‌طور متناوب مانع از اعمال قوانین پویا در فایل assetlinks.json شما در برخی‌از دستگاه‌های دارای Android 15 (سطح API ۳۵) و
بالاتر می‌شد. وقتی این مشکل رخ داد، دستگاه‌های تحت‌تأثیرقرارگرفته فقط از فیلترهای قصدی استفاده کردند که در مانیفست برنامه‌تان اعلام شده بود، بنابراین نشانی‌های وب مستثنی‌شده توسط قوانین پویای شما می‌توانستند برنامه‌تان را باز کنند. لازم نیست برنامه‌تان یا فایل assetlinks.json را تغییر دهید. با این اصلاح، انتظار داریم اکثر دستگاه‌ها قوانین پویای شما را همان‌طور که اعلام کرده‌اید اعمال کنند.
پیاده‌سازی «پیوندهای برنامه» را برنامه‌ریزی کنید
پشتیبانی از «پیوندهای برنامه» مستلزم پیاده‌سازی در برنامه شما و همچنین
کار در سمت سرور برای راه‌اندازی فایل assetlinks.json است. کارهای آماده‌سازی و پیاده‌سازی عمومی در اینجا فهرست شده‌اند و پیوندهایی به منابع دیگر برای جزئیات بیشتر ارائه شده است.
- برنامه‌ریزی پیوندهای عمیق – با ارزیابی پیوندهای عمیق موردنیازتان، الگوهای نشانی وب که استفاده خواهند کرد، نحوه و زمان به‌روزرسانی آن‌ها، و «فعالیت» یا کنشی که می‌خواهید هر نشانی وب در برنامه‌تان به آن منتهی شود شروع کنید.
- پشتیبانی از «پیوندهای پویای برنامه» - به کاربران جدیدترین دستگاه‌های Android بهترین تجربه ممکن را ارائه دهید. از «پیوندهای پویای برنامه» برای کاربران Android 15 یا نسخه‌های جدیدتر بهره ببرید.
- قوانین فیلتر پویای خود را برنامه‌ریزی کنید – اگر از «پیوندهای پویای برنامه» استفاده می‌کنید، برنامه‌ریزی کنید که قوانین سمت سرور شما چگونه با قوانین تعریف‌شده به‌صورت ایستا در مانیفست برنامه شما کار خواهند کرد. به‌خاطر داشته باشید که قوانین فیلتر در فایل assetlinks.json شما نمی‌تواند دامنه فیلترهای مانیفست برنامه‌تان را گسترش دهد. باید برنامه‌ریزی کنید که فیلترهای مانیفست شما گسترده‌ترین دامنه ممکن را اعلام کنند، و سپس قوانین سمت سرور شما می‌توانند آن قوانین را درصورت نیاز اصلاح کنند. برای اطلاعات بیشتر، به پیکربندی قوانین پویا مراجعه کنید.
- فیلترهای قصد را برای پیوندهایتان ایجاد و آزمایش کنید – پیوندهای عمیق خود را در فیلترهای قصد اعلام کنید و تطابق الگوی نشانی وب و مدیریت قصد ورودی را آزمایش کنید. برای پشتیبانی از «پیوندهای پویای برنامه»، توجه داشته باشید که ممکن است لازم باشد برخی‌از مسیرهای دقیق را به فایل JSON سمت سرور منتقل کنید.
- خواندن داده‌ها از هدف‌های «پیوند برنامه» ورودی - هدف‌های پیوند عمیق ورودی را به‌درستی مدیریت کنید و آن‌ها را به «فعالیت» مناسب ارجاع دهید. پیاده‌سازی «پیوندهای برنامه» مانند پیوندهای عمیق معمولی است که در خواندن داده‌ها از هدف‌های ورودی پوشش داده شده است.
- پیکربندی انجمن‌های وب‌سایت و قوانین پویا - برای پشتیبانی از «پیوندهای برنامه»، باید یک فایل سمت سرور را که در وب‌سایت یا دامنه شما میزبانی می‌شود پیکربندی کنید. دستگاه‌های Android این فایل را برای اعتبارسنجی پیاده‌سازی «پیوندهای برنامه» با برنامه‌تان بازیابی خواهند کرد. اطلاعات بیشتر در اینجا.
- درستی‌سنجی «پیوندهای برنامه» را آزمایش کنید - بررسی کنید که سیستم Android می‌تواند پیوندهای عمیق شما را با موفقیت به‌طور خودکار درستی‌سنجی کند. از اشکال‌زدایی و آزمایش سرتاسری استفاده کنید تا مطمئن شوید پیکربندی شما ایمن است و در همه مسیرهای تأییدشده «پیوند برنامه» به‌درستی کار می‌کند.
- با ابزارهایی که می‌توانید برای راه‌اندازی «پیوندهای برنامه» استفاده کنید، ازجمله Android Studio و «کنسول Play»، آشنا شوید. بیشتر در اینجا.