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