> ## 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 لمتجر التطبيقات

> إنشاء رمز QR يربط بتطبيقك في App Store أو Play Store.

## الغرض منه

يُرسل رمز QR من نوع App Store الماسحين مباشرة إلى صفحة تطبيقك في Google Play أو Apple App Store — باختيار المتجر المناسب تلقائيًا حسب جهاز المسح. إنه **Quick Code** — رمز QR ذو إجراء مباشر بدون صفحة هبوط. في التطبيق، تقرأ البطاقة الخاصة به "Send scanners to the right app store for their device."

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

## سلوك إعادة التوجيه

مع تفعيل **Auto-detect device and redirect** (الإعداد الافتراضي)، يتصرف المسح كما يلي:

* يُعاد توجيه جهاز **Android** مباشرة إلى عنوان URL الخاص بـ Google Play.
* يُعاد توجيه جهاز **iOS أو Mac** مباشرة إلى عنوان URL الخاص بـ Apple App Store.
* يرى أي جهاز آخر شاشة اختيار تُدرج كلا الرابطين.

إيقاف مفتاح التبديل يعرض دائمًا شاشة الاختيار بكلا الرابطين، لكل ماسح، بغض النظر عن الجهاز.

<Tip>
  إذا ملأت رابط متجر واحد فقط، فهذا هو الرابط الوحيد الذي سيُعرض على الماسحين على أي جهاز.
</Tip>

## إنشاء رمز QR لمتجر تطبيقات

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

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

  <Step title="إضافة روابط متجرك">
    أدخل **Google Play Store URL** و/أو **Apple App Store URL** — أضف واحدًا على الأقل. اترك **Auto-detect device and redirect** مفعّلًا ما لم ترغب تحديدًا في أن يرى كل ماسح شاشة اختيار بغض النظر عن الجهاز.

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

  <Step title="مراجعة عنوان URL المختصر">
    نظرًا لأن هذا النوع ديناميكي دائمًا، يُولَّد عنوان URL مختصر من Scanova تلقائيًا (على سبيل المثال `scnv.io/6z02`). عدّل المعرّف، أو اربط نطاقًا مخصصًا موثّقًا، أو فعّل معلمات تتبع UTM ضمن **Advanced settings**.
  </Step>

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

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

لإنشاء رمز QR لمتجر تطبيقات عبر الـ API بدلًا من الواجهة، استخدم معرّف الفئة `10` (المسمّى **App Store** في جدول **Category dropdown reference** ضمن [Create QR Code](/v1/api-reference/endpoint/qr_manager/create)، حيث `allowed_qr_types: "dy"` — القيمة `"dy"` فقط صالحة لـ `qr_type`)، مع حمولة `info` بالشكل التالي:

```json theme={null}
{
  "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" }
  ]
}
```

`data` مصفوفة تحتوي على 0 إلى 2 عنصرًا (‏`playStore` و/أو `appleStore`) — أدرج واحدًا على الأقل. حقل شقيق اختياري وهو `settings: { "autoDetectDisabled": true }` يعطّل إعادة التوجيه التلقائية ويعرض دائمًا شاشة الاختيار؛ احذفه (أو اتركه `false`) لإبقاء الاكتشاف التلقائي مفعّلًا.

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

## ذات صلة

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