> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# رمز QR للربط العميق بتطبيق (App Deep Link)

> إنشاء رمز QR يفتح رابطًا عميقًا داخل تطبيق جوال.

## الغرض منه

يفتح رمز QR من نوع App Deep Link تطبيقك مباشرة على شاشة معيّنة — عبر مخطط URI المخصص الخاص به — إذا كان التطبيق مثبّتًا على جهاز المسح. وإن لم يكن مثبّتًا، يعود الرمز إلى صفحة تطبيقك في المتجر، أو إلى صفحة ويب عادية كحل أخير. إنه **Quick Code** — رمز QR ذو إجراء مباشر بدون صفحة هبوط. في التطبيق، تقرأ البطاقة الخاصة به "Open your app directly if it's installed, otherwise fall back to the store."

<Note>
  رمز App Deep Link هو **دائمًا رمز ديناميكي (dynamic)** — وهذا مطلوب حتى يتمكن منطق التحليل (تطبيق ← متجر ← احتياطي) من العمل وقت المسح. تحصل على عنوان URL مختصر من Scanova (‏`scnv.io/...`) ويمكنك ربط نطاق مخصص، لكن لا توجد له صفحة هبوط خاصة.
</Note>

## ترتيب التحليل

يُنظَّم النموذج في ثلاثة أقسام، تُفحص بهذا الترتيب وقت المسح:

1. **التطبيق مثبّت** — يفتح الجهاز تطبيقك مباشرة عبر **Android app URI** أو **iOS app URI** المطابق.
2. **التطبيق غير مثبّت، ونظام التشغيل معروف** — يُرسَل الجهاز إلى **رابط المتجر** المطابق (Google Play أو Apple App Store)، إن وفّرته.
3. **لا ينطبق أي مما سبق** — يُرسَل الماسح إلى **Fallback web URL**، ولهذا يكون هذا الحقل مطلوبًا.

## إنشاء رمز QR من نوع App Deep Link

<Steps>
  <Step title="فتح Create QR Code واختيار Quick Code">
    من الشريط الجانبي، انتقل إلى **QR Codes**، ثم انقر على **Create QR Code** (أو انتقل إلى `/qr/create`). انقر على بطاقة **Quick Code**.
  </Step>

  <Step title="اختيار App Deep Link">
    في شبكة أنواع **Quick Code**، انقر على **Configure** أسفل **App Deep Link**، في قسم **Dynamic** أعلى الصفحة (لا يملك هذا النوع خيار Static). سيفتح هذا النموذج على المسار `/qr/quick/appDeepLink`.
  </Step>

  <Step title="إضافة عناوين URI لتطبيقك">
    ضمن **App URIs**، أدخل واحدًا على الأقل من **Android app URI** أو **iOS app URI** — المخطط المخصص الذي يسجّله تطبيقك للفتح المباشر (مثال: `myapp://profile`).
  </Step>

  <Step title="إضافة روابط المتجر (اختياري) وعنوان احتياطي">
    ضمن **Store links**، أضف اختياريًا روابط Google Play و/أو Apple App Store الخاصة بك، وتظهر عندما لا يكون التطبيق مثبّتًا لكن نظام تشغيل الجهاز معروف. ضمن **Fallback URL**، أدخل **Fallback web URL** — هذا الحقل مطلوب، إذ يمثّل الوجهة الأخيرة لكل الحالات الأخرى.

    <Frame caption="نموذج App Deep Link Quick Code مع إدخال عناوين URI للتطبيق وروابط المتجر وعنوان احتياطي">
      <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/app-deep-link/app-deep-link-quick-code-form.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=fa5c24381e8f34cf1794154ecce881bc" alt="نموذج App Deep Link Quick Code مع عناوين URI لتطبيقي Android وiOS، وروابط متجر اختيارية، وعنوان URL احتياطي مطلوب، وعنوان URL مختصر مُولّد تلقائيًا لرمز QR الديناميكي" width="1280" height="1277" data-path="images/v2/qr-codes/create/app-deep-link/app-deep-link-quick-code-form.png" />
    </Frame>
  </Step>

  <Step title="النشر">
    انقر على **Publish**. تنفتح لوحة لتأكيد رمز QR أو إعادة تسميته، وتعيين مجلد أو وسوم، وضبط تصميم رمز QR قبل التأكيد.
  </Step>
</Steps>

## إنشاؤه عبر الـ API

لإنشاء رمز QR من نوع App Deep Link عبر الـ API بدلًا من الواجهة، استخدم معرّف الفئة `23` (المسمّى **App Deep Link** في جدول **Category dropdown reference** ضمن [Create QR Code](/v1/api-reference/endpoint/qr_manager/create)، حيث `allowed_qr_types: "dy"` — القيمة `"dy"` فقط صالحة لـ `qr_type`). بخلاف كل فئة أخرى في هذه الصفحة، حمولة `info` هنا هي **مصفوفة صِرفة (bare array)** من كتل مصنّفة بالنوع، وليست كائن `{type, data}`:

```json theme={null}
[
  {
    "type": "intentUri",
    "data": [
      { "type": "android", "uri": "acmeapp://profile/42" },
      { "type": "ios", "uri": "acmeapp://profile/42" }
    ]
  },
  {
    "type": "appStore",
    "data": [
      { "type": "playStore", "url": "https://play.google.com/store/apps/details?id=com.acme.app" },
      { "type": "appleStore", "url": "https://apps.apple.com/app/id123456789" }
    ]
  },
  {
    "type": "fallback",
    "data": { "url": "https://acme.com/profile/42" }
  }
]
```

كل كتلة اختيارية من حيث المبدأ، لكن حقل `url` في كتلة `fallback` مطلوب فعليًا — فالنشر بدون عنوان احتياطي يفشل في التحقق بنفس الطريقة التي يمنعها بها نموذج لوحة التحكم. أدرج كتلة `intentUri` فقط إذا كان لديك عنوان URI واحد على الأقل للتطبيق.

راجع [Create QR Code](/v1/api-reference/endpoint/qr_manager/create) للاطلاع على مخطط الطلب الكامل.

## ذات صلة

* [رمز QR لمتجر التطبيقات](/ar/qr-codes/create/app-store) — بديل أبسط لـ "الإرسال إلى المتجر" عندما لا تحتاج إلى ربط عميق داخل التطبيق.
* [إنشاء أول رمز QR لك](/ar/getting-started/first-qr-code) — دليل كامل لسير عمل Quick Code الذي ينتمي إليه هذا النوع.
* [المجلدات والوسوم والعمليات المجمّعة](/ar/qr-codes/manage/folders-tags-bulk-operations) — تنظيم رمز QR بعد نشره.